बड़े पैमाने पर जगहों को मैनेज करें

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

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

खाता टाइप

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

निजी खाता

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

संगठन का खाता

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

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

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

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

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

ध्यान दें: किसी संगठन या उपयोगकर्ता ग्रुप से जुड़े निजी खाते को, सीधे तौर पर किसी लोकेशन या लोकेशन ग्रुप का मालिकाना हक नहीं दिया जा सकता.

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

उपयोगकर्ता समूह खाता

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

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

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

My Business Account Management API की मदद से, उपयोगकर्ता के ग्रुप बनाने के लिए, 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 अनुरोध के जवाब में शामिल किए जा सकते हैं. खाता सूची की समीक्षा करें और उस खास खाते की पहचान करें जिसके पास उन जगहों का ऐक्सेस है जिन्हें आपको मैनेज करना है. इसके बाद, उस खाते के नाम फ़ील्ड के साथ 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",
            ...
         }
     ]
}

लोकेशन मैनेजमेंट का डायग्राम

इस डायग्राम में ये चीज़ें दिखाई गई हैं:

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

पहली इमेज. लोकेशन मैनेजमेंट का क्रम