Method: customers.keywordPlanAdGroups.mutate

建立、更新或移除關鍵字企劃書廣告群組。系統會傳回作業狀態。

擲回錯誤清單：AuthenticationError AuthorizationError DatabaseError FieldError FieldMaskError HeaderError InternalError KeywordPlanAdGroupError KeywordPlanError MutateError NewResourceCreationError QuotaError RequestError ResourceCountLimitExceededError

HTTP 要求

POST https://googleads.googleapis.com/v16/customers/{customerId}/keywordPlanAdGroups:mutate

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

路徑參數

參數
customerId

string

必要欄位。關鍵字企劃書廣告群組的客戶 ID。

要求主體

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

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

object (KeywordPlanAdGroupOperation)

必要欄位。要對個別關鍵字企劃書廣告群組執行的作業清單。
partialFailure

boolean

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

boolean

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

回應主體

關鍵字企劃書廣告群組變更的回應訊息。

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

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

object (Status)

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

object (MutateKeywordPlanAdGroupResult)

變異的所有結果。結果的順序會根據原始要求中的關鍵字順序決定。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。