অবস্থান ডেটা নিয়ে কাজ করুন

এই টিউটোরিয়ালটি দেখায় কিভাবে অবস্থান ডেটা তৈরি এবং সম্পাদনা করতে হয়। My Business Business Information API আপনাকে নিম্নলিখিত কাজ করার ক্ষমতা প্রদান করে:

• একটি নতুন অবস্থান তৈরি করুন ।
• একটি অবস্থান মুছুন ।
• সম্পদের নাম দ্বারা একটি অবস্থান পান ।
• একটি অ্যাকাউন্টের জন্য সমস্ত অবস্থানের তালিকা করুন ।
• একটি অবস্থানের জন্য এক বা একাধিক ক্ষেত্র আপডেট করুন ।

অবস্থানগুলি বিজ্ঞাপনগুলিতে ব্যবহার করা যেতে পারে, তবে অনুসন্ধান এবং মানচিত্রে প্রদর্শিত হওয়ার যোগ্য হওয়ার জন্য সেগুলিকে যাচাই করতে হবে৷ অবস্থান ডেটা accounts.locations সংগ্রহ দ্বারা প্রতিনিধিত্ব করা হয়।

আপনি শুরু করার আগে

আপনি My Business Business Information API ব্যবহার করার আগে, আপনাকে আপনার আবেদন নিবন্ধন করতে হবে এবং OAuth 2.0 শংসাপত্রগুলি পেতে হবে। My Business Business Information API এর সাথে কিভাবে শুরু করবেন তার বিস্তারিত জানার জন্য, বেসিক সেটআপ দেখুন।

একটি অবস্থান তৈরি করুন

আপনি accounts.locations.create এর মাধ্যমে একটি ব্যবসার জন্য একটি নতুন অবস্থান তৈরি করতে My Business Business Information API ব্যবহার করতে পারেন।

একটি অবস্থান তৈরি করতে, নিম্নলিখিত ব্যবহার করুন:

POST
https://mybusinessbusinessinformation.googleapis.com/v1/accounts/{accountId}/locations?requestId=requestId&validateOnly=True|False

{
    "storeCode": "GOOG-SYD",
    "languageCode": "en-AU",
    "title": "Google Sydney",
    "phoneNumbers": {
      "primaryPhone": "02 9374 4000"
     }
    "storefrontAddress": {
      "addressLines": [
        "Level 5",
        "48 Pirrama Road"
      ],
      "locality": "Pyrmont",
      "postalCode": "2009",
      "administrativeArea": "NSW",
      "regionCode": "AU"
    },
    "websiteUri": "https://www.google.com.au/",
    "regularHours": {
      "periods": [
        {
          "openDay": "MONDAY",
          "closeDay": "MONDAY",
          "openTime": "09:00",
          "closeTime": "17:00"
        },
        {
          "openDay": "TUESDAY",
          "closeDay": "TUESDAY",
          "openTime": "09:00",
          "closeTime": "17:00"
        },
        {
          "openDay": "WEDNESDAY",
          "closeDay": "WEDNESDAY",
          "openTime": "09:00",
          "closeTime": "17:00"
        },
        {
          "openDay": "THURSDAY",
          "closeDay": "THURSDAY",
          "openTime": "09:00",
          "closeTime": "17:00"
        },
        {
          "openDay": "FRIDAY",
          "closeDay": "FRIDAY",
          "openTime": "09:00",
          "closeTime": "17:00"
        }
      ]
    },
    "categories": {
      "primaryCategory": {
        "name": "gcid:software_company"
      }
     }
}

একটি অবস্থান মুছুন

আপনি locations.delete এর সাথে একটি অবস্থান মুছে ফেলতে My Business Business Information API ব্যবহার করতে পারেন।

একটি অবস্থান মুছে ফেলার জন্য, নিম্নলিখিত ব্যবহার করুন:

DELETE
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}

নাম দ্বারা একটি অবস্থান পান

আপনার অ্যাকাউন্টের সাথে যুক্ত অনেক ব্যবসা থাকলে, আপনি একটি একক অবস্থান পেতে চাইতে পারেন। আপনি locations.get এর সাথে একটি নির্দিষ্ট অবস্থান পেতে ব্যবসার নাম দ্বারা ফিল্টার করতে পারেন।

নাম দ্বারা একটি অবস্থান পেতে, নিম্নলিখিত ব্যবহার করুন. নির্দিষ্ট ক্ষেত্র পুনরুদ্ধার করতে আপনাকে অবশ্যই একটি readMask নির্দিষ্ট করতে হবে। :

GET
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?readMask={commaSeparatedFieldsToRetrieve}

Google Maps সংস্করণটি ফেরত দিন

GET
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}:googleUpdated?readMask={commaSeparatedFieldsToRetrieve}

কোন ফলাফল না থাকলে, একটি 404 NOT FOUND HTTP স্ট্যাটাস কোড ফেরত দেওয়া হয়। গুগল আপডেট পরিচালনার বিষয়ে আরও বিশদ এখানে পাওয়া যাবে।

অবস্থান তালিকা

আপনি যখন এক বা একাধিক অবস্থান পরিচালনা করেন, তখন আপনি আপনার অ্যাকাউন্টের সাথে যুক্ত সমস্ত অবস্থান তালিকাভুক্ত করতে চাইতে পারেন৷ ব্যবহারকারীর সাথে যুক্ত সমস্ত অবস্থান তালিকাভুক্ত করতে accounts.locations.list API ব্যবহার করুন৷

একটি প্রমাণীকৃত ব্যবহারকারীর সরাসরি মালিকানাধীন বা পরিচালিত সমস্ত অবস্থান তালিকাভুক্ত করতে, নিম্নলিখিতগুলি ব্যবহার করুন:

