Ejemplo

Conoce Merchant API, que es el sucesor oficial de Content API for Shopping. La API de Merchant Center está en versión beta.

Consulta los anuncios más recientes para obtener información sobre funciones nuevas, actualizaciones importantes de la documentación, correcciones de errores y actualizaciones de lanzamientos de la API de Merchant.

Si deseas obtener información para administrar cómo aparecen tu empresa y tus productos en Google y obtener acceso programático a datos, estadísticas y funciones únicas a gran escala, consulta Cómo comenzar a usar la API de Merchant Center.

Esta es una consulta de muestra a MerchantPerformanceView que muestra el rendimiento de tu cuenta en los últimos 30 días, segmentado por program y offer_id. Puedes probar este ejemplo rápido para familiarizarte con el servicio Reports.

Debes tener el rol de administrador de informes para recuperar este informe.

Para realizar la solicitud, pasa la siguiente sentencia del lenguaje de consulta de Merchant Center al método reports.search:

SELECT
  segments.program,
  segments.offer_id,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'

Ejecutar

Haz clic en Run para probar la muestra en el Explorador de API. Después de hacer clic en Run, actualiza el marcador de posición del ID del comerciante a tu propio ID del comerciante en la URL de solicitud. Puedes modificar la consulta. La consulta completa debe permanecer en una sola línea para trabajar con el Explorador de APIs.

Nota: En esta guía, se muestra la solicitud HTTP subyacente como herramienta de enseñanza, pero te recomendamos que uses una de las bibliotecas cliente para enviar tus solicitudes.

URL de solicitud HTTP

La solicitud consiste en una POST HTTP al servidor de la Content API for Shopping en la siguiente URL:

https://shoppingcontent.googleapis.com/content/v2.1/merchantId/reports/search

Ejemplo completo de solicitud HTTP

Este es un ejemplo completo que muestra la definición del informe anterior incluida en una solicitud HTTP POST:

POST /v2.1/merchantId/reports/search HTTP/1.1
Host: shoppingcontent.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer access token

Parameters:
{
  "query" : "SELECT segments.program, segments.offer_id, metrics.impressions,
                    metrics.clicks, metrics.ctr
            FROM MerchantPerformanceView
            WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'"
}