مکان ها را در مقیاس مدیریت کنید

با رشد سازمان شما، مدیریت مکان‌ها و مجوزهایتان می‌تواند شما را سردرگم کند. این راهنما بهترین شیوه‌ها برای مدیریت چندین مکان را شرح می‌دهد و انواع حساب‌های زیر را شرح می‌دهد:

• حساب شخصی
• حساب کاربری سازمان
• حساب گروه مکانی
• حساب کاربری گروه

انواع حساب

هر نوع حساب کاربری نقشی در مدیریت مکان‌ها دارد. یک حساب کاربری شخصی می‌تواند یک حساب سازمانی را مدیریت کند و سپس مجوزهایی را برای گروه‌های کاربری و گروه‌های مکان در آن سازمان کسب کند. سپس حساب کاربری شخصی می‌تواند مکان‌ها و فهرست‌ها را از طریق گروه‌های مکان مرتبط مدیریت کند.

حساب شخصی

هنگام ایجاد حساب گوگل، یک حساب شخصی به طور خودکار در دسترس شما قرار می‌گیرد. حساب‌های شخصی می‌توانند مالک و مدیر فهرست‌ها باشند.

حساب کاربری سازمان

حساب سازمانی، حساب رویی است که نماینده سازمان شما می‌باشد. گروه مکان و گروه‌های کاربری شما در آن ذخیره می‌شوند و همه اعضای یک سازمان به آنها دسترسی دارند. مکان‌ها می‌توانند بخشی از چندین سازمان باشند.

با استفاده از API مدیریت حساب کاربری My Business، می‌توانید از متد accounts.admins.create برای دعوت از حساب‌های شخصی برای مدیریت یا مالکیت حساب سازمانی استفاده کنید.

حساب گروه مکانی

یک گروه مکان برای مدیریت گروهی از مکان‌های مجزا استفاده می‌شود. می‌توانید از یک گروه مکان برای انجام وظایف گروهی در چندین مکان استفاده کنید. وقتی حساب‌های شخصی و گروه‌های کاربری را به یک گروه مکان اضافه می‌کنید، آنها مجوزهای گروه مکان را به ارث می‌برند.

همچنین می‌توانید گروه‌های مکانی ایجاد کنید تا مکان‌ها را دسته‌بندی کنید، مثلاً بر اساس زنجیره، منطقه یا دسته. مکان‌ها می‌توانند همزمان در چندین گروه مکانی باشند.

توجه: حساب شخصی که متعلق به یک سازمان یا گروه کاربری است، واجد شرایط مالکیت مستقیم یک مکان یا گروه مکان نیست.

با استفاده از API مدیریت حساب کاربری My Business، می‌توانید از متد accounts.create برای ایجاد گروه‌های مکان و انتقال مکان‌ها به یک گروه مکان استفاده کنید. همچنین می‌توانید با استفاده از API، حساب‌های شخصی را برای مدیریت گروه‌های مکان دعوت کنید. گروه‌های کاربری را می‌توان مستقیماً از رابط وب به گروه‌های مکان اضافه کرد.

حساب کاربری گروه

برای مدیریت مجوزها در مقیاس بزرگ، از یک گروه کاربری استفاده کنید. می‌توانید حساب‌های شخصی را به یک گروه کاربری اضافه کنید. سپس، می‌توانید به گروه کاربری، دسترسی مدیریت به چندین گروه مکانی در سازمان را اعطا کنید. اکنون همه حساب‌های شخصی در گروه کاربری می‌توانند اقدامات مدیریتی را روی مکان‌های تحت گروه‌های مکانی انجام دهند.

توجه: بهتر است حساب‌های شخصی را به گروه مکان اضافه نکنید. در عوض، مستقیماً به گروه‌های کاربری دسترسی بدهید. این روش آسان‌تری برای مدیریت در مقیاس بزرگ است.

برای مثال، وقتی یک عضو جدید به یک تیم عملیاتی می‌پیوندد، می‌توانید او را مستقیماً به یک گروه کاربری اضافه کنید و او بلافاصله به تمام مکان‌هایی که همسالانش به آنها دسترسی دارند، دسترسی خواهد داشت. اعطای دسترسی به هر مکان به کاربران زمان بیشتری می‌برد و مدیریت آن به این روش دشوارتر است.

با استفاده از API مدیریت حساب کاربری My Business، می‌توانید از متد accounts.create برای ایجاد گروه‌های کاربری استفاده کنید. همچنین می‌توانید از این API برای دعوت از حساب‌های شخصی جهت مدیریت مدیران حساب‌ها و مکان‌ها استفاده کنید.

استفاده از API برای فراخوانی لیستی از تمام حساب‌ها

برای فهرست کردن تمام حساب‌هایی که به آنها دسترسی دارید و انواع حساب‌های مرتبط با آنها، متد accounts.list را با اعتبارنامه‌های OAuth خود فراخوانی کنید. پاسخ شامل فهرستی از تمام حساب‌ها، شناسه‌های حساب آنها که در فیلد نام موجود است و انواع حساب‌ها است.

درخواست

مثال زیر یک درخواست 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",
            ...
         }
     ]
}

نمودار مدیریت مکان

نمودار زیر موارد زیر را نشان می‌دهد:

• سازمان‌ها می‌توانند شامل چندین گروه کاربری باشند.
• گروه‌های کاربری می‌توانند چندین گروه مکان را مدیریت کنند.
• گروه‌های مکان می‌توانند شامل چندین مکان باشند.
• مکان‌ها می‌توانند چندین گروه مکانی را در سازمان‌های مختلف پوشش دهند.

شکل ۱. سلسله مراتب مدیریت مکان