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` Niezmienne. 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 częstotliwość wydawania budżetu kampanii. Jeśli nie określono inaczej w operacji tworzenia, przyjmuje się wartość domyślną STANDARD.
`period`	`enum (BudgetPeriod)` Niezmienne. Okres, w którym ma zostać wydany budżet. Jeśli nie zostanie określony, domyślna wartość to DAILY.
`type`	`enum (BudgetType)` Niezmienne. Typ budżetu kampanii.
`alignedBiddingStrategyId`	`string (int64 format)` Identyfikator strategii portfolio ustalania stawek, z którą powiązany jest budżet kampanii wspólnego. Gdy strategia ustalania stawek i budżet kampanii są zgodne, są one powiązane z tym samym zestawem kampanii. Gdy budżet kampanii jest dopasowany do strategii ustalania stawek, kampanie dodawane do budżetu kampanii również muszą korzystać z tej strategii.
`id`	`string (int64 format)` Tylko dane wyjściowe. Identyfikator budżetu kampanii. Budżet kampanii jest tworzony za pomocą usługi CampaignBudgetService i przypisywany do niego identyfikator budżetu. Identyfikator budżetu może być używany przez różne kampanie. System rozdziela budżet kampanii między różne kampanie w celu uzyskania optymalnych wyników.
`name`	`string` Nazwa budżetu kampanii. Gdy tworzysz budżet kampanii za pomocą usługi CampaignBudgetService, każdy bezpośrednio wspólny budżet kampanii musi mieć niepustą nazwę. Budżety kampanii, które nie są wyraźnie wspólne, wywodzą nazwę z nazwy powiązanej kampanii. Długość tego ciągu znaków musi mieścić się w przedziale od 1 do 255 (włącznie) w bajtach w formacie UTF-8 (z przycięciem).
`amountMicros`	`string (int64 format)` Kwota budżetu w walucie lokalnej konta. Kwota jest wyrażona 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. Kwota jest wyrażona w mikro, gdzie milion to jedna jednostka waluty.
`explicitlyShared`	`boolean` Określa, czy budżet jest bezpośrednio wspólny. Jeśli nie określono inaczej w operacji tworzenia, przyjmuje się wartość domyślną „true” (prawda). Jeśli ma wartość true (prawda), budżet został utworzony w celu wykorzystania go na co najmniej 1 kampanię. Jeśli ma wartość fałsz, budżet został utworzony z myślą o używaniu go tylko 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 nieudostępniany może zostać jawnie udostępniony. Ta sama operacja musi też przypisać nazwę budżetowi. Budżet wspólny kampanii nie może być 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, domyślnie przyjęta zostanie kwota budżetu. Kwota jest wyrażona 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 tygodniowego kosztu w mikro po zastosowaniu zalecanego budżetu. Jeden milion to równowartość jednej jednostki 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`	Służy tylko do zwracania wartości. 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`	Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
`STANDARD`	Serwer budżetu będzie równomiernie ograniczać wyświetlanie reklam w całym wybranym okresie.
`ACCELERATED`	Serwer budżetu nie będzie ograniczać wyświetlania reklam, a reklamy będą wyświetlane tak szybko, jak to możliwe.

BudgetPeriod

Potencjalny okres budżetu.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Służy tylko do zwracania wartości. 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 opcją total_amount, aby określić łączny limit budżetu. Więcej informacji znajdziesz na stronie https://support.google.com/google-ads/answer/6385083.

BudgetType

Możliwe typy budżetu.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
`STANDARD`	Typ budżetu do standardowego użytkowania Google Ads. Ogranicza dzienne wydatki do dwukrotności określonej kwoty budżetu. Szczegółowe informacje: https://support.google.com/google-ads/answer/6385083
`FIXED_CPA`	Typ budżetu ze stałym kosztem pozyskania (konwersją). Szczegółowe informacje: https://support.google.com/google-ads/answer/7528254 Ten typ jest obsługiwany tylko w kampaniach z typem kanału AdvertisingChannelType.DISPLAY (z wyjątkiem AdvertisingChannelSubType.DISPLAY_Gmail), określający typ strategii ustalania stawek.TARGET_CPA i PaymentMode.conversions.
`SMART_CAMPAIGN`	Typ budżetu w kampanii inteligentnej. Szczegółowe informacje: https://support.google.com/google-ads/answer/7653509 Ten typ jest obsługiwany tylko w kampaniach z AdvertisingChannelType.SMART i AdvertisingChannelSubType.SMART_CAMPAIGN.
`LOCAL_SERVICES`	Typ budżetu kampanii Usługi Lokalne. Szczegółowe informacje: https://support.google.com/localservices/answer/7434558 Ten typ jest obsługiwany tylko w kampaniach z AdvertisingChannelType.LOCAL_SERVICES.