探索营销自动化系统，使用 Flow Service API

Last update: Thu May 25 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

开发人员

Flow Service 用于从Adobe Experience Platform中各种不同的来源收集客户数据并对其进行集中。该服务提供了一个用户界面和RESTful API，所有受支持的源均可从此API进行连接。

本教程使用 Flow Service 用于探索营销自动化系统的API。

快速入门

本指南要求您对Adobe Experience Platform的以下组件有一定的了解：

源： Experience Platform 允许从各种源摄取数据，同时让您能够使用以下方式构建、标记和增强传入数据： Platform 服务。
沙盒： Experience Platform 提供对单个进行分区的虚拟沙盒 Platform 将实例安装到单独的虚拟环境中，以帮助开发和改进数字体验应用程序。

以下部分提供在使用以下工具成功连接到营销自动化系统时需要了解的其他信息 Flow Service API。

收集所需的凭据

本教程要求您与希望从中摄取数据的第三方营销自动化应用程序建立有效连接。有效的连接涉及应用程序的连接规范ID和连接ID。有关创建营销自动化连接和检索这些值的更多信息，请参阅将营销自动化源连接到Platform 教程。

正在读取示例API调用

本教程提供了示例API调用来演示如何设置请求的格式。这些资源包括路径、必需的标头和格式正确的请求负载。此外，还提供了在API响应中返回的示例JSON。有关示例API调用文档中使用的约定的信息，请参阅以下章节：如何读取示例API调用在 Experience Platform 疑难解答指南。

收集所需标题的值

为了调用 Platform API，您必须先完成身份验证教程. 完成身份验证教程将提供所有中所有所需标头的值 Experience Platform API调用，如下所示：

授权：持有者 {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}

中的所有资源 Experience Platform，包括属于 Flow Service，与特定的虚拟沙盒隔离。的所有请求 Platform API需要一个标头，用于指定将在其中执行操作的沙盒的名称：

x-sandbox-name: {SANDBOX_NAME}

包含有效负载(POST、PUT、PATCH)的所有请求都需要额外的媒体类型标头：

Content-Type: application/json

浏览您的数据表

使用营销自动化系统的基本连接，您可以通过执行GET请求来浏览数据表。使用以下调用查找要检查或摄取的表的路径 Platform.

API格式

GET /connections/{BASE_CONNECTION_ID}/explore?objectType=root

参数

描述

{BASE_CONNECTION_ID}

营销自动化系统的基本连接的ID。

请求

curl -X GET \
    'http://platform.adobe.io/data/foundation/flowservice/connections/2fce94c1-9a93-4971-8e94-c19a93097129/explore?objectType=root' \
    -H 'Authorization: Bearer {ACCESS_TOKEN}' \
    -H 'x-api-key: {API_KEY}' \
    -H 'x-gw-ims-org-id: {ORG_ID}' \
    -H 'x-sandbox-name: {SANDBOX_NAME}'

响应

成功响应是指从到营销自动化系统的大量表。查找您要引入的表 Platform 并注意其 path 属性，因为您需要在下一步中提供它以检查其结构。

[
    {
        "type": "table",
        "name": "Hubspot.All_Deals",
        "path": "Hubspot.All_Deals",
        "canPreview": true,
        "canFetchSchema": true
    },
    {
        "type": "table",
        "name": "Hubspot.Blog_Authors",
        "path": "Hubspot.Blog_Authors",
        "canPreview": true,
        "canFetchSchema": true
    },
    {
        "type": "table",
        "name": "Hubspot.Blog_Comments",
        "path": "Hubspot.Blog_Comments",
        "canPreview": true,
        "canFetchSchema": true
    },
    {
        "type": "table",
        "name": "Hubspot.Contacts",
        "path": "Hubspot.Contacts",
        "canPreview": true,
        "canFetchSchema": true
    },
]

Inspect表的结构

要从营销自动化系统检查表的结构，请在将表的路径指定为查询参数时执行GET请求。

API格式

GET /connections/{BASE_CONNECTION_ID}/explore?objectType=table&object={TABLE_PATH}

参数

描述

{BASE_CONNECTION_ID}

营销自动化系统的连接ID。

{TABLE_PATH}

营销自动化系统中表的路径。

请求

curl -X GET \
    'http://platform.adobe.io/data/foundation/flowservice/connections/2fce94c1-9a93-4971-8e94-c19a93097129/explore?objectType=table&object=Hubspot.Contacts' \
    -H 'Authorization: Bearer {ACCESS_TOKEN}' \
    -H 'x-api-key: {API_KEY}' \
    -H 'x-gw-ims-org-id: {ORG_ID}' \
    -H 'x-sandbox-name: {SANDBOX_NAME}'

响应

成功的响应将返回表的结构。有关每个表列的详细信息位于 columns 数组。

{
    "format": "flat",
    "schema": {
        "columns": [
            {
                "name": "Properties_Firstname_Value",
                "type": "string",
                "xdm": {
                    "type": "string"
                }
            },
            {
                "name": "Properties_Lastname_Value",
                "type": "string",
                "xdm": {
                    "type": "string"
                }
            },
            {
                "name": "Added_At",
                "type": "string",
                "meta:xdmType": "date-time",
                "xdm": {
                    "type": "string",
                    "format": "date-time"
                }
            },
            {
                "name": "Portal_Id",
                "type": "string",
                "xdm": {
                    "type": "string"
                }
            },
        ]
    }
}

后续步骤

通过学习本教程，您已探索营销自动化系统，找到要引入的表的路径 Platform，并获得了有关其结构的信息。您可以在下一教程中使用此信息来从营销自动化系统收集数据并将其引入平台.

recommendation-more-help

337b99bb-92fb-42ae-b6b7-c7042161d089