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.

AdGroup

Representación JSON
AdGroupStatus
AdGroupAdRotationMode
AudienceSetting
- Representación JSON
AdGroupPrimaryStatus
AdGroupPrimaryStatusReason

Un grupo de anuncios.

Representación JSON

Representación JSON
{ "resourceName": string, "status": enum (`AdGroupStatus`), "type": enum (`AdGroupType`), "adRotationMode": enum (`AdGroupAdRotationMode`), "urlCustomParameters": [ { object (`CustomParameter`) } ], "optimizedTargetingEnabled": boolean, "displayCustomBidDimension": enum (`TargetingDimension`), "targetingSetting": { object (`TargetingSetting`) }, "audienceSetting": { object (`AudienceSetting`) }, "effectiveTargetCpaSource": enum (`BiddingSource`), "effectiveTargetRoasSource": enum (`BiddingSource`), "labels": [ string ], "excludedParentAssetFieldTypes": [ enum (`AssetFieldType`) ], "excludedParentAssetSetTypes": [ enum (`AssetSetType`) ], "primaryStatus": enum (`AdGroupPrimaryStatus`), "primaryStatusReasons": [ enum (`AdGroupPrimaryStatusReason`) ], "id": string, "name": string, "baseAdGroup": string, "trackingUrlTemplate": string, "campaign": string, "cpcBidMicros": string, "effectiveCpcBidMicros": string, "cpmBidMicros": string, "targetCpaMicros": string, "cpvBidMicros": string, "targetCpmMicros": string, "targetRoas": number, "percentCpcBidMicros": string, "finalUrlSuffix": string, "effectiveTargetCpaMicros": string, "effectiveTargetRoas": number }

{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "optimizedTargetingEnabled": boolean,
  "displayCustomBidDimension": enum (TargetingDimension),
  "targetingSetting": {
    object (TargetingSetting)
  },
  "audienceSetting": {
    object (AudienceSetting)
  },
  "effectiveTargetCpaSource": enum (BiddingSource),
  "effectiveTargetRoasSource": enum (BiddingSource),
  "labels": [
    string
  ],
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "primaryStatus": enum (AdGroupPrimaryStatus),
  "primaryStatusReasons": [
    enum (AdGroupPrimaryStatusReason)
  ],
  "id": string,
  "name": string,
  "baseAdGroup": string,
  "trackingUrlTemplate": string,
  "campaign": string,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "cpmBidMicros": string,
  "targetCpaMicros": string,
  "cpvBidMicros": string,
  "targetCpmMicros": string,
  "targetRoas": number,
  "percentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "effectiveTargetCpaMicros": string,
  "effectiveTargetRoas": number
}

