Create a dataflow for MailChimp Campaign using the Flow Service API

以下教程將逐步引導您建立源連接和資料流,以使用Flow Service API將MailChimp Campaign資料帶入Platform。

先決條件

您必須先為MailChimp.擷取存取權杖,才能使用OAuth 2重新整理程式碼將MailChimp連線至Adobe Experience Platform。請參閱MailChimp OAuth 2指南以取得尋找存取權杖的詳細指示。

建立基本連接

檢索到MailChimp身份驗證憑據後,您現在可以開始建立資料流以將MailChimp Campaign資料帶到Platform的過程。 建立資料流的第一步是建立基本連接。

基本連接在源和平台之間保留資訊,包括源的驗證憑據、連接的當前狀態和唯一基本連接ID。 基本連線ID可讓您從來源探索和導覽檔案,並識別您要擷取的特定項目,包括其資料類型和格式的相關資訊。

MailChimp 支援基本驗證和OAuth 2重新整理程式碼。如需如何使用任一驗證類型進行驗證的指引,請參閱下列範例。

使用基本身份驗證建立MailChimp基本連接

要使用基本身份驗證建立MailChimp基本連接,請在提供hostauthorizationTestUrlusernamepassword的憑據的同時向Flow Service API的/connections端點發出POST請求。

API格式

POST /connections

要求

以下請求為MailChimp建立基本連接:

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'
  -d '{
      "name": "MailChimp base connection with basic authentication",
      "description": "MailChimp Campaign base connection with basic authentication",
      "connectionSpec": {
          "id": "c8ce8c8c-37fb-4162-9fbf-c2f181e04a7a",
          "version": "1.0"
      },
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "host": "{HOST}",
              "authorizationTestUrl": "https://login.mailchimp.com/oauth2/metadata",
              "username": "{USERNAME}",
              "password": "{PASSWORD}"
          }
      }
  }'
屬性 說明
name 基本連接的名稱。 請確定基本連線的名稱是描述性的,因為您可以使用此名稱來查詢基本連線的資訊。
description (選用)您可以包含的屬性,以提供有關基本連線的詳細資訊。
connectionSpec.id 源的連接規範ID。 透過Flow Service API註冊並核准您的來源後,即可擷取此ID。
auth.specName 用於將源連接到平台的驗證類型。
auth.params.host 用來連線至MailChimp API的根URL。 根URL的格式為https://{DC}.api.mailchimp.com,其中{DC}代表與您的帳戶對應的資料中心。
auth.params.authorizationTestUrl (可選)建立基本連線時,授權測試URL用於驗證憑證。 如果未提供,則在建立源連接步驟期間將自動檢查憑據。
auth.params.username 與您的MailChimp帳戶對應的使用者名稱。 這是基本驗證的必要條件。
auth.params.password 與您的MailChimp帳戶對應的密碼。 這是基本驗證的必要條件。

回應

成功的響應返回新建的基本連接,包括其唯一連接標識符(id)。 在下一步中,瀏覽源的檔案結構和內容時需要此ID。

{
    "id": "9601747c-6874-4c02-bb00-5732a8c43086",
    "etag": "\"3702dabc-0000-0200-0000-615b5b5a0000\""
}

Create a MailChimp base connection using OAuth 2 refresh code

若要使用OAuth 2重新整理程式碼建立MailChimp基本連線,請在提供hostauthorizationTestUrlaccessToken的認證時,向/connections端點提出POST要求。

API格式

POST /connections

要求

The following request creates a base connection for MailChimp :

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'
  -d '{
      "name": "MailChimp base connection with OAuth 2 refresh code",
      "description": "MailChimp Campaign base connection with OAuth 2 refresh code",
      "connectionSpec": {
          "id": "c8ce8c8c-37fb-4162-9fbf-c2f181e04a7a",
          "version": "1.0"
      },
      "auth": {
          "specName": "oAuth2RefreshCode",
          "params": {
              "host": "{HOST}",
              "authorizationTestUrl": "https://login.mailchimp.com/oauth2/metadata",
              "accessToken": "{ACCESS_TOKEN}"
          }
      }
  }'
