Method: customers.keywordPlans.mutate

Anahtar kelime planları oluşturur, günceller veya kaldırır. İşlem durumları döndürülür.

Atılan hataların listesi: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError KeywordPlanError MutateError NewResourceCreationError QuotaError RequestError ResourceCountLimitExceededError StringLengthError

HTTP isteği

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

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

Yol parametreleri

Parametreler
customerId

string

Zorunlu. Anahtar kelime planları değiştirilen müşterinin kimliği.

İstek içeriği

İstek gövdesi aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi 
{
  "operations": [
    {
      object (KeywordPlanOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
Alanlar
operations[]

object (KeywordPlanOperation)

Zorunlu. Anahtar kelime planlarında tek tek yapılacak işlemlerin listesi.
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ıştır.
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

Anahtar kelime planı mutasyonu 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 (Status)
  },
  "results": [
    {
      object (MutateKeywordPlansResult)
    }
  ]
}
Alanlar
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.
results[]

object (MutateKeywordPlansResult)

Değişiklik için 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ı makaleyi inceleyin.