Method: customers.feedItems.mutate

建立、更新或移除動態饋給項目。系統會傳回作業狀態。

擲回錯誤清單AuthenticationErrorAuthorizationErrorCollectionSizeErrorCriterionErrorDatabaseErrorDateErrorDistinctErrorFeedItemErrorFieldErrorFieldMaskErrorHeaderErrorIdErrorInternalErrorListOperationErrorMutateErrorNotEmptyErrorNullErrorOperatorErrorQuotaErrorRangeErrorRequestErrorSizeLimitErrorStringFormatErrorStringLengthErrorUrlFieldError

HTTP 要求

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

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

路徑參數

參數
customerId

string

必要欄位。資訊提供項目所修改的客戶 ID。

要求主體

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

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

object (FeedItemOperation)

必要欄位。列出要對個別動態饋給項目執行的作業。

partialFailure

boolean

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

validateOnly

boolean

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

responseContentType

enum (ResponseContentType)

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

回應主體

資訊提供項目 change 的回應訊息。

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

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

object (Status)

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

results[]

object (MutateFeedItemResult)

所有與 變更 相關的結果。

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱 OAuth 2.0 總覽