Method: customers.keywordPlanCampaignKeywords.mutate

Anahtar Kelime Planı kampanya anahtar kelimelerini 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 KeywordPlanAdGroupKeywordError KeywordPlanCampaignKeywordError QuotaError RequestError ResourceCountLimitExceededError

HTTP isteği

POST https://googleads.googleapis.com/v17/customers/{customerId}/keywordPlanCampaignKeywords:mutate

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

Yol parametreleri

Parametreler
customerId

string

Zorunlu. Kampanya anahtar kelimeleri 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 (KeywordPlanCampaignKeywordOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
Alanlar
operations[]

object (KeywordPlanCampaignKeywordOperation)

Zorunlu. Bağımsız Anahtar Kelime Planı kampanya anahtar kelimeleri üzerinde gerçekleştirilecek işlemlerin listesi.

partialFailure

boolean

Değer true ise başarılı işlemler gerçekleştirilir ve geçersiz işlemler hata döndürür. False (yanlış) değerine ayarlanırsa tüm işlemler, yalnızca hepsinin geçerli olması koşuluyla tek bir işlemde gerçekleştirilir. Varsayılan değer, false'tur.

validateOnly

boolean

True (doğru) ise istek doğrulanır ancak yürütülmez. Yalnızca hatalar döndürülür, sonuç döndürülmez.

Yanıt gövdesi

Bir Anahtar Kelime Planı kampanya anahtar kelimesi 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 (Status)
  },
  "results": [
    {
      object (MutateKeywordPlanCampaignKeywordResult)
    }
  ]
}
Alanlar
partialFailureError

object (Status)

Kısmi hata modundaki işlem hatalarıyla ilgili hatalar. Yalnızca kısmiFailure = true olduğunda ve tüm hatalar işlemlerin içinde oluştuğunda döndürülür. İşlemlerin dışında herhangi bir hata oluşursa (örneğin, kimlik doğrulama hataları) RPC düzeyinde bir hata döndürürüz.

results[]

object (MutateKeywordPlanCampaignKeywordResult)

Değişim 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 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.