Method: customers.customerAssetSets.mutate

Membuat atau menghapus kumpulan aset pelanggan. Status operasi ditampilkan.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Wajib. ID pelanggan yang kumpulan aset pelanggannya diubah.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

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

object (CustomerAssetSetOperation)

Wajib. Daftar operasi yang akan dilakukan pada set aset pelanggan individual.
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 mutasi kumpulan aset pelanggan.

Jika berhasil, isi respons memuat data dengan struktur berikut:

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

object (MutateCustomerAssetSetResult)

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.

CustomerAssetSetOperation

Satu operasi (buat, hapus) pada kumpulan aset pelanggan.

Representasi JSON 
{

  // Union field operation can be only one of the following:
  "create": {
    object (CustomerAssetSet)
  },
  "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 (CustomerAssetSet)

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

string

Operasi penghapusan: Nama resource untuk kumpulan aset pelanggan yang dihapus diharapkan, dalam format ini: customers/{customerId}/customerAssetSets/{asset_set_id}

MutateCustomerAssetSetResult

Hasil untuk kumpulan aset pelanggan berubah.

Representasi JSON 
{
  "resourceName": string,
  "customerAssetSet": {
    object (CustomerAssetSet)
  }
}
Kolom
resourceName

string

Ditampilkan untuk operasi yang berhasil.
customerAssetSet

object (CustomerAssetSet)

Kumpulan aset pelanggan yang berubah dengan hanya kolom yang dapat diubah setelah mutasi. Kolom ini hanya akan ditampilkan jika responseContentType ditetapkan ke "MUTABLE_RESOURCE".