Salesforce Marketing Cloud

示例 - 列出所有资源

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 Assets。
3. 选择 List 操作，然后点击完成。
4. 连接器任务的任务输入部分中，您可以根据客户要求设置 filterClause。

您必须使用单引号 (') 将过滤条件子句的值括起来，并且必须直接传递该值，例如 CategoryName='Content Builder'。其中，CategoryName 是列名称，Content Builder 是值。

您可以使用过滤条件子句根据列过滤记录。例如，如需过滤记录，请使用以下过滤条件子句：Location='US' 和 region='us-east1'

在某些情况下，传递实体 ID 可能会引发错误。 在这种情况下，您可以使用过滤条件子句，例如 id=172。

示例 - 获取资产记录

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 Assets。
3. 选择 Get 操作，然后点击完成。
4. 将实体 ID 设置为 49851.0，即要传递的键。如需设置实体 ID，请在连接器任务的任务输入部分，点击 EntityId，然后在默认值字段中输入 49851.0。

   实体 ID 的值应直接传递，例如 Id= 49851.0。在此示例中，49851.0 是唯一的主键值，应传递该值。

示例 - 删除资产记录

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 Assets。
3. 选择 Delete 操作，然后点击完成。
4. 将实体 ID 设置为 49851.0，即要传递的键。如需设置实体 ID，请在连接器任务的任务输入部分，点击 EntityId，然后在默认值字段中输入 49851.0。

   实体 ID 的值应直接传递，例如 ID= 49851.0。在此示例中，49851.0 是唯一的主键值，应传递该值。

示例 - 创建 DataExtensionObject_Custom 记录

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 DataExtensionObject_Custom。
3. 选择 Create 操作，然后点击完成。
4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
   "StudentName":"Cruz",
   "StudentID":"1",
   "Rank":"1"}
   

   如果集成成功，连接器任务的 connectorOutputPayload 响应形参将具有类似以下的值：

   {
     "StudentID": 1
   } 

示例 - 创建资产记录

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 Assets。
3. 选择 Create 操作，然后点击完成。
4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "Name": "Googlecloud_Created_HTMLEmail_Testing_V1",
     "TypeName": "htmlemail",
     "TypeId": 208.0
   }

   如果集成成功，连接器任务的 connectorOutputPayload 响应形参将具有类似以下的值：

   {
     "Id": 60188.0
   }

示例 - 创建广告系列记录

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 Campaigns。
3. 选择 Create 操作，然后点击完成。
4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "Name": "Campaigns - Tested via Googlecloud",
     "CampaignCode": "annual2023",
     "Color": "0000ff",
     "Favorite": false
   }

   如果集成成功，连接器任务的 connectorOutputPayload 响应形参将具有类似以下的值：

   {
     "Id": 247.0
   } 

示例 - 创建“转化历程”记录

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 Journeys。
3. 选择 Create 操作，然后点击完成。
4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "Version": 1.0,
     "Name": "API_Journey_Googlecloud_Retest_1",
     "CreatedDate": "2023-04-26 04:20:29.87",
     "ModifiedDate": "2023-05-10 07:45:06.04",
     "LastPublishedDate": "2023-04-26 04:37:18.0",
     "Description": "API_Journey_Googlecloud_Retest_1",
     "WorkFlowApiVersion": 1.0,
     "Tags": null,
     "Goals": "",
     "Triggers": "[{\"id\": \"c79154a3-a0d2-435e-a6ad-bed46474620a\", \"key\": \"TRIGGER\", \"name\": \"API_Journey_Googlecloud\", \"description\": \"\", \"type\": \"APIEvent\", \"outcomes\": [], \"arguments\": {\"startActivityKey\": \"{Context.StartActivityKey}\", \"dequeueReason\": \"{Context.DequeueReason}\", \"lastExecutedActivityKey\": \"{Context.LastExecutedActivityKey}\", \"filterResult\": \"true\"}, \"configurationArguments\": {\"schemaVersionId\": 0, \"criteria\": \"\", \"filterDefinitionId\": \"00000000-0000-0000-0000-000000000000\"}, \"metaData\": {\"sourceInteractionId\": \"00000000-0000-0000-0000-000000000000\", \"eventDefinitionId\": \"8153cf00-ebf6-4c18-b52f-573eb724df87\", \"eventDefinitionKey\": \"APIEvent-4d84e619-a629-6b17-945f-9a6e78a1982c\", \"chainType\": \"None\", \"configurationRequired\": false, \"iconUrl\": \"/images/icon_journeyBuilder-event-api-blue.svg\", \"title\": \"\", \"entrySourceGroupConfigUrl\": \"jb:///data/entry/api-event/entrysourcegroupconfig.json\"}}",
     "Defaults": "[{\"email\": [\"{Event.APIEvent-4d84e619-a629-6b17-945f-9a6e78a1982c.\"Email"}\"], \"properties\": {\"analyticsTracking\": {\"enabled\": false, \"analyticsType\": \"google\", \"urlDomainsToTrack\": []}}}]"
   }

   如果集成成功，连接器任务的 connectorOutputPayload 响应形参将具有类似以下的值：

   {
     "Id": "aa03afe4-6a28-481f-bec4-564712127414"
   }

