Uwaga: przeglądasz dokumentację interfejsu REST interfejsu API. Większość oficjalnych bibliotek klienta używa gRPC. Więcej informacji znajdziesz we wprowadzeniu do REST.

Ta strona została przetłumaczona przez Cloud Translation API.

CampaignBudget

Zapis JSON
BudgetStatus
BudgetDeliveryMethod
BudgetPeriod
BudgetType

Budżet kampanii.

Zapis JSON

Zapis JSON
{ "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
}

Pola
`resourceName`	`string` Stałe. Nazwa zasobu budżetu kampanii. Nazwy zasobów budżetu kampanii mają postać: `customers/{customerId}/campaignBudgets/{campaign_budget_id}`
`status`	`enum (BudgetStatus)` Tylko dane wyjściowe. Stan budżetu kampanii. To pole jest tylko do odczytu.
`deliveryMethod`	`enum (BudgetDeliveryMethod)` Metoda wyświetlania, która określa tempo wydawania budżetu kampanii. Jeśli nie określono inaczej w operacji tworzenia, wartość domyślna to STANDARD.
`period`	`enum (BudgetPeriod)` Stałe. Okres, w którym zostanie wykorzystany budżet. Jeśli nie zostanie określony, przyjmuje się, że domyślnie jest to DAILY.
`type`	`enum (BudgetType)` Stałe. Typ budżetu kampanii.
`alignedBiddingStrategyId`	`string (int64 format)` Identyfikator strategii portfolio ustalania stawek, z którą powiązany jest budżet tej kampanii wspólnego. Po dopasowaniu strategii ustalania stawek do budżetu kampanii są one powiązane z tym samym zestawem kampanii. Po dopasowaniu budżetu kampanii do strategii ustalania stawek kampanie dodawane do budżetu kampanii też muszą korzystać z tej samej strategii.
`id`	`string (int64 format)` Tylko dane wyjściowe. Identyfikator budżetu kampanii. Budżet kampanii jest tworzony za pomocą operacji tworzenia CampaignBudgetService i przypisywany do niego identyfikator budżetu. Identyfikator budżetu może być używany przez różne kampanie. System będzie następnie rozdzielał budżet kampanii między różne kampanie, aby zapewnić jak najlepsze wyniki.
`name`	`string` Nazwa budżetu kampanii. Przy tworzeniu budżetu kampanii za pomocą usługi CampaignBudgetService nazwa każdego bezpośrednio udostępnianego budżetu kampanii nie może mieć pustej wartości i nie może mieć wartości null. Budżety kampanii, które nie są wyraźnie wspólne, ich nazwy pochodzą z nazwy dołączonej kampanii. Musi on mieścić się w zakresie od 1 do 255 bajtów w formacie UTF-8 (z przycięciem).
`amountMicros`	`string (int64 format)` Kwota budżetu w walucie lokalnej konta. Kwotę podaje się w mikro, gdzie milion to jedna jednostka waluty. Wydatki miesięczne są ograniczone do 30,4 raza więcej.
`totalAmountMicros`	`string (int64 format)` Kwota budżetu od początku śledzenia w walucie lokalnej konta. Kwotę podaje się w mikro, gdzie milion to jedna jednostka waluty.
`explicitlyShared`	`boolean` Określa, czy budżet jest jawnie wspólny. Jeśli nie określono inaczej w operacji tworzenia, wartość domyślna to true (prawda). Jeśli wartość to prawda, budżet został utworzony w celu wykorzystania go na co najmniej 1 kampanię. Jeśli wartość to fałsz, budżet został utworzony tylko w celu wykorzystania go w jednej kampanii. Nazwa i stan budżetu będą synchronizowane z nazwą i stanem kampanii. Próba udostępnienia budżetu drugiej kampanii zakończy się błędem. Budżet inny niż wspólny może stać się jawnie udostępniany. Ta sama operacja musi też przypisać nazwę budżetowi. Budżet wspólny kampanii nigdy nie może stać się udostępniany.
`referenceCount`	`string (int64 format)` Tylko dane wyjściowe. Liczba kampanii aktywnie korzystających z budżetu. To pole jest tylko do odczytu.
`hasRecommendedBudget`	`boolean` Tylko dane wyjściowe. Wskazuje, czy istnieje zalecany budżet dla tego budżetu kampanii. To pole jest tylko do odczytu.
`recommendedBudgetAmountMicros`	`string (int64 format)` Tylko dane wyjściowe. Zalecana kwota budżetu. Jeśli nie jest dostępna żadna rekomendacja, zostanie użyta kwota budżetu. Kwotę podaje się w mikro, gdzie milion to jedna jednostka waluty. To pole jest tylko do odczytu.
`recommendedBudgetEstimatedChangeWeeklyClicks`	`string (int64 format)` Tylko dane wyjściowe. Szacowana zmiana tygodniowej liczby kliknięć po zastosowaniu zalecanego budżetu. To pole jest tylko do odczytu.
`recommendedBudgetEstimatedChangeWeeklyCostMicros`	`string (int64 format)` Tylko dane wyjściowe. Szacowana zmiana kosztu tygodniowego w mikro po zastosowaniu zalecanego budżetu. Jeden milion to jedna jednostka waluty. To pole jest tylko do odczytu.
`recommendedBudgetEstimatedChangeWeeklyInteractions`	`string (int64 format)` Tylko dane wyjściowe. Szacowana zmiana tygodniowej liczby interakcji po zastosowaniu zalecanego budżetu. To pole jest tylko do odczytu.
`recommendedBudgetEstimatedChangeWeeklyViews`	`string (int64 format)` Tylko dane wyjściowe. Szacowana zmiana tygodniowej liczby wyświetleń po zastosowaniu zalecanego budżetu. To pole jest tylko do odczytu.

