La API de Search Ads 360 Reporting se basa en una plataforma moderna y presenta varios conceptos novedosos. Estos se describen en las siguientes secciones.
Recursos
Los objetos de recursos reemplazan los tipos de informes. En lugar de solicitar tipos de informes predefinidos, ahora puedes consultar todos los recursos con un nuevo lenguaje de consulta similar a SQL. Consulta la estructura de la API de Search Ads 360 Reporting para obtener más información.
Informes de búsqueda
La Búsqueda tiene su propio servicio en la nueva API. El servicio de búsqueda reemplaza al servicio de informes heredado. Todas las consultas pasan por
SearchAds360Service
que proporciona dos métodos, SearchStream y Search, para buscar y
recuperar datos y métricas de informes. Ambos métodos de búsqueda muestran todos los objetos SearchAds360Row que coinciden con tu consulta de búsqueda. Consulta
Cómo crear informes de búsqueda para obtener más información.
Metadatos de recursos
SearchAds360FieldService
te permite solicitar de forma dinámica el catálogo de recursos, los campos de recursos, las claves de segmentación y las métricas disponibles en los métodos de búsqueda de SearchAds360Service. Consulta Cómo recuperar metadatos de recursos para obtener
más información.
Nombres de campos
La API presenta nombres de campos anidados separados con la notación de puntos. Por ejemplo, campaign.id y ad_group.id. También puedes anidar más, por ejemplo,ad_group.campaign.id. Consulta la
estructura de la API de Search Ads 360 Reporting para obtener
más información.
Los informes de la API de Search Ads 360 anterior se basan en campos separados en diferentes entidades para conceptos similares. Por ejemplo, los informes
campaign y
adgroup incluyen un campo
campaignId separado.
Lenguaje de consulta
La API presenta el lenguaje de consulta de Search Ads 360. Este es un lenguaje flexible similar a SQL que te permite definir consultas para recuperar los datos de informes específicos que mejor se adapten a tu empresa. Consulta Lenguaje de consulta de Search Ads 360 para obtener más información.
Solicitudes GET
En la nueva API, la búsqueda tiene su propio servicio (SearchAds360Service), pero las solicitudes GET aún existen en el servicio específico de cada entidad. Por ejemplo, puedes obtener
información de columnas personalizadas de
CustomColumnService.
Consulta
Cambios de formato en la API de Search Ads 360 Reporting
para obtener más información.
Columnas personalizadas
En la nueva experiencia de Search Ads 360, las columnas de fórmulas y las conversiones personalizadas se denominan columnas personalizadas.
Obtén más información acerca de las columnas personalizadas.
El nuevo
CustomColumnService
habilita las columnas personalizadas. Siempre que tengas los permisos necesarios, puedes solicitar recursos CustomColumn que sean propiedad de cualquier cuenta en el árbol de cuentas.
Administración de la cuenta
La nueva experiencia de Search Ads 360 organiza las cuentas en una jerarquía de cuentas de administrador, de subadministrador y de cliente. Las cuentas de administrador representan las cuentas de agencia y las de subadministrador representan las cuentas de anunciante en la experiencia anterior de Search Ads 360. Consulta Acerca de las cuentas de administrador de Search Ads 360 para obtener más información.
Puedes consultar el árbol de cuentas y, luego, enviar solicitudes para cada cuenta de la que deseas obtener datos de informes.
Como resultado del cambio en la jerarquía de cuentas, los campos relacionados con el concepto de anunciante o agencia se reemplazaron por alternativas adecuadas para proporcionar paridad funcional siempre que sea posible. Consulta Asignaciones de campos para obtener una lista de los campos afectados y sus sustitutos.
Encabezado del ID de cliente de acceso
login-customer-id es un encabezado nuevo que se requiere cuando se usa una cuenta de administrador para acceder a una cuenta de subadministrador o de cliente. Consulta
Encabezado del ID de cliente de acceso
para obtener más información.
Control de versiones
La API de Search Ads 360 Reporting usa
el control de versiones semántico. Hay versiones principales y secundarias,
con el formato vMAJOR_MINOR. Consulta
Control de versiones para obtener más información.