जगहों और एट्रिब्यूट में किए गए बदलावों का स्टेटस देखना

My Business Business Information API या Business Profile के यूज़र इंटरफ़ेस (यूआई) से कारोबार की जानकारी अपडेट करने पर, बदलावों को Google Search और Maps पर लाइव दिखने से पहले, समीक्षा और पुष्टि की प्रोसेस से गुज़रना पड़ता है. इसके अलावा, Google, उपयोगकर्ता की रिपोर्ट या लाइसेंस वाले डेटा सोर्स के आधार पर, कारोबार की जानकारी अपडेट कर सकता है.

v1alpha Edit Status एंडपॉइंट की मदद से, एक ही अनुरोध में किसी जगह या उसके एट्रिब्यूट की जानकारी को एक ही जगह पर देखा जा सकता है:

  • कारोबारी या कंपनी की ओर से दिया गया डेटा: कारोबारी या कंपनी की ओर से सबमिट की गई आखिरी वैल्यू.
  • उपभोक्ताओं को दिखने वाला डेटा: Google Search और Maps पर दिखने वाली वैल्यू.
  • फ़ील्ड का ज़्यादा मेटाडेटा: हर फ़ील्ड या हर एट्रिब्यूट में किए गए बदलाव की स्थिति. इसमें, हाल ही में किए गए बदलाव की लाइफ़साइकल स्टेज, ओरिजनल सोर्स (API या UI), पिछली बार किए गए बदलाव का टाइमस्टैंप, और नीति के उल्लंघन की कोई वजह शामिल है. ऐसा तब होता है, जब बदलाव को अस्वीकार कर दिया गया हो.

शुरू करने से पहले

My Business Business Information API का इस्तेमाल करने से पहले, अपना ऐप्लिकेशन रजिस्टर करें और OAuth 2.0 क्रेडेंशियल पाएं. शुरू करने के तरीके के बारे में ज़्यादा जानने के लिए, बेसिक सेटअप देखें.

जगह की जानकारी का ज़्यादा डेटा वापस पाना

कारोबारी या कंपनी से मिले जगह की जानकारी के डेटा, उपभोक्ता को दिखने वाले जगह की जानकारी के डेटा, और किसी जगह के लिए हर फ़ील्ड में बदलाव की स्थिति की जांच करने के लिए, locations.getExtended को कॉल करें.

locations.get के उलट, locations.getExtended के लिए readMask पैरामीटर की ज़रूरत नहीं होती. साथ ही, यह पूरा ExtendedLocation संसाधन दिखाता है.

अनुरोध

एचटीटीपी
GET https://mybusinessbusinessinformation.googleapis.com/v1alpha/locations/{locationId}:getExtended

जवाब

जवाब में तीन टॉप-लेवल फ़ील्ड होते हैं:

  • locationProvidedByMerchant: कारोबारी या कंपनी की ओर से मैनेज किया गया Location डेटा.
  • locationSeenByConsumers: Location का डेटा, जो Google Search और Maps पर उपभोक्ताओं को दिखता है.
  • 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 को कॉल करें.

अनुरोध

एचटीटीपी
GET https://mybusinessbusinessinformation.googleapis.com/v1alpha/locations/{locationId}/attributes:getExtended

जवाब

जवाब में एक ExtendedAttributes संसाधन मिलता है, जिसमें ExtendedAttribute एंट्री की सूची होती है. हर एंट्री, उस एट्रिब्यूट के लिए attributeProvidedByMerchant और attributeSeenByConsumers को extendedFieldData ऑब्जेक्ट के साथ जोड़ती है:

{
  "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) इस फ़ील्ड या एट्रिब्यूट में आखिरी बार किए गए बदलाव को सबमिट करने का टाइमस्टैंप (आरएफ़सी 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 के वेब यूज़र इंटरफ़ेस (यूआई) या मोबाइल ऐप्लिकेशन से सबमिट किया गया था.
  • 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 रेफ़रंस दस्तावेज़ देखें.