La API de Search Ads 360 Reporting se basa en una plataforma moderna y presenta varios conceptos nuevos. Estos se describen en las siguientes secciones.
Recursos
Los objetos de recursos reemplazan a 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 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, campos de recursos, claves de segmentación y métricas disponibles en los métodos de búsqueda 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, usa las etiquetas 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 anterior de Search Ads 360 se basan en campos separados en diferentes entidades para conceptos similares. Por ejemplo, los informes campaign y adgroup incluyen un campo campaignId independiente.
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.
Cómo obtener solicitudes
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 las 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 sobre las columnas personalizadas. El nuevo elemento CustomColumnService habilita las columnas personalizadas. Siempre que tengas los permisos necesarios, puedes solicitar recursos de CustomColumn que pertenezcan a cualquier cuenta en
el árbol de cuentas.
Administración de la cuenta
En la nueva experiencia de Search Ads 360, las cuentas se organizan 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 la cuenta y, luego, enviar solicitudes para cada cuenta de la que quieras obtener datos de informes.
Como resultado del cambio en la jerarquía de la cuenta, 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 de 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 cliente. Consulta el encabezado de 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.