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

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

• الحساب الشخصي
• حساب المؤسسة
• حساب مجموعة المواقع الجغرافية
• حساب مجموعة المستخدمين

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

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

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

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