এপিআই এর মাধ্যমে বণিক স্থিতি জিজ্ঞাসা করা

ব্যবহারের ক্ষেত্রে

গুগল ম্যাপস বুকিং এপিআই দুটি পদ্ধতি প্রদান করে, যা বিভিন্ন অ্যাকশন সেন্টার ইন্টিগ্রেশন বা স্থানীয় পরিষেবা বিজ্ঞাপন ইনভেন্টরির জন্য পৃথক ব্যবসায়ীদের স্ট্যাটাস প্রোগ্রাম্যাটিকভাবে পুনরুদ্ধার করতে ব্যবহার করা যেতে পারে।

মার্চেন্ট স্ট্যাটাস API-এর জন্য কেস ব্যবহার করুন:

• অ্যাকশনস সেন্টার প্ল্যাটফর্মে আপনার গ্রাহকদের কীভাবে তাদের ইনভেন্টরি দেখানো হয় তা প্রদর্শনের জন্য বিদ্যমান গ্রাহক সম্পর্ক ব্যবস্থাপনা সরঞ্জামগুলিকে উন্নত করুন।
• আপনার ব্যবসায়ীদের ইনভেন্টরি স্ট্যাটাস এবং ম্যাচিং স্ট্যাটাস ট্র্যাক করার জন্য একটি ড্যাশবোর্ড তৈরি করুন।
• আপনার বণিকদের ম্যাচিং এবং বুকিংযোগ্য স্ট্যাটাসগুলি প্রোগ্রাম্যাটিকভাবে পুনরুদ্ধার করুন এবং ডেটার মান উন্নত করতে কোনও ভুল তথ্য ঠিক করুন।

বণিকের স্ট্যাটাসে কী থাকে?

MerchantStatus- এ নিম্নলিখিত তথ্য রয়েছে:

• মার্চেন্ট ইনভেন্টরি স্ট্যাটাস: বুকিং এবং/অথবা ওয়েটলিস্ট মার্চেন্ট উভয়ের ক্ষেত্রেই প্রযোজ্য।
• মার্চেন্ট ম্যাচিং স্ট্যাটাস: মিলে যাওয়া ব্যবসার তালিকার বিশদ বিবরণ অন্তর্ভুক্ত করে
• শুধুমাত্র Google স্থানীয় পরিষেবা বিজ্ঞাপনের জন্য) মিলে যাওয়া বণিক পরিষেবা প্রদানকারী: গ্রাহক আইডি এবং পরিষেবা বিভাগ অন্তর্ভুক্ত করে।
• রিজার্ভ উইথ গুগলের মাধ্যমে ব্যবসায়ীকে কীভাবে দেখানো হয় তা দেখানোর জন্য URL গুলি।

একজন একক বণিকের স্ট্যাটাস দেখুন

আপনি inventory.partners.merchants.getStatus ব্যবহার করে একজন একক বণিকের স্ট্যাটাস পেতে পারেন:

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

এখানে একটি পাইথন কোড নমুনা (আরও ভাষায় উদাহরণ দেখুন এখানে ):

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

এই প্রতিক্রিয়ায় ৫০টি MerchantStatus থাকবে যা ফিল্টারিং শর্ত পূরণ করে এবং merchant_id দ্বারা ক্রমানুসারে তৈরি করা হবে। প্রতিক্রিয়াটিতে পরবর্তী পৃষ্ঠাটি জিজ্ঞাসা করার জন্য একটি পৃষ্ঠা টোকেন (যদি এটি শেষ পৃষ্ঠা না হয়)ও থাকবে।

অনুগ্রহ করে মনে রাখবেন: ফিল্টারিং শর্তাবলী সমস্ত পৃষ্ঠায় সামঞ্জস্যপূর্ণ হওয়া উচিত।

সেরা অনুশীলন

যেহেতু বেশিরভাগ সময় মার্চেন্ট স্ট্যাটাস ঘন ঘন পরিবর্তিত হয় না, তাই পুনরুদ্ধার করা ফলাফলগুলি ক্যাশে করার এবং পর্যায়ক্রমে (যেমন প্রতি কয়েক ঘন্টা অন্তর) নতুন কোয়েরির মাধ্যমে সেগুলি পুনরুদ্ধার করার পরামর্শ দেওয়া হয়। প্রতি সেকেন্ডে অনুরোধের সংখ্যা অত্যধিক বেশি মনে হলে অ্যাকশন সেন্টার আপনার কোয়েরিগুলিকে থ্রোটল করতে পারে।