Method: customers.adGroupAds.mutate

建立、更新或移除廣告。系統會傳回作業狀態。

擲回錯誤清單：AdCustomizerError AdError AdGroupAdError AdSharingError AdxError AssetError AssetLinkError AuthenticationError AuthorizationError CollectionSizeError ContextError DatabaseError DateError DistinctError FeedAttributeReferenceError FieldError FieldMaskError FunctionError FunctionParsingError HeaderError IdError ImageError InternalError ListOperationError MediaBundleError MediaFileError MutateError NewResourceCreationError NotEmptyError NullError OperationAccessDeniedError OperatorError PolicyFindingError PolicyValidationParameterError PolicyViolationError QuotaError RangeError RequestError ResourceCountLimitExceededError SizeLimitError StringFormatError StringLengthError UrlFieldError

HTTP 要求

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

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

路徑參數

參數
customerId

string

必要欄位。廣告修改對象的客戶 ID。

要求主體

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

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

object (AdGroupAdOperation)

必要欄位。列出要對個別廣告執行的作業。
partialFailure

boolean

如為 true，則會執行成功的作業，且執行無效作業會傳回錯誤。如果設為 False，則所有作業都必須是有效狀態，才會在單一交易中進行。預設值為 false。
validateOnly

boolean

如果為 true，表示請求已經驗證，但不會執行。只會傳回錯誤，不會傳回結果。
responseContentType

enum (ResponseContentType)

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

回應主體

廣告群組廣告變更的回應訊息。

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

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

object (Status)

在部分失敗模式中，與作業失敗相關的錯誤。只有在部分失敗 = 是 true，且作業中出現所有錯誤時，才會傳回這個引數。如果作業之外發生任何錯誤 (例如驗證錯誤)，則會傳回遠端程序呼叫 (RPC) 層級錯誤。
results[]

object (MutateAdGroupAdResult)

所有與 變更 相關的結果。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。