Method: customers.accountBudgetProposals.mutate

Membuat, memperbarui, atau menghapus proposal anggaran akun. Status operasi ditampilkan.

Daftar error yang ditampilkan: AccountBudgetProposalError AuthenticationError AuthorizationError DatabaseError DateError FieldError FieldMaskError HeaderError InternalError MutateError QuotaError RequestErrorStringLengthError

Permintaan HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}/accountBudgetProposals:mutate

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Wajib. ID pelanggan.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "operation": {
    object (AccountBudgetProposalOperation)
  },
  "validateOnly": boolean
}
Kolom
operation

object (AccountBudgetProposalOperation)

Wajib. Operasi yang akan dilakukan pada proposal anggaran tingkat akun perorangan.
validateOnly

boolean

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

Isi respons

Pesan respons untuk operasi mutasi anggaran tingkat akun.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "result": {
    object (MutateAccountBudgetProposalResult)
  }
}
Kolom
result

object (MutateAccountBudgetProposalResult)

Hasil mutate.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

AccountBudgetProposalOperation

Satu tindakan untuk mengusulkan pembuatan anggaran tingkat akun baru atau mengedit/mengakhiri/menghapus anggaran yang ada.

Representasi JSON 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "create": {
    object (AccountBudgetProposal)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
Kolom
updateMask

string (FieldMask format)

FieldMask yang menentukan kolom anggaran yang diubah. Meskipun anggaran dapat diubah, proposal yang mengusulkan perubahan tersebut bersifat final. Oleh karena itu, operasi update tidak didukung untuk proposal.

Proposal yang mengubah anggaran memiliki jenis proposal 'perbarui'. Menentukan mask untuk jenis proposal lainnya dianggap sebagai error.

Ini adalah daftar yang dipisahkan koma yang berisi nama-nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".
Kolom union operation. Operasi mutasi. operation hanya ada berupa salah satu diantara berikut:
create

object (AccountBudgetProposal)

Membuat operasi: Proposal baru untuk membuat anggaran baru, mengedit anggaran yang ada, mengakhiri anggaran yang berjalan secara aktif, atau menghapus anggaran yang disetujui yang dijadwalkan untuk dimulai di masa mendatang. Tidak ada nama resource untuk proposal baru.
remove

string

Operasi penghapusan: Nama resource untuk proposal yang dihapus diharapkan, dalam format ini:

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id} Permintaan dapat dibatalkan jika tertunda.

MutateAccountBudgetProposalResult

Hasil untuk proposal anggaran akun berubah.

Representasi JSON 
{
  "resourceName": string
}
Kolom
resourceName

string

Dikembalikan untuk operasi yang berhasil.