एक साथ कई जगहों की जानकारी मैनेज करना

जैसे-जैसे आपका संगठन बड़ा होता है, अपनी जगहों और अनुमतियों को मैनेज करना आपके लिए मुश्किल हो सकता है. इस गाइड में, एक से ज़्यादा जगहों को मैनेज करने के सबसे सही तरीकों के बारे में बताया गया है. साथ ही, यहां खाते के इन टाइप के बारे में भी बताया गया है:

• निजी खाता
• संगठन का खाता
• लोकेशन ग्रुप खाता
• उपयोगकर्ता ग्रुप खाता

खाता प्रकार

जगहों को मैनेज करने में, हर खाता टाइप की भूमिका होती है. निजी खाते से, संगठन के खाते को मैनेज किया जा सकता है. इसके बाद, उस संगठन के उपयोगकर्ता ग्रुप और जगहों के ग्रुप को अनुमतियां मिल सकती हैं. इसके बाद, निजी खाता, उससे जुड़े लोकेशन ग्रुप के ज़रिए जगहों की जानकारी और लिस्टिंग को मैनेज कर सकता है.

निजी खाता

Google खाता बनाते समय, आपके लिए निजी खाता अपने-आप बन जाता है. निजी खातों के मालिक और मैनेजर, लिस्टिंग के मालिक और मैनेजर हो सकते हैं.

संगठन का खाता

संगठन खाता, सबसे ऊपर मौजूद खाता होता है. यह आपकी एजेंसी के बारे में बताता है. इसमें आपका जगह की जानकारी वाला ग्रुप और उपयोगकर्ता ग्रुप सेव होते हैं. साथ ही, संगठन के सभी सदस्यों के पास इनका ऐक्सेस होता है. जगहें एक से ज़्यादा संगठनों का हिस्सा हो सकती हैं.

My Business खाता मैनेजमेंट एपीआई की मदद से, accounts.admins.create के तरीके का इस्तेमाल करके, निजी खातों को संगठन के खाते को मैनेज करने या उसका मालिकाना हक देने का न्योता भेजा जा सकता है.

लोकेशन ग्रुप खाता

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

जगहों को अलग-अलग कैटगरी में बांटने के लिए, लोकेशन ग्रुप भी बनाए जा सकते हैं. जैसे, चेन, क्षेत्र या कैटगरी के हिसाब से. जगहों की जानकारी को एक से ज़्यादा लोकेशन ग्रुप में एक साथ रखा जा सकता है.

My Business खाता मैनेजमेंट एपीआई की मदद से, accounts.create तरीके का इस्तेमाल करके लोकेशन ग्रुप बनाए जा सकते हैं. साथ ही, किसी लोकेशन ग्रुप में जगह की जानकारी ट्रांसफ़र की जा सकती है. एपीआई की मदद से, निजी खातों को लोकेशन ग्रुप मैनेज करने का न्योता भी दिया जा सकता है. वेब इंटरफ़ेस से, उपयोगकर्ता ग्रुप को सीधे लोकेशन ग्रुप में जोड़ा जा सकता है.

उपयोगकर्ता ग्रुप खाता

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

उदाहरण के लिए, जब कोई नया सदस्य ऑपरेशंस टीम में शामिल होता है, तो उसे सीधे तौर पर किसी उपयोगकर्ता ग्रुप में जोड़ा जा सकता है. इससे, उसके पास उन सभी जगहों का ऐक्सेस तुरंत मिल जाता है जिनका ऐक्सेस उसके साथ काम करने वाले अन्य लोगों के पास होता है. उपयोगकर्ताओं को हर जगह की जानकारी का ऐक्सेस देने में ज़्यादा समय लगता है. साथ ही, इसे मैनेज करना भी मुश्किल होता है.

My Business खाता मैनेजमेंट एपीआई की मदद से, उपयोगकर्ता ग्रुप बनाने के लिए, accounts.create तरीके का इस्तेमाल किया जा सकता है. आपके पास एपीआई का इस्तेमाल करके, व्यक्तिगत खातों को खातों और जगहों के एडमिन मैनेज करने का न्योता भेजने का विकल्प भी है.

सभी खातों की सूची देखने के लिए, एपीआई का इस्तेमाल करना

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

अनुरोध

accounts.list अनुरोध का यह उदाहरण देखें:

GET
https://mybusinessaccountmanagement.googleapis.com/v1/accounts
Authorization: Bearer <access_token>

जवाब

accounts.list के जवाब का उदाहरण यहां दिया गया है:

{
    "accounts": [
        {
            "name": "accounts/{accountId}",
            "accountName": "John Doe",
            "type": "PERSONAL",
            "state": {
                "status": "UNVERIFIED"
            },
            "profilePhotoUrl": "//lh5.googleusercontent.com/REDACTED"
        },
        {
            "name": "accounts/{accountId}",
            "accountName": "John Doe’s Location Group",
            "type": "LOCATION_GROUP",
            "role": "OWNER",
            "state": {
                "status": "UNVERIFIED"
            },
            "accountNumber": "{accountNumber}",
            "permissionLevel": "OWNER_LEVEL"
        }
    ]
}

इस गाइड में बताए गए सभी खाता टाइप, आपके accounts.list अनुरोध के जवाब में शामिल किए जा सकते हैं. खातों की सूची देखें और उस खाते की पहचान करें जिसके पास उन जगहों का ऐक्सेस है जिन्हें आपको मैनेज करना है. इसके बाद, उस खाते के name फ़ील्ड के साथ accounts.locations.list को कॉल करें. इससे, उन जगहों की सूची वापस मिलेगी जिनका ऐक्सेस उस खाते के पास है.

उदाहरण के लिए, अगर आपको "जॉन डो'स के जगह की जानकारी वाले ग्रुप" से जुड़ी सभी जगहों की जानकारी चाहिए, तो यह अनुरोध करें:

GET
https://mybusinessbusinessinformation.googleapis.com/v1/{accountId}/locations
Authorization: Bearer <access_token>

जवाब में, उन जगहों की सूची दिखती है जिनका ऐक्सेस उपयोगकर्ता के पास है. यह सूची इस तरह दिखती है:

{
    "locations": [
        {
            "name": "locations/{locationId}",
            "locationName": "Test Business",
            ...
        },
        {
            "name": "locations/{locationId}",
            "locationName": "2nd Test Business",
            ...
         }
     ]
}

जगह की जानकारी मैनेज करने का डायग्राम

इस डायग्राम में, इन चीज़ों के बारे में बताया गया है:

• संगठनों में एक से ज़्यादा उपयोगकर्ता ग्रुप हो सकते हैं.
• उपयोगकर्ता ग्रुप, एक से ज़्यादा लोकेशन ग्रुप मैनेज कर सकते हैं.
• लोकेशन ग्रुप में कई जगहें हो सकती हैं.
• जगहों की जानकारी, संगठनों के एक से ज़्यादा लोकेशन ग्रुप में हो सकती है.