ניהול מיקומים בהיקף נרחב

ככל שהארגון שלכם גדל, ניהול המיקומים וההרשאות שלכם עשוי מדהים אותך. במדריך הזה מתוארות השיטות המומלצות לניהול של כמה ומתאר את סוגי החשבונות הבאים:

• חשבון אישי
• חשבון ארגוני
• חשבון קבוצת מיקומים
• חשבון של קבוצת משתמשים

סוגי חשבונות

לכל סוג חשבון יש תפקיד בניהול המיקומים. חשבון לשימוש אישי יכול לנהל חשבון ארגוני, ולאחר מכן לקבל הרשאות לקבוצות המשתמשים וקבוצות המיקומים בארגון הזה. החשבון האישי יוכל לנהל מיקומים וכרטיסי מוצר באמצעות קבוצות המיקומים המשויכות.

חשבון לשימוש אישי

חשבון לשימוש אישי זמין לכם באופן אוטומטי כשיוצרים חשבון חשבון Google. חשבונות לשימוש אישי יכול להיות הבעלים והמנהלים של דפים עסקיים.

חשבון ארגוני

חשבון ארגוני הוא החשבון הראשי שמייצג את הסוכנות. קבוצת המיקומים וקבוצות המשתמשים שמורות בה, וכל החברים לארגון יש גישה אליהם. מיקומים יכולים להיות חלק מכמה מיקומים ארגונים.

באמצעות My Business Account Management API אפשר accounts.admins.create להזמין חשבונות אישיים לנהל את החשבון הארגוני או להיות הבעלים שלו.

חשבון של קבוצת מיקומים

א' קבוצה לפי מיקום משמש לניהול קבוצה של מיקומים נפרדים. אפשר להשתמש בקבוצת מיקומים כדי לבצע משימות בכמות גדולה בכמה מיקומים. כשמוסיפים חשבונות אישיים קבוצות משתמשים בקבוצת מיקומים, הם יורשים את ההרשאות של הקבוצה לפי מיקום.

תוכלו גם ליצור קבוצות לפי מיקום כדי לחלק את המיקומים לקטגוריות, למשל לפי רשת, אזור או קטגוריה. מיקומים יכולים להיות בכמה קבוצות לפי מיקום בו-זמנית.

הערה: חשבון אישי ששייך לארגון או לקבוצת משתמשים לא שייך לארגון יכול להיות הבעלים הישיר של מיקום או קבוצה לפי מיקום.

באמצעות My Business Account Management API אפשר השיטה accounts.create ליצור קבוצות לפי מיקום, וכן העברת מיקומים למיקום קבוצה. אפשר גם להזמין חשבונות אישיים אל ניהול קבוצות לפי מיקום באמצעות ה-API. משתמשים אפשר להוסיף קבוצות לפי מיקום ישירות דרך ממשק האינטרנט.

חשבון של קבוצת משתמשים

כדי לנהל הרשאות בקנה מידה גדול, צריך להשתמש קבוצת משתמשים. אפשר להוסיף חשבונות אישיים לקבוצת משתמשים. לאחר מכן תוכלו לתת למשתמש הרשאת גישה לניהול קבוצות לכמה קבוצות לפי מיקום בארגון. עכשיו הכול החשבונות האישיים בקבוצת המשתמשים יכולים לבצע פעולות ניהול מיקומים בקבוצות לפי מיקום.

הערה: מומלץ לא להוסיף חשבונות אישיים לקבוצת מיקומים. במקום זאת, מעניקים לקבוצות משתמשים ניגשות ישירות. זו דרך קלה יותר לנהל אפליקציות בקנה מידה גדול.

לדוגמה, כשחבר חדש מצטרף לצוות תפעול, אפשר להוסיף אותו ישירות לקבוצת משתמשים, והם מקבלים גישה מיידית לכל המיקומים שלעמיתים שלהם יש גישה אליהם. נדרש יותר זמן כדי להעניק למשתמשים גישה בנפרד, וקשה יותר לנהל אותו בדרך הזו.

באמצעות My Business Account Management API אפשר השיטה accounts.create ליצור קבוצות משתמשים. אפשר גם להשתמש ב-API כדי להזמין חשבונות לשימוש אישי ניהול אדמינים של חשבונות ומיקומים

שימוש ב-API כדי לשלוח קריאה לרשימה של כל החשבונות

כדי להציג רשימה של כל החשבונות שיש לכם גישה אליהם ואת סוגי החשבונות שמשויכים אליהם, קריאה ל-method accounts.list בפרטי הכניסה של OAuth. מכילה רשימה של כל החשבונות, את מספרי החשבונות שלהם, שנמצאים בשדה name, ואת סוגי החשבונות.

בקשה

זוהי דוגמה דוגמה לבקשת accounts.list:

HTTP

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 בשדה name של החשבון הספציפי, כדי לאחזר רשימה של מיקומים שלחשבון הזה יש גישה אליהם.

למשל, אם אתם רוצים לאחזר את כל המיקומים ששייכים לקטגוריה 'פלונית' קבוצת מיקומים", שולחים את הבקשה הבאה:

HTTP

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",
            ...
         }
     ]
}

תרשים ניהול מיקומים

התרשים הבא ממחיש את הדברים הבאים:

• ארגונים יכולים להכיל כמה קבוצות משתמשים.
• קבוצות משתמשים יכולות לנהל כמה קבוצות לפי מיקום.
• קבוצות לפי מיקום יכולות להכיל כמה מיקומים.
• המיקומים יכולים להתפרס על פני כמה קבוצות מיקומים וארגונים שונים.

איור 1. היררכיה של ניהול מיקומים