BudgetStatus

Możliwe stany budżetu.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
`ENABLED`	Budżet jest włączony.
`REMOVED`	Budżet został usunięty.

BudgetDeliveryMethod

Możliwe metody wyświetlania budżetu.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
`STANDARD`	Serwer budżetu będzie ograniczać wyświetlanie równomiernie w całym okresie.
`ACCELERATED`	Serwer budżetu nie będzie ograniczać wyświetlania reklam, a reklamy będą wyświetlać się tak szybko, jak to możliwe.

BudgetPeriod

Potencjalny okres budżetu.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
`DAILY`	Budżet dzienny.
`CUSTOM_PERIOD`	Budżet niestandardowy dodany ponownie w wersji 5. Budżetu niestandardowego można użyć z wartością total_amount, aby określić limit czasu trwania budżetu. Więcej informacji znajdziesz na https://support.google.com/google-ads/answer/6385083.

BudgetType

Możliwe typy budżetów.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
`STANDARD`	Typ budżetu do standardowego wykorzystania Google Ads. Ogranicza dzienne wydatki do dwukrotności określonej kwoty budżetu. Pełne informacje: https://support.google.com/google-ads/answer/6385083
`FIXED_CPA`	Typ budżetu ze stałym kosztem pozyskania (konwersjami). Pełne informacje: https://support.google.com/google-ads/answer/7528254 Ten typ jest obsługiwany tylko w kampaniach z typem kanału AdvertisingChannelType.DISPLAY (z wyłączeniem AdvertisingChannelSubType.DISPLAY_GMAIL), którego typ strategii ustalania stawek.TARGET_CPA i PaymentMode.conversions jest aktywny.
`SMART_CAMPAIGN`	Typ budżetu w kampanii inteligentnej. Pełne informacje: https://support.google.com/google-ads/answer/7653509 Ten typ jest obsługiwany tylko w kampaniach z wartością AdvertisingChannelType.SMART i AdvertisingChannelSubType.SMART_CAMPAIGN.
`LOCAL_SERVICES`	Typ budżetu w przypadku kampanii w Usługach Lokalnych. Pełne informacje: https://support.google.com/localservices/answer/7434558 Ten typ jest obsługiwany tylko w kampaniach z wartością AdvertisingChannelType.LOCAL_SERVICE.