Membuat, memperbarui, atau menghapus resource. Metode ini mendukung transaksi atomik dengan beberapa jenis resource. Misalnya, Anda dapat membuat kampanye dan anggaran kampanye secara atomik, atau melakukan hingga ribuan mutasi secara atomik.
Metode ini pada dasarnya adalah wrapper di sekitar serangkaian metode mutasi. Satu-satunya fitur yang ditawarkannya untuk memanggil metode tersebut secara langsung adalah:
- Transaksi atomik
- Nama resource sementara (dijelaskan di bawah)
- Mengurangi latensi untuk melakukan serangkaian panggilan mutasi
Catatan: Hanya resource yang mendukung transaksi atom yang disertakan, sehingga metode ini tidak dapat mengganti semua panggilan ke setiap layanan.
Manfaat Transaksi Atomik
Atomisitas membuat penanganan error jauh lebih mudah. Jika Anda membuat serangkaian perubahan dan satu perubahan gagal, hal ini dapat membuat akun Anda dalam keadaan tidak konsisten. Dengan atomicity, Anda dapat langsung menjangkau status yang dipilih, atau permintaan akan gagal dan Anda dapat mencoba lagi.
Nama Resource 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 setara dengan customers/123/campaignBudgets/-1
, nama resource tersebut dapat digunakan kembali di kolom Campaign.budget
dalam permintaan yang sama. Dengan begitu, kedua resource dibuat dan ditautkan secara atomik.
Untuk membuat nama resource sementara, masukkan angka negatif di bagian nama yang biasanya akan dialokasikan server.
Catatan:
- Resource harus dibuat dengan nama sementara sebelum nama tersebut dapat digunakan kembali. Misalnya, contoh CampaignBudget+Campaign 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 yang unik, meskipun jenis resource berbeda.
Latensi
Penting untuk mengelompokkan mutasi berdasarkan jenis resource. Jika tidak, permintaan dapat kehabisan waktu dan gagal. Latensi kurang lebih sama dengan serangkaian panggilan ke metode mutasi individual, dengan setiap perubahan dalam jenis resource adalah panggilan baru. Misalnya, mengubah 10 kampanye, lalu 10 grup iklan akan menjadi seperti 2 panggilan, sedangkan mengubah 1 kampanye, 1 grup iklan, 1 kampanye, dan 1 grup iklan sama seperti 4 panggilan.
Errors{i>Error<i}Dimasukkan {60Fle-baris}{i>Error<i}6{i>Error<i}stafopsi{i><b}{bi}{b>DisgustError1{i>Error<i}Dirata-rata{i>3{/13{/13{/13{/13{/23-rata-rata{/13AdCustomizerErrorAdErrorAdGroupAdErrorAdGroupCriterionErrorAdGroupErrorAssetErrorAuthorizationErrorBiddingErrorCampaignBudgetErrorCampaignCriterionErrorCampaignErrorCampaignExperimentErrorCampaignSharedSetErrorCollectionSizeErrorContextErrorConversionActionErrorCriterionErrorCustomerFeedErrorDatabaseErrorDateErrorDateRangeErrorDistinctErrorExtensionFeedItemErrorExtensionSettingErrorFeedAttributeReferenceErrorFeedErrorFeedItemErrorFeedItemSetErrorFieldErrorFieldMaskErrorFunctionParsingErrorHeaderErrorImageErrorInternalErrorKeywordPlanAdGroupKeywordErrorKeywordPlanCampaignErrorKeywordPlanErrorLabelErrorListOperationErrorMediaUploadErrorMutateErrorNewResourceCreationErrorNullErrorOperationAccessDeniedErrorPolicyFindingErrorPolicyViolationErrorQuotaErrorRangeErrorRequestErrorResourceCountLimitExceededErrorSettingErrorSharedSetErrorSizeLimitErrorStringFormatErrorStringLengthErrorUrlFieldErrorUserListErrorYoutubeVideoRegistrationError
Permintaan HTTP
POST https://googleads.googleapis.com/v14/customers/{customerId}/googleAds:mutate
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
customerId |
Wajib. ID pelanggan yang resource-nya diubah. |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "mutateOperations": [ { object ( |
Kolom | |
---|---|
mutateOperations[] |
Wajib. Daftar operasi yang akan dilakukan pada resource individual. |
partialFailure |
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 |
Jika true (benar), permintaan akan divalidasi tetapi tidak dieksekusi. Hanya error yang ditampilkan, bukan hasil. |
responseContentType |
Setelan jenis konten respons. Menentukan apakah resource yang dapat berubah atau hanya nama resource yang harus ditampilkan setelah mutasi. Resource yang dapat berubah 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 ( |
Kolom | |
---|---|
partialFailureError |
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[] |
Semua respons untuk mutate. |
Cakupan otorisasi
Memerlukan cakupan OAuth berikut ini:
https://www.googleapis.com/auth/adwords
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.