Method: customers.accountLinks.mutate

Hesap bağlantısı oluşturur veya kaldırır. V5'ten itibaren, AccountLinkService.MutateAccountLink aracılığıyla oluşturma işlemi desteklenmez. Bunun yerine AccountLinkService.CreateAccountLink işlevini kullanın.

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

HTTP isteği

POST https://googleads.googleapis.com/v19/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

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

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

object (AccountLinkOperation)

Zorunlu. Bağlantıda yapılacak işlem.
partialFailure

boolean

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

boolean

Doğru ise istek doğrulanır ancak yürütülmez. Sonuçlar değil, yalnızca hatalar döndürülür.

Yanıt gövdesi

Hesap bağlantısı değiştirme işlemi 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ştirme işleminin sonucu.
partialFailureError

object (Status)

Kısmi hata modundaki işlem hatalarıyla ilgili hatalar. Yalnızca partialFailure = true olduğunda ve tüm hatalar işlemler içinde gerçekleştiğinde 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 Overview sayfasına 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, alanların tam nitelikli adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo".
Birlik alanı operation. Yapılacak işlem. operation yalnızca aşağıdakilerden biri olabilir:
update

object (AccountLink)

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

string

Kaldırma işlemi: Kaldırılması gereken hesap bağlantısının kaynak adı, şu biçimde beklenir:

customers/{customerId}/accountLinks/{accountLinkId}

MutateAccountLinkResult

Hesap bağlantısı için sonuçta mutasyon oluşur.

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

string

Başarılı işlemler için döndürülür.