使用開始

前提条件

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

認証

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

• Salesforce CDP 取り込み API データへのアクセスと管理 (cdp_ingest_api)。
• データへのアクセスと管理 (api)。
• ユーザに代わっていつでも要求を実行 (refresh_token, offline_access)。

接続アプリケーションに適切な範囲が設定されたら、Salesforce にアクセストークンを要求し、Salesforce CDP アクセストークンと交換します。

レコードで有効な日付形式

dateTime 項目を指定するには、yyyy-MM-ddTHH:mm:ss.SSSZ 形式を使用します。例: 2021-07-05T09:31:44.457Z

• yyyy は 4 桁の年号
• MM は 2 桁の月 (01 ～ 12)
• dd は 2 桁の日付 (01 ～ 31)
• 「T」はこの後に時刻が記述されることを示す区切り文字
• HH は 2 桁の時間 (00 ～ 23)
• mm は 2 桁の分 (00 ～ 59)
• ss は 2 桁の秒 (00 ～ 59)
• SSS は省略可能な 3 桁のミリ秒 (000 ～ 999)
• 「Z」はタイムゾーンが UTC であることを示す

取り込み API の制限

状況コードとエラー応答