- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- AccountLinkOperation
- MutateAccountLinkResult
- Deneyin.
Hesap bağlantısı oluşturur veya kaldırır. V5'te, AccountLinkService.MutateAccountLink üzerinden oluşturma desteklenmiyor. Bunun yerine AccountLinkService.CreateAccountLink kullanın.
Atılan hataların listesi: AccountLinkError AuthenticationError AuthorizationError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError
HTTP isteği
POST https://googleads.googleapis.com/v14/customers/{customerId}/accountLinks:mutate
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
customerId |
Zorunlu. Değiştirilen müşterinin kimliği. |
İstek içeriği
İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:
JSON gösterimi |
---|
{
"operation": {
object ( |
Alanlar | |
---|---|
operation |
Zorunlu. Bağlantı üzerinde gerçekleştirilecek işlem. |
partialFailure |
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 tümü geçerliyse ve yalnızca geçerliyse tek bir işlemde gerçekleştirilir. Varsayılan değer, false (yanlış) değeridir. |
validateOnly |
Doğru değerine ayarlanırsa 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ş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 ( |
Alanlar | |
---|---|
result |
Mutasyon için sonuç. |
partialFailureError |
Kısmi hata modundaki işlem hatalarıyla ilgili hatalar. Yalnızca kısmiFailure = true olduğunda ve işlemlerde tüm hatalar 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 |
Alanlar | |
---|---|
updateMask |
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: |
operation alanı. Gerçekleştirilecek işlem. operation şunlardan yalnızca biri olabilir: |
|
update |
Güncelleme işlemi: Hesap bağlantısının geçerli bir kaynak adına sahip olması beklenir. |
remove |
Kaldırma işlemi: Kaldırılacak hesap bağlantısı için şu biçimde bir kaynak adı bekleniyor:
|
MutateAccountLinkResult
Hesap bağlantısı değişikliğinin sonucu.
JSON gösterimi |
---|
{ "resourceName": string } |
Alanlar | |
---|---|
resourceName |
Başarılı işlemler için iade edildi. |