Method: customers.accountLinks.mutate

Hesap bağlantısı oluşturur veya kaldırır. V5'te, AccountLinkService.MutateAccountLink üzerinden oluşturma desteklenmiyor. Bunun yerine AccountLinkService.CreateAccountLink kullanın.

Verilen hataların listesi: AccountLinkError AuthenticationError AuthorizationError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
customerId

string

Zorunlu. Değiştirilen müşterinin kimliği.

İstek içeriği

İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:

JSON gösterimi 
{
  "operation": {
    object (AccountLinkOperation)
  },
  "partialFailure": boolean,
  "validateOnly": boolean
}
Alanlar
operation

object (AccountLinkOperation)

Zorunlu. Bağlantı üzerinde gerçekleştirilecek işlem.
partialFailure

boolean

Doğru değerine ayarlanırsa başarılı işlemler gerçekleştirilir ve geçersiz işlemler hata döndürür. Yanlış değerine ayarlanırsa tüm işlemler, yalnızca hepsinin geçerli olması durumunda tek bir işlemde gerçekleştirilir. Varsayılan değer, false (yanlış) değeridir.
validateOnly

boolean

Doğru ise istek doğrulanır ancak yürütülmez. Yalnızca hatalar döndürülür, sonuç döndürülmez.

Yanıt gövdesi

Hesap bağlantısı değişikliği için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "result": {
    object (MutateAccountLinkResult)
  },
  "partialFailureError": {
    object (Status)
  }
}
Alanlar
result

object (MutateAccountLinkResult)

Değişim için sonuç.
partialFailureError

object (Status)

Kısmi hata modundaki işlem hatalarıyla ilgili hatalar. Yalnızca kısmiFailure = true olduğunda ve tüm hatalar işlemler içinde ortaya çıktığında döndürülür. İşlemler dışında herhangi bir hata oluşursa (ör. kimlik doğrulama hataları) RPC düzeyinde bir hata döndürürüz.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.

AccountLinkOperation

Hesap bağlantısında tek bir güncelleme.

JSON gösterimi 
{
  "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.
}
Alanlar
updateMask

string (FieldMask format)

Bir güncellemede hangi kaynak alanlarının değiştirileceğini belirleyen FieldMask.

Bu, tam nitelikli alan adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo".
Birleştirme alanı operation. Gerçekleştirilecek işlem. operation şunlardan yalnızca biri olabilir:
update

object (AccountLink)

Güncelleme işlemi: Hesap bağlantısının geçerli bir kaynak adına sahip olması beklenir.
remove

string

Kaldırma işlemi: Kaldırılacak hesap bağlantısı için şu biçimde bir kaynak adı bekleniyor:

customers/{customerId}/accountLinks/{accountLinkId}

MutateAccountLinkResult

Hesap bağlantısı değişmesinin sonucu.

JSON gösterimi 
{
  "resourceName": string
}
Alanlar
resourceName

string

Başarılı operasyonlar için iade edildi.