يشرح هذا الدليل كيفية استخدام الأسلوب
get()
على مورد Space
من Google Chat API للاطّلاع على تفاصيل عن مساحة،
مثل اسمها المعروض ووصفها وإرشاداتها.
إذا كنت مشرفًا في Google Workspace، يمكنك استدعاء الطريقة get()
لاسترداد تفاصيل عن أي مساحة في مؤسستك على Google Workspace.
يمثّل
مورد Space
مكانًا يمكن فيه للمستخدمين وتطبيقات Chat إرسال الرسائل
ومشاركة الملفات والتعاون. تتوفّر عدة أنواع من المساحات:
- الرسائل المباشرة هي محادثات بين مستخدمَين أو مستخدم وأحد تطبيقات Chat.
- المحادثات الجماعية هي محادثات بين ثلاثة مستخدمين أو أكثر وتطبيقات Chat.
- المساحات المُسمّاة هي أماكن دائمة يرسل فيها المستخدمون الرسائل ويشاركون الملفات ويتعاونون معًا.
تتيح المصادقة باستخدام مصادقة التطبيق لتطبيق Chat الحصول على تفاصيل عن مساحة يكون تطبيق Chat عضوًا فيها. تتيح لك المصادقة باستخدام مصادقة المستخدم الوصول إلى المساحات التي يمكن للمستخدم المُعتمَد الوصول إليها، إما بصفته عضوًا في المساحة أو مشرفًا في Google Workspace.
المتطلبات الأساسية
Node.js
- حساب Business أو Enterprise Google Workspace لديه إذن بالوصول إلى 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 في 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.spaces.readonly
أوchat.spaces
. - باستخدام مصادقة التطبيق،
حدِّد نطاق التفويض
chat.bot
أو نطاقchat.app.spaces
. يتوفّر نطاقchat.app.spaces
في مرحلة معاينة المطوّر ويتطلّب موافقة المشرف لمرة واحدة.
- باستخدام
مصادقة المستخدم،
حدِّد نطاق التفويض
- استخدِم الطريقة
GetSpace()
، مع تمريرname
للمساحة التي تريد الحصول عليها. يمكنك الحصول على اسم المساحة من مواردSpace
Google Chat أو من عنوان URL للمساحة.
الحصول على تفاصيل المساحة كمستخدم
في ما يلي كيفية الحصول على تفاصيل المساحة باستخدام مصادقة المستخدم:
Node.js
Python
Java
برمجة تطبيقات
لتشغيل هذا النموذج، استبدِل SPACE_NAME
برقم التعريف من حقل
name
الخاص بالمساحة. يمكنك الحصول على المعرّف من خلال استدعاء الوسيطة
ListSpaces()
أو من عنوان URL للمساحة.
تعرض Chat API مثيلًا من
Space
الذي يوضّح تفاصيل المساحة المحدّدة.
الحصول على تفاصيل المساحة بصفتك مشرفًا في Google Workspace
إذا كنت مشرفًا في Google Workspace، يمكنك استدعاء الطريقة GetSpace
لاسترداد تفاصيل عن أي مساحة في مؤسستك
على Google Workspace.
لاستدعاء هذه الطريقة بصفتك مشرفًا في Google Workspace، اتّبِع الخطوات التالية:
- استخدِم طريقة المصادقة للمستخدم لطلب الإجراء، وحدِّد نطاق التفويض الذي يتيح طلب الإجراء باستخدام امتيازات المشرف.
- في طلبك، حدِّد مَعلمة طلب البحث
useAdminAccess
إلىtrue
.
لمزيد من المعلومات والأمثلة، يُرجى الاطّلاع على مقالة إدارة مساحات Google Chat بصفتك مشرفًا في Google Workspace.
الحصول على تفاصيل المساحة كتطبيق Chat
في ما يلي كيفية الحصول على تفاصيل المساحة باستخدام مصادقة التطبيق:
Node.js
Python
Java
برمجة تطبيقات
لتشغيل هذا النموذج، استبدِل SPACE_NAME
برقم التعريف من حقل
name
الخاص بالمساحة. يمكنك الحصول على المعرّف من خلال استدعاء الطريقة
ListSpaces()
أو من عنوان URL للمساحة.
تعرض Chat API مثيلًا من
Space
الذي يوضّح تفاصيل المساحة المحدّدة.