Method: customers.campaignCriteria.mutate

建立、更新或移除條件。傳回作業狀態。

擲回錯誤清單：AdxError AuthenticationError AuthorizationError CampaignCriterionError CollectionSizeError ContextError CriterionError DatabaseError DistinctError FieldError FieldMaskError FunctionError HeaderError IdError InternalError MutateError NewResourceCreationError NotEmptyError NullError OperationAccessDeniedError OperatorError QuotaError RangeError RegionCodeError RequestError ResourceCountLimitExceededError SizeLimitError StringFormatError StringLengthError

HTTP 要求

POST https://googleads.googleapis.com/v19/customers/{customerId}/campaignCriteria:mutate

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

路徑參數

參數
customerId

string

必要欄位。要修改條件的客戶 ID。

要求主體

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

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

object (CampaignCriterionOperation)

必要欄位。針對個別條件執行的作業清單。
partialFailure

boolean

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

boolean

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

enum (ResponseContentType)

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

回應主體

廣告活動條件變更的回應訊息。

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

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

object (Status)

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

object (MutateCampaignCriterionResult)

變異的所有結果。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 Overview。