Method: customers.accountBudgetProposals.mutate

Hesap bütçesi teklifleri oluşturur, günceller veya kaldırır. İşlem durumları döndürülür.

Verilen hataların listesi: AccountBudgetProposalError AuthenticationError AuthorizationError DatabaseError DateError FieldError FieldMaskError HeaderError InternalError MutateError QuotaErrorRequestErrorStringLengthError

HTTP isteği

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

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

Yol parametreleri

Parametreler
customerId

string

Zorunlu. Müşterinin kimliği.

İstek içeriği

İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:

JSON gösterimi 
{
  "operation": {
    object (AccountBudgetProposalOperation)
  },
  "validateOnly": boolean
}
Alanlar
operation

object (AccountBudgetProposalOperation)

Zorunlu. Hesap düzeyindeki tek bir bütçe teklifinde gerçekleştirilen işlem.
validateOnly

boolean

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

Hesap düzeyinde bütçe değiştirme işlemleri için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "result": {
    object (MutateAccountBudgetProposalResult)
  }
}
Alanlar
result

object (MutateAccountBudgetProposalResult)

Değişimin sonucu.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.

AccountBudgetProposalOperation

Hesap düzeyinde yeni bir bütçe oluşturulmasını veya mevcut bir bütçeyi düzenleme/sonlandırma/kaldırmayı önermek için kullanılan tek bir işlem.

JSON gösterimi 
{
  "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.
}
Alanlar
updateMask

string (FieldMask format)

Hangi bütçe alanlarının değiştirileceğini belirleyen FieldMask. Bütçeler üzerinde değişiklik yapılabilir ancak bu tür değişiklikler öneren teklifler nihaidir. Bu nedenle, güncelleme işlemleri teklifler için desteklenmez.

Bütçeleri değiştiren teklifler, "güncelleme" teklif türüne sahiptir. Başka herhangi bir teklif türü için maske belirtmek hata olarak kabul edilir.

Bu, tam nitelikli alan adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo".
Birleştirme alanı operation. Değiştirme işlemi. operation şunlardan yalnızca biri olabilir:
create

object (AccountBudgetProposal)

Oluşturma işlemi: Yeni bir bütçe oluşturmak, mevcut bir bütçeyi düzenlemek, aktif olarak çalışan bir bütçeyi sona erdirmek veya gelecekte başlayacak şekilde planlanmış onaylanmış bir bütçeyi kaldırmak için oluşturulan yeni teklif. Yeni teklif için kaynak adı beklenmiyor.
remove

string

Kaldırma işlemi: Kaldırılan teklif için şu biçimde bir kaynak adı olması beklenir:

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id} Beklemede olan istekler iptal edilebilir.

MutateAccountBudgetProposalResult

Hesap bütçesi teklifinin sonucu değişir.

JSON gösterimi 
{
  "resourceName": string
}
Alanlar
resourceName

string

Başarılı operasyonlar için iade edildi.