अक्सर पूछे जाने वाले प्रश्न

GBP API क्या हैं?

Business Profile API, प्रोग्रामिंग इंटरफ़ेस हैं. इनकी मदद से डेवलपर, अपने Business Profile खाते और जगह की जानकारी के डेटा को मैनेज करने के लिए, ऐप्लिकेशन लिख सकते हैं. एपीआई की मदद से, व्यापारी/कंपनी/कारोबारी या उनके प्रतिनिधि यह मैनेज कर सकते हैं कि Google पर उनका डेटा किस तरह दिखे. साथ ही, यह कंट्रोल किया जा सकता है कि उनके डेटा को कौन मैनेज कर सकता है. उपयोगकर्ता का बनाया गया डेटा, जैसे कि फ़ोटो, पोस्ट, और समीक्षाएं, एपीआई के ज़रिए भी मैनेज की जा सकती हैं.

Business Profile API में भी काफ़ी हद तक Business Profile के यूज़र इंटरफ़ेस जैसी ही सुविधाएं मिलती हैं. इनमें एपीआई के लिए कुछ अन्य सुविधाएं भी शामिल हैं. एपीआई के उपयोगकर्ताओं के लिए यह उम्मीद की जा सकती है कि Google अपडेट ठीक वैसे ही होंगे जैसे यूज़र इंटरफ़ेस के उपयोगकर्ताओं के लिए होते हैं.

GBP API का ऐक्सेस किसे मिल सकता है?

GBP API आम लोगों के लिए उपलब्ध नहीं हैं. GBP API का इस्तेमाल करने के लिए, उपयोगकर्ताओं को उसे ऐक्सेस करने का अनुरोध करना होगा. GBP API को ऐक्सेस करने का कानूनी कारोबारी मकसद दिखाने वाले किसी भी व्यक्ति या कंपनी को उसे ऐक्सेस करने की मंज़ूरी दी जाएगी. कारोबार के कानूनी होने की पुष्टि करने के लिए, यहां कुछ सुझाव दिए गए हैं:

  • कारोबार के ऐसे मान्य ईमेल पते का इस्तेमाल करें जो आपके कारोबार के डोमेन से जुड़ा हो.
  • पक्का करें कि कारोबार की वेबसाइट अपडेट हो और लाइव हो.

क्या GBP API का ऐक्सेस होने पर उपयोगकर्ता, Google Business Profile के किसी डेटा के बारे में क्वेरी कर सकता है?

नहीं. GBP API का ऐक्सेस मिल जाने के बाद भी, Google Business Profile के डेटा को तब तक क्वेरी नहीं की जा सकती, जब तक आपके पास उस Google Business Profile का ऐक्सेस न हो.

GBP API का इस्तेमाल करने वाले लोगों के लिए कौनसी नीतियां काम की हैं?

पार्टनर को Google Business Profile की नीतियों के साथ-साथ, एपीआई की सभी नीतियों और नियमों और शर्तों का भी पालन करना होगा.

उपयोगकर्ताओं को GBP API का ऐक्सेस कैसे मिलता है?

अपना पहला क्लाइंट ऐप्लिकेशन बनाने के लिए, आपको नीचे दी गई ज़रूरी शर्तें पूरी करनी होंगी:

  1. कोई Google खाता बनाएं.
  2. Business Profile आज़माएं.
  3. Google API (एपीआई) कंसोल में कोई प्रोजेक्ट बनाएं.
  4. एपीआई को ऐक्सेस करने का अनुरोध करना: अनुरोधों की समीक्षा 14 दिनों में कर ली जाती है.

GBP API में, उपयोगकर्ता किसी खास एपीआई को कैसे ऐक्सेस करते हैं?

