Google Maps Reviews
Las reseñas de Google Maps son registros públicos de opiniones sobre un lugar que pueden incluir texto escrito, una referencia de quien reseña, una calificación, enlaces de origen y del sujeto, momentos de publicación y de recopilación, y contenido multimedia. Sirven para armar conjuntos de datos de opiniones vinculados a su fuente y para hacer comparaciones entre lugares conocidos o ventanas de recopilación.
Funcionalidades de la Google Maps Reviews API
- Entrada por lotes de URL conocidasEnvíe una o más URL compatibles de google.com o goo.gl en una sola tarea asíncrona, en lugar de resolver los lugares con una API de identificadores aparte.
- Ventana de días opcionalAplique un único valor positivo de days_limit a cada fila de URL enviada cuando el flujo de trabajo necesite una ventana de reseñas recientes.
- Registros de reseñas establesLea la identidad de la reseña, el texto, los campos de quien reseña, la calificación, las referencias del lugar, las marcas de tiempo, la URL de origen y el contenido multimedia disponible mediante el esquema de reseñas v1.0.
Parámetros de la Google Maps Reviews API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Una o más URL no vacías en google.com, en cualquier subdominio de google.com, en goo.gl o en un subdominio de goo.gl, separadas por comas o saltos de línea. Use URL conocidas de lugares de Maps para recopilar reseñas. |
days_limit | Opcional | Entero positivo opcional que se aplica a cada fila de entrada del proveedor como ventana de actualidad de las reseñas. Omítalo para no enviar ningún filtro de ventana de días. |
results_limit | Opcional | Entero opcional de 1 a 2,000 que limita el total de reseñas almacenadas para la tarea. Su valor predeterminado es 100, y la disponibilidad de la fuente puede producir menos filas. |
Cómo usar la Google Maps Reviews API
Envíe URL conocidas de Google Maps, siga la tarea asíncrona y lea los registros de reseñas guardados mediante el cursor de resultados de la tarea.
- Prepare una o más URL compatibles de lugares de Google Maps en google.com o goo.gl.
- Envíe urls por POST a /v1/google-maps/reviews y, cuando haga falta, también days_limit y results_limit.
- Consulte /v1/tasks/{task_id} hasta que status sea succeeded o failed.
- Lea /v1/tasks/{task_id}?limit=50 y continúe con results.next_cursor mientras results.has_more sea true.
curl -X POST "https://api.socq.ai/v1/google-maps/reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.google.com/maps/place/Coffee%20Project%20New%20York%20%7C%20East%20Village/data=!4m7!3m6!1s0x89c2599b5a24d7fd:0x9e354f6cf514b9fc!8m2!3d40.7270884!4d-73.9893820!16s%2Fg%2F11c3svpqld!19sChIJ_dckWptZwokR_LkU9WxPNZ4?authuser=0&hl=en&rclk=1"],"days_limit":3650,"results_limit":3}'
# Poll GET /v1/tasks/{task_id}, then request
# GET /v1/tasks/{task_id}?limit=50&cursor={results.next_cursor}.Casos de uso de la Google Maps Reviews API
- Conjuntos de datos de opiniones sobre lugares conocidos: Prepare el texto de las reseñas, las calificaciones, los momentos de publicación y los enlaces de origen para un conjunto definido de URL públicas de lugares.
- Investigación de quienes reseñan con trazabilidad de la fuente: Conserve los nombres, los nombres de usuario, los enlaces de perfil y las URL de las reseñas disponibles de quienes reseñan, para que los registros sigan siendo trazables a su contexto público.
- Comparaciones de ventanas recientes: Ejecute el mismo conjunto de lugares con valores documentados de days_limit en momentos distintos para comparar recopilaciones acotadas, sin afirmar que se tiene el historial completo.
- Archivos de reseñas con contenido multimedia vinculado: Conserve el contenido multimedia disponible de las reseñas junto con el texto, la calificación, la referencia del lugar y el momento de recopilación en un registro de investigación normalizado.
Consejos de expertos para la Google Maps Reviews API
- Envíe URL de Maps de google.com o goo.gl que se puedan resolver; un nombre de lugar, una cuenta de Perfil de Empresa de Google o un Place ID por sí solos no son un elemento aceptado de urls.
- Use days_limit solo cuando tenga sentido una ventana en números enteros positivos; si lo omite, la fila del proveedor queda sin ese filtro.
- Trate results_limit como un tope global de resultados almacenados para todo el lote de URL, no como una promesa por cada URL.
- Mantenga separado el results_limit del envío y el limit de lectura de la tarea: este último controla el tamaño de página de 1 a 500 y usa un cursor opaco.
- Permita que el texto, los atributos de quien reseña, la calificación, las referencias del sujeto, las marcas de tiempo y el contenido multimedia estén ausentes cuando la fuente pública no los exponga.
APIs relacionadas
Además de la Google Maps Reviews API, use estas APIs cuando necesite otro tipo de datos públicos de Google Maps.
- Google Maps Search API — Busca lugares públicos de Google Maps por consulta y ubicación, con campos normalizados de identidad, dirección, contacto, calificación, cantidad de reseñas, URL y coordenadas.
- Google Maps Place Details API