Casos prácticos
La API de Google Maps Booking proporciona dos métodos que se pueden usar. para recuperar de forma programática el estado de los comercios individuales de varias integraciones o Anuncios de Servicios Locales en el inventario de Google.
Casos de uso de Merchant Status API:
- Mejore las herramientas existentes de administración de relaciones con los clientes para demostrar su a los clientes cómo se muestra su inventario en Google.
- Crear un panel para hacer un seguimiento del estado del inventario y de coincidencia de tus comercios.
- Recupera de manera programática los estados coincidentes y reservables de tus y corregir la información incorrecta para mejorar la calidad de los datos.
¿Qué contiene el estado del comercio?
El MerchantStatus contiene la siguiente información:
- Estado del inventario del comercio: Se aplica a los comercios de reservas o listas de espera.
- Estado de coincidencia del comercio: Incluye detalles de la ficha de la empresa coincidente
- Para Anuncios de Servicios Locales de Google) Coincide con el proveedor de servicios del comercio: incluye el ID de cliente y las categorías de servicio.
- Son las URLs para demostrar cómo el comercio aparece en Google.
Cómo buscar el estado de un solo comercio
Puedes obtener el estado de un solo comercio usando inventory.partners.merchants.getStatus:
GET https://mapsbooking.googleapis.com/v1alpha/inventory/partners/{partnerId}/merchants/{merchantId}/status
Aquí hay una muestra de código de Python (consulta ejemplos en más lenguajes) aquí):
from google.auth.transport.requests import AuthorizedSession from google.oauth2 import service_account credentials = service_account.Credentials.from_service_account_file( './your_key.json') scoped_credentials = credentials.with_scopes( ['https://www.googleapis.com/auth/mapsbooking']) authed_session = AuthorizedSession(scoped_credentials) response = authed_session.get('https://partnerdev-mapsbooking.googleapis.com' + '/v1alpha/inventory/partners/123456789/merchants/001/status')
Ejemplo La respuesta de MerchantStatus se ve de la siguiente manera:
{ "name": "partners/123456789/merchants/001/status", "merchantName": "Foo Bar Restaurant", "inputGeoInfo": { "unstructured_address": "123 Foo Bar Street, Mountain View" }, "processingStatus": "COMPLETED", "bookingStatus": { "hasValidFutureInventory": true }, "waitlistStatus": { "hasValidWaitlistService": true } "geoMatch": { "name": "Foo Bar Restaurant", "formattedAddress": "123 Foo Bar St, Mountain View, CA 94043", "placeId": "ChIAAAAAAAAABBBBBBBB" }, "directUrls": [ { "type": "BOOKING", "url": "https://reserve-partnerdev.sandbox.google.com/maps/reserve/v/dine/m/Nwaaaaa" }, { "type": "WAITLIST", "url": "https://reserve-partnerdev.sandbox.google.com/maps/reserve/v/wait/c/iDbbbbb" } ] }
Recuperar los estados de los comercios de forma masiva
Puedes recuperar los estados de todos los comercios o de un grupo de comercios el cumplimiento de ciertas condiciones de inventario/coincidencia, inventory.partners.merchants.status.list. Por ejemplo, puedes hacer esta llamada para obtener todos los comercios no coincidentes con reservas válidas a fecha futura inventario:
GET https://mapsbooking.googleapis.com/v1alpha/inventory/partners/{partnerId}/merchants/status?pageSize=50&bookingInventoryStatusRestrict=HAS_VALID_FUTURE_INVENTORY&geoMatchRestrict=GEO_UNMATCHED
Una respuesta de muestra se vería de la siguiente manera:
{ "merchantStatuses": [ { "name": "partners/123456789/merchants/002/status", "merchantName": "Bar Foo Restaurant", "inputGeoInfo": { "unstructured_address": "234 Bar Foo Street, Mountain View" }, "processingStatus": "COMPLETED", "bookingStatus": { "hasValidFutureInventory": true }, "waitlistStatus": {}, }, ... { "name": "partners/123456789/merchants/080/status", "merchantName": "Baz Restaurant", "inputGeoInfo": { "unstructured_address": "345 Baz Street, Mountain View" }, "processingStatus": "COMPLETED", "bookingStatus": { "hasValidFutureInventory": true }, "waitlistStatus": { "hasValidWaitlistService": true }, }, ], "nextPageToken": "AAABBBB" }
Esta respuesta contendrá 50
MerchantStatus que cumpla con las condiciones de filtrado y ordenado por
merchant_id La respuesta también contiene un token de página (si
no en la última) para consultar la página siguiente.
Tenga en cuenta que las condiciones de filtrado deben ser coherentes en todas páginas.
Prácticas recomendadas
Dado que los estados de los comercios no cambian con frecuencia en la mayoría de los casos, es se recomienda almacenar en caché los resultados recuperados y periódicamente (p.ej., cada pocas horas) los recupera a través de consultas nuevas. Es posible que el Centro de acciones limite tu si la cantidad de solicitudes por segundo se considera demasiado alta.