Ejemplo

A continuación, se incluye una consulta de ejemplo para MerchantPerformanceView que devuelve 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 de Reports.

Necesitas el rol de administrador de informes para recuperar este informe.

Para realizar la solicitud, pasa la siguiente instrucción del lenguaje de consultas 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 Ejecutar para probar la muestra en el Explorador de APIs. Después de hacer clic en Ejecutar, actualiza el marcador de posición del ID de comerciante con tu propio ID en la URL de la solicitud. Puedes modificar la búsqueda. La consulta completa debe permanecer en una sola línea para que funcione 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 la solicitud HTTP

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

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

Ejemplo de solicitud HTTP completa

A continuación, se muestra un ejemplo completo de 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'"
}