Method: customers.keywordPlanCampaignKeywords.mutate

Membuat, memperbarui, atau menghapus kata kunci kampanye Rencana Kata Kunci. Status operasi ditampilkan.

Daftar error yang ditampilkan: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError KeywordPlanAdGroupKeywordError KeywordPlanCampaignKeywordError QuotaError RequestError ResourceCountLimitExceededError

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Wajib diisi. ID pelanggan yang kata kunci kampanyenya diubah.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "operations": [
    {
      object (KeywordPlanCampaignKeywordOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
Kolom
operations[]

object (KeywordPlanCampaignKeywordOperation)

Wajib diisi. Daftar operasi yang akan dijalankan untuk setiap kata kunci kampanye Rencana Kata Kunci.

partialFailure

boolean

Jika true (benar), operasi yang berhasil akan dilakukan dan operasi yang tidak valid akan menampilkan error. Jika salah, semua operasi akan dilakukan dalam satu transaksi jika dan hanya jika semuanya valid. Defaultnya adalah false.

validateOnly

boolean

Jika true (benar), permintaan divalidasi tetapi tidak dijalankan. Hanya error yang ditampilkan, bukan hasil.

Isi respons

Pesan respons untuk mutasi kata kunci kampanye Rencana Kata Kunci.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (MutateKeywordPlanCampaignKeywordResult)
    }
  ]
}
Kolom
partialFailureError

object (Status)

Error yang berkaitan dengan kegagalan operasi dalam mode kegagalan parsial. Ditampilkan hanya jika partialFailure = true dan semua error terjadi dalam operasi. Jika terjadi error di luar operasi (misalnya, error autentikasi), kami akan menampilkan error tingkat RPC.

results[]

object (MutateKeywordPlanCampaignKeywordResult)

Semua hasil untuk mutasi.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/adwords

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.