Method: members.hasMember

للتحقق مما إذا كان المستخدم المحدد عضوًا في المجموعة أم لا. يمكن أن تكون العضوية مباشرة أو متداخلة، ولكن في حال دمجها، يجب أن تكون memberKey وgroupKey كيانَين في النطاق نفسه، وإلا سيتم عرض الخطأ Invalid input. للتحقّق من الاشتراكات المدمَجة التي تتضمن كيانات خارج نطاق المجموعة، استخدِم طريقة checkTransitiveMembership() في Cloud Identity Groups API.

طلب HTTP

GET https://admin.googleapis.com/admin/directory/v1/groups/{groupKey}/hasMember/{memberKey}

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
groupKey

string

يحدد المجموعة في طلب البيانات من واجهة برمجة التطبيقات. يمكن أن تكون القيمة عنوان البريد الإلكتروني للمجموعة أو العنوان البديل للمجموعة أو رقم تعريف المجموعة الفريد.

memberKey

string

تحدد العضو المستخدم في طلب البيانات من واجهة برمجة التطبيقات. يمكن أن تكون القيمة عنوان البريد الإلكتروني الرئيسي للمستخدم أو العنوان البديل للبريد الإلكتروني أو المعرّف الفريد.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

نموذج JSON لـ "تحتوي على ردّ عضو" في Directory API

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "isMember": boolean
}
الحقول
isMember

boolean

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

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

  • https://apps-apis.google.com/a/feeds/groups/
  • https://www.googleapis.com/auth/admin.directory.group
  • https://www.googleapis.com/auth/admin.directory.group.member
  • https://www.googleapis.com/auth/admin.directory.group.member.readonly
  • https://www.googleapis.com/auth/admin.directory.group.readonly

لمزيد من المعلومات، راجِع دليل التفويض.