يشرح هذا الدليل كيفية استخدام طريقة
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 الخاصة بنظام 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 من مساحة