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 recurso 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 heredados. 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 la 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 de SearchAds360Service. Consulta Recupera metadatos de recursos para obtener más información.
Nombres de campos
La API ingresa 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 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 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.
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 la columna personalizada desde 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 objeto 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 cuentas
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. Una cuenta de administrador representa la cuenta de agencia, y las cuentas de subadministrador representan las cuentas de anunciante en la experiencia anterior de Search Ads 360. Consulta el artículo 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 quieras obtener datos de informes.
Como resultado del cambio en la jerarquía de las cuentas, los campos relacionados con el concepto del anunciante o la 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 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.