Cuidado: você está vendo a documentação da interface REST da API. A maioria das nossas bibliotecas de cliente oficiais usa o gRPC. Consulte Introdução ao REST para ver mais detalhes.

Esta página foi traduzida pela API Cloud Translation.

CampaignBudget

Representação JSON
BudgetStatus
BudgetDeliveryMethod
BudgetPeriod
BudgetType

Um orçamento de campanha.

Representação JSON

Representação 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
}

Campos
`resourceName`	`string` Imutável. O nome do recurso do orçamento da campanha. Os nomes dos recursos de orçamento da campanha têm o seguinte formato: `customers/{customerId}/campaignBudgets/{campaign_budget_id}`
`status`	`enum (BudgetStatus)` Apenas saída. O status do orçamento dessa campanha. Este campo é somente leitura.
`deliveryMethod`	`enum (BudgetDeliveryMethod)` O método de exibição que determina a taxa em que o orçamento da campanha é gasto. O padrão será "STANDARD" se não for especificado em uma operação de criação.
`period`	`enum (BudgetPeriod)` Imutável. Período em que o orçamento será usado. O padrão será DIÁRIO se não for especificado.
`type`	`enum (BudgetType)` Imutável. Tipo de orçamento da campanha.
`alignedBiddingStrategyId`	`string (int64 format)` ID da estratégia de lances de portfólio com que este orçamento de campanha compartilhado está alinhado. Quando uma estratégia de lances e um orçamento de campanha estão alinhados, eles são anexados ao mesmo conjunto de campanhas. Depois que o orçamento de uma campanha estiver alinhado a uma estratégia de lances, as campanhas adicionadas a ele também precisarão usar a estratégia de lances alinhada.
`id`	`string (int64 format)` Apenas saída. O ID do orçamento da campanha. Um orçamento de campanha é criado usando a operação de criação CampaignBudgetService e recebe um ID de orçamento. Um ID do orçamento pode ser compartilhado entre campanhas diferentes. O sistema vai alocar o orçamento entre diferentes campanhas para alcançar os melhores resultados.
`name`	`string` Nome do orçamento da campanha. Ao criar um orçamento de campanha por meio de CampaignBudgetService, todo orçamento de campanha explicitamente compartilhado deve ter um nome não nulo e não vazio. Os orçamentos de campanha que não são explicitamente compartilhados derivam o nome deles da campanha anexada. A string precisa estar entre 1 e 255, inclusive, em bytes UTF-8 (cortados).
`amountMicros`	`string (int64 format)` É o valor do orçamento, na moeda local da conta. O valor é especificado em micros, em que um milhão é equivalente a uma unidade monetária. O gasto mensal é limitado a 30,4 vezes esse valor.
`totalAmountMicros`	`string (int64 format)` Mostra o valor da vida útil do orçamento, na moeda local da conta. O valor é especificado em micros, em que um milhão é equivalente a uma unidade monetária.
`explicitlyShared`	`boolean` Especifica se o orçamento é compartilhado explicitamente. O padrão será "true" se não for especificado em uma operação de criação. Se verdadeiro, o orçamento foi criado com o propósito de compartilhamento em uma ou mais campanhas. Se for falso, o orçamento foi criado com a intenção de ser usado apenas com uma única campanha. O nome e o status do orçamento continuarão sincronizados com o da campanha. A tentativa de compartilhar o orçamento com uma segunda campanha resultará em um erro. Um orçamento não compartilhado pode se tornar explicitamente compartilhado. A mesma operação também precisa atribuir um nome ao orçamento. Um orçamento de campanha compartilhado nunca pode se tornar não compartilhado.
`referenceCount`	`string (int64 format)` Apenas saída. O número de campanhas que usam o orçamento ativamente. Este campo é somente leitura.
`hasRecommendedBudget`	`boolean` Apenas saída. Indica se há um orçamento recomendado para esse orçamento de campanha. Este campo é somente leitura.
`recommendedBudgetAmountMicros`	`string (int64 format)` Apenas saída. É o valor do orçamento recomendado. Se nenhuma recomendação estiver disponível, o valor do orçamento será definido. O valor é especificado em micros, em que um milhão é equivalente a uma unidade monetária. Este campo é somente leitura.
`recommendedBudgetEstimatedChangeWeeklyClicks`	`string (int64 format)` Apenas saída. A alteração estimada nos cliques semanais se o orçamento recomendado for aplicado. Este campo é somente leitura.
`recommendedBudgetEstimatedChangeWeeklyCostMicros`	`string (int64 format)` Apenas saída. A alteração estimada no custo semanal em micros se o orçamento recomendado for aplicado. Um milhão é equivalente a uma unidade monetária. Este campo é somente leitura.
`recommendedBudgetEstimatedChangeWeeklyInteractions`	`string (int64 format)` Apenas saída. A alteração estimada nas interações semanais se o orçamento recomendado for aplicado. Este campo é somente leitura.
`recommendedBudgetEstimatedChangeWeeklyViews`	`string (int64 format)` Apenas saída. A alteração estimada nas visualizações semanais se o orçamento recomendado for aplicado. Este campo é somente leitura.

BudgetStatus

Status possíveis de um orçamento.

Enums
`UNSPECIFIED`	Não especificado.
`UNKNOWN`	Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão.
`ENABLED`	O orçamento está ativado.
`REMOVED`	O orçamento é removido.

BudgetDeliveryMethod

Possíveis métodos de exibição de um orçamento.

Enums
`UNSPECIFIED`	Não especificado.
`UNKNOWN`	Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão.
`STANDARD`	O servidor de orçamentos controlará o serviço de forma equilibrada durante todo o período.
`ACCELERATED`	O servidor de orçamentos não limitará a veiculação, e os anúncios serão veiculados o mais rápido possível.

BudgetPeriod

Período possível de um orçamento.

Enums
`UNSPECIFIED`	Não especificado.
`UNKNOWN`	Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão.
`DAILY`	Orçamento diário.
`CUSTOM_PERIOD`	Orçamento personalizado, adicionado novamente na V5. O orçamento personalizado pode ser usado com total_amount para especificar o limite do orçamento da vida útil. Consulte: https://support.google.com/google-ads/answer/6385083 para mais informações.

BudgetType

Possíveis tipos de orçamento.

Enums
`UNSPECIFIED`	Não especificado.
`UNKNOWN`	Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão.
`STANDARD`	Tipo de orçamento para uso padrão do Google Ads. Limita o gasto diário duas vezes o valor do orçamento especificado. Detalhes completos: https://support.google.com/google-ads/answer/6385083
`FIXED_CPA`	Tipo de orçamento com um custo por aquisição (conversão) fixo. Detalhes completos: https://support.google.com/google-ads/answer/7528254 Esse tipo só é compatível com campanhas com AdvertisingChannelType.DISPLAY (exceto AdvertisingChannelSubType.DISPLAY_ histórico), BiddingStrategyType.TARGET_CPA e PaymentMode.conversions.
`SMART_CAMPAIGN`	Tipo de orçamento da campanha inteligente. Detalhes completos: https://support.google.com/google-ads/answer/7653509 Esse tipo só é compatível com campanhas com AdvertisingChannelType.SMART e AdvertisingChannelSubType.SMART_CAMPAIGN.
`LOCAL_SERVICES`	Tipo de orçamento para campanha dos Serviços Locais. Mais detalhes: https://support.google.com/localservices/answer/7434558 Esse tipo só é compatível com campanhas com AdvertisingChannelType.LOCAL_solutions.