屬性 說明
name 基本連接的名稱。 請確定基本連線的名稱是描述性的,因為您可以使用此名稱來查詢基本連線的資訊。
description (選用)您可以包含的屬性,以提供有關基本連線的詳細資訊。
connectionSpec.id 源的連接規範ID。 使用Flow Service API註冊您的源後,可以檢索此ID。
auth.specName 用於向平台驗證源的驗證類型。
auth.params.host 用來連線至MailChimp API的根URL。 根URL的格式為https://{DC}.api.mailchimp.com,其中{DC}代表與您的帳戶對應的資料中心。
auth.params.authorizationTestUrl (可選)建立基本連線時,授權測試URL用於驗證憑證。 如果未提供,則在建立源連接步驟期間將自動檢查憑據。
auth.params.accessToken 用於驗證源的相應訪問令牌。 這是OAuth型驗證的必要項目。

回應

成功的響應返回新建的基本連接,包括其唯一連接標識符(id)。 在下一步中,瀏覽源的檔案結構和內容時需要此ID。

{
    "id": "9601747c-6874-4c02-bb00-5732a8c43086",
    "etag": "\"3702dabc-0000-0200-0000-615b5b5a0000\""
}

探索源

使用在上一步中生成的基本連接ID,可以通過執行GET請求來瀏覽檔案和目錄。 執行GET請求以探索源的檔案結構和內容時,必須包括下表中列出的查詢參數:

參數 說明
{BASE_CONNECTION_ID} 上一步驟中產生的基本連線ID。
{OBJECT_TYPE} 要瀏覽的對象的類型。 For REST sources, this value defaults to rest.
{OBJECT} 您要探索的物件。
{FILE_TYPE} 只有在查看特定目錄時,才需要此參數。 其值表示要瀏覽的目錄的路徑。
{PREVIEW} 一個布林值,定義連接的內容是否支援預覽。
{SOURCE_PARAMS} campaign_id的base64編碼字串。
秘訣

若要擷取{SOURCE_PARAMS}接受的格式類型,您必須以base64對整個campaignId字串進行編碼。 例如,以base64編碼的{"campaignId": "c66a200cda"}等於eyJjYW1wYWlnbklkIjoiYzY2YTIwMGNkYSJ9

API format

GET /connections/{BASE_CONNECTION_ID}/explore?objectType=rest&objectType={OBJECT_TYPE}&fileType={FILE_TYPE}&preview={PREVIEW}&sourceParams={SOURCE_PARAMS}

要求

curl -X GET \
  'https://platform.adobe.io/data/foundation/flowservice/connections/05c595e5-edc3-45c8-90bb-fcf556b57c4b/explore?objectType=rest&object=json&fileType=json&preview=true&sourceParams=eyJjYW1wYWlnbklkIjoiYzY2YTIwMGNkYSJ9' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

回應

成功的回應會傳回查詢的檔案結構。

{
    "data": [
        {
            "emails": [
                {
                    "campaign_id": "c66a200cda",
                    "list_id": "10c097ca71",
                    "list_is_active": true,
                    "email_id": "cff65fb4c5f5828666ad846443720efd",
                    "email_address": "kendall2134@gmail.com",
                    "_links": [
                        {
                            "rel": "parent",
                            "href": "https://us6.api.mailchimp.com/3.0/reports/c66a200cda/email-activity",
                            "method": "GET",
                            "targetSchema": "https://us6.api.mailchimp.com/schema/3.0/Definitions/Reports/EmailActivity/CollectionResponse.json"
                        },
                        {
                            "rel": "self",
                            "href": "https://us6.api.mailchimp.com/3.0/reports/c66a200cda/email-activity/cff65fb4c5f5828666ad846443720efd",
                            "method": "GET",
                            "targetSchema": "https://us6.api.mailchimp.com/schema/3.0/Definitions/Reports/EmailActivity/Response.json"
                        },
                        {
                            "rel": "member",
                            "href": "https://us6.api.mailchimp.com/3.0/lists/10c097ca71/members/cff65fb4c5f5828666ad846443720efd",
                            "method": "GET",
                            "targetSchema": "https://us6.api.mailchimp.com/schema/3.0/Definitions/Lists/Members/Response.json"
                        }
                    ]
                },
                {
                    "campaign_id": "c66a200cda",
                    "list_id": "10c097ca71",
                    "list_is_active": true,
                    "email_id": "a16b82774b211afaf60902d1afd8abc5",
                    "email_address": "logan9935890967@gmail.com",
                    "_links": [
                        {
                            "rel": "parent",
                            "href": "https://us6.api.mailchimp.com/3.0/reports/c66a200cda/email-activity",
                            "method": "GET",
                            "targetSchema": "https://us6.api.mailchimp.com/schema/3.0/Definitions/Reports/EmailActivity/CollectionResponse.json"
                        },
                        {
                            "rel": "self",
                            "href": "https://us6.api.mailchimp.com/3.0/reports/c66a200cda/email-activity/a16b82774b211afaf60902d1afd8abc5",
                            "method": "GET",
                            "targetSchema": "https://us6.api.mailchimp.com/schema/3.0/Definitions/Reports/EmailActivity/Response.json"
                        },
                        {
                            "rel": "member",
                            "href": "https://us6.api.mailchimp.com/3.0/lists/10c097ca71/members/a16b82774b211afaf60902d1afd8abc5",
                            "method": "GET",
                            "targetSchema": "https://us6.api.mailchimp.com/schema/3.0/Definitions/Lists/Members/Response.json"
                        }
                    ]
                },
            ]
        }
    ]    
}

