লোকেশন ও অ্যাট্রিবিউটের জন্য এডিট স্ট্যাটাস চেক করা

আপনি My Business Business Information API বা Business Profile UI-এর মাধ্যমে ব্যবসার তথ্য আপডেট করলে, Google Search এবং Maps-এ লাইভ হওয়ার আগে এডিটগুলি মডারেশন এবং যাচাইকরণ পাইপলাইনের মাধ্যমে পাস হয়। এছাড়াও, ব্যবহারকারীর অভিযোগ বা লাইসেন্সপ্রাপ্ত ডেটা সোর্সের ভিত্তিতে Google ব্যবসার বিবরণ আপডেট করতে পারে।

v1alpha এডিট স্ট্যাটাস এন্ডপয়েন্ট আপনাকে একটি লোকেশন বা তার অ্যাট্রিবিউটের ইউনিফায়েড ভিউ একটি অনুরোধের মাধ্যমে ফিরিয়ে আনতে দেয়:

  • মার্চেন্টের দেওয়া ডেটা: মার্চেন্টের শেষবার জমা দেওয়া ভ্যালু।
  • গ্রাহকের জন্য ডেটা: Google Search এবং Maps-এ লাইভ ভ্যালু।
  • এক্সটেন্ডেড ফিল্ড মেটাডেটা: প্রতিটি ফিল্ড বা প্রতিটি অ্যাট্রিবিউট এডিট করার স্ট্যাটাস, যার মধ্যে রয়েছে লেটেস্ট এডিটের লাইফসাইকেল স্টেজ, মূল সোর্স (API বা UI), শেষ এডিটের টাইমস্ট্যাম্প এবং কোনও এডিট বাতিল করা হলে, নীতি লঙ্ঘনের কারণ।

শুরু করার আগে

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

বর্ধিত লোকেশন ডেটা ফিরিয়ে আনে

মার্চেন্টের দেওয়া লোকেশন ডেটা, গ্রাহকের জন্য লোকেশন ডেটা এবং প্রতিটি ফিল্ডের জন্য লোকেশনের এডিট স্ট্যাটাস চেক করতে, locations.getExtended কল করুন।

locations.get-এর মতো নয়, locations.getExtended-এর জন্য readMask প্যারামিটার প্রয়োজন হয় না এবং এটি সম্পূর্ণ ExtendedLocation রিসোর্স ফিরিয়ে দেয়।

অনুরোধ করুন

HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1alpha/locations/{locationId}:getExtended

রেসপন্স

রেসপন্সে তিনটি টপ-লেভেল ফিল্ড থাকে:

  • locationProvidedByMerchant: Location ডেটা মার্চেন্ট ম্যানেজ করেন।
  • locationSeenByConsumers: Google Search ও Maps-এ গ্রাহকদের দেখানো Location ডেটা।
  • extendedFieldData: snake_case-এ টপ-লেভেল Location ফিল্ডের নামের ম্যাপ (যেমন title, phone_numbers, website_uri, storefront_address, অথবা regular_hours) থেকে ExtendedFieldData অবজেক্ট। কী সবসময় সাধারণ টপ-লেভেল ফিল্ডের নাম হয়, কখনও নেস্টেড সাবফিল্ড হয় না।
{
  "locationProvidedByMerchant": {
    "name": "locations/{locationId}",
    "title": "Example Coffee Roasters - Best Coffee in Sydney",
    "phoneNumbers": {
      "primaryPhone": "02 5550 1234"
    },
    "websiteUri": "https://www.example.com/"
  },
  "locationSeenByConsumers": {
    "name": "locations/{locationId}",
    "title": "Example Coffee Roasters",
    "phoneNumbers": {
      "primaryPhone": "+61 2 5550 1234"
    },
    "websiteUri": "https://www.example.com/"
  },
  "extendedFieldData": {
    "title": {
      "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_REJECTED",
      "rejectionReason": "MISREPRESENTATION",
      "updateTime": "2026-09-25T08:00:00Z",
      "source": "SOURCE_API"
    },
    "phone_numbers": {
      "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_UPDATED_BY_GOOGLE",
      "updateTime": "2026-09-20T14:15:00Z",
      "source": "SOURCE_UI"
    },
    "website_uri": {
      "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_ACCEPTED",
      "updateTime": "2026-09-15T10:30:00Z",
      "source": "SOURCE_API"
    }
  }
}

