Method: customers.customInterests.mutate

Membuat atau memperbarui minat kustom. Status operasi ditampilkan.

Daftar error yang ditampilkan: AuthenticationError AuthorizationError CriterionError CustomInterestError HeaderError InternalError MutateError PolicyViolationError QuotaError RequestError StringLengthError

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Wajib. ID pelanggan yang minat kustomnya diubah.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

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

object (CustomInterestOperation)

Wajib. Daftar operasi yang akan dilakukan pada setiap minat kustom.
validateOnly

boolean

Jika benar, permintaan divalidasi tetapi tidak dieksekusi. Hanya error yang ditampilkan, bukan hasil.

Isi respons

Pesan respons untuk mutasi minat kustom.

Jika berhasil, isi respons memuat data dengan struktur berikut:

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

object (MutateCustomInterestResult)

Semua hasil untuk mutasi.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

CustomInterestOperation

Satu operasi (membuat, memperbarui) pada minat kustom.

Representasi JSON 
{
  "updateMask": string,

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

string (FieldMask format)

FieldMask yang menentukan kolom resource mana yang diubah dalam update.

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

object (CustomInterest)

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

object (CustomInterest)

Operasi pembaruan: Minat kustom diharapkan memiliki nama resource yang valid.

MutateCustomInterestResult

Hasil untuk mutasi minat kustom.

Representasi JSON 
{
  "resourceName": string
}
Kolom
resourceName

string

Ditampilkan untuk operasi yang berhasil.