ドキュメント Campaign Campaign Standard ドキュメント

API を使用した購読の削除 mdeleting-subscriptions-api

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
API

作成対象：

経験者
開発者

特定プロファイルのサービス購読の削除 deleting-service-subscription

これは、3 つの手順で構成される手順です。

目的のプロファイルの購読 URL を取得します。
購読 URL でGETリクエストを実行します。
目的のサービス URL でDELETEリクエストを実行します。

削除リクエストが成功した場合、応答ステータスは 204 コンテンツなしになります。

リクエストのサンプル

以下のサンプルペイロードは、プロファイルをサービスから購読解除する方法を示しています。まず、GETリクエストを実行してプロファイルを取得します。

-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/profile/<PKEY> \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

プロファイルの購読 URL を返します。

  {
    ...
    "postalAddress":...,
    "preferredLanguage": "none",
    "subscriptions": {
      "href": "https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/profile/<PKEY>/subscriptions/"
    },
  }

購読 URL でGETリクエストを実行します。

-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/profile/<PKEY>/subscriptions \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

選択したプロファイルの購読のリストと、購読している各サービスの URL が返されます。

...
"service": {
  "PKey": "<PKEY>",
  "href": "https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/service/<PKEY>",
  "label": "Sport Newsletter",
  "name": "SVC1",
  "title": "Sport Newsletter (SVC1)"
},
...

目的のサービス URL でDELETEリクエストを実行します。

-X DELETE https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/service/<PKEY> \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

特定プロファイルのサービス購読の削除

これは、3 つの手順で構成される手順です。

目的のサービスとその購読 URL を取得します。
購読 URL でGETリクエストを実行して、すべてのプロファイル購読を取得します。
目的のプロファイル購読 URL でDELETEリクエストを実行します。

削除リクエストが成功した場合、応答ステータスは 204 コンテンツなしになります。

リクエストのサンプル

サービスレコードを取得します。

-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/service/<PKEY> \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

これは、サービスの購読 URL を返します。

{
  ...
  "messageType": "email",
  "mode": "newsletter",
  "name": "SVC3",
  "subScenarioEventType": "subscriptionEvent",
  "subscriptions": {
    "href": "https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/service/<PKEY>/subscriptions/"
  },
  "targetResource": "profile",
  ...
},

購読 URL でGETリクエストを実行します。

-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/service/<PKEY>/subscriptions \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

選択したサービスの購読のリストと、各プロファイル購読の URL （href）が返されます。

{
  "PKey": "<PKEY>",
  "created": "2019-03-26 08:58:04.764Z",
  "email": "",
  "expirationDate": "",
  "href": "https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/service/<PKEY>/subscriptions/<PKEY>",
  "metadata": "subscriptionRcp",
  "service": ...,
  "serviceName": "SVC3",
  "subscriber": ...,
  ...
}

目的のプロファイル購読 URL でDELETEリクエストを実行します。

-X DELETE https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/service/<PKEY>/subscriptions/<PKEY> \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

recommendation-more-help

3ef63344-7f3d-48f9-85ed-02bf569c4fff