Campos
`resourceName`	`string` Inmutable. El nombre del recurso del grupo de anuncios. Los nombres de recursos de grupos de anuncios tienen el siguiente formato: `customers/{customerId}/adGroups/{adGroupId}`
`status`	`enum (AdGroupStatus)` El estado del grupo de anuncios.
`type`	`enum (AdGroupType)` Inmutable. El tipo del grupo de anuncios.
`adRotationMode`	`enum (AdGroupAdRotationMode)` El modo de rotación de anuncios del grupo de anuncios.
`urlCustomParameters[]`	`object (CustomParameter)` Es la lista de asignaciones usadas para sustituir etiquetas de parámetros personalizados en `trackingUrlTemplate`, `finalUrls` o `mobile_final_urls`.
`optimizedTargetingEnabled`	`boolean` Verdadero si está habilitada la segmentación optimizada. La segmentación optimizada reemplaza a la expansión del público.
`displayCustomBidDimension`	`enum (TargetingDimension)` Permite a los anunciantes especificar una dimensión de segmentación en la que establecer ofertas absolutas. Esto es válido solo para las campañas que se orientan solo a la Red de Display y no a la Red de búsqueda.
`targetingSetting`	`object (TargetingSetting)` Es el parámetro de configuración de las funciones relacionadas con la segmentación.
`audienceSetting`	`object (AudienceSetting)` Inmutable. Es el parámetro de configuración de las funciones relacionadas con el público.
`effectiveTargetCpaSource`	`enum (BiddingSource)` Solo salida. La fuente del CPA objetivo efectivo. Este campo es de solo lectura.
`effectiveTargetRoasSource`	`enum (BiddingSource)` Solo salida. La fuente del ROAS objetivo eficaz Este campo es de solo lectura.
`labels[]`	`string` Solo salida. Los nombres de recursos de las etiquetas adjuntas a este grupo de anuncios.
`excludedParentAssetFieldTypes[]`	`enum (AssetFieldType)` Los tipos de campos de recursos que deben excluirse de este grupo de anuncios. Este grupo de anuncios no heredará los vínculos de recursos con estos tipos de campos de los niveles superiores.
`excludedParentAssetSetTypes[]`	`enum (AssetSetType)` Los tipos de conjuntos de recursos que deben excluirse de este grupo de anuncios. Este grupo de anuncios no heredará los vínculos de conjuntos de recursos con estos tipos de los niveles superiores. Los tipos de grupos por ubicación (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP y STATIC_LOCATION_GROUP) son tipos secundarios de LOCATION_SYNC. Por lo tanto, si se configura LOCATION_SYNC para este campo, todos los conjuntos de recursos del grupo por ubicación no se podrán vincular a este grupo de anuncios, y todas las extensiones de ubicación (LE) y de ubicación afiliada (ALE) no se publicarán en este grupo de anuncios. Por el momento, solo se admite LOCATION_SYNC.
`primaryStatus`	`enum (AdGroupPrimaryStatus)` Solo salida. Proporciona una vista global de por qué un grupo de anuncios no se publica o no se publica de manera óptima.
`primaryStatusReasons[]`	`enum (AdGroupPrimaryStatusReason)` Solo salida. Proporciona los motivos por los cuales un grupo de anuncios no se publica o no se publica de manera óptima.
`id`	`string (int64 format)` Solo salida. El ID del grupo de anuncios.
`name`	`string` El nombre del grupo de anuncios. Este campo es obligatorio y no debe estar vacío cuando se crean grupos de anuncios nuevos. Debe contener menos de 255 caracteres de ancho completo UTF-8. No debe contener caracteres nulos (punto de código 0x0), de salto de línea NL (punto de código 0xA) ni de retorno de carro (punto de código 0xD).
`baseAdGroup`	`string` Solo salida. Para grupos de anuncios experimentales o de borrador, este campo es el nombre del recurso del grupo de anuncios base a partir del cual se creó este grupo de anuncios. Si un grupo de anuncios en borrador o experimental no tiene un grupo de anuncios base, este campo será nulo. En el caso de los grupos de anuncios base, este campo es igual al nombre del recurso del grupo de anuncios. Este campo es de solo lectura.
`trackingUrlTemplate`	`string` La plantilla de URL para crear una URL de seguimiento.
`campaign`	`string` Inmutable. La campaña a la que pertenece el grupo de anuncios.
`cpcBidMicros`	`string (int64 format)` La oferta de CPC (costo por clic) máxima.
`effectiveCpcBidMicros`	`string (int64 format)` Solo salida. El valor será el mismo que el del valor de la oferta de CPC (costo por clic) cuando la estrategia de ofertas es CPC manual, CPC avanzado, página uno promocionada o porcentaje de ranking superior objetivo. De lo contrario, el valor será nulo.
`cpmBidMicros`	`string (int64 format)` Es la oferta de CPM (costo por cada mil impresiones visibles) máximo.
`targetCpaMicros`	`string (int64 format)` El CPA (costo por adquisición) objetivo Si la estrategia de ofertas de la campaña del grupo de anuncios es CPA objetivo o Maximizar conversiones (con el campo de CPA objetivo establecido), este campo anulará el CPA objetivo especificado en la estrategia de ofertas de la campaña. De lo contrario, se ignorará este valor.
`cpvBidMicros`	`string (int64 format)` La oferta de CPV (costo por vista).
`targetCpmMicros`	`string (int64 format)` Es el importe promedio en micros que el anunciante está dispuesto a pagar cada vez que el anuncio se muestra mil veces.
`targetRoas`	`number` La anulación del ROAS (retorno de la inversión publicitaria) objetivo Si la estrategia de ofertas de la campaña del grupo de anuncios es TargetRoas o MaximizarConversionValue (con su campo targetRoas configurado), este campo anulará el ROAS objetivo especificado en la estrategia de ofertas de la campaña. De lo contrario, se ignorará este valor.
`percentCpcBidMicros`	`string (int64 format)` Es el porcentaje del importe de la oferta de CPC, expresado como una fracción del precio anunciado para algún producto o servicio. El rango válido para la fracción es [0,1) y el valor almacenado aquí es 1,000,000 * [fracción].
`finalUrlSuffix`	`string` Plantilla de URL para agregar parámetros a la URL final.
`effectiveTargetCpaMicros`	`string (int64 format)` Solo salida. El costo por adquisición (CPA) objetivo eficaz. Este campo es de solo lectura.
`effectiveTargetRoas`	`number` Solo salida. Es el ROAS (retorno de la inversión publicitaria) objetivo eficaz. Este campo es de solo lectura.

AdGroupStatus

Los estados posibles de un grupo de anuncios

Enumeradores
`UNSPECIFIED`	No se especificó el estado.
`UNKNOWN`	El valor recibido no se conoce en esta versión. Este es un valor de solo respuesta.
`ENABLED`	El grupo de anuncios está habilitado.
`PAUSED`	El grupo de anuncios está detenido.
`REMOVED`	Se quitó el grupo de anuncios.

AdGroupAdRotationMode

Son los modos posibles de rotación de anuncios de un grupo de anuncios.

