يشرح هذا الدليل كيفية استخدام طريقة
get
في مورد Membership ضِمن Google Chat API للحصول على تفاصيل حول
عضوية في مساحة.
يمكن لمالكي المساحات ومديريها
حصر إمكانية رؤية قائمة الأعضاء
بمستخدمين محددين في المساحة. في حال تم حصر إمكانية الوصول، ستعرض الطلبات الموجَّهة إلى هذه الطريقة باستخدام مصادقة التطبيق فقط العضويات التي يمكن لأعضاء المساحة الاطّلاع عليها، وستعرض الخطأ PERMISSION_DENIED للعضويات التي لا يمكن لأعضاء المساحة الاطّلاع عليها. تؤدي الطلبات التي يتم إجراؤها على هذه الطريقة باستخدام
مصادقة المستخدم
إلى عرض الخطأ PERMISSION_DENIED.
إذا كنت مشرفًا في Google Workspace، يمكنك استدعاء طريقة get لاسترداد تفاصيل حول أي عضوية في مؤسسة Google Workspace.
يمثّل
Membership المورد
ما إذا كان مستخدم بشري أو تطبيق Google Chat مدعوًا إلى مساحة أو جزءًا منها أو غير متوفّر فيها.
تتيح عملية المصادقة باستخدام مصادقة التطبيق لتطبيق Chat الحصول على عضويات من المساحات التي يمكنه الوصول إليها في Google Chat (مثل المساحات التي يكون عضوًا فيها)، ولكنها تستبعد عضويات تطبيق Chat، بما في ذلك عضويته الخاصة. تؤدي المصادقة باستخدام مصادقة المستخدم إلى عرض العضويات من المساحات التي يمكن للمستخدم المصادَق عليه الوصول إليها.
المتطلبات الأساسية
Node.js
- حساب Google Workspace تابع للعمل أو لمؤسسة مع إمكانية الوصول إلى Google Chat
- إعداد البيئة:
- أنشئ مشروعًا على Google Cloud.
- ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- فعِّل واجهة برمجة تطبيقات Google Chat وهيئها من خلال إضافة اسم ورمز ووصف لتطبيق Chat.
- ثبِّت Node.js Cloud Client Library.
- أنشئ بيانات اعتماد الوصول استنادًا إلى طريقة المصادقة في طلب Google Chat API:
- لإجراء المصادقة كمستخدم في Chat، عليك إنشاء بيانات اعتماد معرّف عميل OAuth وحفظ بيانات الاعتماد كملف JSON باسم
credentials.jsonفي الدليل المحلي. - لإجراء المصادقة بصفتك تطبيق Chat، عليك إنشاء بيانات اعتماد حساب الخدمة وحفظها كملف JSON باسم
credentials.json.
- لإجراء المصادقة كمستخدم في Chat، عليك إنشاء بيانات اعتماد معرّف عميل OAuth وحفظ بيانات الاعتماد كملف JSON باسم
- اختَر نطاق تفويض استنادًا إلى ما إذا كنت تريد المصادقة كمستخدم أو كتطبيق Chat.
- مساحة Google Chat يكون المستخدم الذي تم إثبات هويته أو تطبيق Chat الذي يجري المكالمة عضوًا فيها لإثبات هويتك كتطبيق Chat، أضِف تطبيق Chat إلى المساحة.
Python
- حساب Google Workspace تابع للعمل أو لمؤسسة مع إمكانية الوصول إلى Google Chat
- إعداد البيئة:
- أنشئ مشروعًا على Google Cloud.
- ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- فعِّل واجهة برمجة تطبيقات Google Chat وهيئها من خلال إضافة اسم ورمز ووصف لتطبيق Chat.
- ثبِّت مكتبة عميل Cloud الخاصة بلغة Python.
- أنشئ بيانات اعتماد الوصول استنادًا إلى طريقة المصادقة في طلب Google Chat API:
- لإجراء المصادقة كمستخدم في Chat،
أنشئ بيانات اعتماد معرّف عميل OAuthواحفظها كملف JSON باسم
credentials.jsonفي الدليل المحلي. - لإجراء المصادقة بصفتك تطبيق Chat،
أنشئ بيانات اعتماد
لحساب الخدمة واحفظها كملف JSON باسم
credentials.json.
- لإجراء المصادقة كمستخدم في Chat،
أنشئ بيانات اعتماد معرّف عميل OAuthواحفظها كملف JSON باسم
- اختَر نطاق تفويض استنادًا إلى ما إذا كنت تريد المصادقة كمستخدم أو كتطبيق Chat.
- مساحة Google Chat يكون المستخدم الذي تم إثبات هويته أو تطبيق Chat الذي يجري المكالمة عضوًا فيها لإثبات هويتك كتطبيق Chat، أضِف تطبيق Chat إلى المساحة.
جافا
- حساب Google Workspace تابع للعمل أو لمؤسسة مع إمكانية الوصول إلى Google Chat
- إعداد البيئة:
- أنشئ مشروعًا على Google Cloud.
- ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- فعِّل واجهة برمجة تطبيقات Google Chat وهيئها من خلال إضافة اسم ورمز ووصف لتطبيق Chat.
- ثبِّت Java Cloud Client Library.
- أنشئ بيانات اعتماد الوصول استنادًا إلى طريقة المصادقة في طلب Google Chat API:
- لإجراء المصادقة كمستخدم في Chat، عليك إنشاء بيانات اعتماد معرّف عميل OAuth وحفظ بيانات الاعتماد كملف JSON باسم
credentials.jsonفي الدليل المحلي. - لإجراء المصادقة بصفتك تطبيق Chat،
أنشئ بيانات اعتماد
لحساب الخدمة واحفظها كملف JSON باسم
credentials.json.
- لإجراء المصادقة كمستخدم في Chat، عليك إنشاء بيانات اعتماد معرّف عميل OAuth وحفظ بيانات الاعتماد كملف JSON باسم
- اختَر نطاق تفويض استنادًا إلى ما إذا كنت تريد المصادقة كمستخدم أو كتطبيق Chat.
- مساحة Google Chat يكون المستخدم الذي تم إثبات هويته أو تطبيق Chat الذي يجري المكالمة عضوًا فيها لإثبات هويتك كتطبيق Chat، أضِف تطبيق Chat إلى المساحة.
برمجة التطبيقات
- حساب Google Workspace تابع للعمل أو لمؤسسة مع إمكانية الوصول إلى Google Chat
- إعداد البيئة:
- أنشئ مشروعًا على Google Cloud.
- ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- فعِّل واجهة برمجة تطبيقات Google Chat وهيئها من خلال إضافة اسم ورمز ووصف لتطبيق Chat.
- أنشئ مشروعًا مستقلاً في "برمجة تطبيقات Google"، وفعِّل خدمة 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
جافا
برمجة التطبيقات
لتشغيل هذا النموذج، استبدِل ما يلي:
-
SPACE_NAME: رقم التعريف منnameالخاص بالمساحة يمكنك الحصول على رقم التعريف من خلال استدعاء الطريقةListSpacesأو من عنوان URL الخاص بالمساحة. - استبدِل
MEMBER_NAMEبمعرّفnameالخاص بالمشترك. يمكنك الحصول على رقم التعريف من خلال استدعاء الطريقةListMemberships.
تعرض Chat API مثيلاً من Membership يوضّح تفاصيل العضوية المحدّدة.
الحصول على اشتراك من خلال مصادقة التطبيق
إليك كيفية الحصول على اشتراك باستخدام مصادقة التطبيق:
Node.js
Python
جافا
برمجة التطبيقات
لتشغيل هذا النموذج، استبدِل ما يلي:
-
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 من مساحة