Precaución: Estás viendo la documentación de la interfaz REST de la API. La mayoría de nuestras bibliotecas cliente oficiales usan gRPC. Consulta la Introducción a REST para obtener más detalles.

Se usó la API de Cloud Translation para traducir esta página.

CampaignBudget

Representación JSON
BudgetStatus
BudgetDeliveryMethod
BudgetPeriod
BudgetType

El presupuesto de una campaña

Representación JSON

Representación 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` Inmutable. El nombre del recurso del presupuesto de la campaña. Los nombres de los recursos de presupuesto de la campaña tienen el siguiente formato: `customers/{customerId}/campaignBudgets/{campaign_budget_id}`
`status`	`enum (BudgetStatus)` Solo salida. El estado del presupuesto de esta campaña. Este campo es de solo lectura.
`deliveryMethod`	`enum (BudgetDeliveryMethod)` El método de publicación que determina el ritmo al que se invierte el presupuesto de la campaña. El valor predeterminado es STANDARD si no se especifica en una operación de creación.
`period`	`enum (BudgetPeriod)` Inmutable. Período en el que se debe invertir el presupuesto. El valor predeterminado es DAILY si no se especifica.
`type`	`enum (BudgetType)` Inmutable. Es el tipo del presupuesto de la campaña.
`alignedBiddingStrategyId`	`string (int64 format)` ID de la estrategia de oferta de cartera con la que está alineado el presupuesto de esta campaña compartida. Cuando una estrategia de ofertas y el presupuesto de una campaña están alineados, se vinculan al mismo conjunto de campañas. Después de que el presupuesto de una campaña se alinea con una estrategia de oferta, las campañas que se agregan al presupuesto de la campaña también deben usar la estrategia de ofertas alineada.
`id`	`string (int64 format)` Solo salida. El ID del presupuesto de la campaña Se crea un presupuesto de campaña con la operación de creación CampaignBudgetService y se le asigna un ID de presupuesto. Un ID de presupuesto se puede compartir entre diferentes campañas; el sistema luego asignará el presupuesto de la campaña entre diferentes campañas para obtener resultados óptimos.
`name`	`string` El nombre del presupuesto de la campaña Al crear un presupuesto de campaña mediante CampaignBudgetService, cada presupuesto de campaña compartido explícitamente debe tener un nombre que no sea nulo ni vacío. Los presupuestos de campaña que no se comparten explícitamente derivan su nombre del de la campaña adjunta. La longitud de esta string debe ser entre 1 y 255, inclusive, en bytes UTF-8 (recortada).
`amountMicros`	`string (int64 format)` El importe del presupuesto en la moneda local de la cuenta. El importe se especifica en micros, en el que un millón es equivalente a una unidad de moneda. El gasto mensual está limitado a 30.4 veces este importe.
`totalAmountMicros`	`string (int64 format)` Es el importe desde el principio del presupuesto, en la moneda local de la cuenta. El importe se especifica en micros, en el que un millón es equivalente a una unidad de moneda.
`explicitlyShared`	`boolean` Especifica si el presupuesto se comparte explícitamente. El valor predeterminado es verdadero si no se especifica en una operación de creación. Si es verdadero, el presupuesto se creó con el propósito de compartirlo en una o más campañas. Si es falso, el presupuesto se creó con la intención de usarse solo con una campaña. El nombre y el estado del presupuesto se mantendrán sincronizados con el nombre y el estado de la campaña. Si intentas compartir el presupuesto con otra campaña, se mostrará un error. Un presupuesto no compartido puede convertirse en un presupuesto compartido explícitamente. La misma operación también debe asignarle un nombre al presupuesto. Los presupuestos de las campañas compartidas nunca pueden convertirse en elementos no compartidos.
`referenceCount`	`string (int64 format)` Solo salida. La cantidad de campañas que usan el presupuesto de forma activa. Este campo es de solo lectura.
`hasRecommendedBudget`	`boolean` Solo salida. Indica si existe un presupuesto recomendado para esta campaña. Este campo es de solo lectura.
`recommendedBudgetAmountMicros`	`string (int64 format)` Solo salida. Es el importe del presupuesto recomendado. Si no hay ninguna recomendación disponible, se establecerá el importe del presupuesto. El importe se especifica en micros, en el que un millón es equivalente a una unidad de moneda. Este campo es de solo lectura.
`recommendedBudgetEstimatedChangeWeeklyClicks`	`string (int64 format)` Solo salida. Es el cambio estimado en los clics semanales si se aplica el presupuesto recomendado. Este campo es de solo lectura.
`recommendedBudgetEstimatedChangeWeeklyCostMicros`	`string (int64 format)` Solo salida. El cambio estimado en el costo semanal en micros si se aplica el presupuesto recomendado. Un millón equivale a una unidad monetaria. Este campo es de solo lectura.
`recommendedBudgetEstimatedChangeWeeklyInteractions`	`string (int64 format)` Solo salida. El cambio estimado en las interacciones semanales si se aplica el presupuesto recomendado. Este campo es de solo lectura.
`recommendedBudgetEstimatedChangeWeeklyViews`	`string (int64 format)` Solo salida. El cambio estimado en las vistas semanales si se aplica el presupuesto recomendado. Este campo es de solo lectura.

BudgetStatus

Posibles estados de un presupuesto

Enumeradores
`UNSPECIFIED`	No se especifica.
`UNKNOWN`	Se usa solo para el valor de retorno. Representa un valor desconocido en esta versión.
`ENABLED`	El presupuesto está habilitado.
`REMOVED`	Se quita el presupuesto.

BudgetDeliveryMethod

Los posibles métodos de publicación de un presupuesto.

Enumeradores
`UNSPECIFIED`	No se especifica.
`UNKNOWN`	Se usa solo para el valor de retorno. Representa un valor desconocido en esta versión.
`STANDARD`	El servidor de presupuestos regulará la publicación de anuncios de manera uniforme durante todo el período.
`ACCELERATED`	El servidor de presupuestos no limitará la publicación, y los anuncios se publicarán lo más rápido posible.

BudgetPeriod

Es el período posible de un presupuesto.

Enumeradores
`UNSPECIFIED`	No se especifica.
`UNKNOWN`	Se usa solo para el valor de retorno. Representa un valor desconocido en esta versión.
`DAILY`	Presupuesto diario.
`CUSTOM_PERIOD`	Presupuesto personalizado, que se vuelve a agregar en V5. El presupuesto personalizado se puede usar con total_amount para especificar el límite de presupuesto del ciclo de vida del cliente. Consulte https://support.google.com/google-ads/answer/6385083 para obtener más información.

BudgetType

Tipos de presupuesto posibles.

Enumeradores
`UNSPECIFIED`	No se especifica.
`UNKNOWN`	Se usa solo para el valor de retorno. Representa un valor desconocido en esta versión.
`STANDARD`	Tipo de presupuesto para el uso estándar de Google Ads. Limita la inversión diaria con el doble del importe del presupuesto especificado. Detalles completos: https://support.google.com/google-ads/answer/6385083
`FIXED_CPA`	Es un tipo de presupuesto con un costo por adquisición (conversión) fijo. Detalles completos: https://support.google.com/google-ads/answer/7528254 Este tipo solo es compatible con las campañas que utilizan AdvertisingChannelType.DISPLAY (excepto AdvertisingChannelSubType.DISPLAY_Gmail), BiddingStrategyType.TARGET_CPA y PaymentMode.ir.
`SMART_CAMPAIGN`	Es el tipo de presupuesto para la campaña inteligente. Detalles completos: https://support.google.com/google-ads/answer/7653509 Este tipo solo es compatible con campañas que incluyen AdvertisingChannelType.SMART y AdvertisingChannelSubType.SMART_CAMPAIGN.
`LOCAL_SERVICES`	Es el tipo de presupuesto de la campaña de Servicios Locales. Detalles completos: https://support.google.com/localservices/answer/7434558 Este tipo solo es compatible con campañas con AdvertisingChannelType.LOCAL_SERVICES.