建立源連接

您可以向Flow Service API發出POST請求,以建立來源連線。 源連接由連接ID、源資料檔案的路徑和連接規範ID組成。

要建立源連接,您還必須為資料格式屬性定義枚舉值。

為檔案型來源使用下列列舉值:

資料格式 列舉值
分隔 delimited
JSON json
鑲木 parquet

對於所有基於表的源,將值設定為tabular

API格式

POST /sourceConnections

要求

以下請求為MailChimp建立源連接:

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/sourceConnections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'
  -d '{
      "name": "MailChimp source connection to ingest campaign ID",
      "description": "MailChimp Campaign source connection to ingest campaign ID",
      "baseConnectionId": "4cea039f-f1cc-4fa5-9136-db8dd4c7fbfa",
      "connectionSpec": {
          "id": "c8ce8c8c-37fb-4162-9fbf-c2f181e04a7a",
          "version": "1.0"
      },
      "data": {
          "format": "json"
      },
      "params": {
          "campaignId": "c66a200cda"
      }
  }'
屬性 說明
name 源連接的名稱。 請確保源連接的名稱是描述性的,因為您可以使用此名稱查找有關源連接的資訊。
description 可包含的選用值,用於提供來源連線的詳細資訊。
baseConnectionId 基本連接ID MailChimp。 此ID是在先前的步驟中產生。
connectionSpec.id 與源對應的連接規範ID。
data.format 您要擷取的MailChimp資料格式。
params.campaignId The MailChimp campaign ID identifies a specific MailChimp campaign, which then allows you to send emails to your lists/audiences.

回應

成功的響應返回新建源連接的唯一標識符(id)。 在後續步驟中需要此ID才能建立資料流。

{
    "id": "d6557bf1-7347-415f-964c-9316bd4cbf56",
    "etag": "\"e205c206-0000-0200-0000-615b5c070000\""
}

建立目標XDM結構

為了在Platform中使用來源資料,必須建立目標架構,以根據您的需求來建構來源資料。 然後,目標架構會用來建立包含來源資料的Platform資料集。

通過對Schema Registry API執行POST請求,可以建立目標XDM架構。

如需如何建立目標XDM架構的詳細步驟,請參閱有關使用API🔗建立架構的教學課程。

建立目標資料集

目標資料集的建立方式,是對目錄服務API執行POST請求,提供裝載內目標架構的ID。

如需如何建立目標資料集的詳細步驟,請參閱有關使用API🔗建立資料集的教學課程。

建立目標連線

目標連線代表所擷取資料所登陸之目的地的連線。 要建立目標連接,必須提供與Data Lake對應的固定連接規範ID。 此ID為:c604ff05-7f1a-43c0-8e18-33bf874cb11c

目標架構中的目標資料集和Data Lake的連接規範ID現在具有唯一標識符。 使用這些識別碼,您可以使用Flow Service API建立目標連線,以指定將包含傳入來源資料的資料集。

