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/v19/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 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 benar, permintaan divalidasi tetapi tidak dieksekusi. Hanya error yang ditampilkan, bukan hasil.

Isi respons

Pesan respons untuk mutasi penautan akun.

Jika berhasil, isi respons memuat data dengan struktur berikut:

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

object (MutateAccountLinkResult)

Hasil untuk mutasi.
partialFailureError

object (Status)

Error yang berkaitan dengan kegagalan operasi dalam mode kegagalan sebagian. Hanya ditampilkan 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:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

AccountLinkOperation

Satu pembaruan pada penautan 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 yang diubah dalam update.

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

object (AccountLink)

Operasi pembaruan: Penautan 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 penautan akun berubah.

Representasi JSON 
{
  "resourceName": string
}
Kolom
resourceName

string

Ditampilkan untuk operasi yang berhasil.