示例 - 创建列表记录

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 List。
3. 选择 Create 操作，然后点击完成。
4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "ID": "04052023.0",
     "ObjectID": "82349658-b482-404f-8c67-e555aadee0f4",
     "PartnerKey": "null",
     "CreatedDate": "2023-03-16 10:52:48.097",
     "ModifiedDate": "2023-03-17 10:30:34.497",
     "Client_ID": "5.14012689E8",
     "Client_PartnerClientKey": null,
     "ListName": "Googlecloud_Created_Subscriber_List",
     "Description": "null",
     "Category": "15449.0",
     "Type": "Public",
     "CustomerKey": "Googlecloud_BCONE",
     "ListClassification": "ExactTargetList",
     "AutomatedEmail_ID": "null"
   }

   如果集成成功，连接器任务的 connectorOutputPayload 响应形参将具有类似以下的值：

   {
     "Id": 4052023.0
   }

示例 - 创建订阅者记录

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 Subscriber。
3. 选择 Create 操作，然后点击完成。
4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "EmailAddress": "baklavainthebalkans@gmail.com",
     "SubscriberKey": "KB1"
   }

   如果集成成功，连接器任务的 connectorOutputPayload 响应形参将具有类似以下的值：

   {
     "Success": true
   }

示例 - 更新 DataExtensionObject_Custom 记录

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 DataExtensionObject_Custom。
3. 选择 Update 操作，然后点击完成。
4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
   "StudentName":"Charlie",
   "Rank":"1"
   }
   

5. 将实体 ID 设置为要传递的主键，例如：103032。如需设置实体 ID，请在连接器任务的任务输入部分，点击 entityId，然后在默认值字段中输入 10。

   如果实体具有复合业务键或主键，您也可以将 filterClause 设置为 Rank='1' and StudentID='10'，而不是指定 entityId。

如果集成成功，连接器任务的 connectorOutputPayload 响应形参将具有类似以下的值：

{
    "StudentID": 1
}

示例 - 更新资产记录

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择“素材资源”。
3. 选择 Update 操作，然后点击完成。
4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "Description": "June2023-Updated"
   }
   

5. 将实体 ID 设置为资产的实体。如需设置实体 ID，请点击 entityId，然后在默认值字段中输入 52080。

   如果集成成功，连接器任务的 connectorOutputPayload 响应形参将具有类似以下的值：

   {
     "Id": 52080.0
   }
   

示例 - 更新“历程”记录

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 Journeys。
3. 选择 Update 操作，然后点击完成。
4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "Name": "SFMC_CRETAE_JOURNEY_FROM_Googlecloud_Updated_V1"
   }
   

5. 将实体 ID 设置为“用户转化历程”的实体。如需设置实体 ID，请点击 entityId，然后在默认值字段中输入 0868BF36-3107-460E-9EF1-09633A0592E8。

   如果集成成功，连接器任务的 connectorOutputPayload 响应形参将具有类似以下的值：

   {
     "Id": "0868bf36-3107-460e-9ef1-09633a0592e8"
   }
   

示例 - 更新列表记录

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 List。
3. 选择 Update 操作，然后点击完成。
4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "Description": "UpdatedDescription"
   }
   

5. 将实体 ID 设置为 List 的实体。如需设置实体 ID，请点击 entityId，然后在默认值字段中输入 1234。

   如果集成成功，连接器任务的 connectorOutputPayload 响应形参将具有类似以下的值：

   {
     "ID": 1234.0
   }