API格式

POST /targetConnections

要求

以下請求為MailChimp建立目標連接:

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/targetConnections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'
  -d '{
      "name": "MailChimp target connection",
      "description": "MailChimp Campaign target connection",
      "connectionSpec": {
          "id": "c604ff05-7f1a-43c0-8e18-33bf874cb11c",
          "version": "1.0"
      },
      "data": {
          "format": "parquet_xdm",
          "schema": {
              "id": "https://ns.adobe.com/{TENANT_ID}/schemas/570630b91eb9d5cf5db0436756abb110d02912917a67da2d",
              "version": "application/vnd.adobe.xed-full+json;version=1"
          }
      },
      "params": {
          "dataSetId": "6155e3a9bd13651949515f14"
      }
  }'
屬性 說明
name 目標連接的名稱。 請確定目標連線的名稱是描述性的,因為您可以使用此名稱來查詢目標連線的資訊。
description 可包含的選用值,用於提供目標連線的詳細資訊。
connectionSpec.id 與Data Lake對應的連接規範ID。 此固定ID為:c604ff05-7f1a-43c0-8e18-33bf874cb11c
data.format 要帶入Platform的MailChimp資料格式。
params.dataSetId 上一步驟中擷取的目標資料集ID。

回應

成功的響應返回新目標連接的唯一標識符(id)。 This ID is required in later steps.

{
    "id": "9463fe9c-027d-4347-a423-894fcd105647",
    "etag": "\"b902e822-0000-0200-0000-615b5c370000\""
}
重要

MailChimp Campaign目前不支援資料準備函式。

建立流程

將MailChimp資料帶入Platform的最後一步是建立資料流。 您現在已準備下列必要值:

資料流負責從源中調度和收集資料。 您可以在裝載中提供先前提及的值時,執行POST要求來建立資料流。

To schedule an ingestion, you must first set the start time value to epoch time in seconds. 然後,您必須將頻率值設定為以下五個選項之一:onceminutehourdayweek。 間隔值指定兩個連續擷取和建立一次性擷取(once)之間的期間,不需要設定間隔。 對於所有其他頻率,間隔值必須設定為等於或大於15

API格式

POST /flows

要求

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/flows' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'
  -d '{
      "name": "MailChimp Campaign dataflow",
      "description": "MailChimp Campaign dataflow",
      "flowSpec": {
          "id": "6499120c-0b15-42dc-936e-847ea3c24d72",
          "version": "1.0"
      },
      "sourceConnectionIds": [
          "d6557bf1-7347-415f-964c-9316bd4cbf56"
      ],
      "targetConnectionIds": [
          "9463fe9c-027d-4347-a423-894fcd105647"
      ],
      "scheduleParams": {
          "startTime": "1632809759",
          "frequency": "minute",
          "interval": 15
      }
  }'
屬性 說明
name 資料流的名稱。 請確保資料流的名稱具有描述性,因為您可以使用此名稱查找資料流的資訊。
description (可選)可以包括的屬性,用於提供有關資料流的更多資訊。
flowSpec.id 建立資料流所需的流規範ID。 此固定ID為:6499120c-0b15-42dc-936e-847ea3c24d72
flowSpec.version 流規範ID的相應版本。 此值預設為1.0
sourceConnectionIds 先前步驟中產生的源連接ID
targetConnectionIds 先前步驟中產生的目標連線ID
scheduleParams.startTime 資料首次擷取開始時的指定開始時間。
scheduleParams.frequency The frequency at which the dataflow will collect data. 可接受的值包括:onceminutehourdayweek
scheduleParams.interval 該間隔指定兩個連續流運行之間的週期。 間隔的值應為非零整數。 當頻率設定為once且對於其他頻率值應大於或等於15時,不需要間隔。

回應

成功的響應返回新建立的資料流的ID(id)。 您可以使用此ID監視、更新或刪除資料流。

{
    "id": "be2d5249-eeaf-4a74-bdbd-b7bf62f7b2da",
    "etag": "\"7e010621-0000-0200-0000-615b5c9b0000\""
}

監視資料流

