Method: customers.adGroupAdLabels.mutate

Reklam grubu reklam etiketleri oluşturur ve kaldırır. İşlem durumları döndürülür.

Atılan hataların listesi: AuthenticationError AuthorizationError DatabaseError HeaderError InternalError LabelError MutateError NewResourceCreationError QuotaError RequestError

HTTP isteği

POST https://googleads.googleapis.com/v14/customers/{customerId}/adGroupAdLabels:mutate

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

Yol parametreleri

Parametreler
customerId

string

Zorunlu. Reklam grubu reklam etiketleri 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 (AdGroupAdLabelOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
Alanlar
operations[]

object (AdGroupAdLabelOperation)

Zorunlu. Reklam grubu reklam etiketlerinde gerçekleştirilecek işlemlerin listesi.
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 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

boolean

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 grubu reklam etiketleri için yanıt mesajı değişiyor.

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

JSON gösterimi 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (MutateAdGroupAdLabelResult)
    }
  ]
}
Alanlar
partialFailureError

object (Status)

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[]

object (MutateAdGroupAdLabelResult)

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.