Dikkat: API'nin REST arayüzüyle ilgili dokümanları görüntülüyorsunuz. Resmi istemci kitaplıklarımızın çoğu gTB kullanır. Ayrıntılar için REST Tanıtımı'nı inceleyin.

Bu sayfa, Cloud Translation API ile çevrilmiştir.

CampaignBudget

JSON gösterimi
BudgetStatus
BudgetDeliveryMethod
BudgetPeriod
BudgetType

Kampanya bütçesi.

JSON gösterimi

JSON gösterimi
{ "resourceName": string, "status": enum (`BudgetStatus`), "deliveryMethod": enum (`BudgetDeliveryMethod`), "period": enum (`BudgetPeriod`), "type": enum (`BudgetType`), "alignedBiddingStrategyId": string, "id": string, "name": string, "amountMicros": string, "totalAmountMicros": string, "explicitlyShared": boolean, "referenceCount": string, "hasRecommendedBudget": boolean, "recommendedBudgetAmountMicros": string, "recommendedBudgetEstimatedChangeWeeklyClicks": string, "recommendedBudgetEstimatedChangeWeeklyCostMicros": string, "recommendedBudgetEstimatedChangeWeeklyInteractions": string, "recommendedBudgetEstimatedChangeWeeklyViews": string }

{
  "resourceName": string,
  "status": enum (BudgetStatus),
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "type": enum (BudgetType),
  "alignedBiddingStrategyId": string,
  "id": string,
  "name": string,
  "amountMicros": string,
  "totalAmountMicros": string,
  "explicitlyShared": boolean,
  "referenceCount": string,
  "hasRecommendedBudget": boolean,
  "recommendedBudgetAmountMicros": string,
  "recommendedBudgetEstimatedChangeWeeklyClicks": string,
  "recommendedBudgetEstimatedChangeWeeklyCostMicros": string,
  "recommendedBudgetEstimatedChangeWeeklyInteractions": string,
  "recommendedBudgetEstimatedChangeWeeklyViews": string
}

Alanlar
`resourceName`	`string` Sabit. Kampanya bütçesinin kaynak adı. Kampanya bütçe kaynak adları şu biçimdedir: `customers/{customerId}/campaignBudgets/{campaign_budget_id}`
`status`	`enum (BudgetStatus)` Yalnızca çıkış. Bu kampanya bütçesinin durumu. Bu alan salt okunurdur.
`deliveryMethod`	`enum (BudgetDeliveryMethod)` Kampanya bütçesinin harcanma oranını belirleyen yayınlanma yöntemi. Bir oluşturma işleminde belirtilmezse varsayılan olarak STANDARD değerine ayarlanır.
`period`	`enum (BudgetPeriod)` Sabit. Bütçenin harcanacağı dönem. Belirtilmezse varsayılan olarak DAILY değerine ayarlanır.
`type`	`enum (BudgetType)` Sabit. Kampanya bütçesinin türü.
`alignedBiddingStrategyId`	`string (int64 format)` Bu paylaşılan kampanya bütçesinin uyumlu olduğu portföy teklifi stratejisinin kimliği. Teklif stratejisi ve kampanya bütçesi uyumlu hale geldiğinde, aynı kampanya grubuna eklenirler. Kampanya bütçesi bir teklif stratejisiyle uyumlu hale getirildikten sonra, kampanya bütçesine eklenen kampanyalarda da uyumlu teklif stratejisi kullanılmalıdır.
`id`	`string (int64 format)` Yalnızca çıkış. Kampanya bütçesinin kimliği. Kampanya bütçesi, CampaignBudgetService oluşturma işlemi kullanılarak oluşturulur ve bu bütçeye bütçe kimliği atanır. Bütçe kimliği farklı kampanyalar arasında paylaşılabilir. Sistem, en uygun sonuçları elde etmek için kampanya bütçesini farklı kampanyalar arasında paylaştırır.
`name`	`string` Kampanya bütçesinin adı. CampaignBudgetService aracılığıyla bir kampanya bütçesi oluştururken, açık olarak paylaşılan her kampanya bütçesinin boş olmayan bir ada sahip olması gerekir. Açıkça paylaşılmayan kampanya bütçeleri, adlarını ekli kampanyanın adından alır. Bu dizenin uzunluğu 1 ile 255 arasında (UTF-8 baytlar dahil) (kırpılmış) olmalıdır.
`amountMicros`	`string (int64 format)` Hesabın yerel para birimindeki bütçe tutarı. Tutar, mikro cinsinden belirtilir. Burada bir milyon, bir para birimine eşittir. Aylık harcama, bu tutarın 30,4 katıyla sınırlıdır.
`totalAmountMicros`	`string (int64 format)` Hesabın yerel para biriminde bütçenin kullanım süresi tutarı. Tutar, mikro cinsinden belirtilir. Burada bir milyon, bir para birimine eşittir.
`explicitlyShared`	`boolean` Bütçenin açıkça paylaşılıp paylaşılmadığını belirtir. Bir oluşturma işleminde belirtilmezse varsayılan olarak doğru değerini alır. Bu değer true (doğru) ise bütçe, bir veya daha fazla kampanya arasında paylaşım amacıyla oluşturulmuştur. Yanlış ise, bütçe yalnızca tek bir kampanyayla kullanılmak amacıyla oluşturulmuştur. Bütçenin adı ve durumu, kampanyanın adı ve durumuyla senkronize kalır. Bütçe ikinci bir kampanyayla paylaşılmaya çalışılırsa hatayla sonuçlanır. Paylaşılmayan bütçe, açık bir şekilde paylaşılan bir bütçe haline gelebilir. Aynı işlem, bütçeye bir ad da atamalıdır. Paylaşılan bir kampanya bütçesi hiçbir zaman paylaşılmayan bir bütçeye dönüşemez.
`referenceCount`	`string (int64 format)` Yalnızca çıkış. Bütçeyi aktif olarak kullanan kampanyaların sayısı. Bu alan salt okunurdur.
`hasRecommendedBudget`	`boolean` Yalnızca çıkış. Bu kampanya bütçesi için önerilen bir bütçe olup olmadığını belirtir. Bu alan salt okunurdur.
`recommendedBudgetAmountMicros`	`string (int64 format)` Yalnızca çıkış. Önerilen bütçe tutarı. Herhangi bir öneri yoksa bütçe tutarına ayarlanır. Tutar, mikro cinsinden belirtilir. Burada bir milyon, bir para birimine eşittir. Bu alan salt okunurdur.
`recommendedBudgetEstimatedChangeWeeklyClicks`	`string (int64 format)` Yalnızca çıkış. Önerilen bütçenin uygulanması durumunda haftalık tıklama sayısındaki tahmini değişim. Bu alan salt okunurdur.
`recommendedBudgetEstimatedChangeWeeklyCostMicros`	`string (int64 format)` Yalnızca çıkış. Önerilen bütçenin uygulanması durumunda haftalık maliyetteki tahmini değişim (mikrosaniye cinsinden). Bir milyon, bir para birimine karşılık gelir. Bu alan salt okunurdur.
`recommendedBudgetEstimatedChangeWeeklyInteractions`	`string (int64 format)` Yalnızca çıkış. Önerilen bütçe uygulanırsa haftalık etkileşim sayısındaki tahmini değişim. Bu alan salt okunurdur.
`recommendedBudgetEstimatedChangeWeeklyViews`	`string (int64 format)` Yalnızca çıkış. Önerilen bütçenin uygulanması durumunda haftalık görüntüleme sayısındaki tahmini değişim. Bu alan salt okunurdur.