建立資料流後,您可以監視正在通過資料流進行內嵌的資料,以查看有關流運行、完成狀態和錯誤的資訊。

API格式

GET /runs?property=flowId=={FLOW_ID}

要求

以下請求將檢索現有資料流的規範。

curl -X GET \
  'https://platform.adobe.io/data/foundation/flowservice/runs?property=flowId==993f908f-3342-4d9c-9f3c-5aa9a189ca1a' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

回應

成功的回應會傳回關於流程執行的詳細資訊,包括關於其建立日期、來源和目標連線的資訊,以及流程執行的唯一識別碼(id)。

{
    "items": [
        {
            "id": "209812ad-7bef-430c-b5b2-a648aae72094",
            "createdAt": 1633044829955,
            "updatedAt": 1633044838006,
            "createdBy": "{CREATED_BY}",
            "updatedBy": "{UPDATED_BY}",
            "createdClient": "{CREATED_CLIENT}",
            "updatedClient": "{UPDATED_CLIENT}",
            "sandboxId": "{SANDBOX_ID}",
            "sandboxName": "{SANDBOX_NAME}",
            "imsOrgId": "{IMS_ORG}",
            "name": "MailChimp Campaign dataflow",
            "description": "MailChimp Campaign dataflow",
            "flowSpec": {
                "id": "6499120c-0b15-42dc-936e-847ea3c24d72",
                "version": "1.0"
            },
            "state": "enabled",
            "version": "\"7e01322c-0000-0200-0000-615b5d520000\"",
            "etag": "\"7e01322c-0000-0200-0000-615b5d520000\"",
            "sourceConnectionIds": [
                "d6557bf1-7347-415f-964c-9316bd4cbf56"
            ],
            "targetConnectionIds": [
                "9463fe9c-027d-4347-a423-894fcd105647"
            ],
            "inheritedAttributes": {
                "sourceConnections": [
                    {
                        "id": "d6557bf1-7347-415f-964c-9316bd4cbf56",
                        "connectionSpec": {
                            "id": "c8ce8c8c-37fb-4162-9fbf-c2f181e04a7a",
                            "version": "1.0"
                        },
                        "baseConnection": {
                            "id": "9601747c-6874-4c02-bb00-5732a8c43086",
                            "connectionSpec": {
                                "id": "c8ce8c8c-37fb-4162-9fbf-c2f181e04a7a",
                                "version": "1.0"
                            }
                        }
                    }
                ],
                "targetConnections": [
                    {
                        "id": "9463fe9c-027d-4347-a423-894fcd105647",
                        "connectionSpec": {
                            "id": "c604ff05-7f1a-43c0-8e18-33bf874cb11c",
                            "version": "1.0"
                        }
                    }
                ]
            },
            "scheduleParams": {
                "startTime": "1633377385",
                "frequency": "minute",
                "interval": 15
            },
            "runs": "/flows/be2d5249-eeaf-4a74-bdbd-b7bf62f7b2da/runs",
            "lastOperation": {
                "started": 1633377421476,
                "updated": 0,
                "operation": "create"
            },
            "lastRunDetails": {
                "id": "84f95788-3e83-4ce0-8e45-c0a89117c6f1",
                "state": "failed",
                "startedAtUTC": 1633377445979,
                "completedAtUTC": 1633377487082
            }
        }
    ]
}
屬性 說明
items 包含與您特定流程執行相關聯的中繼資料的單一裝載。
id 顯示與資料流對應的ID。
state 顯示資料流的當前狀態。
inheritedAttributes 包含定義流的屬性,例如其對應基礎、來源和目標連線的ID。
scheduleParams 包含資料流的獲取調度的資訊,如其開始時間(以紀元時間)、頻率和間隔。
transformations 包含有關應用於資料流的轉換屬性的資訊。
runs 顯示流程的對應執行ID。 您可以使用此ID來監控特定的流程執行。

更新資料流

要更新資料流的運行計畫、名稱和說明,請對Flow Service API執行PATCH請求,同時提供您的流ID、版本和要使用的新計畫。

重要

提出PATCH請求時需要If-Match標題。 此標題的值是您要更新的連線的唯一版本。

API格式

PATCH /flows/{FLOW_ID}

