Method: customers.customAudiences.mutate

Membuat atau memperbarui audiens kustom. Status operasi ditampilkan.

Daftar error yang ditampilkan: AuthenticationError AuthorizationError CustomAudienceError CustomInterestError FieldError FieldMaskError HeaderError InternalError MutateError OperationAccessDeniedError PolicyViolationError QuotaErrorRequestError

Permintaan HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}/customAudiences:mutate

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Wajib. ID pelanggan yang audiens kustomnya diubah.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "operations": [
    {
      object (CustomAudienceOperation)
    }
  ],
  "validateOnly": boolean
}
Kolom
operations[]

object (CustomAudienceOperation)

Wajib. Daftar operasi yang akan dijalankan pada masing-masing audiens kustom.
validateOnly

boolean

Jika true (benar), permintaan akan divalidasi tetapi tidak dieksekusi. Hanya error yang ditampilkan, bukan hasil.

Isi respons

Pesan respons untuk mutasi audiens kustom.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "results": [
    {
      object (MutateCustomAudienceResult)
    }
  ]
}
Kolom
results[]

object (MutateCustomAudienceResult)

Semua hasil untuk mutate.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

CustomAudienceOperation

Satu operasi (buat, perbarui) pada audiens kustom.

Representasi JSON 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "create": {
    object (CustomAudience)
  },
  "update": {
    object (CustomAudience)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
Kolom
updateMask

string (FieldMask format)

FieldMask yang menentukan kolom resource yang diubah dalam pembaruan.

Ini adalah daftar yang dipisahkan koma yang berisi nama-nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".
Kolom union operation. Operasi mutasi. operation hanya ada berupa salah satu diantara berikut:
create

object (CustomAudience)

Operasi pembuatan: Tidak ada nama resource yang diharapkan untuk audiens kustom baru.
update

object (CustomAudience)

Operasi pembaruan: Audiens kustom diharapkan memiliki nama resource yang valid.
remove

string

Operasi penghapusan: Nama resource untuk audiens kustom yang dihapus diharapkan dalam format ini:

customers/{customerId}/customAudiences/{custom_audience_id}

MutateCustomAudienceResult

Hasil untuk mutasi audiens kustom.

Representasi JSON 
{
  "resourceName": string
}
Kolom
resourceName

string

Dikembalikan untuk operasi yang berhasil.