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

এই টিউটোরিয়ালটি দেখায় কিভাবে অবস্থান ডেটা তৈরি এবং সম্পাদনা করতে হয়। 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 ব্যবহার করতে পারেন।

দ্রষ্টব্য: My Business Business Information API ব্যবসায়িক প্রোফাইল UI হিসাবে প্রয়োজনীয় ক্ষেত্রের একই তালিকা শেয়ার করে।

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

HTTP

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 ব্যবহার করতে পারেন।

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

HTTP

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

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

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

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

HTTP

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

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

HTTP

একটি অবস্থানের Google মানচিত্র সংস্করণ ফেরত দিতে, অনুরোধ URL-এ googleUpdated যুক্ত করুন, নিম্নলিখিত উদাহরণের মতো:

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

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

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

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

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

HTTP

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

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

HTTP

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

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

HTTP

আপনি accounts.locations.list কল করার সময় যে ফলাফলগুলি ফেরত আসে তা সীমিত করতে আপনি ফিল্টার ব্যবহার করতে পারেন। একটি অনুরোধ ফিল্টার করতে, এই উদাহরণে দেখানো বেস URL-এ একটি ফিল্টার এক্সপ্রেশন যোগ করুন:

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

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

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

HTTP

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

বোল্ডার, কলোরাডো মার্কিন যুক্তরাষ্ট্রের 1000 মাইলের মধ্যে অবস্থানগুলি ফিল্টার করতে:

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

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

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