Business Profile से जुड़े आठ एपीआई, Google API Console में चालू किए जाने चाहिए:

  • Google My Business API 4.9, जिसमें एपीआई कॉल की ये अहम सुविधाएं शामिल हैं:
    • FoodMenus
    • Media
    • Reviews
    • LocalPosts
  • मेरा व्यवसाय खाता प्रबंधन API
  • My Business लॉजिंग एपीआई
  • My Business की जगह से जुड़ी कार्रवाइयों का एपीआई
  • My Business नोटिफ़िकेशन एपीआई
  • My Business की पुष्टि करने वाला एपीआई
  • मेरा व्यवसाय जानकारी एपीआई
  • My Business के सवाल और जवाब का एपीआई
  • Business Profile परफ़ॉर्मेंस एपीआई

अगर ऐक्सेस के अनुरोध के लिए किसी उपयोगकर्ता का ऐप्लिकेशन स्वीकार कर लिया जाता है, तो उसे सभी आठ एपीआई के लिए एक स्टैंडर्ड डिफ़ॉल्ट कोटा दिया जाता है.

GBP API का ऐक्सेस कैसे काम करता है?

Google Cloud प्रोजेक्ट लेवल पर, GBP API का ऐक्सेस दिया जाता है. अगर उपयोगकर्ता A ने प्रोजेक्ट # - 12345678 के लिए, Google Business Profile API को ऐक्सेस करने का आवेदन किया है, तो प्रोजेक्ट # - 12345678 को ऐक्सेस मिल जाता है. Google Cloud प्रोजेक्ट का ऐक्सेस रखने वाला कोई भी उपयोगकर्ता, Google Business Profile API को कॉल कर सकता है. इसमें उपयोगकर्ता A भी शामिल है. गलत इस्तेमाल से बचने के लिए, पार्टनर को Google Cloud प्रोजेक्ट के ऐक्सेस को ऐक्सेस करने की ज़रूरत के हिसाब से कंट्रोल करना चाहिए.

क्या आपके पास एपीआई के बारे में खास जानकारी और सुविधाओं के उदाहरण हैं?

अलग-अलग एपीआई और उनकी क्षमताओं के बारे में जानने के लिए, यहां दी गई टेबल देखें.

API रेफ़रंस डॉक्यूमेंटेशन क्षमताओं के उदाहरण
खाता मैनेजमेंट एपीआई दस्तावेज़
  • किसी जगह का ऐक्सेस मैनेज करना.
  • दिए गए पैरंट के तहत, बताए गए नाम और टाइप वाला खाता बनाता है.
  • पुष्टि किए गए उपयोगकर्ता के सभी खाते की सूची बनाता है.
  • यह डायलॉग बॉक्स तय किए गए खाते के लिए, ऐसे न्योतों की सूची बनाता है जिन्हें मंज़ूरी मिलना बाकी है.
  • किसी ऐसे खाते से जगह की जानकारी को ट्रांसफ़र करता है जिस पर उपयोगकर्ता का मालिकाना हक है.
  • बताई गई जगह के लिए एडमिन को अपडेट करता है.
Business Information API दस्तावेज़
  • Business Information API से, प्रोफ़ाइल की लाइफ़साइकल मैनेज की जा सकती है. साथ ही, GBP पर कारोबार की जानकारी जोड़ी या मैनेज की जा सकती है.
  • यह व्यापारियों/कंपनियों/कारोबारियों को Google Business Profile बनाने, उन्हें अपडेट करने या मिटाने की सुविधा देती है.
  • यह व्यापारियों/कंपनियों/कारोबारियों को प्रोफ़ाइल से जुड़े एट्रिब्यूट पाने या उन्हें अपडेट करने की सुविधा देता है.
  • इससे कारोबारियों या कंपनियों को चेन और प्रोफ़ाइल कैटगरी देखने या खोजने की सुविधा मिलती है.