BudgetStatus

Bütçenin olası durumları.

Sıralamalar
`UNSPECIFIED`	Belirtilmedi.
`UNKNOWN`	Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
`ENABLED`	Bütçe etkinleştirildi.
`REMOVED`	Bütçe kaldırıldı.

BudgetDeliveryMethod

Bütçenin olası yayınlama yöntemleri.

Sıralamalar
`UNSPECIFIED`	Belirtilmedi.
`UNKNOWN`	Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
`STANDARD`	Bütçe sunucusu, sunumu tüm dönem boyunca eşit şekilde kısıtlar.
`ACCELERATED`	Bütçe sunucusu sunumu kısıtlamaz ve reklamlar mümkün olduğunca hızlı yayınlanır.

BudgetPeriod

Bütçenin olası dönemi.

Sıralamalar
`UNSPECIFIED`	Belirtilmedi.
`UNKNOWN`	Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
`DAILY`	Günlük bütçe.
`CUSTOM_PERIOD`	Özel bütçe, V5'te tekrar eklendi. Özel bütçe, ömür boyu bütçe sınırını belirtmek için total_amount ile birlikte kullanılabilir. Daha fazla bilgi için https://support.google.com/google-ads/answer/6385083 adresini ziyaret edin.

BudgetType

Olası Bütçe türleri.

Sıralamalar
`UNSPECIFIED`	Belirtilmedi.
`UNKNOWN`	Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
`STANDARD`	Standart Google Ads kullanımı için bütçe türü. Günlük harcamayı, belirtilen bütçe tutarının iki katıyla sınırlar. Tüm ayrıntıları şu adreste bulabilirsiniz: https://support.google.com/google-ads/answer/6385083
`FIXED_CPA`	Sabit bir edinme başına maliyete (dönüşüm) sahip bütçe türü. Tüm ayrıntıları şu adreste bulabilirsiniz: https://support.google.com/google-ads/answer/7528254 Bu tür yalnızca, AdvertisingChannelType.DISPLAY (AdvertisingChannelSubType.DISPLAY_GMAIL hariç), BiddingStratejiType.TARGET_CPA ve PaymentMode.CONVERSIONS gösterim içeren kampanyalar tarafından desteklenir.
`SMART_CAMPAIGN`	Akıllı Kampanya için bütçe türü. Tüm ayrıntıları şu adreste bulabilirsiniz: https://support.google.com/google-ads/answer/7653509 Bu tür yalnızca AdvertisingChannelType.SMART ve AdvertisingChannelSubType.SMART_CAMPAIGN olan kampanyalar tarafından desteklenir.
`LOCAL_SERVICES`	Yerel Hizmet Kampanyasının bütçe türü. Ayrıntılı bilgi: https://support.google.com/localservices/answer/7434558 Bu tür yalnızca AdvertisingChannelType.LOCAL_SERVICE olan kampanyalar tarafından desteklenir.