Method: customers.adGroupAds.mutate

Membuat, memperbarui, atau menghapus iklan. Status operasi ditampilkan.

Daftar error yang ditampilkan: 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

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Wajib. ID pelanggan yang iklannya diubah.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "operations": [
    {
      object (AdGroupAdOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
Kolom
operations[]

object (AdGroupAdOperation)

Wajib. Daftar operasi yang akan dilakukan pada setiap iklan.
partialFailure

boolean

Jika benar, operasi yang berhasil akan dilakukan dan operasi yang tidak valid akan menampilkan error. Jika salah, semua operasi akan dilakukan dalam satu transaksi jika dan hanya jika semuanya valid. Defaultnya adalah false.
validateOnly

boolean

Jika benar, permintaan divalidasi tetapi tidak dieksekusi. Hanya error yang ditampilkan, bukan hasil.
responseContentType

enum (ResponseContentType)

Setelan jenis konten respons. Menentukan apakah resource yang dapat berubah atau hanya nama resource yang harus ditampilkan setelah mutasi.

Isi respons

Pesan respons untuk mutasi iklan grup iklan.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (MutateAdGroupAdResult)
    }
  ]
}
Kolom
partialFailureError

object (Status)

Error yang berkaitan dengan kegagalan operasi dalam mode kegagalan parsial. Hanya ditampilkan jika partialFailure = true dan semua error terjadi di dalam operasi. Jika terjadi error di luar operasi (misalnya, error autentikasi), kami akan menampilkan error tingkat RPC.
results[]

object (MutateAdGroupAdResult)

Semua hasil untuk mutasi.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.