Lodging API दस्तावेज़ के रूप में
  • इसकी मदद से, होटल से जुड़े डेटा को मैनेज किया जा सकता है. जैसे, प्रॉपर्टी की सुविधाएं, और Google पर कारोबारों के लिए नीतियां. यह एपीआई खास तौर पर, ठहरने से जुड़ी सेवाएं देने वाले कारोबारों के लिए है, जैसे कि होटल. Lodging API की मदद से डेवलपर, Google Business Profile पर मौजूद अपने होटल से जुड़े एट्रिब्यूट अपडेट कर सकते हैं.
Place Actions एपीआई दस्तावेज़
  • कारोबारों पर कार्रवाई करने के लिंक को मैनेज करने की अनुमति देता है.
  • लोगों को अपॉइंटमेंट बुक करने, टेबल बुक करने, और खाने की डिलीवरी का ऑर्डर देने जैसी कार्रवाइयां करने के लिए रीडायरेक्ट करना.
Notifications API दस्तावेज़
  • चुने गए खातों के लिए सूचना सेटिंग के मैनेजमेंट को चालू करता है.
पुष्टि करने वाला एपीआई दस्तावेज़
  • किसी जगह की पुष्टि करने की प्रक्रिया शुरू करता है.
  • किसी खास भाषा में किसी जगह के लिए पुष्टि करने के सभी ज़रूरी विकल्पों की रिपोर्ट करता है.
सवाल और जवाब का एपीआई दस्तावेज़ के रूप में
  • इसकी मदद से, किसी जगह के बारे में पूछे गए सवालों और जवाबों को मैनेज किया जा सकता है.
Business Profile की परफ़ॉर्मेंस एपीआई दस्तावेज़ के रूप में
  • इसकी मदद से व्यापारी Google पर अपने कारोबार की लिस्टिंग की परफ़ॉर्मेंस से जुड़ी अहम जानकारी पा सकते हैं.
  • अहम जानकारी में ये चीज़ें शामिल होती हैं: कारोबार के इंप्रेशन, निर्देश के अनुरोध, कॉल क्लिक, वेबसाइट पर होने वाले क्लिक, बुकिंग, खाने के ऑर्डर, मेन्यू इंटरैक्शन वगैरह.
मीडिया एपीआई दस्तावेज़
  • एपीआई डेवलपर को कारोबार की प्रोफ़ाइल के लिए फ़ोटो और वीडियो अपलोड करने की अनुमति देता है.
समीक्षाओं का एपीआई दस्तावेज़
  • यह व्यापारियों/कंपनियों/कारोबारियों को, कारोबार की प्रोफ़ाइल पर समीक्षाएं पाने और समीक्षाओं के जवाब देने की अनुमति देता है.
लोकल पोस्ट एपीआई दस्तावेज़
  • यह व्यापारियों/कंपनियों/कारोबारियों को स्थानीय पोस्ट पाने, बनाने या अपडेट करने की सुविधा देता है.
Foodमेन्यूs एपीआई दस्तावेज़ के रूप में
  • यह व्यापारियों/कंपनियों/कारोबारियों को, कारोबार की प्रोफ़ाइल के लिए खाने के मेन्यू पाने, बनाने या अपडेट करने की सुविधा देता है.

GBP API का इस्तेमाल करने के लिए, पार्टनर अपने खाते का स्ट्रक्चर कैसे सेट अप कर सकते हैं?

अगर आप तीसरे पक्ष के ऐसे पार्टनर हैं जो कारोबारों के लिए लिस्टिंग मैनेज करते हैं, तो:

कारोबार, GBP API पार्टनर को अपने कारोबार की लिस्टिंग मैनेज करने की अनुमति कैसे देते हैं?

