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/v14/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, 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.

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 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.

AccountLinkOperation

Pembaruan tunggal 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 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 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 link akun yang akan dihapus diharapkan, dalam format ini:

customers/{customerId}/accountLinks/{accountLinkId}

MutateAccountLinkResult

Hasil untuk mutasi penautan akun.

Representasi JSON 
{
  "resourceName": string
}
Kolom
resourceName

string

Dikembalikan untuk operasi yang berhasil.