Ejemplo

Conoce la API de Merchant (beta), el sucesor oficial de Content API for Shopping.

Obtén las últimas novedades sobre las funciones nuevas, las correcciones de errores y las actualizaciones de lanzamiento de la API de Merchant (beta).

Aprende a administrar tu empresa y tus productos en Google, y a obtener acceso programático a datos, estadísticas y funciones únicas a gran escala. Comienza ahora

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'"
}