বর্ধিত অ্যাট্রিবিউট ডেটা পুনরুদ্ধার করে

কোনও লোকেশনের অ্যাট্রিবিউটের জন্য মার্চেন্টের দেওয়া ভ্যালু, গ্রাহকের জন্য ভ্যালু এবং এডিট স্ট্যাটাস পরীক্ষা করতে, locations.attributes.getExtended কল করুন।

অনুরোধ করুন

HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1alpha/locations/{locationId}/attributes:getExtended

রেসপন্স

উত্তরে ExtendedAttributes রিসোর্স পাওয়া যায় যার মধ্যে ExtendedAttribute এন্ট্রির তালিকা থাকে। প্রতিটি এন্ট্রি, সেই অ্যাট্রিবিউটের জন্য extendedFieldData অবজেক্টের সাথে attributeProvidedByMerchant এবং attributeSeenByConsumers-কে পেয়ার করে:

{
  "name": "locations/{locationId}/attributes",
  "extendedAttributes": [
    {
      "attributeProvidedByMerchant": {
        "name": "attributes/has_wheelchair_accessible_entrance",
        "valueType": "BOOL",
        "values": [
          true
        ]
      },
      "attributeSeenByConsumers": {
        "name": "attributes/has_wheelchair_accessible_entrance",
        "valueType": "BOOL",
        "values": [
          true
        ]
      },
      "extendedFieldData": {
        "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_ACCEPTED",
        "updateTime": "2026-09-10T12:00:00Z",
        "source": "SOURCE_API"
      }
    },
    {
      "attributeProvidedByMerchant": {
        "name": "attributes/wi_fi",
        "valueType": "ENUM",
        "values": [
          "free_wi_fi"
        ]
      },
      "attributeSeenByConsumers": {
        "name": "attributes/wi_fi",
        "valueType": "ENUM",
        "values": [
          "paid_wi_fi"
        ]
      },
      "extendedFieldData": {
        "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_PENDING",
        "updateTime": "2026-09-28T16:45:00Z",
        "source": "SOURCE_API"
      }
    }
  ]
}

এক্সটেন্ডেড ফিল্ড মেটাডেটা সম্পর্কে বোঝা

প্রতিটি ExtendedFieldData অবজেক্টে নিম্নলিখিত ফিল্ড থাকে:

ফিল্ড ধরন বিবরণ
lastEditLifecycleStage EditLifecycleStage এই ফিল্ড বা অ্যাট্রিবিউটে সবচেয়ে সাম্প্রতিক এডিটের মডারেশন বা দেখানোর স্ট্যাটাস।
rejectionReason PolicyViolation নীতি লঙ্ঘনের কারণে এডিট বাতিল করা হয়েছে। lastEditLifecycleStage, EDIT_LIFECYCLE_STAGE_REJECTED হলে পপুলেট করা হয়।
updateTime string (Timestamp) এই ফিল্ড বা অ্যাট্রিবিউটে শেষবার এডিট করার টাইমস্ট্যাম্প (RFC 3339 ফর্ম্যাট)।
source Source যে সারফেস থেকে মার্চেন্ট এডিট জমা দিয়েছেন (SOURCE_API বা SOURCE_UI)।

লাইফসাইকেল স্টেজ এডিট করুন

EditLifecycleStage enum থেকে বোঝা যায় যে এডিটটি তার লাইফসাইকেলের কোন পর্যায়ে আছে:

