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

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

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

סוגי חשבונות

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

חשבון אישי

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

חשבון ארגוני

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

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

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

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

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

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

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

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

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

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

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

באמצעות ה-API לניהול חשבון 'Google לעסק שלי', אפשר להשתמש ב-method‏ accounts.create כדי ליצור קבוצות משתמשים. אפשר גם להשתמש ב-API כדי להזמין חשבונות אישיים לניהול האדמינים של חשבונות ומיקומים.

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

כדי לקבל רשימה של כל החשבונות שיש לכם גישה אליהם ואת סוגי החשבונות המשויכים אליהם, צריך להפעיל את השיטה 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. היררכיית ניהול המיקומים