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，請在 「Connectors」(連結器) 工作的「Task Input」(工作輸入) 部分中，按一下「EntityId」(實體 ID)，然後 在「Default Value」(預設值) 欄位中輸入 49851.0。

   應直接傳遞實體 ID 的值，例如 Id= 49851.0。這裡的 49851.0 是應傳遞的唯一主鍵值。

範例 - 刪除資產記錄

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Assets。
3. 選取 Delete 作業，然後按一下「完成」。
4. 將實體 ID 設為 49851.0，這是要傳遞的鍵。如要設定實體 ID，請在 「Connectors」(連結器) 工作的「Task Input」(工作輸入) 部分中，按一下「EntityId」(實體 ID)，然後 在「Default Value」(預設值) 欄位中輸入 49851.0。

   實體 ID 的值應直接傳遞，例如 ID= 49851.0。這裡的 49851.0 是應傳遞的唯一主鍵值。

範例 - 建立 DataExtensionObject_Custom 記錄

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 DataExtensionObject_Custom。
3. 選取 Create 作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

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

   如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似以下內容：

   {
     "StudentID": 1
   } 

範例 - 建立資產記錄

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Assets。
3. 選取 Create 作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 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. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 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. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 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. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 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. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 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. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

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

5. 將實體 ID 設為 103032 (例如)，這是要傳遞的主鍵。如要設定實體 ID，請在「Connectors」(連結器) 工作的「Task Input」(工作輸入) 部分，按一下「entityId」，然後在「Default Value」(預設值) 欄位中輸入 10。

   如果實體有複合式商家或主鍵，除了指定 entityId，您也可以將 filterClause 設為 Rank='1' and StudentID='10'。

如果整合成功，連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容：

{
    "StudentID": 1
}

範例 - 更新資產記錄

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取「資產」。
3. 選取 Update 作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
     "Description": "June2023-Updated"
   }
   

5. 將實體 ID 設為 Assets 的實體。如要設定實體 ID，請按一下「entityId」，然後在「Default Value」(預設值) 欄位中輸入 52080。

   如果整合成功，連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容：

   {
     "Id": 52080.0
   }
   

範例 - 更新歷程記錄

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Journeys。
3. 選取 Update 作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
     "Name": "SFMC_CRETAE_JOURNEY_FROM_Googlecloud_Updated_V1"
   }
   

5. 將實體 ID 設為「旅程」的實體。如要設定實體 ID，請按一下「entityId」，然後在「Default Value」(預設值) 欄位中輸入 0868BF36-3107-460E-9EF1-09633A0592E8。

   如果整合成功，連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容：

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

範例 - 更新清單記錄

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 List。
3. 選取 Update 作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
     "Description": "UpdatedDescription"
   }
   

5. 將實體 ID 設為清單的實體。如要設定實體 ID，請按一下「entityId」，然後在「Default Value」(預設值) 欄位中輸入 1234。

   如果整合成功，連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容：

   {
     "ID": 1234.0
   }