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

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

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

انواع حساب

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

حساب شخصی

هنگامی که یک حساب 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 برای فراخوانی لیستی از همه حساب ها استفاده کنید

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

درخواست

مثال زیر یک نمونه درخواست 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 را با فیلد نام حساب خاص فراخوانی کنید تا فهرستی از مکان‌هایی که آن حساب به آنها دسترسی دارد بازیابی کنید.

برای مثال، اگر می‌خواهید همه مکان‌های متعلق به «گروه مکان جان دو» را بازیابی کنید، درخواست زیر را انجام دهید:

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. سلسله مراتب مدیریت مکان