ApplyAssetGroupListingGroupActions 服務作業 - 營銷活動管理

發行項
03/28/2024

將動作套用至資產群組清單群組。

請注意下列驗證規則：

您至少必須指定清單群組樹狀結構的根節點。清單群組的根 AssetGroupListingGroup 必須將其條件 Operand 設定為 “All” 且 Attribute 設為 null。如果您要為目錄中的所有產品提供廣告，請將 PartitionType 設定為 “Unit”。如果您要針對更特定的產品條件提供廣告，請將 YPartitionTypeY 設定為 “Subdivision”，將 ParentCriterionId 設為 null，並將 Id 設為負值。對於任何子節點，您都會使用負值做為 ParentCriterionId 。
根節點會被視為層級 0，而樹狀結構最多可以有 7 層深的分支。
每個呼叫最多可指定 5,000 個 AssetGroupListingGroupAction 物件。透過多個呼叫建立的整個樹狀結構最多可以有 20,000 個節點。
每個 AssetGroupListingGroup 對象都必須有相同的 AssetGroupId，否則呼叫將會失敗。
若要更新 Condition 或 Attribute 屬性，您必須刪除現有的產品數據分割樹狀節點，並新增會取得新標識符的產品分割樹狀節點。若要從未排除的更新為排除的 AssetGroupListingGroup 或相反的方式，您必須刪除現有的產品分割樹狀節點，並新增新的產品分割樹狀節點，以取得新的標識符。
如果有任何動作失敗，可能已成功的所有剩餘動作也會失敗。
一次呼叫中的所有動作都必須產生完整的樹狀結構。如果您需要針對每個資產群組套用超過 5,000 個動作，您必須進行多次呼叫。從第一次呼叫取得父資產群組標識符，然後在後續呼叫中視需要新增更多子系。
從根節點到分支結尾的每個路徑都必須以分葉節點終止， (ProductPartitionType=Unit) 。
在細分條件的其餘部分，每個細分必須至少有一個分葉節點。例如，使用與其同層級單位相同的操作數 (的) ，並將其 Attribute 設定為 null。
您只能在其父節點之後指定子節點。
如果您要在父系或子系都不存在的多個層級中加入分割區，請使用負 int 值作為參考來識別父系。例如，將父系的 Id和子系的 ParentListingGroupId 專案設定為相同的負值。負數標識碼只在呼叫期間有效。回應消息中會傳回每個成功新增資產群組清單群組的唯一系統標識碼。
若要暫停任何產品分割區，您必須呼叫 UpdateAssetGroups 來暫停整個資產群組。您可以呼叫 UpdateCampaigns 來暫停整個營銷活動。
針對 Delete 動作，您只需要在 AssetGroupListingGroup 中指定 Id 和 AssetGroupId。
如果您刪除父系產品分割區，也會刪除其所有子系和子系。
您不能在分支中指定重複的產品條件。

要求專案

ApplyAssetGroupListingGroupActionsRequest 物件會定義服務作業要求的主體和標頭元素。元素的順序必須與要求SOAP中所示的順序相同。

注意事項

除非下面另有說明，否則所有要求專案都是必要的。

要求本文專案

元素	描述	資料類型
ListingGroupActions	AssetGroupListingGroupAction 對象的清單，每個物件都包含 Action 元素和 ListingGroup 元素。所有資產群組清單群組動作都必須適用於相同的資產群組。您可以每個呼叫傳遞 5,000 個 AssetGroupListingGroupAction ，並將最多 20,000 個清單群組套用至每個資產群組。	AssetGroupListingGroupAction 陣列

要求標頭元素

元素	描述	資料類型
AuthenticationToken	OAuth 存取令牌，代表具有 Microsoft Advertising 帳戶許可權之用戶的認證。如需詳細資訊，請參閱使用 OAuth 進行驗證。	string
CustomerAccountId	擁有或與要求中實體相關聯之廣告帳戶的標識碼。當兩者都需要時，此標頭元素必須具有與 AccountId body 元素相同的值。此元素是大部分服務作業的必要專案，最佳做法是一律加以設定。如需詳細資訊，請參閱取得您的帳戶和客戶標識符。	string
CustomerId	(使用者存取或操作之使用者) 客戶的管理員帳戶標識碼。用戶可以存取多個管理員帳戶。此元素是大部分服務作業的必要專案，最佳做法是一律加以設定。如需詳細資訊，請參閱取得您的帳戶和客戶標識符。	string
DeveloperToken	用來存取 Bing 廣告 API 的開發人員令牌。如需詳細資訊，請參閱取得開發人員令牌。	string
密碼	此元素會保留供內部使用，並會從未來的 API 版本中移除。您必須使用 AuthenticationToken 元素來設定用戶認證。	string
UserName	此元素會保留供內部使用，並會從未來的 API 版本中移除。您必須使用 AuthenticationToken 元素來設定用戶認證。	string

Response 元素

ApplyAssetGroupListingGroupActionsResponse 物件會定義服務作業回應的主體和標頭元素。這些元素的傳回順序與回應SOAP中所示的順序相同。

回應本文專案

元素	描述	資料類型
AssetGroupListingGroupIds	已套用動作之清單群組的標識碼清單。標識符清單會直接對應至要求中的清單群組清單。如果有任何清單群組動作失敗，則所有剩餘的清單群組動作都會失敗，而且此清單中的所有元素都會是 Null。	long 陣列
PartialErrors	BatchError 物件的陣列，其中包含任何未成功要求專案的詳細數據。	BatchError 陣列