Enumeradores
`UNSPECIFIED`	No se especificó el modo de rotación de anuncios.
`UNKNOWN`	El valor recibido no se conoce en esta versión. Este es un valor de solo respuesta.
`OPTIMIZE`	Optimizar los anuncios del grupo de anuncios según los clics o las conversiones
`ROTATE_FOREVER`	Rotar de manera uniforme y permanente.

AudienceSetting

Es la configuración de la segmentación por público.

Representación JSON
{ "useAudienceGrouped": boolean }

Campos

Campos
`useAudienceGrouped`	`boolean` Inmutable. Si es "true", este grupo de anuncios utiliza un recurso de público para la Segmentación por público. Si es falso, este grupo de anuncios puede utilizar los criterios del segmento de público en su lugar.

useAudienceGrouped

boolean

Inmutable. Si es "true", este grupo de anuncios utiliza un recurso de público para la Segmentación por público. Si es falso, este grupo de anuncios puede utilizar los criterios del segmento de público en su lugar.

AdGroupPrimaryStatus

Indica los estados posibles de un grupo de anuncios.

Enumeradores
`UNSPECIFIED`	No se especifica.
`UNKNOWN`	Se usa solo para el valor que se muestra. Representa un valor desconocido en esta versión.
`ELIGIBLE`	El grupo de anuncios es apto para publicarse.
`PAUSED`	El grupo de anuncios está detenido.
`REMOVED`	Se quitó el grupo de anuncios.
`PENDING`	Es posible que el grupo de anuncios se publique en el futuro.
`NOT_ELIGIBLE`	El grupo de anuncios no es apto para publicarse.
`LIMITED`	El grupo de anuncios tiene capacidad de publicación limitada.

AdGroupPrimaryStatusReason

Posibles motivos para el estado del grupo de anuncios.

Enumeradores
`UNSPECIFIED`	No se especifica.
`UNKNOWN`	Se usa solo para el valor que se muestra. Representa un valor desconocido en esta versión.
`CAMPAIGN_REMOVED`	Se quita el estado de la campaña especificado por el usuario. Contribuye a AdGroupPrimaryStatus.NOT_ELIGIBLE.
`CAMPAIGN_PAUSED`	El estado de campaña especificado por el usuario está detenido. Contribuye a AdGroupPrimaryStatus.NOT_ELIGIBLE.
`CAMPAIGN_PENDING`	La hora de inicio de esta campaña especificada por el usuario es en el futuro. Contribuye a AdGroupPrimaryStatus.NOT_ELIGIBLE
`CAMPAIGN_ENDED`	Ya pasó la hora especificada por el usuario para finalizar esta campaña. Contribuye a AdGroupPrimaryStatus.NOT_ELIGIBLE.
`AD_GROUP_PAUSED`	El estado del grupo de anuncios especificado por el usuario está detenido. Contribuye a AdGroupPrimaryStatus.PAUSE.
`AD_GROUP_REMOVED`	Se quita el estado del grupo de anuncios especificado por el usuario. Contribuye a AdGroupPrimaryStatus.REMOVED.
`AD_GROUP_INCOMPLETE`	Aún no se completó la creación de este grupo de anuncios. Contribuye a AdGroupPrimaryStatus.NOT_ELIGIBLE.
`KEYWORDS_PAUSED`	Los estados de palabras clave especificados por el usuario en este grupo de anuncios están todos detenidos. Contribuye a AdGroupPrimaryStatus.NOT_ELIGIBLE.
`NO_KEYWORDS`	No existen palabras clave aptas en este grupo de anuncios. Contribuye a AdGroupPrimaryStatus.NOT_ELIGIBLE.
`AD_GROUP_ADS_PAUSED`	Los estados de anuncios del grupo de anuncios especificados por el usuario en este grupo de anuncios están todos detenidos. Contribuye a AdGroupPrimaryStatus.NOT_ELIGIBLE.
`NO_AD_GROUP_ADS`	No hay ningún anuncio del grupo de anuncios apto en este grupo de anuncios. Contribuye a AdGroupPrimaryStatus.NOT_ELIGIBLE.
`HAS_ADS_DISAPPROVED`	Indica el motivo del estado con respecto a las políticas cuando se rechaza, al menos, un anuncio. Contribuye a varios AdGroupPrimaryStatus.
`HAS_ADS_LIMITED_BY_POLICY`	Indica el motivo del estado con respecto a la política cuando al menos un anuncio está limitado por la política. Contribuye a varios AdGroupPrimaryStatus.
`MOST_ADS_UNDER_REVIEW`	Indica el motivo del estado de la política cuando la mayoría de los anuncios están pendientes de revisión. Contribuye a AdGroupPrimaryStatus.PENDING.
`CAMPAIGN_DRAFT`	El grupo de anuncios pertenece a un borrador de campaña. Contribuye a AdGroupPrimaryStatus.NOT_ELIGIBLE.
`AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY`	El grupo de anuncios se detuvo debido a una baja actividad prolongada en la publicación. Contribuye a AdGroupPrimaryStatus.PAUSE.