Reklamları günceller. İşlem durumları döndürülür. Metin Reklam, GenişletilmişDinamik Arama Ağı Reklamı, GmailAd ve Resim Reklam için reklam güncelleme işlemi desteklenmez.
Atılan hatalar listesi: AdCustomizerErrorDaha FazlasıHataErrorDateErrorDistinctErrorFeedAttributeReferenceErrorFieldErrorFieldMaskErrorFunctionErrorFunctionParsingErrorHeaderErrorIdErrorImageErrorInternalErrorListOperationErrorMediaBundleErrorMediaFileErrorMutateErrorNewResourceCreationErrorNotEmptyErrorNullErrorOperatorErrorPolicyFindingErrorPolicyViolationErrorQuotaErrorRangeErrorRequestErrorSizeLimitErrorStringFormatErrorStringLengthErrorUrlFieldError
HTTP isteği
POST https://googleads.googleapis.com/v15/customers/{customerId}/ads:mutate
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
customerId |
Zorunlu. Reklamları 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 |
---|
{ "operations": [ { object ( |
Alanlar | |
---|---|
operations[] |
Zorunlu. Bağımsız reklamlar üzerinde gerçekleştirilecek işlemlerin listesi. |
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. |
responseContentType |
Yanıt içerik türü ayarı. Mutasyondan sonra değişken kaynağın mı yoksa yalnızca kaynak adının mı döndürüleceğini belirler. |
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
Bir reklam 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 |
---|
{ "partialFailureError": { object ( |
Alanlar | |
---|---|
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. |
results[] |
Değişimle ilgili tüm sonuçlar. |
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.