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. El tipo de presupuesto de la campaña.
`alignedBiddingStrategyId`	`string (int64 format)` ID de la estrategia de oferta de cartera con la que se alineó el presupuesto de esta campaña compartida. Cuando una estrategia de ofertas y el presupuesto de una campaña se alinean, se vinculan al mismo conjunto de campañas. Después de que el presupuesto de una campaña se alinee con una estrategia de oferta, las campañas que se agregan a este también deben utilizar la estrategia de oferta alineada.
`id`	`string (int64 format)` Solo salida. El ID del presupuesto de la campaña. El presupuesto de una campaña se crea con la operación de creación CampaignBudgetService y se le asigna un ID de presupuesto. Se puede compartir un ID de presupuesto entre diferentes campañas; el sistema asignará el presupuesto 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, todos los presupuestos de campaña compartidos explícitamente deben tener un nombre que no sea nulo ni vacío. Los presupuestos de las campañas que no se comparten explícitamente derivan su nombre del nombre de la campaña adjunta. La longitud de esta string debe ser entre 1 y 255, inclusive, en bytes UTF-8, (recortado).
`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 del presupuesto desde el principio, 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 en una campaña. El nombre y el estado del presupuesto se sincronizarán con el nombre y el estado de la campaña. Si intentas compartir el presupuesto con otra campaña, se producirá 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. El presupuesto de una campaña compartido nunca puede dejar de compartirse.
`referenceCount`	`string (int64 format)` Solo salida. Indica la cantidad de campañas que utilizan activamente el presupuesto. Este campo es de solo lectura.
`hasRecommendedBudget`	`boolean` Solo salida. Indica si existe un presupuesto recomendado para el presupuesto de 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á en 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. Es 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. Es 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

Estados posibles de un presupuesto.

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

BudgetDeliveryMethod

Posibles métodos de publicación de un presupuesto.

Enumeradores
`UNSPECIFIED`	No se especifica.
`UNKNOWN`	Se usa solo para el valor que se muestra. Representa un valor desconocido en esta versión.
`STANDARD`	El servidor de presupuestos regulará la publicación 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 que se muestra. Representa un valor desconocido en esta versión.
`DAILY`	Presupuesto diario.
`CUSTOM_PERIOD`	Presupuesto personalizado, que se vuelve a agregar en la versión 5 El presupuesto personalizado se puede utilizar con el importe total para especificar el límite de presupuesto desde el principio. 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 que se muestra. Representa un valor desconocido en esta versión.
`STANDARD`	Es el 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.conversions.
`SMART_CAMPAIGN`	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 con AdvertisingChannelType.SMART y AdvertisingChannelSubType.SMART_CAMPAIGN.
`LOCAL_SERVICES`	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 las campañas con AdvertisingChannelType.LOCAL_SERVICES.