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

はじめに

このセクションでは、Data Cloud の API ライブラリと SDK を使い始めるために必要な前提条件を理解できます。

Data Cloud の理解

このアプリケーションに慣れていない場合は、Data Cloud オンラインヘルプを参照してください。

Data Cloud の設定

Data Cloud API を使用するには、アプリケーションを定義する必要があります。アプリケーションの設定手順は、PDF ガイド: 『Data Cloud Implementation Overview Guide (Data Cloud 実装概要ガイド)』に掲載されています。既存のインスタンスを使用している場合は、使用しているユーザプロファイルに、Data Cloud API を使用する権限があるかどうかを管理者に確認してください。

データソースの設定

Data Cloud インスタンスを作成したら、インスタンスからのデータの取り込みおよび有効化の範囲を制御できます。

データソースを設定するには、ユーザインターフェースでアプリケーションコネクタを作成して、データの対応付けとセグメント用のデータを取り込む場所をアプリケーションに指示します。

接続アプリケーションの作成

Data Cloud API へのアクセスを認証および要求する接続アプリケーションを設定します。接続アプリケーションは、認証と承認のための標準的な OAuth プロトコルを有効にします。必要に応じて Salesforce ヘルプの「接続アプリケーションの作成」の手順に従って、アプリケーションを設定します。接続アプリケーションで、[OAuth 設定の有効化] と必要な OAuth 範囲が選択されていることを確認します。選択可能な範囲は次のとおりです。

Data Cloud のデータに対する ANSI SQL クエリを実行 (cdp_query_api): cdp_query_api の範囲では、ユーザの代わりに Data Cloud のデータの ANSI SQL クエリを実行できます。
Data Cloud のプロファイルデータを管理 (cdp_profile_api): cdp_profile_api の範囲では、Data Cloud REST API データにアクセスできます。この範囲を使用して、プロファイルレコードを管理します。
いつでも要求を実行 (refresh_token): この範囲では、更新トークンを受け取る資格が要求元クライアントにある場合に、更新トークンを返すことが許可されます。更新トークンにより、ユーザがオフラインのときにアプリケーションはユーザのデータを操作できます。
API を使用してユーザデータを管理 (api): この範囲では、REST API や Bulk API 2.0 などの API を使用して、現在のログインユーザのアカウントへのアクセスが許可されます。

組織に Data Cloud ライセンスをプロビジョニングし、また、ユーザに適切なロールを割り当てて Data Cloud アプリケーションのオブジェクトにフル��クセスできるようにする必要があります。接続アプリケーションを設定する前に、「Data Cloud のユーザロールと権限セット」を参照してください。

重要

アクセストークンの取得

Salesforce アクセストークンを取得するための要求を送信します。要求の内容は、次のようになります。

1POST https://login.salesforce.com/services/oauth2/token
2Content-Type : x-www-form-urlencoded
3grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer
4&assertion=eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJpc3MiOiIzTVZHOUFPcDRrYnJpWk9JZmg0eWZPQVlQUjFpYzJqb1JDQkhwZFZtaXBXU05sbXNwT2Vib1VtcWdMdHJIcDlRVFRQMGpWc3g0SHlzUW4xLk1SazFyIiwic3ViIjoic3VkaGVlckBvcmdtYWluMi5jb20iLCJhdWQiOiJodHRwOi8vc3VrdW1hci1sdG0uaW50ZXJuYWwuc2FsZXNmb3JjZS5jb20iLCJleHAiOjE2MDQ2Mzc4MTkyNTd9.WkEcmaGj_jhJpyFqXwEUtw-bkeXYuxkqc2c3lkwbGjg3GDo7sStITht_O_dSNanS0xk2q9ARA6Uom-uaiyNw_GGGK5L3jBQjK-ytrGumuJAsujjfSmLdYStxPVnjU2zyuPSWMQJmeDegxDgmeht3UQyluj0q4lX3rayx0Ol-vZfTuzr4YlxmdOKTNrPJCQ8h26uMSPFrQmmqcssrSg1DRgm3kMh15VKM3yZyNAg43EPw1BfncPWIxOmsGt2JxUUclBER3enTLM2cJKr9fDx16Ssesj2UKqXGbwN68gCF5rZxD6yGN5B0VeZIZVJrY5cTtExqBp3Lj8UOcqUj6esyCQ

