REST Resource: accounts.admins

المورد: المشرف

مشرف حساب أو موقع جغرافي.

تمثيل JSON 
{
  "name": string,
  "admin": string,
  "account": string,
  "role": enum (AdminRole),
  "pendingInvitation": boolean
}
الحقول
name

string

غير قابل للتغيير. اسم المورد. بالنسبة إلى مشرفي الحساب، يكون هذا بالتنسيق: accounts/{account_id}/admins/{admin_id}

بالنسبة إلى مشرفي المواقع الجغرافية، يكون هذا بالتنسيق: locations/{locationId}/admins/{admin_id}

سيتم تجاهل هذا الحقل في حال ضبطه أثناء إنشاء حساب المشرف.
admin

string

اختياريّ. اسم المشرف. عند إرسال الدعوة الأولى، يكون هذا العنوان هو عنوان البريد الإلكتروني للمدعو. في مكالمات GET، يتم عرض عنوان البريد الإلكتروني للمستخدم إذا كانت الدعوة لا تزال في انتظار المراجعة. وبخلاف ذلك، يحتوي على الاسم الأول واسم العائلة للمستخدم.

يجب ضبط هذا الحقل أثناء إنشاء حساب المشرف فقط.
account

string

غير قابل للتغيير. اسم مورد "الحساب" الذي يشير إليه هذا المشرف. يتم استخدامه عند الاتصال بـ location.admins.create لدعوة موقع LocationGroup كمشرف.

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

التنسيق: accounts/{account}
role

enum (AdminRole)

مطلوب. تُحدِّد الدور الذي يستخدمه هذا المشرف مع الحساب أو الموقع الجغرافي المحدّد.
pendingInvitation

boolean

النتائج فقط. يشير هذا العمود إلى ما إذا كان هذا المشرف لديه دعوة معلّقة للمورد المحدّد.

AdminRole

تشير إلى مستوى الوصول الذي يمتلكه المشرف. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة مركز المساعدة.

عمليات التعداد
ADMIN_ROLE_UNSPECIFIED لم يتم تحديده.
PRIMARY_OWNER ويتمتع المشرف بإذن وصول على مستوى المالك، كما أنه المالك الأساسي. (يظهر على أنّه "المالك الأساسي" في واجهة المستخدم).
OWNER يمتلك المشرف إذن وصول على مستوى المالك. (يظهر باسم "المالك" في واجهة المستخدم).
MANAGER يمتلك المشرف إذن وصول إداري.
SITE_MANAGER يمكن للمشرف إدارة صفحات الشبكات الاجتماعية (Google+ ). (يظهر باسم "مدير الموقع الجغرافي" في واجهة المستخدم). لا تسمح واجهة برمجة التطبيقات هذه بإنشاء مشرف حساب بدور SITE_MANAGER.

الطُرق

create

 دعوة للمستخدم المحدّد ليصبح مشرفًا للحساب المحدّد

delete

 إزالة المشرف المحدّد من الحساب المحدّد

list

 يسرد المشرفين على الحساب المحدّد.

patch

 يتم تحديث "المشرف" لـ "مشرف الحساب" المحدّد.