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

GBP API क्या हैं?

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

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

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

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

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

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

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

GBP API के उपयोगकर्ताओं के लिए कौनसी नीतियां लागू होती हैं?

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

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

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

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

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

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

  • Google My Business API 4.9, जिसमें ये अहम सुविधाएं शामिल हैं:
    • FoodMenus
    • Media
    • Reviews
    • LocalPosts
  • My Business Account Management API
  • My Business Lodging API
  • My Business Place Actions API
  • My Business नोटिफ़िकेशन एपीआई
  • My Business Verifications API
  • My Business Business Information API
  • My Business के सवाल-जवाब वाले एपीआई
  • Business Profile Performance API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

मैं कितने कोटे का अनुरोध कर सकता/सकती हूं?

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

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

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

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