Listy oczekujących rezerwacji i wysyłanie zapytań o stan sprzedawcy za pomocą interfejsu API

Przypadki użycia

Google Maps Booking API udostępnia 2 metody, których można używać automatycznego pobierania stanu poszczególnych sprzedawców przy użyciu różnych metod integracji Reklamy Usług Lokalnych zasobów reklamowych.

Przypadki użycia interfejsu Merchant Status API:

  • Ulepsz obecne narzędzia do zarządzania relacjami z klientami, aby zademonstrować klientów, w jaki sposób ich asortyment jest prezentowany w Google.
  • Utwórz panel do śledzenia stanu asortymentu i dopasowania ze swoimi sprzedawcami.
  • Automatycznie pobieraj stany pasujących i możliwych do zarezerwowania ze sprzedawcami i popraw wszelkie nieprawidłowe informacje, aby poprawić jakość danych.

Co zawiera stan sprzedawcy

MerchantStatus zawiera te informacje:

  • Stan asortymentu sprzedawcy: dotyczy zarówno sprzedawców dokonujących rezerwacji, jak i sprzedawców z listy oczekujących.
  • Stan dopasowania sprzedawcy: zawiera szczegóły pasującej firmy
  • Dla: Reklam Usług Lokalnych Google) Dopasowany sprzedawca: zawiera identyfikator klienta i kategorie usług.
  • Adresy URL pokazujące sposób prezentowania sprzedawcy w Google.

Sprawdzanie stanu pojedynczego sprzedawcy

Stan jednego sprzedawcy możesz sprawdzić za pomocą inventory.partners.merchants.getStatus: 

GET https://mapsbooking.googleapis.com/v1alpha/inventory/partners/{partnerId}/merchants/{merchantId}/status

Oto przykładowy kod w Pythonie (zobacz przykłady w większej liczbie języków) tutaj): 

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')

Przykład Odpowiedź MerchantStatus wygląda tak: 

  {
    "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"
      }
    ]
  }

Zbiorcze pobieranie stanów sprzedawców

Możesz pobrać stany wszystkich lub grupy sprzedawców spełniają określone warunki zasobów reklamowych/spełniania, przy użyciu inventory.partners.merchants.status.list. Możesz na przykład sprawić, to wywołanie, aby pobrać wszystkich niedopasowanych sprzedawców z prawidłowymi rezerwacjami z datą przypadającą w przyszłości zasoby reklamowe: 

GET https://mapsbooking.googleapis.com/v1alpha/inventory/partners/{partnerId}/merchants/status?pageSize=50&bookingInventoryStatusRestrict=HAS_VALID_FUTURE_INVENTORY&geoMatchRestrict=GEO_UNMATCHED

Przykładowa odpowiedź może wyglądać tak:

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

Ta odpowiedź będzie zawierać 50 MerchantStatus, który spełnia warunki filtrowania i porządkowany według merchant_id Odpowiedź zawiera też token strony (jeśli jest nie ostatniej strony), aby wysłać zapytanie na następną stronę.

Uwaga: warunki filtrowania powinny być spójne we wszystkich .

Sprawdzone metody

Status sprzedawcy zwykle nie zmienia się zbyt często, dlatego zachęcane do zapisywania pobranych wyników w pamięci podręcznej i okresowego zapisywania ich w pamięci podręcznej (np. co kilka godz.), są pobierane za pomocą nowych zapytań. Centrum działań może ograniczać zapytań, jeśli liczba żądań na sekundę wydaje się zbyt duża.

Wstecz
Wytyczne dotyczące dopasowania
Dalej
Dopasowywanie adresów URL w Mapach Google przez sprzedawców