JWT アサーションの作成については、「サーバ間インテグレーション用の OAuth 2.0 JWT ベアラーフロー」を参照してください。

メモ

応答形式

1{
2"access_token": "00Dxx0000006JFr!AQEAQL7SvQ1t..2yYtyM0jfXtMNriivdMpTYE3mThqATnm5YqPIX.xnzUC45zd0HEIU3tc9GdHLqWOFVprsgszWdYMPRUnOy",
3"scope": "cdpquery api cdpprofile",
4"instance_url": "http://orgmain2.localhost.internal.salesforce.com:6109",
5"id": "http://sukumar-ltm.internal.salesforce.com:6109/id/00Dxx0000006JFrEAM/005xx000001X9hBAAS",
6"token_type": "Bearer"
7}

アクセストークンの Data Cloud トークンとの交換

Salesforce アクセストークンを取得できたので、次の要求でアクセストークンを取得して、API を呼び出します。

1POST <Instance URL>/services/a360/token
2Content-Type : x-www-form-urlencoded
3grant_type=urn:salesforce:grant-type:external:cdp
4&subject_token=<CORE ACCESS TOKEN>
5&subject_token_type=urn:ietf:params:oauth:token-type:access_token

1{
2"access_token": "eyJraWQiOiJDT1JFLjAwRHh4MDAwMDAwNkpGci4xNjAzMjM5NzI2NjI5IiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiJodHRwOi8vc3VrdW1hci1sdG0uaW50ZXJuYWwuc2FsZXNmb3JjZS5jb206NjEwOS9pZC8wMER4eDAwMDAwMDZKRnJFQU0vMDA1eHgwMDAwMDFYOWhCQUFTIiwiYXVkIjoiYTM2MCIsInNjcCI6ImNkcHByb2ZpbGUgY2RwcXVlcnkiLCJuYmYiOjE2MDQ1NTE3NzYsInNmb2lkIjoiMDBEeHgwMDAwMDA2SkZyIiwiaXNzIjoiaHR0cDovL3N1a3VtYXItbHRtLmludGVybmFsLnNhbGVzZm9yY2UuY29tOjYxMDkvIiwic2Z1aWQiOiIwMDV4eDAwMDAwMVg5aEIiLCJleHAiOjE2MDQ1NTkwMjgsImlhdCI6MTYwNDU1MTgzNiwianRpIjoiYjk1ODA1ZDUtM2MzYS00MDNkLWJiNjgtNjBkNTJlNmM4OTBjIiwic2ZhcHBpZCI6IjNNVkc5QU9wNGticmlaT0lmaDR5Zk9BWVBSMWljMmpvUkNCSHBkVm1pcFdTTmxtc3BPZWJvVW1xZ0x0ckhwOVFUVFAwalZzeDRIeXNRbjEuTVJrMXIifQ.GAWqiPpVJoDig-adGtD4d5cO7L7JaIn2mOYH9GyDD7oO7Ayrsnv_k05QRPp-B1gSd4U8lqE_cuC0MTE9L6lzJA",
3"instance_url": "https://a360.cdp.cdp001.dev1-uswest2.aws.sfdc.cl",
4"token_type": "Bearer",
5"issued_token_type": "urn:ietf:params:oauth:token-type:jwt",
6"expires_in": 7191
7}

ここで取得したアクセストークンを instance_url として使用します。これは、Data Cloud URL です。

自動生成されるエンドポイント

Data Cloud アプリケーションは、システムが生成した一意のエンドポイントを各組織に割り当てます。

Data Cloud でエンドポイントを取得したら、そのエンドポイントを自分の組織の API コールで使用します。他の Data Cloud ユーザがそのエンドポイントを使用して API 要求を実行することはできません。

ユーザは c360a.salesforce.com エンドポイント構造に基づいた自分のエンドポイントのみを使用できます。

Data Cloud 開発者ガイド