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

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

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

סוגי חשבונות

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

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

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

חשבון ארגוני

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

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

חשבון ברמת קבוצת המיקומים

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

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

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

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

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

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

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

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

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

שימוש ב-API כדי להפעיל רשימה של כל החשבונות

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

בקשה

לפניכם דוגמה לבקשה ל-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. היררכיה של ניהול מיקומים