يشرح هذا الدليل كيفية استخدام طريقة
get()
في مورد Membership ضِمن Google Chat API للحصول على تفاصيل حول
عضوية في مساحة.
إذا كنت مشرفًا في Google Workspace، يمكنك استدعاء طريقة get() لاسترداد تفاصيل حول أي عضوية في مؤسستك على Google Workspace.
يمثّل
المورد Membership
ما إذا تمت دعوة مستخدم بشري أو تطبيق Google Chat إلى مساحة أو كان جزءًا منها أو غير متواجد فيها.
تتيح المصادقة باستخدام مصادقة التطبيق لتطبيق Chat الحصول على الاشتراكات من المساحات التي يمكنه الوصول إليها في Google Chat (على سبيل المثال، المساحات التي يكون عضوًا فيها)، ولكنها تستبعد اشتراكات تطبيق Chat، بما في ذلك اشتراكه الخاص. تؤدي المصادقة باستخدام مصادقة المستخدم إلى عرض العضويات من المساحات التي يمكن للمستخدم المصادَق عليه الوصول إليها.
المتطلبات الأساسية
Node.js
- حساب Google Workspace Business أو Enterprise مع إمكانية الوصول إلى Google Chat
- إعداد البيئة:
- أنشئ مشروعًا على Google Cloud.
- ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- فعِّل واجهة Google Chat API وأعِدّها باستخدام اسم ورمز ووصف لتطبيق Chat.
- ثبِّت مكتبة برامج Cloud Client Library لنظام Node.js.
- أنشئ بيانات اعتماد الوصول استنادًا إلى الطريقة التي تريد استخدامها للمصادقة في طلب Google Chat API:
- لإجراء المصادقة كمستخدم في Chat،
أنشئ بيانات اعتماد معرّف عميل OAuthواحفظها كملف JSON باسم
credentials.jsonفي الدليل المحلي. - لإجراء المصادقة بصفتك تطبيق Chat،
أنشئ بيانات اعتماد
لحساب الخدمة واحفظها كملف JSON باسم
credentials.json.
- لإجراء المصادقة كمستخدم في Chat،
أنشئ بيانات اعتماد معرّف عميل OAuthواحفظها كملف JSON باسم
- اختَر نطاق تفويض استنادًا إلى ما إذا كنت تريد المصادقة كمستخدم أو كتطبيق Chat.
- مساحة Google Chat يكون المستخدم الذي تم التحقّق من هويته أو تطبيق الاتصال في Chat عضوًا فيها لإثبات هويتك كتطبيق Chat، أضِف تطبيق Chat إلى المساحة.
Python
- حساب Google Workspace Business أو Enterprise مع إمكانية الوصول إلى Google Chat
- إعداد البيئة:
- أنشئ مشروعًا على Google Cloud.
- ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- فعِّل واجهة Google Chat API وأعِدّها باستخدام اسم ورمز ووصف لتطبيق Chat.
- ثبِّت مكتبة برامج Cloud للغة Python.
- أنشئ بيانات اعتماد الوصول استنادًا إلى الطريقة التي تريد استخدامها للمصادقة في طلب Google Chat API:
- لإجراء المصادقة كمستخدم في Chat،
أنشئ بيانات اعتماد معرّف عميل OAuthواحفظها كملف JSON باسم
credentials.jsonفي الدليل المحلي. - لإجراء المصادقة بصفتك تطبيق Chat،
أنشئ بيانات اعتماد
لحساب الخدمة واحفظها كملف JSON باسم
credentials.json.
- لإجراء المصادقة كمستخدم في Chat،
أنشئ بيانات اعتماد معرّف عميل OAuthواحفظها كملف JSON باسم
- اختَر نطاق تفويض استنادًا إلى ما إذا كنت تريد المصادقة كمستخدم أو كتطبيق Chat.
- مساحة Google Chat يكون المستخدم الذي تم التحقّق من هويته أو تطبيق الاتصال في Chat عضوًا فيها لإثبات هويتك كتطبيق Chat، أضِف تطبيق Chat إلى المساحة.
Java
- حساب Google Workspace Business أو Enterprise مع إمكانية الوصول إلى Google Chat
- إعداد البيئة:
- أنشئ مشروعًا على Google Cloud.
- ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- فعِّل واجهة Google Chat API وأعِدّها باستخدام اسم ورمز ووصف لتطبيق Chat.
- ثبِّت مكتبة برامج Cloud للغة Java.
- أنشئ بيانات اعتماد الوصول استنادًا إلى الطريقة التي تريد استخدامها للمصادقة في طلب Google Chat API:
- لإجراء المصادقة كمستخدم في Chat،
أنشئ بيانات اعتماد معرّف عميل OAuthواحفظها كملف JSON باسم
credentials.jsonفي الدليل المحلي. - لإجراء المصادقة بصفتك تطبيق Chat،
أنشئ بيانات اعتماد
لحساب الخدمة واحفظها كملف JSON باسم
credentials.json.
- لإجراء المصادقة كمستخدم في Chat،
أنشئ بيانات اعتماد معرّف عميل OAuthواحفظها كملف JSON باسم
- اختَر نطاق تفويض استنادًا إلى ما إذا كنت تريد المصادقة كمستخدم أو كتطبيق Chat.
- مساحة Google Chat يكون المستخدم الذي تم التحقّق من هويته أو تطبيق الاتصال في Chat عضوًا فيها لإثبات هويتك كتطبيق Chat، أضِف تطبيق Chat إلى المساحة.
برمجة التطبيقات
- حساب Google Workspace Business أو Enterprise مع إمكانية الوصول إلى Google Chat
- إعداد البيئة:
- أنشئ مشروعًا على Google Cloud.
- ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- فعِّل واجهة Google Chat API وأعِدّها باستخدام اسم ورمز ووصف لتطبيق Chat.
- أنشئ مشروعًا مستقلاً في "برمجة التطبيقات"، وفعِّل خدمة Chat المتقدّمة.
- في هذا الدليل، يجب استخدام مصادقة المستخدم أو التطبيق. للمصادقة كتطبيق Chat، أنشئ بيانات اعتماد حساب خدمة. للاطّلاع على الخطوات، يُرجى قراءة مقالة المصادقة والتفويض كتطبيق Google Chat.
- اختَر نطاق تفويض استنادًا إلى ما إذا كنت تريد المصادقة كمستخدم أو كتطبيق Chat.
- مساحة Google Chat يكون المستخدم الذي تم التحقّق من هويته أو تطبيق الاتصال في Chat عضوًا فيها لإثبات هويتك كتطبيق Chat، أضِف تطبيق Chat إلى المساحة.
الحصول على تفاصيل حول عضوية
للحصول على تفاصيل حول عضوية في Google Chat، عليك تضمين ما يلي في طلبك:
- باستخدام
مصادقة التطبيق، حدِّد
نطاق التفويض
chat.bot. باستخدام مصادقة المستخدم، حدِّد نطاق تفويضchat.memberships.readonlyأوchat.memberships. من أفضل الممارسات اختيار النطاق الأكثر تقييدًا الذي يتيح لتطبيقك العمل. - استدعِ الطريقة
GetMembership(). - مرِّر
nameالعضوية المطلوب الحصول عليها. احصل على اسم العضوية من مورد العضوية في Google Chat.
الحصول على عضوية مع مصادقة المستخدم
إليك كيفية الحصول على عضوية تتطلّب مصادقة المستخدم:
Node.js
Python
Java
برمجة التطبيقات
لتشغيل هذا النموذج، استبدِل ما يلي:
SPACE_NAME: رقم التعريف منnameالخاص بالمساحة يمكنك الحصول على المعرّف من خلال استدعاء طريقةListSpaces()أو من عنوان URL الخاص بالمساحة.MEMBER_NAME: رقم التعريف منnameالخاص بالمشترك يمكنك الحصول على رقم التعريف من خلال استدعاء الطريقةListMemberships().
تعرض واجهة Chat API مثيلاً من
Membership
يتضمّن تفاصيل العضوية المحدّدة.
الحصول على اشتراك باستخدام مصادقة التطبيق
إليك كيفية الحصول على عضوية من خلال المصادقة عبر التطبيق:
Node.js
Python
Java
برمجة التطبيقات
لتشغيل هذا النموذج، استبدِل ما يلي:
SPACE_NAME: رقم التعريف منnameالخاص بالمساحة يمكنك الحصول على المعرّف من خلال استدعاء طريقةListSpaces()أو من عنوان URL الخاص بالمساحة.MEMBER_NAME: رقم التعريف منnameالخاص بالمشترك يمكنك الحصول على رقم التعريف من خلال استدعاء الطريقةListMemberships().
تعرض واجهة Chat API مثيلاً من
Membership
يتضمّن تفاصيل العضوية المحدّدة.
الحصول على تفاصيل حول الاشتراكات بصفتك مشرفًا في Google Workspace
إذا كنت مشرفًا في Google Workspace، يمكنك استدعاء طريقة GetMembership() لاسترداد تفاصيل حول اشتراك أي مستخدم في مؤسسة Google Workspace.
لاستدعاء هذه الطريقة بصفتك مشرفًا في Google Workspace، اتّبِع الخطوات التالية:
- استدعِ الطريقة باستخدام مصادقة المستخدم، وحدِّد نطاق تفويض يتيح استدعاء الطريقة باستخدام امتيازات المشرف.
- في طلبك، حدِّد مَعلمة طلب البحث
useAdminAccessعلىtrue.
لمزيد من المعلومات والأمثلة، يُرجى الاطّلاع على مقالة إدارة مساحات Google Chat بصفتك مشرف Google Workspace.
مواضيع ذات صلة
- إدراج الأعضاء في مساحة
- دعوة مستخدم أو تطبيق Chat إلى مساحة أو إضافتهما
- تعديل عضوية مستخدم في مساحة Google Chat
- إزالة مستخدم أو تطبيق Chat من مساحة