ভ্যালু বিবরণ প্রস্তাবিত অ্যাকশন
EDIT_LIFECYCLE_STAGE_ACCEPTED মার্চেন্টের এডিট অনুমোদন করা হয়েছে এবং দেখানোর জন্য উপযুক্ত। কিছু প্রয়োজন নেই।
EDIT_LIFECYCLE_STAGE_PENDING মার্চেন্টের এডিট পর্যালোচনা করা হচ্ছে এবং গ্রাহকের জন্য উপলভ্য লিস্টিংয়ে তা প্রয়োগ করা হয়নি। মডারেশন সম্পূর্ণ হওয়ার জন্য অপেক্ষা করুন। কোনও এডিট বাকি থাকলে, একই এডিট বারবার জমা দেবেন না।
EDIT_LIFECYCLE_STAGE_REJECTED মার্চেন্টের করা এডিট গ্রহণ করা হয়নি। নির্দিষ্ট PolicyViolation ভ্যালুর জন্য rejectionReason চেক করুন। নীতি লঙ্ঘনের সমস্যা সমাধান করুন এবং locations.patch বা locations.updateAttributes ব্যবহার করে নতুন আপডেট জমা দিন।
EDIT_LIFECYCLE_STAGE_UPDATED_BY_GOOGLE গ্রাহকের জন্য দেখানো ভ্যালু Google আপডেট করেছে (যেমন, ব্যবহারকারীর রিপোর্ট বা এক্সটার্নাল সোর্স থেকে) এবং এটি মার্চেন্টের দেওয়া ভ্যালুর থেকে আলাদা। locationSeenByConsumers বা attributeSeenByConsumers ভ্যালু পর্যালোচনা করে সেটি গ্রহণ বা ওভাররাইড করুন। Google আপডেট ম্যানেজ করুন বিকল্পটি দেখুন।
EDIT_LIFECYCLE_STAGE_DRAFT এডিটটি ড্রাফ্ট হিসেবে সেভ করা হয়েছে (যেমন, যাচাই না করা লোকেশনে) এবং Google Search ও Maps-এ লাইভ নেই। লোকেশন যাচাইকরণ সম্পূর্ণ করুন যাতে লিস্টিং লাইভ করা যায়।
EDIT_LIFECYCLE_STAGE_UNSPECIFIED এডিট লাইফসাইকেল স্টেজ অজানা বা উল্লেখ করা নেই। কোনওটিই নয়।

সোর্স এডিট করুন

Source enum সেই চ্যানেলকে শনাক্ত করে যার মাধ্যমে মার্চেন্ট এডিট জমা দিয়েছেন:

  • SOURCE_API: My Business Business Information API-এর মাধ্যমে এডিট জমা দেওয়া হয়েছে।
  • SOURCE_UI: Business Profile ওয়েব UI বা মোবাইল অ্যাপের মাধ্যমে এডিট জমা দেওয়া হয়েছে।
  • SOURCE_UNSPECIFIED: এডিটের সোর্স নির্দিষ্ট করা নেই।

নীতি লঙ্ঘন

lastEditLifecycleStage-এর মান EDIT_LIFECYCLE_STAGE_REJECTED হলে, rejectionReason ফিল্ডে PolicyViolation enum ভ্যালু থাকে যা থেকে বোঝা যায় যে এডিট কেন বাতিল করা হয়েছে। বাতিল করার কারণের মধ্যে নিম্নলিখিত ক্ষেত্রগুলি (উদাহরণ) অন্তর্ভুক্ত:

  • প্রোফাইল ও অ্যাকাউন্টের স্ট্যাটাস: ACCOUNT_RESTRICTED_AND_SUSPENDED, ACCOUNT_RESTRICTED_AND_EDIT_REJECTED, ASSOCIATED_ACCOUNT_SUSPENDED, BUSINESS_INELIGIBLE, LOCATION_SUSPENDED, LOCATION_VERIFICATION_REQUIRED, OWNERSHIP_REVOKED, PO_BOX.
  • এডিট করার ক্ষেত্রে বিধিনিষেধ: EDITING_RESTRICTION, ILLEGAL_BUSINESS_HOURS_EDIT, IDENTITY_CHANGE, GEOGRAPHIC_LOCATION_CHANGE.
  • কন্টেন্ট নীতি: MISREPRESENTATION, OFF_TOPIC, PERSONAL_INFO, GIBBERISH_AND_REPETITIVE, OBSCENITY_AND_PROFANITY, GENERIC_QUALITY.

enum ভ্যালু ও বিবরণের সম্পূর্ণ তালিকা দেখতে, PolicyViolation রেফারেন্স ডকুমেন্টেশন দেখুন।