要求

以下請求會更新流程運行計畫以及資料流的名稱和說明。

curl -X PATCH \
  'https://platform.adobe.io/data/foundation/flowservice/flows/209812ad-7bef-430c-b5b2-a648aae72094' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'
  -H 'If-Match: "2e01f11d-0000-0200-0000-615649660000"' \
  -d '[
          {
              "op": "replace",
              "path": "/scheduleParams/frequency",
              "value": "day"
          },
          {
              "op": "replace",
              "path": "/name",
              "value": "MailChimp Campaign Dataflow 2.0"
          },
          {
              "op": "replace",
              "path": "/description",
              "value": "MailChimp Campaign Dataflow Updated"
          }
      ]'
參數 說明
op 用於定義更新資料流所需操作的操作調用。 操作包括:addreplaceremove
path 要更新的參數的路徑。
value 您要用更新參數的新值。

回應

A successful response returns your flow ID and an updated etag. 您可以在提供流程ID時,向Flow Service API提出GET要求,以驗證更新。

{
    "id": "209812ad-7bef-430c-b5b2-a648aae72094",
    "etag": "\"50014cc8-0000-0200-0000-6036eb720000\""
}

Delete your dataflow

With an existing flow ID, you can delete a dataflow by performing a DELETE request to the Flow Service API.

API format

DELETE /flows/{FLOW_ID}
參數 說明
{FLOW_ID} 要刪除的資料流的唯一id值。

要求

curl -X DELETE \
  'https://platform.adobe.io/data/foundation/flowservice/flows/209812ad-7bef-430c-b5b2-a648aae72094' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

回應

A successful response returns HTTP status 204 (No Content) and a blank body. 您可以嘗試對資料流執行查閱(GET)請求以確認刪除。 API會傳回HTTP 404(找不到)錯誤,指出資料流已刪除。

更新您的連線

要更新連接的名稱、說明和憑據,請對Flow Service API執行PATCH請求,同時提供您的基本連接ID、版本和要使用的新資訊。

重要

提出PATCH請求時需要If-Match標題。 此標題的值是您要更新的連線的唯一版本。

API格式

PATCH /connections/{BASE_CONNECTION_ID}
參數 說明
{BASE_CONNECTION_ID} 要更新的連接的唯一id值。

要求

以下請求會提供新名稱和說明,以及一組新的憑證,以更新您的連線。

curl -X PATCH \
  'https://platform.adobe.io/data/foundation/flowservice/connections/4cea039f-f1cc-4fa5-9136-db8dd4c7fbfa' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'
  -H 'If-Match: 4000cff7-0000-0200-0000-6154bad60000' \
  -d '[
      {
          "op": "replace",
          "path": "/auth/params",
          "value": {
              "username": "mailchimp-member-activity-user",
              "password": "{NEW_PASSWORD}"
          }
      },
      {
          "op": "replace",
          "path": "/name",
          "value": "MailChimp Campaign Connection 2.0"
      },
      {
          "op": "add",
          "path": "/description",
          "value": "Updated MailChimp Campaign Connection"
      }
  ]'
參數 說明
op 用來定義更新連線所需動作的操作呼叫。 操作包括:addreplaceremove
path 要更新的參數的路徑。
value 您要用更新參數的新值。

回應

成功的回應會傳回基本連線ID和更新的etag。 您可以在提供連線ID時,向Flow Service API提出GET要求,以驗證更新。

{
    "id": "4cea039f-f1cc-4fa5-9136-db8dd4c7fbfa",
    "etag": "\"3600e378-0000-0200-0000-5f40212f0000\""
}

刪除您的連線

擁有現有基本連線ID後,請對Flow Service API執行DELETE請求。

API格式

DELETE /connections/{CONNECTION_ID}
參數 說明
{BASE_CONNECTION_ID} 要刪除的基本連接的唯一id值。

要求

curl -X DELETE \
  'https://platform.adobe.io/data/foundation/flowservice/connections/4cea039f-f1cc-4fa5-9136-db8dd4c7fbfa' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

回應

成功的回應會傳回HTTP狀態204(無內容)和空白內文。

您可以嘗試對連線進行查詢(GET)以確認刪除。

本頁內容