ক্ষেত্র	বর্ণনা এবং উদাহরণ
স্ট্রিং ম্যাচিং ক্ষেত্র
title	ব্যবসার আসল নাম https://mybusinessbusinessinformation.googleapis.com/v1/accounts/ {accountId} /locations?readMask= {commaSeparatedFieldsToRetrieve} &filter=title:"Bajis" (একটি সাবস্ট্রিং হিসাবে "Bajis" এর সাথে যেকোনো অবস্থানের নামের সাথে মিলে যায়) https://mybusinessbusinessinformation.googleapis.com/v1/accounts/ {accountId} /locations?readMask= {commaSeparatedFieldsToRetrieve} &filter=title="Bajis" (টোকেন/শব্দ হিসাবে "বাজিস" এর সাথে যেকোনো অবস্থানের নামের সাথে মিলে যায়)
categories	প্রাথমিক বিভাগ এবং অতিরিক্ত বিভাগগুলির সমন্বয়। মনে রাখবেন যে "gcid:" বাদ দিতে হবে। একাধিক বিভাগ থাকলে, এই ফিল্টারটি মেলে যদি অন্তত একটি বিভাগ এই প্যাটার্নের সাথে মেলে। https://mybusinessbusinessinformation.googleapis.com/v1/accounts/ {accountId} /locations?readMask= {commaSeparatedFieldsToRetrieve} &filter=categories="french_restaurant"
phone_numbers.primary_phone	E.164 ফর্ম্যাটে প্রাথমিক ফোন নম্বর (উদাহরণস্বরূপ: "[phone]")। https://mybusinessbusinessinformation.googleapis.com/v1/accounts/ {accountId} /locations?readMask= {commaSeparatedFieldsToRetrieve} &filter=phone_numbers.primary_phone="[phone]"
storefront_address.region_code	ঠিকানার দেশ/অঞ্চলের CLDR অঞ্চল কোড https://mybusinessbusinessinformation.googleapis.com/v1/accounts/ {accountId} /locations?readMask= {commaSeparatedFieldsToRetrieve} &filter=storefront_address.region_code="US"
storefront_address.administrative_area	সর্বোচ্চ প্রশাসনিক উপবিভাগ যা একটি দেশ বা অঞ্চলের ডাক ঠিকানার জন্য ব্যবহৃত হয় https://mybusinessbusinessinformation.googleapis.com/v1/accounts/ {accountId} /locations?readMask= {commaSeparatedFieldsToRetrieve} &filter=storefront_address.administrative_area="CA"
storefront_address.locality	ঠিকানার শহর/শহরের অংশ https://mybusinessbusinessinformation.googleapis.com/v1/accounts/ {accountId} /locations?readMask= {commaSeparatedFieldsToRetrieve} &filter=storefront_address.locality="New York"
storefront_address.postal_code	ঠিকানার পোস্টাল কোড https://mybusinessbusinessinformation.googleapis.com/v1/accounts/ {accountId} /locations?readMask= {commaSeparatedFieldsToRetrieve} &filter=storefront_address.postal_code="12345"
metadata.place_id	যদি এই অবস্থানটি যাচাই করা হয়ে থাকে এবং Google মানচিত্রের সাথে সংযুক্ত/আবির্ভূত হয়, তাহলে এই ক্ষেত্রটি অবস্থানের জন্য স্থান আইডির সমান https://mybusinessbusinessinformation.googleapis.com/v1/accounts/ {accountId} /locations?readMask= {commaSeparatedFieldsToRetrieve} &filter=metadata.place_id="12345"
openInfo.status	অবস্থানটি বর্তমানে ব্যবসার জন্য খোলা আছে কি না তা নির্দেশ করে ( OPEN , CLOSED_PERMANENTLY ) https://mybusinessbusinessinformation.googleapis.com/v1/accounts/ {accountId} /locations?readMask= {commaSeparatedFieldsToRetrieve} &filter=openInfo.status="OPEN" https://mybusinessbusinessinformation.googleapis.com/v1/accounts/ {accountId} /locations?readMask= {commaSeparatedFieldsToRetrieve} &filter=openInfo.status="CLOSED_PERMANENTLY"
labels	আপনাকে আপনার ব্যবসা ট্যাগ করার অনুমতি দেওয়ার জন্য ফ্রি-ফর্ম স্ট্রিংগুলির একটি সংগ্রহ৷ অন্যান্য সমস্ত ক্ষেত্রের বিপরীতে, এই মানটি অবশ্যই কেসিং সহ একটি সম্পূর্ণ লেবেলের সাথে মিলবে এবং শুধুমাত্র একটি টোকেন নয়। যেমন একটি লেবেল যদি "XX YY" হয়, তাহলে "XX" বা "xx yy" কোনোটিই মিলবে না৷ https://mybusinessbusinessinformation.googleapis.com/v1/accounts/ {accountId} /locations?readMask= {commaSeparatedFieldsToRetrieve} &filter=labels="newly open"
storeCode	এই অবস্থানের জন্য বাহ্যিক শনাক্তকারী, যা একটি প্রদত্ত অ্যাকাউন্টের মধ্যে অনন্য হতে হবে https://mybusinessbusinessinformation.googleapis.com/v1/accounts/ {accountId} /locations?readMask= {commaSeparatedFieldsToRetrieve} &filter=storeCode="12345"
ফাংশন
distance	একটি ভৌগলিক বিন্দু থেকে অবস্থানের দূরত্বের উপর ভিত্তি করে আপনাকে ফিল্টার করার অনুমতি দেয়। https://mybusinessbusinessinformation.googleapis.com/v1/accounts/ {accountId} /locations?readMask= {commaSeparatedFieldsToRetrieve} &filter=distance(latlng, geopoint(1.0, -25.0))<1000.0

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

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

HTTP

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

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

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

গুরুত্বপূর্ণ: প্যাচ অনুরোধে একটি updateMask ব্যবহার করা প্রয়োজন। শুধুমাত্র একটি আপডেট প্রয়োজন যে ক্ষেত্র অন্তর্ভুক্ত.

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

HTTP

অবস্থান ক্ষেত্রের সাথে ক্ষেত্র এবং আপডেট করা মানগুলি যোগ করুন এবং fieldMask মান হিসাবে আপডেট করা ক্ষেত্রগুলির একটি কমা দ্বারা পৃথক করা তালিকা ব্যবহার করুন।

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