Method: customers.adGroupAssetSets.mutate

Membuat, atau menghapus kumpulan aset grup iklan. Status operasi ditampilkan.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Wajib. ID pelanggan yang kumpulan aset grup iklannya diubah.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

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

object (AdGroupAssetSetOperation)

Wajib. Daftar operasi yang akan dilakukan pada setiap set aset grup iklan.
partialFailure

boolean

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

boolean

Jika true (benar), permintaan divalidasi tetapi tidak dijalankan. 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 kumpulan aset grup iklan bermutasi.

Jika berhasil, isi respons memuat data dengan struktur berikut:

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

object (MutateAdGroupAssetSetResult)

Semua hasil untuk mutasi.
partialFailureError

object (Status)

Error yang berkaitan dengan kegagalan operasi dalam mode kegagalan sebagian. Ditampilkan hanya 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.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

AdGroupAssetSetOperation

Satu operasi (buat, hapus) di kumpulan aset grup iklan.

Representasi JSON 
{

  // Union field operation can be only one of the following:
  "create": {
    object (AdGroupAssetSet)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
Kolom
Kolom union operation. Operasi mutasi. operation hanya ada berupa salah satu diantara berikut:
create

object (AdGroupAssetSet)

Operasi buat: Tidak ada nama resource yang diharapkan untuk kumpulan aset grup iklan baru.
remove

string

Operasi penghapusan: Nama resource untuk kumpulan aset grup iklan yang dihapus diharapkan, dalam format ini: customers/{customerId}/adGroupAssetSets/{adGroupId}~{asset_set_id}

MutateAdGroupAssetSetResult

Hasil untuk kumpulan aset grup iklan berubah.

Representasi JSON 
{
  "resourceName": string,
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  }
}
Kolom
resourceName

string

Ditampilkan untuk operasi yang berhasil.
adGroupAssetSet

object (AdGroupAssetSet)

Aset grup iklan yang berubah ditetapkan dengan hanya kolom yang dapat diubah setelah mutasi. Kolom ini hanya akan ditampilkan jika responseContentType ditetapkan ke "MUTABLE_RESOURCE".