Estructura de la API de informes de Search Ads 360

Los componentes principales de la API de informes de Search Ads 360 son los recursos y servicios. Un recurso representa una entidad de Search Ads 360 y usas un servicio para recuperar entidades de Search Ads 360.

Jerarquía de objetos

Una cuenta de Search Ads 360 es una jerarquía de objetos.

  • El recurso de nivel superior de una cuenta es el cliente.

  • Cada cuenta contiene una o más campañas activas.

  • Cada Campaign contiene uno o más grupos de anuncios que agrupan tus anuncios en colecciones lógicas.

  • Cada AdGroup contiene uno o más anuncios del grupo de anuncios.

  • Puedes adjuntar uno o más AdGroupCriterion o CampaignCriterion a un grupo de anuncios o a una campaña. Los criterios definen la manera en que se activan los anuncios.

    • Existen muchos tipos de criterios, como palabras clave, rangos de edad y ubicaciones. Los criterios definidos a nivel de la campaña afectan a todos los demás recursos dentro de la campaña. También puedes especificar presupuestos y fechas para toda la campaña.

Recursos

Los recursos representan las entidades en tu cuenta de Search Ads 360. Algunos recursos de ejemplo son Customer, Campaign y AdGroup.

ID de objeto

Cada objeto en Search Ads 360 se identifica con su propio ID. Algunos IDs son únicos a nivel global, es decir, en todas las cuentas de Search Ads 360, mientras que otros son únicos solo dentro de un alcance limitado.

Alcance de singularidad del ID de objeto
ID de presupuesto Global
Campaign ID Global
ID del grupo de anuncios Global
ID del anuncio Ad Group

Cada par AdGroupId / AdId es único a nivel global.
ID de criterio del grupo de anuncios Ad Group

Cada par AdGroupId / CriterionId es único a nivel global.
ID de criterio de campaña Campaña

Cada par CampaignId / CriterionId es único a nivel global.
Extensiones de anuncios Campaña

Cada par CampaignId / AdExtensionId es único a nivel global.
ID del feed Global
ID de elemento del feed Global
ID del atributo del feed Feed
ID de asignación de feeds Global
ID de etiqueta Global
ID de lista de usuarios Global

Estas reglas de ID pueden ser útiles cuando diseñas un almacenamiento local para tus objetos de Search Ads 360.

Tipos de objetos

Algunos objetos se pueden usar para varios tipos de entidades. Si este es el caso, el objeto contiene un campo type que describe su contenido. Por ejemplo, AdGroupAd puede hacer referencia a un anuncio de texto, de hotel o local. Puedes acceder al valor del tipo mediante el campo AdGroupAd.ad.type. Su valor se muestra en la enumeración AdType.

Nombres de recursos

Cada recurso se identifica de forma única mediante una string resource_name que concatena el recurso y sus elementos superiores en una ruta de acceso.

Por ejemplo, los nombres de los recursos de las campañas tienen el siguiente formato:

customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID

Una campaña con el ID 987654 en la cuenta de Search Ads 360 con el ID de cliente 1234567 tiene resource_name:

customers/1234567/campaigns/987654

Servicios

Los servicios te permiten recuperar tus entidades y metadatos de Search Ads 360. Existen tres tipos de servicios:

Servicio de búsqueda
SearchAds360Service es el servicio único y unificado para recuperar todos los objetos de recursos y estadísticas de rendimiento. Proporciona dos métodos: Search y SearchStream. Ambos métodos requieren una consulta que especifique el recurso que se consulta, los atributos de recursos y las métricas de rendimiento que se recuperarán, los predicados que se usarán para filtrar la solicitud y los segmentos que se usarán con el fin de desglosar aún más las estadísticas de rendimiento. Consulta Crea informes de búsqueda y el Lenguaje de consulta de Search Ads 360 para obtener más información.
Servicio de campo
SearchAds360FieldService recupera los metadatos sobre los recursos, como los atributos disponibles para un recurso y su tipo de datos. Puedes solicitar el catálogo para los recursos, los campos de recursos, las claves de segmentación y las métricas disponibles en los métodos de búsqueda SearchAds360Service. Consulta Recupera metadatos de recursos para obtener más información.
Servicios específicos de la entidad

Estos servicios proporcionan un método de solicitud GET que recupera una sola instancia de recurso. Esto es útil para examinar la estructura de un recurso.

Estos son algunos ejemplos de servicios específicos de entidades: