Method: customers.adGroupAssetSets.mutate

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

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Wajib. ID pelanggan yang kumpulan aset grup iklannya sedang 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 kumpulan aset grup 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 diubah atau hanya nama resource yang akan ditampilkan setelah mutasi.

Isi respons

Pesan respons untuk mutasi kumpulan aset grup iklan.

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 dalam operasi. Jika terjadi error di luar operasi (misalnya, error autentikasi), kami akan menampilkan error tingkat RPC.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

AdGroupAssetSetOperation

Satu operasi (buat, hapus) pada 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 dapat berupa salah satu dari berikut:
create

object (AdGroupAssetSet)

Operasi pembuatan: 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 mutasi kumpulan aset grup iklan.

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

string

Ditampilkan untuk operasi yang berhasil.
adGroupAssetSet

object (AdGroupAssetSet)

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