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

Portability

Portability API は、Salesforce Customer 360 Privacy Center での可搬性ポリシーの作成時に識別したオブジェクトと項目から顧客情報をコンパイルします。API バージョン 50.0 以降を使用している場合は、複数のレコードから顧客の個人識別情報 (PII) を特定できます。データの可搬性により、組織のプラットフォームに保存されている PII のコピーを顧客が取得するための権利に対応できます。一般データ保護規則 (GDPR) などのプライバシー規制に準拠するには、データの可搬性に関する要求が出されてから 1 か月以内に実行する必要があります。

POST メソッドを使用して Portability API を実行して、取引先、取引先責任者、個人、リード、個人取引先、ユーザオブジェクトの PII を 1 つのファイルに集約します。ファイルをダウンロードする URL、ポリシーファイル ID、ポリシーを作成するときに選択したすべてのオブジェクトと項目に関する情報を含む応答を受信します。ポリシーファイル ID を使用し、GET メソッドを使用して Portability API を実行します。

GET メソッドを使用して Portability API を実行し、POST メソッド実行要求の状況を確認します。POST メソッド応答のポリシーファイル ID を使用して GET メソッドを実行します。GET メソッド応答には、次の情報が含まれます。

値	説明
policyFileStatus	コンパイルされているファイルの状況。値は、In Progress (処理中)、Complete (完了)、Failed (失敗) です。
policyFileURL	コンパイル後にファイルをダウンロードできるサーブレットの URL。
policyFileID	POST メソッド応答で返される、コンパイルされているファイルの ID。ID は 15 文字です。

Spring '21 リリース以降、Customer 360 Privacy Center では Portability API によって生成されたファイルは 60 日後に自動的に削除されます。ファイルが削除される 7 日前にアラームを受信します。

メモ

必須権限

Portability API を使用するには、ModifyAllData または PrivacyDataAccess ユーザ権限を持っている必要があります。Salesforce システム管理者からこれらの権限が付与されていることを確認してください。

構文

URI

/services/data/vXX.X/consent/dsr/rtp/execute

適用開始バージョン

50.0

形式

JSON

HTTP のメソッド

POST、GET

POST 要求のパラメータ

パラメータ	説明
dataSubjectId	要求を行う顧客の ID。ID は 15 または 18 文字で、取引先、取引先責任者、個人、リード、個人取引先、およびユーザオブジェクトに表示されます。
policyName	有効なポリシーの名前。これには dataSubjectId パラメータ内のオブジェクトが含まれます。

GET 要求のパラメータ

パラメータ	説明
policyFileId	POST メソッド応答で返される、コンパイルされているファイルの ID。ID は 15 文字です。

POST の例

URI

/services/data/v50.0/consent/dsr/rtp/execute

リクエストボディ

1{
2   “dataSubjectID”:”<root ID>”,
3   “policyName”:”<policyName>”
4}

応答

1{ 
2   “status" : "SUCCESS",
3   "warnings" : [ ], 
4   "result" : { 
5       "policyFileStatus" : "In Progress", 
6       "policyFileUrl" : "https://na45.stmfb.stm.salesforce.com/servlet/policyFileDownload?file=0jeS70000004CBO", 
7       "policyFileId" : "0jeS70000004CBO" 
8   } 
9}

GET の例

URI: /services/data/v50.0/consent/dsr/rtp/execute?policyFileId=0jeS70000004CBO

応答

1{ 
2   “status" : "SUCCESS",
3   "warnings" : [ ], 
4   "result" : { 
5       "policyFileStatus" : "Failed", 
6       "policyFileUrl" : "https://na45.stmfb.stm.salesforce.com/servlet/policyFileDownload?file=0jeS70000004CBO", 
7       "policyFileId" : "0jeS70000004CBO" 
8   } 
9}

REST API 開発者ガイド

Portability

必須権限

構文

POST の例

GET の例