回應標頭元素

元素	描述	資料類型
TrackingId	包含 API 呼叫詳細數據的記錄項目識別碼。	string

要求SOAP

此範本是由工具所產生，用來顯示SOAP要求的主體和標頭元素順序。如需可搭配此服務作業使用的支援類型，請參閱上述的要求本文項目參考。

<s:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
    <Action mustUnderstand="1">ApplyAssetGroupListingGroupActions</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <CustomerAccountId i:nil="false">ValueHere</CustomerAccountId>
    <CustomerId i:nil="false">ValueHere</CustomerId>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <ApplyAssetGroupListingGroupActionsRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <ListingGroupActions i:nil="false">
        <AssetGroupListingGroupAction>
          <Action>ValueHere</Action>
          <ListingGroup i:nil="false">
            <AssetGroupId>ValueHere</AssetGroupId>
            <AssetGroupListingType>ValueHere</AssetGroupListingType>
            <Dimension i:nil="false">
              <Attribute i:nil="false">ValueHere</Attribute>
              <Operand i:nil="false">ValueHere</Operand>
              <Operator i:nil="false">ValueHere</Operator>
            </Dimension>
            <Id i:nil="false">ValueHere</Id>
            <IsExcluded>ValueHere</IsExcluded>
            <ParentListingGroupId i:nil="false">ValueHere</ParentListingGroupId>
          </ListingGroup>
        </AssetGroupListingGroupAction>
      </ListingGroupActions>
    </ApplyAssetGroupListingGroupActionsRequest>
  </s:Body>
</s:Envelope>

回應 SOAP

此範本是由工具所產生，用來顯示SOAP回應的主體和標頭元素順序。

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
    <TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
  </s:Header>
  <s:Body>
    <ApplyAssetGroupListingGroupActionsResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <AssetGroupListingGroupIds d4p1:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <a1:long>ValueHere</a1:long>
      </AssetGroupListingGroupIds>
      <PartialErrors d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <BatchError d4p1:type="-- derived type specified here with the appropriate prefix --">
          <Code>ValueHere</Code>
          <Details d4p1:nil="false">ValueHere</Details>
          <ErrorCode d4p1:nil="false">ValueHere</ErrorCode>
          <FieldPath d4p1:nil="false">ValueHere</FieldPath>
          <ForwardCompatibilityMap xmlns:e63="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
            <e63:KeyValuePairOfstringstring>
              <e63:key d4p1:nil="false">ValueHere</e63:key>
              <e63:value d4p1:nil="false">ValueHere</e63:value>
            </e63:KeyValuePairOfstringstring>
          </ForwardCompatibilityMap>
          <Index>ValueHere</Index>
          <Message d4p1:nil="false">ValueHere</Message>
          <Type d4p1:nil="false">ValueHere</Type>
          <!--These fields are applicable if the derived type attribute is set to EditorialError-->
          <Appealable d4p1:nil="false">ValueHere</Appealable>
          <DisapprovedText d4p1:nil="false">ValueHere</DisapprovedText>
          <Location d4p1:nil="false">ValueHere</Location>
          <PublisherCountry d4p1:nil="false">ValueHere</PublisherCountry>
          <ReasonCode>ValueHere</ReasonCode>
        </BatchError>
      </PartialErrors>
    </ApplyAssetGroupListingGroupActionsResponse>
  </s:Body>
</s:Envelope>

程序代碼語法

範例語法可以與 Bing 廣告 SDK 搭配使用。如需更多範例，請參閱 Bing 廣告 API 程式代碼範例。

public async Task<ApplyAssetGroupListingGroupActionsResponse> ApplyAssetGroupListingGroupActionsAsync(
	IList<AssetGroupListingGroupAction> listingGroupActions)
{
	var request = new ApplyAssetGroupListingGroupActionsRequest
	{
		ListingGroupActions = listingGroupActions
	};

	return (await CampaignManagementService.CallAsync((s, r) => s.ApplyAssetGroupListingGroupActionsAsync(r), request));
}

static ApplyAssetGroupListingGroupActionsResponse applyAssetGroupListingGroupActions(
	ArrayOfAssetGroupListingGroupAction listingGroupActions) throws RemoteException, Exception
{
	ApplyAssetGroupListingGroupActionsRequest request = new ApplyAssetGroupListingGroupActionsRequest();

	request.setListingGroupActions(listingGroupActions);

	return CampaignManagementService.getService().applyAssetGroupListingGroupActions(request);
}

static function ApplyAssetGroupListingGroupActions(
	$listingGroupActions)
{

	$GLOBALS['Proxy'] = $GLOBALS['CampaignManagementProxy'];

	$request = new ApplyAssetGroupListingGroupActionsRequest();

	$request->ListingGroupActions = $listingGroupActions;

	return $GLOBALS['CampaignManagementProxy']->GetService()->ApplyAssetGroupListingGroupActions($request);
}

response=campaignmanagement_service.ApplyAssetGroupListingGroupActions(
	ListingGroupActions=ListingGroupActions)

需求

服務： CampaignManagementService.svc v13
命名空間： https://bingads.microsoft.com/CampaignManagement/v13

共用方式為