Method: customers.googleAds.mutate

Membuat, mengupdate, atau menghapus resource. Metode ini mendukung transaksi atomik dengan beberapa jenis resource. Misalnya, Anda dapat membuat kampanye dan anggaran kampanye secara menyeluruh, atau menjalankan hingga ribuan mutasi secara atomik.

Metode ini pada dasarnya adalah wrapper di sekitar serangkaian metode mutate. Satu-satunya fitur yang ditawarkannya dibandingkan memanggil metode tersebut secara langsung adalah:

  • Transaksi atomik
  • Nama resource sementara (dijelaskan di bawah)
  • Mengurangi latensi saat melakukan serangkaian panggilan mutasi

Catatan: Hanya resource yang mendukung transaksi atomik yang disertakan, sehingga metode ini tidak dapat mengganti semua panggilan ke masing-masing layanan.

Manfaat Transaksi Atomik

Atomisitas membuat penanganan error jauh lebih mudah. Jika Anda melakukan serangkaian perubahan dan salah satunya gagal, hal tersebut dapat menyebabkan akun dalam status tidak konsisten. Dengan atomisitas, Anda mencapai status yang dipilih secara langsung, atau permintaan gagal dan Anda dapat mencoba lagi.

Nama Sumber Daya Sementara

Nama resource sementara adalah jenis nama resource khusus yang digunakan untuk membuat resource dan mereferensikan resource tersebut dalam permintaan yang sama. Misalnya, jika anggaran kampanye dibuat dengan resourceName yang sama dengan customers/123/campaignBudgets/-1, nama resource tersebut dapat digunakan kembali di kolom Campaign.budget dalam permintaan yang sama. Dengan begitu, kedua resource tersebut akan dibuat dan ditautkan secara atomik.

Untuk membuat nama resource sementara, masukkan angka negatif di bagian nama yang biasanya akan dialokasikan oleh server.

Catatan:

  • Resource harus dibuat dengan nama sementara sebelum namanya dapat digunakan kembali. Misalnya, contoh Anggaran+Kampanye+Kampanye sebelumnya akan gagal jika urutan mutasi dibatalkan.
  • Nama sementara tidak diingat di seluruh permintaan.
  • Tidak ada batasan jumlah nama sementara dalam permintaan.
  • Setiap nama sementara harus menggunakan angka negatif unik, meskipun jenis resourcenya berbeda.

Lambat

Penting untuk mengelompokkan mutasi berdasarkan jenis resource atau permintaan mungkin kehabisan waktu dan gagal. Latensi kurang lebih sama dengan serangkaian panggilan ke metode mutasi individual, dengan setiap perubahan jenis resource merupakan panggilan baru. Misalnya, memutasikan 10 kampanye, lalu 10 grup iklan sama seperti 2 panggilan, sedangkan memutasikan 1 kampanye, 1 grup iklan, 1 kampanye, 1 grup iklan sama seperti 4 panggilan.

{i>Error<i} <u}{u>u<i}{u>u<i}{u> Silakan{i> <i}"AdCustomizerErrorAdErrorAdGroupAdErrorAdGroupCriterionErrorAdGroupErrorAssetErrorAuthenticationErrorAuthorizationErrorBiddingErrorCampaignBudgetErrorCampaignCriterionErrorCampaignErrorCampaignExperimentErrorCampaignSharedSetErrorCollectionSizeErrorContextErrorConversionActionErrorCriterionErrorCustomerFeedErrorDatabaseErrorDateErrorDateRangeErrorDistinctErrorExtensionFeedItemErrorExtensionSettingErrorFeedAttributeReferenceErrorFeedErrorFeedItemErrorFeedItemSetErrorFieldErrorFieldMaskErrorFunctionParsingErrorHeaderErrorImageErrorInternalErrorKeywordPlanAdGroupKeywordErrorKeywordPlanCampaignErrorKeywordPlanErrorLabelErrorListOperationErrorMediaUploadErrorMutateErrorNewResourceCreationErrorNullErrorOperationAccessDeniedErrorPolicyFindingErrorPolicyViolationErrorQuotaErrorRangeErrorRequestErrorResourceCountLimitExceededErrorSettingErrorSharedSetErrorSizeLimitErrorStringFormatErrorStringLengthErrorUrlFieldErrorUserListErrorYoutubeVideoRegistrationError

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Wajib. ID pelanggan yang resource-nya diubah.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "mutateOperations": [
    {
      object (MutateOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
Kolom
mutateOperations[]

object (MutateOperation)

Wajib. Daftar operasi yang akan dilakukan pada setiap resource.
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.
responseContentType

enum (ResponseContentType)

Setelan jenis konten respons. Menentukan apakah resource yang dapat berubah atau hanya nama resource yang harus ditampilkan setelah mutasi. Resource yang dapat diubah hanya akan ditampilkan jika resource memiliki kolom respons yang sesuai. Misalnya, MutateCampaignResult.campaign.

Isi respons

Pesan respons untuk GoogleAdsService.Mutate.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "partialFailureError": {
    object (Status)
  },
  "mutateOperationResponses": [
    {
      object (MutateOperationResponse)
    }
  ]
}
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.
mutateOperationResponses[]

object (MutateOperationResponse)

Semua respons untuk mutasi.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.