この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

取り込み API の使用開始

API を介したカスタマーデータプラットフォーム組織へのデータの読み込みを開始する前に、前提条件を完了し、認証を設定し、一括取り込み API およびストリーミング取り込み API に適用される制限を把握します。

前提条件

取り込み API コネクタを設定する。データを消費するエンドポイントとペイロードを定義します。
データストリームを作成およびリリースする。取り込みジョブを設定し、外部消費用の API を公開します。
接続アプリケーションを設定する。外部アプリケーションが OAuth を使用して Salesforce と統合できるようにします。
Salesforce OAuth 認証フローからカスタマーデータプラットフォームアクセストークンを要求します。API 要求の実行に必要なアクセストークンを取得および更新するための OAuth ダンスを実装します。

カスタマーデータプ��ットフォーム取り込み API は、他の Salesforce REST API でサポートされるすべての OAuth 2.0 フローをサポートする RESTful API のセットです。API を介してデータを読み込むには、接続アプリケーションに次の範囲が必要です。

接続アプリケーションに適切な範囲が設定されたら、Salesforce にアクセストークンを要求し、カスタマーデータプラットフォームアクセストークンと交換します。CDP アクセストークンは、ベアラースキーマを使用した Authorization ヘッダーで送信されます。

取り込み API は、ISO 8601 UTC Zulu 形式をサポートしています。dateTime 項目を指定するには、yyyy-MM-ddTHH:mm:ss.SSSZ 形式を使用します。例: 2021-07-05T09:31:44.457Z

項目	説明
API の使用制限	各要求の後、アプリケーションで応答コードを確認する必要があります。`HTTP 429 Too Many Requests` 状況コードは、アプリケーションの要求頻度を減らす必要があることを示しています。
一括ジョブの存続期間	経過日数が 7 日を超えている未完了 (state = Open/UploadComplete) の一括ジョブは取り込みキューから削除されます。
ジョブごとのファイル	一括ジョブごとに一度に 1 つのファイルをアップロードできます。1 つのジョブで最大 100 ファイルを保持できます。
ペイロードサイズ	Bulk API を介してアップロードされる CSV ファイルの最大サイズは 150 MB です。

項目	説明
API の使用制限	各要求の後、アプリケーションで応答コードを確認する必要があります。`HTTP 429 Too Many Requests` 状況コードは、アプリケーションの要求頻度を減らす必要があることを示しています。
予測される遅延	データは約 15 分ごとに非同期で処理されます。
ペイロードサイズ	ストリーミング API を介してアップロードされる JSON データの最大ボディサイズは要求ごとに 200 KB です。
レコード削除の制限	最大 200 件のレコードをストリーミング API によって削除できます。

HTTP 応答コード	説明
200 OK	要求が正常に完了しました。
201 Created	リソースが正常に作成されたことを示します。
202 Accepted	要求が受諾されました。データは非同期で処理されます。
204 No Content	ジョブが正常に削除されました。
400 Bad Request	クライアントエラーのためサーバが要求を処理できません。原因として、不正な要求構文または無効なリクエストボディが考えられます。
401 Unauthorized	JWT が無効または期限切れのため、認証に失敗しました。トークンを更新してください。
404 Not Found	クライアントエラー: 要求されたリソースが存在しません。
409 Conflict	クライアントエラー: この状況ではジョブの状況を更新できません。
429 Conflict	一定の時間内にユーザが送信した要求数が多すぎます。バックオフポリシーを実装して要求数を減らしてください。
500 Internal Server Error	内部サーバエラー。要求を再試行してください。