Method: customers.adGroupAssetSets.mutate

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

Permintaan HTTP

POST https://googleads.googleapis.com/v14/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 kumpulan aset grup iklan.
partialFailure

boolean

Jika true (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 true (benar), permintaan akan 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 perubahan 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 mutate.
partialFailureError

object (Status)

Error yang berkaitan dengan kegagalan operasi dalam mode kegagalan parsial. 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 ini:

  • 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 ada berupa salah satu diantara berikut:
create

object (AdGroupAssetSet)

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

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

string

Dikembalikan 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".