অ্যাপয়েন্টমেন্ট এপিআই-এর মাধ্যমে বণিক স্থিতি অনুসন্ধানের পুনঃনির্দেশ

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

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

বণিক স্থিতি API-এর ক্ষেত্রে ব্যবহার করুন:

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

বণিক স্থিতি ধারণ করে কি

মার্চেন্ট স্ট্যাটাসে নিম্নলিখিত তথ্য রয়েছে:

• মার্চেন্ট ইনভেন্টরি স্ট্যাটাস: বুকিং এবং/অথবা অপেক্ষা তালিকা ব্যবসায়ী উভয়ের ক্ষেত্রেই প্রযোজ্য।
• বণিক মেলার স্থিতি: মিলে যাওয়া ব্যবসার তালিকার বিশদ বিবরণ অন্তর্ভুক্ত করে
• শুধুমাত্র Google লোকাল সার্ভিস বিজ্ঞাপনের জন্য) মিলে যাওয়া বণিক পরিষেবা প্রদানকারী: গ্রাহক আইডি এবং পরিষেবা বিভাগগুলি অন্তর্ভুক্ত করে।
• 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"
  }

এই প্রতিক্রিয়াটিতে 50টি মার্চেন্ট স্ট্যাটাস থাকবে যা ফিল্টারিং শর্ত পূরণ করে এবং merchant_id দ্বারা অর্ডার করা হয়। পরবর্তী পৃষ্ঠায় জিজ্ঞাসা করার জন্য প্রতিক্রিয়াটিতে একটি পৃষ্ঠা টোকেনও রয়েছে (যদি এটি শেষ পৃষ্ঠা না হয়)।

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

সেরা অনুশীলন

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