翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# サードパーティーAPIs に接続する (汎用)
<a name="connectors-api"></a>

App Studio で汎用 **API Connector** を作成するには、次の手順に従います。**API Connector** は、App Studio アプリにサードパーティーのサービス、リソース、またはオペレーションへのアクセスを提供するために使用されます。

****API Connector** を使用してサードパーティーのサービスに接続するには**

1. 左側のナビゲーションペインで、**管理**セクションで**コネクタ**を選択します。既存のコネクタのリストとそれぞれの詳細を示すページが表示されます。

1. **\$1 コネクタの作成**を選択します。

1. **API Connector** を選択します。次に、次のフィールドに入力してコネクタを設定します。

1. **コネクタ名: **コネクタの名前を指定します。

1. **コネクタの説明: **コネクタの説明を入力します。

1. **ベース URL: ** サードパーティー接続のウェブサイトまたはホスト。例えば、`www.slack.com`。

1. **認証方法:** ターゲットサービスで認証する方法を選択します。
   + **なし:** 認証なしでターゲットサービスにアクセスします。
   + **基本:** 接続先のサービスから****取得した**ユーザー名とパスワード**を使用して、ターゲットサービスにアクセスします。
   + **ベアラートークン:** サービスのユーザーアカウントまたは API 設定から取得した認証トークンの**トークン値**を使用して、ターゲットサービスにアクセスします。
   + **OAuth 2.0:** OAuth 2.0 プロトコルを使用してターゲットサービスにアクセスします。これにより、App Studio は認証情報や ID を共有せずにサービスとリソースにアクセスできるようになります。OAuth 2.0 認証方法を使用するには、まず App Studio を表す接続先のサービスからアプリケーションを作成して、必要な情報を取得する必要があります。この情報を使用して、次のフィールドに入力します。

     1. **クライアント認証情報フロー:** アプリケーションがユーザーとやり取りすることなく独自に動作するsystem-to-systemやり取りに最適です。たとえば、ユーザーが追加した新しいレコードに基づいて Salesforce レコードを自動的に更新する CRM アプリや、トランザクションデータを取得してレポートに表示するアプリなどです。

        1. **クライアント ID** に、ターゲットサービスで作成された OAuth アプリから取得した ID を入力します。

        1. **クライアントシーク**レットで、ターゲットサービスで作成された OAuth アプリから取得したシークレットを入力します。

        1. **アクセストークン URL** で、ターゲットサービスで作成された OAuth アプリから取得したトークン URL を入力します。

        1. 必要に応じて、**スコープ**にアプリケーションのスコープを入力します。スコープは、アプリケーションに必要なアクセス許可またはアクセスレベルです。ターゲットサービスの API ドキュメントを参照してスコープを理解し、App Studio アプリに必要なスコープのみを設定します。

        **接続の検証**を選択して、認証と接続をテストします。

     1. **認可コードフロー:** ユーザーに代わって動作する必要があるアプリケーションに最適です。たとえば、ユーザーがログインしてサポートチケットを表示および更新するカスタマーサポートアプリや、各チームメンバーがログインして販売データを表示および管理するセールスアプリなどです。

        1. **クライアント ID** に、ターゲットサービスで作成された OAuth アプリから取得した ID を入力します。

        1. **クライアントシーク**レットで、ターゲットサービスで作成された OAuth アプリから取得したシークレットを入力します。

        1. **認可 URL** に、ターゲットサービスの認可 URL を入力します。

        1. **アクセストークン URL** で、ターゲットサービスで作成された OAuth アプリから取得したトークン URL を入力します。

        1. 必要に応じて、**スコープ**にアプリケーションのスコープを入力します。スコープは、アプリケーションに必要なアクセス許可またはアクセスレベルです。ターゲットサービスの API ドキュメントを参照してスコープを理解し、App Studio アプリに必要なスコープのみを設定します。

1. **ヘッダー:** リクエストまたはレスポンスに関するメタデータを提供するために使用される HTTP ヘッダーを追加します。キーと値の両方を追加することも、ビルダーがアプリケーションで値を提供できるキーのみを指定することもできます。

1. **クエリパラメータ:** リクエスト URL の一部としてオプション、フィルター、またはデータを渡すために使用されるクエリパラメータを追加します。ヘッダーと同様に、キーと値の両方を指定することも、ビルダーがアプリケーションで値を提供できるキーのみを指定することもできます。

1. **[作成]** を選択します。新しく作成されたコネクタが**コネクタ**リストに表示されます。

コネクタが作成されると、ビルダーはそれをアプリケーションで使用できます。