يوضّح هذا الدليل كيفية استخدام الأسلوب
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 باسم
client_secrets.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 Client Library لبرنامج Python.
- أنشئ بيانات اعتماد الوصول استنادًا إلى الطريقة التي تريد المصادقة بها في طلب Google Chat API:
- لمصادقة مستخدم Chat،
أنشئ بيانات اعتماد معرّف العميل لبروتوكول OAuth واحفظ بيانات الاعتماد كملف JSON باسم
client_secrets.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 Client Library لبرنامج Java.
- أنشئ بيانات اعتماد الوصول استنادًا إلى الطريقة التي تريد المصادقة بها في طلب Google Chat API:
- لمصادقة مستخدم Chat،
أنشئ بيانات اعتماد معرّف العميل لبروتوكول OAuth واحفظ بيانات الاعتماد كملف JSON باسم
client_secrets.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.
- أنشئ مشروعًا مستقلاً في Apps Script، وفعِّل خدمة 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 من مساحة