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

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

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

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

الحساب الشخصي

يتوفّر لك حساب شخصي تلقائيًا عند إنشاء حساب 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 مع حقل 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. التسلسل الهرمي لإدارة المواقع الجغرافية