एपीआई के ज़रिए व्यापारी/कंपनी के स्टेटस के बारे में क्वेरी करना

उपयोग के उदाहरण

Google Maps का बुकिंग एपीआई दो तरीके देता है. इन तरीकों का इस्तेमाल किया जा सकता है प्रोग्राम के ज़रिए, अलग-अलग व्यापारियों/कंपनियों/कारोबारियों की स्थिति को अलग-अलग इंटिग्रेशन या Local Services विज्ञापन इन्वेंट्री.

Merchant Status API के लिए इस्तेमाल के उदाहरण:

  • मौजूदा कस्टमर रिलेशन मैनेजमेंट टूल को बेहतर बनाकर, और उनकी इन्वेंट्री Google पर कैसे दिखती है.
  • इन्वेंट्री स्थिति और मिलान स्थिति को ट्रैक करने के लिए एक डैशबोर्ड बनाएं आपके कारोबारी या कंपनी.
  • प्रोग्राम की मदद से, अपनी सेवाओं के मैच होने वाले और बुक किए जा सकने वाले स्टेटस वापस पाएं पर जाएं और डेटा क्वालिटी को बेहतर बनाने के लिए, किसी भी गलत जानकारी को ठीक करें.

कारोबारी या कंपनी के स्टेटस में क्या जानकारी होती है

कॉन्टेंट बनाने MerchantStatus में यह जानकारी शामिल होती है:

  • कारोबारी या कंपनी की इन्वेंट्री की स्थिति: यह बुकिंग और/या वेटलिस्ट से जुड़े कारोबारियों या कंपनियों, दोनों पर लागू होती है.
  • कारोबारी या कंपनी के मैचिंग स्टेटस: इसमें, मैच होने वाले कारोबार की लिस्टिंग की जानकारी शामिल है
  • इसके लिए सिर्फ़ Google Local Services Ads से मेल खाने वाली कारोबारी या कंपनी: ग्राहक आईडी और सेवा की कैटगरी शामिल होती हैं.
  • इन यूआरएल में बताया गया है कि Google पर कारोबारी या कंपनी को कैसे दिखाया जाता है.

एक व्यापारी/कंपनी का स्टेटस देखना

किसी एक कारोबारी या कंपनी की स्थिति का पता लगाने के लिए, यहां जाएं: inventory.partners.merchants.getStatus:

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

यहां Python कोड का सैंपल दिया गया है (ज़्यादा भाषाओं में उदाहरण देखें यहां देखें):

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

एक उदाहरण MerchantStatus जवाब ऐसा दिखता है:

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

एक साथ कई व्यापारी स्थितियों का पता लगाना

आपके पास सभी व्यापारियों/कंपनियों/कारोबारियों या उनके किसी ग्रुप के स्टेटस की जानकारी पाने का विकल्प है कुछ इन्वेंट्री/मैच करने की शर्तों को पूरा करना होगा. इसके लिए, inventory.partners.merchants.status.list. उदाहरण के लिए, आप यह कॉल उन सभी व्यापारियों/कंपनियों/कारोबारियों को पाने के लिए है जो आने वाले समय की मान्य बुकिंग के साथ मेल नहीं खाती हैं इन्वेंट्री:

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

सैंपल के तौर पर दिया गया जवाब कुछ ऐसा दिखेगा:

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

इस जवाब में 50 क्वेरी शामिल होंगी MerchantStatus, जो फ़िल्टर करने की शर्तों को पूरा करता है और क्रम से लगाया जाता है merchant_id. रिस्पॉन्स में पेज टोकन भी शामिल होता है, अगर यह अंतिम पेज नहीं) क्वेरी करें.

कृपया ध्यान दें: फ़िल्टर करने की शर्तें सभी कैटगरी में एक जैसी होनी चाहिए पेज.

सबसे सही तरीके

ज़्यादातर मामलों में, कारोबारी या कंपनी का स्टेटस बार-बार नहीं बदलता है. इसलिए, ऐसा होता है मिलने वाले नतीजों को कैश मेमोरी में सेव करने और समय-समय पर (उदाहरण के लिए, हर कुछ समय पर) घंटे) उन्हें नई क्वेरी के माध्यम से फिर से पाएं. कार्रवाई केंद्र आपकी साइट को क्वेरी का जवाब दें.