Method: customers.adGroupAssetSets.mutate

建立或移除廣告群組素材資源集合。系統會傳回作業狀態。

HTTP 要求

POST https://googleads.googleapis.com/v17/customers/{customerId}/adGroupAssetSets:mutate

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
customerId

string

必要欄位。廣告群組素材資源集合正在修改的客戶 ID。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "operations": [
    {
      object (AdGroupAssetSetOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
欄位
operations[]

object (AdGroupAssetSetOperation)

必要欄位。要在個別廣告群組素材資源集合上執行的作業清單。
partialFailure

boolean

如果為 true，系統會執行成功的作業，並傳回無效作業的錯誤。如果設為 false，只有在所有作業都有效時，系統才會在單一交易中執行所有作業。預設值為 false。
validateOnly

boolean

如果為 true，系統會驗證要求，但不會執行。只會傳回錯誤，不會傳回結果。
responseContentType

enum (ResponseContentType)

回應內容類型設定。決定是否應在異動後傳回可變動資源或僅傳回資源名稱。

回應主體

廣告群組素材資源集合變更的回應訊息。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "results": [
    {
      object (MutateAdGroupAssetSetResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
欄位
results[]

object (MutateAdGroupAssetSetResult)

所有與 變更 相關的結果。
partialFailureError

object (Status)

與部分失敗模式下作業失敗相關的錯誤。只有在 partialFailure = true 且所有錯誤都發生在作業中時，系統才會傳回此值。如果在作業之外發生任何錯誤 (例如驗證錯誤)，我們會傳回 RPC 層級錯誤。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/adwords

詳情請參閱 OAuth 2.0 總覽。

AdGroupAssetSetOperation

對廣告群組素材資源集合執行單一操作 (建立、移除)。

JSON 表示法 
{

  // Union field operation can be only one of the following:
  "create": {
    object (AdGroupAssetSet)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
欄位
聯集欄位 operation。變異作業。operation 只能是下列其中一項：
create

object (AdGroupAssetSet)

建立作業：新廣告群組素材資源集合不應有資源名稱。
remove

string

移除作業：系統會要求移除的廣告群組素材資源集合的資源名稱，格式如下：customers/{customerId}/adGroupAssetSets/{adGroupId}~{asset_set_id}

MutateAdGroupAssetSetResult

廣告群組素材資源集合的結果會發生變化。

JSON 表示法 
{
  "resourceName": string,
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  }
}
欄位
resourceName

string

在成功執行作業時傳回。
adGroupAssetSet

object (AdGroupAssetSet)

已變動的廣告群組素材資源組合，在 變更之後只有可變動的欄位。只有在 responseContentType 設為「MUTABLE_RESOURCE」時，系統才會傳回這個欄位。