कारोबार दो तरीकों से 3P पार्टनर को ऐक्सेस देते हैं:

  • OAuth सेटअप: यह गाइड देखें जानें कि 3P पार्टनर प्लैटफ़ॉर्म, व्यापारी/कंपनी/कारोबारी या कारोबार की तरफ़ से, Google Business Profile के डेटा में बदलाव करने और उसे ऐक्सेस करने के लिए, व्यापारी/कंपनी/कारोबारी के क्रेडेंशियल का इस्तेमाल कैसे करते हैं.

  • मालिक या मैनेजर का ऐक्सेस: अगर व्यापारी/कंपनी/कारोबारी ने Google Business Profile में किसी 3P पार्टनर को मैनेजर के तौर पर जोड़ा है और वह GBP का मुख्य मालिक होना चाहिए, तो उस कारोबार के क्रेडेंशियल का इस्तेमाल करने के लिए, 3P पार्टनर को GBP API का इस्तेमाल नहीं करना होगा.

    ध्यान दें: हमारा सुझाव है कि 3P पार्टनर, खुद को GBP के मालिक के तौर पर न जोड़ें, बल्कि खुद को मैनेजर के तौर पर जोड़ें.

अगर कोई कारोबार 10 से ज़्यादा जगहों पर मौजूद है, तो क्या एक साथ कई प्रोफ़ाइलों की पुष्टि कराने का कोई तरीका है?

हां. 10 से ज़्यादा प्रोफ़ाइलों के लिए, एक साथ पुष्टि का अनुरोध किया जा सकता है. पुष्टि होने के बाद, पब्लिश की गई चेन लोकेशन को Business Profile API के साथ उसी तरह मैनेज किया जा सकता है जिस तरह अन्य जगहों को मैनेज किया जाता है. हालांकि, इसमें कुछ अपवाद भी हैं. उदाहरण के लिए, साइट मैनेजर के साथ अलग तरह से पेश आएं और वे खुद को फ़्रेंचाइज़ लोकेशन में जोड़ सकते हैं.

अलग-अलग एपीआई के लिए कोटा सीमाएं क्या हैं?

इस्तेमाल की सीमाएं लेख में बताया गया है कि यह सीमा तय की गई है या नहीं. अगर आपको ज़्यादा सीमाएं चाहिए, तो स्टैंडर्ड कोटा का अनुरोध सबमिट किया जा सकता है.

कितना कोटा जोड़ने का अनुरोध किया जा सकता है?

कोटा सीमित संसाधन है. GBP API की सहायता टीम, कोटा बढ़ाने के आपके अनुरोध की ज़रूरी शर्तें पूरी करती है. इसके लिए, वह आपके पिछले कोटा के इस्तेमाल की पुष्टि करती है. अगर आपको अपना कोटा इस्तेमाल करने की औसत सीमा, मौजूदा कोटा की सीमा के 70% से कम है, तो ऐसा हो सकता है कि आपको और ज़्यादा बढ़ोतरी करने से मना किया जा सके.

क्या GBP API के पार्टनर, प्रोडक्शन के लिए टेस्ट खाता बना सकते हैं?

नहीं. माफ़ करें, GBP यूज़र इंटरफ़ेस या एपीआई की मदद से, प्रोडक्शन में GBP की नकली लिस्टिंग बनाने और उसकी जांच करने का कोई सीधा तरीका नहीं है.

बनाई गई ज़्यादातर फ़र्ज़ी लिस्टिंग को हमारा मॉडरेशन फ़्लैग कर देता है और उन्हें निलंबित कर दिया जाता है. हमारी सलाह है कि आप या तो क्लाइंट लिस्टिंग का इस्तेमाल करें और कुछ ही घंटों के बाद उस पर काम करें (बशर्ते आपने लिस्टिंग की मुख्य जानकारी, जैसे कि नाम, पता, कैटगरी न बदली हो) या अपनी कंपनी के मुख्यालय के लिए लिस्टिंग बनाएं. अगर आपको किसी लिस्टिंग या ऐसी किसी अन्य कार्रवाई की पुष्टि करने के लिए, एपीआई से मिले रिस्पॉन्स की जांच करनी है जिसके लिए प्रोडक्शन लिस्टिंग ज़रूरी है, तो मॉक एपीआई रिस्पॉन्स का इस्तेमाल करें.