Внимание! Вы просматриваете документацию по интерфейсу REST API. Большинство наших официальных клиентских библиотек используют gRPC. Подробнее см. в разделе Введение в REST .

Эта страница переведена с помощью Cloud Translation API.

CampaignBudget

JSON-представление
Статус бюджета
Метод доставки бюджета
Бюджетный период
Тип бюджета

Бюджет кампании.

JSON-представление

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
}

Поля
`resourceName`	`string` Неизменный. Имя ресурса бюджета кампании. Имена ресурсов бюджета кампании имеют вид: `customers/{customerId}/campaignBudgets/{campaign_budget_id}`
`status`	`enum ( BudgetStatus )` Только вывод. Статус бюджета этой кампании. Это поле доступно только для чтения.
`deliveryMethod`	`enum ( BudgetDeliveryMethod )` Метод доставки, определяющий скорость расходования бюджета кампании. По умолчанию используется значение STANDARD, если оно не указано в операции создания.
`period`	`enum ( BudgetPeriod )` Неизменный. Период, в течение которого расходуется бюджет. По умолчанию ЕЖЕДНЕВНО, если не указано.
`type`	`enum ( BudgetType )` Неизменный. Тип бюджета кампании.
`alignedBiddingStrategyId`	`string ( int64 format)` Идентификатор пакетной стратегии назначения ставок, с которой связан этот общий бюджет кампании. Если стратегия назначения ставок и бюджет кампании совпадают, они привязываются к одному и тому же набору кампаний. После того как бюджет кампании будет согласован со стратегией назначения ставок, кампании, добавленные в бюджет кампании, также должны использовать согласованную стратегию назначения ставок.
`id`	`string ( int64 format)` Только вывод. Идентификатор бюджета кампании. Бюджет кампании создается с помощью операции создания CampaignBudgetService, и ему присваивается идентификатор бюджета. Идентификатор бюджета можно использовать в разных кампаниях; затем система распределит бюджет кампании между различными кампаниями для получения оптимальных результатов.
`name`	`string` Название бюджета кампании. При создании бюджета кампании с помощью CampaignBudgetService каждый явно общий бюджет кампании должен иметь непустое и непустое имя. Бюджеты кампаний, которые не являются общими явно, получают свое название от названия прикрепленной кампании. Длина этой строки должна быть от 1 до 255 включительно в байтах UTF-8 (обрезанная).
`amountMicros`	`string ( int64 format)` Сумма бюджета в местной валюте для счета. Сумма указывается в микромах, где один миллион соответствует одной денежной единице. Ежемесячные расходы ограничены суммой, в 30,4 раза превышающей эту сумму.
`totalAmountMicros`	`string ( int64 format)` Сумма бюджета за весь срок действия в местной валюте аккаунта. Сумма указывается в микромах, где один миллион соответствует одной денежной единице.
`explicitlyShared`	`boolean` Указывает, является ли бюджет явно общим. По умолчанию — true, если не указано в операции создания. Если это правда, бюджет был создан с целью его распределения между одной или несколькими кампаниями. Если значение равно false, бюджет был создан с намерением использовать его только в одной кампании. Название и статус бюджета будут синхронизироваться с названием и статусом кампании. Попытка разделить бюджет со второй кампанией приведет к ошибке. Необщий бюджет может стать явно общим. Эта же операция должна также присвоить бюджету имя. Общий бюджет кампании никогда не может стать неразделенным.
`referenceCount`	`string ( int64 format)` Только вывод. Количество кампаний, активно использующих бюджет. Это поле доступно только для чтения.
`hasRecommendedBudget`	`boolean` Только вывод. Указывает, существует ли рекомендуемый бюджет для этой кампании. Это поле доступно только для чтения.
`recommendedBudgetAmountMicros`	`string ( int64 format)` Только вывод. Рекомендуемая сумма бюджета. Если рекомендации недоступны, для нее будет установлена сумма бюджета. Сумма указывается в микромах, где один миллион соответствует одной денежной единице. Это поле доступно только для чтения.
`recommendedBudgetEstimatedChangeWeeklyClicks`	`string ( int64 format)` Только вывод. Предполагаемое изменение количества кликов за неделю при применении рекомендованного бюджета. Это поле доступно только для чтения.
`recommendedBudgetEstimatedChangeWeeklyCostMicros`	`string ( int64 format)` Только вывод. Предполагаемое изменение еженедельной стоимости в микронах при применении рекомендованного бюджета. Один миллион эквивалентен одной денежной единице. Это поле доступно только для чтения.
`recommendedBudgetEstimatedChangeWeeklyInteractions`	`string ( int64 format)` Только вывод. Предполагаемое изменение количества взаимодействий за неделю при применении рекомендованного бюджета. Это поле доступно только для чтения.
`recommendedBudgetEstimatedChangeWeeklyViews`	`string ( int64 format)` Только вывод. Предполагаемое изменение числа просмотров за неделю при применении рекомендованного бюджета. Это поле доступно только для чтения.

Статус бюджета

Возможные статусы бюджета.

Перечисления
`UNSPECIFIED`	Не указан.
`UNKNOWN`	Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
`ENABLED`	Бюджет включен.
`REMOVED`	Бюджет удален.

Метод доставки бюджета

Возможные способы доставки бюджета.

Перечисления
`UNSPECIFIED`	Не указан.
`UNKNOWN`	Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
`STANDARD`	Сервер бюджета будет регулировать обслуживание равномерно в течение всего периода времени.
`ACCELERATED`	Бюджетный сервер не будет ограничивать показ, и объявления будут показываться максимально быстро.

Бюджетный период

Возможный период действия бюджета.

Перечисления
`UNSPECIFIED`	Не указан.
`UNKNOWN`	Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
`DAILY`	Ежедневный бюджет.
`CUSTOM_PERIOD`	Пользовательский бюджет, добавленный еще в V5. Пользовательский бюджет можно использовать с total_amount, чтобы указать лимит бюджета на весь срок действия. Дополнительную информацию см. на странице https://support.google.com/google-ads/answer/6385083 .

Тип бюджета

Возможные типы бюджета.

Перечисления
`UNSPECIFIED`	Не указан.
`UNKNOWN`	Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
`STANDARD`	Тип бюджета для стандартного использования Google Рекламы. Ежедневные ограничения тратят в два раза больше указанной суммы бюджета. Полная информация: https://support.google.com/google-ads/answer/6385083 .
`FIXED_CPA`	Тип бюджета с фиксированной ценой за приобретение (конверсию). Полная информация: https://support.google.com/google-ads/answer/7528254 . Этот тип поддерживается только кампаниями с AdvertisingChannelType.DISPLAY (исключая AdvertisingChannelSubType.DISPLAY_GMAIL), BiddingStrategyType.TARGET_CPA и PaymentMode.CONVERSIONS.
`SMART_CAMPAIGN`	Тип бюджета для умной кампании. Полная информация: https://support.google.com/google-ads/answer/7653509 . Этот тип поддерживается только кампаниями с AdvertisingChannelType.SMART и AdvertisingChannelSubType.SMART_CAMPAIGN.
`LOCAL_SERVICES`	Тип бюджета для кампании местных услуг. Полная информация: https://support.google.com/localservices/answer/7434558 . Этот тип поддерживается только кампаниями с AdvertisingChannelType.LOCAL_SERVICES.