إدارة المواقع الجغرافية على نطاق واسع

مع تطوّر مؤسستك، يمكن أن تربكك إدارة مواقعك الجغرافية وأذوناتك. يوضح هذا الدليل بالتفصيل أفضل الممارسات لإدارة مواقع جغرافية متعددة، ويصف أنواع الحسابات التالية:

أنواع الحسابات

لكل نوع حساب دور في إدارة المواقع الجغرافية. ويمكن للحساب الشخصي إدارة حساب مؤسسة، ثم الحصول على أذونات لمجموعات المستخدمين ومجموعات المواقع الجغرافية في تلك المؤسسة. ويمكن للحساب الشخصي بعد ذلك إدارة المواقع الجغرافية والبيانات من خلال مجموعات المواقع الجغرافية المرتبطة.

حساب شخصي

يتوفر حساب شخصي لك تلقائيًا عند إنشاء حساب Google. ويمكن أن تكون الحسابات الشخصية مالكي بطاقات البيانات ومديريها.

حساب المؤسسة

حساب المؤسسة هو الحساب الرئيسي الذي يمثل وكالتك. ويتم حفظ مجموعة مواقعك الجغرافية ومجموعات المستخدمين فيها، ويحصل جميع أعضاء المؤسسة على إمكانية الوصول إليها. يمكن أن تكون المواقع جزءًا من مؤسسات متعددة.

باستخدام My Business Account Management API، يمكنك استخدام طريقة accounts.admins.create لدعوة الحسابات الشخصية إلى إدارة حساب المؤسسة أو امتلاكه.

حساب مجموعة المواقع الجغرافية

تُستخدم مجموعة المواقع الجغرافية لإدارة مجموعة من المواقع الجغرافية الفردية. يمكنك استخدام مجموعة مواقع جغرافية لتنفيذ مهام مجمّعة لمواقع جغرافية متعددة عند إضافة حسابات شخصية ومجموعات مستخدمين إلى مجموعة مواقع جغرافية، فإنّها تكتسب أذونات مجموعة المواقع الجغرافية.

يمكنك أيضًا إنشاء مجموعات مواقع جغرافية لتصنيف المواقع الجغرافية، مثل حسب السلسلة أو المنطقة أو الفئة. يمكن أن تتوفّر المواقع الجغرافية في مجموعات مواقع جغرافية متعددة في الوقت نفسه.

باستخدام My Business Account Management API، يمكنك استخدام طريقة accounts.create لإنشاء مجموعات مواقع جغرافية ونقل المواقع الجغرافية إلى مجموعة مواقع جغرافية. ويمكنك أيضًا دعوة حسابات شخصية لإدارة مجموعات المواقع الجغرافية باستخدام واجهة برمجة التطبيقات. يمكن إضافة مجموعات المستخدمين مباشرةً إلى مجموعات المواقع الجغرافية من واجهة الويب.

حساب مجموعة المستخدمين

لإدارة الأذونات على نطاق واسع، استخدِم مجموعة مستخدمين. ويمكنك إضافة حسابات شخصية إلى مجموعة مستخدمين. بعد ذلك، يمكنك منح إدارة مجموعة المستخدمين إذن الوصول إلى مجموعات مواقع جغرافية متعددة في المؤسسة. يمكن الآن لجميع الحسابات الشخصية في مجموعة المستخدمين تنفيذ إجراءات إدارية على المواقع الجغرافية ضمن مجموعات المواقع الجغرافية.

على سبيل المثال، عندما ينضم عضو جديد إلى فريق عمليات، يمكنك إضافتهم مباشرةً إلى مجموعة مستخدمين وسيتمكّنون على الفور من الوصول إلى جميع المواقع التي يمكن لزملائهم الوصول إليها. ويستغرق منح المستخدمين وقتًا أطول للوصول إلى كل موقع على حدة، كما أنه أكثر صعوبة في الإدارة بهذه الطريقة.

باستخدام My Business Account Management API، يمكنك استخدام طريقة accounts.create لإنشاء مجموعات مستخدمين. يمكنك أيضًا استخدام واجهة برمجة التطبيقات لدعوة الحسابات الشخصية لإدارة المشرفين على الحسابات والمواقع الجغرافية.

استخدام واجهة برمجة التطبيقات لطلب قائمة بكل الحسابات

لإدراج جميع الحسابات التي يمكنك الوصول إليها وأنواع الحسابات المرتبطة بها، استدعى طريقة 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 مع حقل الاسم للحساب المحدد من أجل استرداد قائمة بالمواقع التي يمكن لهذا الحساب الوصول إليها.

على سبيل المثال، إذا كنت تريد استرداد جميع المواقع التي تنتمي إلى "مجموعة المواقع الجغرافية لـ John Doe"، فعليك تقديم الطلب التالي:

بروتوكول 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. التسلسل الهرمي لإدارة المواقع الجغرافية