- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- AccountBudgetProposalOperation
- MutateAccountBudgetProposalResult
- Deneyin.
Hesap bütçesi teklifleri oluşturur, günceller veya kaldırır. İşlem durumları döndürülür.
Atılan hataların listesi: AccountBudgetProposalError AuthenticationError AuthorizationError DatabaseError DateError FieldError FieldMaskError HeaderError InternalError MutateError QuotaErrorRequestErrorStringLengthError
HTTP isteği
POST https://googleads.googleapis.com/v14/customers/{customerId}/accountBudgetProposals:mutate
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
customerId |
Zorunlu. Müşterinin kimliği. |
İstek içeriği
İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:
JSON gösterimi |
---|
{
"operation": {
object ( |
Alanlar | |
---|---|
operation |
Zorunlu. Hesap düzeyinde bireysel bütçe teklifinde gerçekleştirilecek işlem. |
validateOnly |
Doğru değerine ayarlanırsa istek doğrulanır ancak yürütülmez. Sonuçlar değil, yalnızca hatalar döndürülür. |
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 ( |
Alanlar | |
---|---|
result |
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ı öneren tek bir işlem.
JSON gösterimi |
---|
{ "updateMask": string, // Union field |
Alanlar | |
---|---|
updateMask |
Hangi bütçe alanlarının değiştirileceğini belirleyen FieldMask. Bütçeler değiştirilebilir ancak bu tür değişiklikleri ö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. Diğer 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: |
operation alanı. Değiştirme işlemi. operation şunlardan yalnızca biri olabilir: |
|
create |
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 yapılan yeni teklif. Yeni teklif için kaynak adı beklenmiyor. |
remove |
Kaldırma işlemi: Kaldırılan teklif için şu biçimde bir kaynak adı beklenir:
|
MutateAccountBudgetProposalResult
Hesap bütçesi teklifinin sonucu değişir.
JSON gösterimi |
---|
{ "resourceName": string } |
Alanlar | |
---|---|
resourceName |
Başarılı işlemler için iade edildi. |