このガイドでは、Adobe Experience Platform Privacy Service API を呼び出す前に知っておく必要があるコア概念の概要を示します。
このガイドでは、 Privacy Service およびを使用すると、Adobe Experience Cloudアプリケーション全体でデータ主体(顧客)からのアクセス要求と削除要求を管理できます。
API のアクセス資格情報を作成するには、組織内の管理者がAdobe Admin Console内でPrivacy Service用の製品プロファイルを事前に設定しておく必要があります。 API 統合に割り当てる製品プロファイルによって、統合機能にアクセスする際に統合に付与されるPrivacy Serviceが決まります。 詳しくは、 Privacy Service権限の管理 を参照してください。
Privacy ServiceAPI を呼び出すには、まず、必要なヘッダーで使用するアクセス資格情報を収集する必要があります。
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
これらの値は、 Adobe Developer Console. お使いの {ORG_ID}
および {API_KEY}
は 1 回だけ生成する必要があり、今後の API 呼び出しで再利用できます。 ただし、 {ACCESS_TOKEN}
は一時的で、24 時間ごとに再生成する必要があります。
これらの値を生成する手順については、以下で詳しく説明します。
Adobe Developer Console に移動し 、Adobe ID を使用してログインします。次に、Developer Console のドキュメントにある空のプロジェクトを作成に関するチュートリアルで説明されている手順に従います。
新しいプロジェクトを作成したら、「 プロジェクトに追加 を選択します。 API をドロップダウンメニューから選択します。
API の追加画面が表示されます。 選択 Experience Cloud 使用可能な API のリストを絞り込むには、 Privacy ServiceAPI 選択する前に 次へ.
この API の設定 画面が表示されます。 次のオプションを選択します。 キーペアを生成を選択し、「 キーペアを生成.
キーペアが自動的に生成され、秘密鍵と公開証明書を含む ZIP ファイルがブラウザーによってダウンロードされます(後の手順で使用します)。 「次へ」をクリックして続行します。
最後の設定手順では、この統合の権限を継承する製品プロファイルを選択します。 複数のプロファイルを選択した場合、その権限セットは統合用に結合されます。
製品プロファイルとそれらが提供する詳細な権限は、管理者がAdobe Admin Consoleを通じて作成および管理します。 詳しくは、 Privacy Service権限 を参照してください。
終了したら、「 」を選択します。 設定済み API を保存.
API がプロジェクトに追加されると、プロジェクトページが Privacy ServiceAPI の概要 ページ。 ここから、 サービスアカウント (JWT) セクションに含まれます。Privacy ServiceAPI へのすべての呼び出しで必要な、以下のアクセス資格情報が提供されます。
{API_KEY}
を x-api-key
ヘッダー。x-gw-ims-org-id
ヘッダーで使用する必要がある {ORG_ID}
値です。収集する必要がある最後の資格情報は、 {ACCESS_TOKEN}
:Authorization ヘッダーで使用されます。 の値とは異なる {API_KEY}
および {ORG_ID}
に値を指定する場合、API を引き続き使用するには、24 時間ごとに新しいトークンを生成する必要があります。
一般に、アクセストークンを生成する方法は 2 つあります。
新しい {ACCESS_TOKEN}
」をクリックし、以前にダウンロードした秘密鍵を開き、その内容をの横にあるテキストボックスに貼り付けます。 アクセストークンを生成 選択する前に トークンを生成.
新しいアクセストークンが生成され、トークンをクリップボードにコピーするためのボタンが提供されます。 この値は、必要な Authorization ヘッダーに使用され、の形式で指定する必要があります Bearer {ACCESS_TOKEN}
.
AdobeIdentity Managementサービス (IMS) にPOSTリクエストを通じて JSON Web トークン (JWT) を送信することで、自動プロセス用の新しいアクセストークンを生成できます。 次のドキュメントにある開発者コンソールのドキュメントを参照してください。 JWT 認証 を参照してください。
各エンドポイントガイドには、API 呼び出しの例が用意されており、リクエストの形式を設定する方法を示しています。 これには、パス、必須ヘッダー、適切な形式のリクエストペイロードが含まれます。また、API レスポンスで返されるサンプル JSON も示されています。サンプル API 呼び出しのドキュメントで使用されている規則については、 Platform API の開始ガイドのAPI 呼び出し例の読み方に関する節を参照してください。
使用するヘッダーを理解できたので、Privacy Service API への呼び出しを開始できます。開始するには、次のいずれかのエンドポイントガイドを選択します。