Method: customers.assets.mutate

アセットを作成する。オペレーションのステータスが返されます。

DistinctError FieldError FieldMaskError HeaderErrorFieldMaskErrorIdErrorInternalErrorListOperationErrorMediaUploadErrorMutateErrorNotAllowlistedErrorNotEmptyErrorOperatorErrorQuotaErrorRangeErrorRequestErrorSizeLimitErrorStringFormatErrorStringLengthErrorUrlFieldErrorYoutubeVideoRegistrationError

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
customerId

string

必須。アセットを変更する顧客の ID。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "operations": [
    {
      object (AssetOperation)
    }
  ],
  "partialFailure": boolean,
  "responseContentType": enum (ResponseContentType),
  "validateOnly": boolean
}
フィールド
operations[]

object (AssetOperation)

必須。個々のアセットに対して実行するオペレーションのリスト。
partialFailure

boolean

true の場合、正常なオペレーションが実行され、無効なオペレーションはエラーが返されます。false の場合、すべてのオペレーションが有効である場合に限り、1 つのトランザクションですべてのオペレーションが実行されます。デフォルトは false です。
responseContentType

enum (ResponseContentType)

レスポンスのコンテンツ タイプの設定。ミューテーション後に可変リソースを返すか、リソース名のみを返すかを決定します。
validateOnly

boolean

true の場合、リクエストは検証されますが、実行されません。結果ではなく、エラーのみが返されます。

レスポンスの本文

アセットの変更に対するレスポンス メッセージです。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (MutateAssetResult)
    }
  ]
}
フィールド
partialFailureError

object (Status)

Partial Failure モードのオペレーション障害に関連するエラーです。partialFailure = true で、すべてのエラーがオペレーション内で発生した場合にのみ返されます。オペレーション以外でエラーが発生した場合（認証エラーなど）は、RPC レベルのエラーを返します。
results[]

object (MutateAssetResult)

変換のすべての結果。

認可スコープ

次の OAuth スコープが必要です。

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

詳しくは、OAuth 2.0 の概要をご覧ください。