GET
https://mybusinessbusinessinformation.googleapis.com/v1/accounts/{accountId}/locations?readMask={commaSeparatedFieldsToRetrieve}

পরোক্ষভাবে মালিকানাধীন তালিকা অন্তর্ভুক্ত করতে অনুরোধ URL-এ অ্যাকাউন্টের জন্য একটি '-' ওয়াইল্ডকার্ড ব্যবহার করুন (একটি গ্রুপের মাধ্যমে মালিকানাধীন বা পরিচালিত):

GET
https://mybusinessbusinessinformation.googleapis.com/v1/accounts/-/locations?readMask={commaSeparatedFieldsToRetrieve}

আপনি অবস্থান তালিকাভুক্ত করার সময় ফলাফল ফিল্টার করুন

GET
https://mybusinessbusinessinformation.googleapis.com/v1/accounts/{accountId}/locations?readMask={commaSeparatedFieldsToRetrieve}&filter={FIELD_NAME}=%22{YOUR_QUERY}%22

মৌলিক ক্যোয়ারী সিনট্যাক্স

একটি সীমাবদ্ধতার নিম্নলিখিত সিনট্যাক্স রয়েছে: <field><operator><value> , যেখানে অপারেটর হয় EQUALS (=) বা HAS (:)। EQUALS (=) এবং HAS (:) অপারেটরগুলি locationName ব্যতীত সমস্ত ক্ষেত্রের জন্য সমতুল্য (নীচের সারণী দেখুন)।

উদ্ধৃতি চিহ্নগুলি "%22" হিসাবে এনকোড করা হয়েছে এবং স্পেসগুলি প্লাস চিহ্ন ( + ) হিসাবে।

অন্যথায় উল্লেখ করা না থাকলে, সমস্ত তুলনা হল কেস সংবেদনশীল টোকেন তুলনা। উদাহরণস্বরূপ, "4 ড্রাইভ" মিলবে "4, প্রাইভেট ড্রাইভ"।

একটি ফিল্টার ক্যোয়ারীতে একাধিক ক্ষেত্র একত্রিত করুন

API সমস্ত ক্ষেত্রের সীমাবদ্ধতাগুলিকে সংযোগ করার অনুমতি দেয়। যাইহোক, যখন OR কীওয়ার্ড আসে, সমস্ত সীমাবদ্ধতা একই ক্ষেত্রে প্রয়োগ করতে হবে। যেমন: locationName=A OR labels=B অনুমোদিত নয়।

উদাহরণ

নিম্নলিখিত উদাহরণটি একটি ফিল্টার অভিব্যক্তি দেখায় যা "পেপে লে পিউ" নামের সাথে সমস্ত অবস্থান ফেরত দেয়। এটি "ফ্রেঞ্চ_রেস্তোরাঁ" বা "ইউরোপীয়_রেস্তোরাঁ" এবং "নতুন খোলা"-এর একটি লেবেলের জন্য বিভাগ দেখায়।

locationName=%22Pepé+Le+Pew%22+AND+
(categories=%22french_restaurant%22+OR+
categories=%22european_restaurant%22)+AND+
labels=%22newly+open%22

দূরত্ব বা অ্যাকাউন্ট দ্বারা অনুসন্ধান করুন

নিম্নলিখিত উদাহরণটি দেখায় যে আপনি কীভাবে একটি ভৌগলিক বিন্দু থেকে একটি নির্দিষ্ট দূরত্বের মধ্যে অবস্থানগুলি অনুসন্ধান করতে পারেন:

GET
https://mybusinessbusinessinformation.googleapis.com/v1/accounts/{accountId}/locations?readMask={commaSeparatedFieldsToRetrieve}&filter=distance(latlng, geopoint({latitude}, {longitude}))<{distance}

GET
https://mybusinessbusinessinformation.googleapis.com/v1/accounts/{accountId}/locations?readMask={commaSeparatedFieldsToRetrieve}&filter=distance(latlng, geopoint(40.01, -105.27))<1000.0

সমস্ত সমর্থিত ফিল্টার ক্ষেত্রের তালিকা

ফিল্টারিংয়ের জন্য ব্যবহার করা যেতে পারে এমন সমস্ত ক্ষেত্রের একটি সম্পূর্ণ তালিকা নীচে দেওয়া হল:

ক্যোয়ারী ক্ষেত্র অনুসারে সাজান

আপনি ব্যবসার নাম বা স্টোর কোড অনুসারে ফলাফলগুলি ক্রমবর্ধমান বা অবরোহী ক্রমে সাজাতে পারেন৷ একাধিক অর্ডারের মানদণ্ড orderBy স্ট্রিং-এ কমা দ্বারা পৃথক করা হয়েছে, যেমনটি নিম্নলিখিত উদাহরণে রয়েছে:

GET
https://mybusinessbusinessinformation.googleapis.com/v1/accounts/{accountId}/locations?readMask={commaSeparatedFieldsToRetrieve}&orderBy=locationName,storeCode

একটি অবস্থান প্যাচ করুন

locations.patch সহ একটি অবস্থানের জন্য এক বা একাধিক ক্ষেত্র আপডেট করতে আমার ব্যবসার তথ্য API ব্যবহার করুন।

একটি অবস্থানের জন্য এক বা একাধিক ক্ষেত্র পরিবর্তন করতে, নিম্নলিখিতগুলি ব্যবহার করুন:

PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?languageCode=language&validateOnly=True|False&updateMask=title
{
    "title": "Google Shoes"
}