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 لـ "تحتوي على رد أعضاء" في واجهة برمجة تطبيقات الدليل

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

تمثيل 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

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.