Method: customers.customerAssetSets.mutate

Membuat atau menghapus kumpulan aset pelanggan. Status operasi ditampilkan.

Permintaan HTTP

POST https://googleads.googleapis.com/v14/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 setiap kumpulan aset pelanggan.
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 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 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.

CustomerAssetSetOperation

Satu operasi (buat, hapus) di 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 pembuatan: Tidak ada nama resource 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 mutasi kumpulan aset pelanggan.

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

string

Dikembalikan untuk operasi yang berhasil.
customerAssetSet

object (CustomerAssetSet)

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