カスタムアクション

1.) この手順では、空の画面に Input フィールドと Button、User's Collection に "Personal Link" という Text プロパティを追加します。この手順についてのヘルプが必要な場合は、最初に当社の はじめに ガイドを参照してください。以下のようなものがあるはずです：

2.) カスタムアクションを追加するコンポーネントを選択します。この手順では、Micro という強力な外部サービスを使用してリンクを短縮するボタンに追加します。

3.) ボタンの Click Actions 領域で、Add Action をクリックし、Custom Action の上にカーソルを合わせて New Custom Action を選択します。以前にカスタムアクションを作成したことがある場合は、ここに表示されます。

4.) 新しいカスタムアクションに Shorten URL などの Name を付け、Adalo で表示するアクションの種類を選択します。Create、Update、または Delete のいずれかを選択できます。この手順では、Create を選択して Next をクリックします。

5.) Microアカウントが含まれるブラウザータブを開き、右上隅のメールをクリックしてからAPI Keysをクリックします。APIキーは、APIの使用に対するパスワードのようなものです。この特定のAPIでは、異なるアプリケーションのために必要な場合に複数のAPIキーを作成することができますが、すべてのAPIがこのように機能するわけではありません。

6.) Createをクリックします。ポップアップが表示され、キーのDescriptionを入力し、このキーが使用するScopes（権限）を選択する必要があります。スコープは、このAPIキーで使用したいサービスに直接関連しています。今回は、URLを短縮するためにURLサービスを使用するので、今はURLだけをチェックしてください（Microのサービスの完全なリストと説明はこちらで確認できます）。

7.) Createをクリックすると、新しいキーが黒いテキストボックスに表示されます。必ずCopyをクリックして、安全で覚えやすい場所に保存してください。キーを紛失した場合は、別のキーを作成する必要があります。完了したらCloseをクリックしてください。

8.) ポップアップが閉じたら、API Usageセクションでコードスニペットを見つけ、https://api.m3o.com/v1/{service}/{endpoint}と書かれた部分をコピーします。これが私たちのベースURLです。これをカスタムアクションのAPI Base URLフィールドに貼り付けます。

9.) 次に、リンクの**{service}と{endpoint}の部分を使用したいサービスとエンドポイントに置き換えます。urlサービスのMicroドキュメントによると、URLを短縮するためのエンドポイントはshortenと呼ばれます。したがって、私たちのベースURLは次のようになります：https://api.m3o.com/v1/url/shorten**。

10.) ほとんどのAPIは、機能に応じてエンドポイントに使用すべきメソッドを指定しますが、MicroではドロップダウンからPOSTを選択する必要があります。リクエストメソッドに関する詳細は、Methodsプライマーを参照してください。

11.) このAPIでは、APIキーを使用して認証する必要があります。MicroアカウントのAPI Keysセクションに戻ると、API Usageセクションで、Authorizationという名前のHeader（-H）が必要であり、その値としてキーが必要であることがわかります。カスタムアクションでは、Headers and Queriesセクションの下にある**+Add Item**をクリックし、Headerを選択します。

12.) ヘッダーの名前にAuthorizationと入力し、値にBearerと入力してから、Microから保存したAPIキーを貼り付けます。Bearerとキーの間にスペース（Enterではなく）を追加するのを忘れないでください。

13.) 次に、Magic Text を使用して任意の URL を送信できるように、アクション用の入力フィールドを追加する必要があります。カスタムアクションの右側の Inputs セクションの下にある +Add Input をクリックします。URL は文字、数字、および記号の組み合わせなので、入力タイプとして Text を選択します。

14.) 新しい入力に "URL to be Shortened" のようなラベル/名前を付け、Example Value としてテスト用に URL を貼り付け、その後 Done をクリックします。データ型と説明の完全なリストは、このヘルプガイドの Learn More セクションで見つけることができます。

15.) エンドポイントに関連する任意のパラメータを送信する必要があります。この場合、短縮する URL を送信する必要があります。"Shorten" エンドポイントの Micro ドキュメント によると、destinationURL という1つのパラメータだけを送信する必要があることがわかります。カスタムアクションの JSON Body フィールドに、Micro ドキュメントからのリクエストコードスニペットを貼り付けます: { "destinationURL": "https://mysite.com/this-is-a-rather-long-web-address" }

使用するエンドポイントが複数のパラメータを必要とする場合は、同じ方法でフォーマットしますが、最後の行以外の各行の後にコンマを追加します。たとえば、Micro の Weather Forecast エンドポイントを取ると:

{ "days": 3, "location": "St. Louis" }

このような JSON の使用および作成に関する詳細は、JSON の基礎 を参照してください。

16.) Magic Text ボタン を使用して、引用符内の https://mysite.com/this... を "URL to be Shortened" 入力で置き換えます。

17.) Run Test Request をクリックします。すべてがうまくいくと、API からの shortURL という出力とともに、テストが成功したメッセージを受け取ります。これらの出力は、返されたデータのために自動的に作成された Magic Text 出力です。これらの出力をカスタマイズするには、名前やタイプを変更するためにそれらをクリックするか、不要な場合は出力を削除することができます。完了したら、Save Custom Action をクリックします。

18.) 今度は、作成した URL to be Shortened という入力を、ユーザーが入力フィールドに入力した内容に設定するために Magic Text を使用する必要があります。

19.) カスタムアクションの出力を後続のアクションで使用することができます。例として、短縮URLアクションの下に更新アクションを追加しましょう。この更新アクションはログインユーザーを更新するようにします。

20.) "Personal Link"プロパティでマジックテキストを使用して、前のカスタムアクション短縮URL > shortURLから情報を配置します。カスタムアクションを編集する必要がある場合は、アクションをクリックしてアクションの左下にある鉛筆アイコンを選択します。

カスタムアクションの例 - Micro APIを使用してリンクを短縮する

カスタムアクションの例 - SendGridを使用してメールを送信する

カスタムアクションの例 - Zapier Webhookに情報を送信する

カスタムアクションの結果や出力を使用する