Method: customers.accountLinks.mutate

Membuat atau menghapus penautan akun. Dari V5, pembuatan tidak didukung melalui AccountLinkService.MutateAccountLink. Sebagai gantinya, gunakan AccountLinkService.CreateAccountLink.

Daftar error yang ditampilkan: AccountLinkError AuthenticationError AuthorizationError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Wajib. ID pelanggan yang diubah.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "operation": {
    object (AccountLinkOperation)
  },
  "partialFailure": boolean,
  "validateOnly": boolean
}
Kolom
operation

object (AccountLinkOperation)

Wajib. Operasi yang akan dilakukan pada link.
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.

Isi respons

Pesan respons untuk mutasi link akun.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "result": {
    object (MutateAccountLinkResult)
  },
  "partialFailureError": {
    object (Status)
  }
}
Kolom
result

object (MutateAccountLinkResult)

Hasil untuk mutate.
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.

AccountLinkOperation

Satu pembaruan pada tautan akun.

Representasi JSON 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "update": {
    object (AccountLink)
  },
  "remove": string
  // 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 yang akan dilakukan. operation hanya ada berupa salah satu diantara berikut:
update

object (AccountLink)

Operasi pembaruan: Link akun diharapkan memiliki nama resource yang valid.
remove

string

Operasi penghapusan: Nama resource untuk penautan akun yang akan dihapus diharapkan, dalam format ini:

customers/{customerId}/accountLinks/{accountLinkId}

MutateAccountLinkResult

Hasil untuk link akun berubah.

Representasi JSON 
{
  "resourceName": string
}
Kolom
resourceName

string

Ditampilkan untuk operasi yang berhasil.