במדריך הזה מוסבר איך להשתמש ב-method 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 בשם
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 עבור Java.
- יוצרים את פרטי הכניסה בהתאם לאופן שבו רוצים לבצע אימות בבקשה ל-Google Chat API:
- כדי לבצע אימות כמשתמש ב-Chat, צריך ליצור פרטי כניסה למזהה הלקוח ב-OAuth ולשמור את פרטי הכניסה כקובץ JSON בשם
client_secrets.json
בספרייה המקומית. - כדי לבצע אימות בתור אפליקציית Chat, צריך ליצור פרטי כניסה לחשבון שירות ולשמור את פרטי הכניסה כקובץ JSON בשם
credentials.json
.
- כדי לבצע אימות כמשתמש ב-Chat, צריך ליצור פרטי כניסה למזהה הלקוח ב-OAuth ולשמור את פרטי הכניסה כקובץ JSON בשם
- בוחרים היקף הרשאה בהתאם לכך אם רוצים לבצע אימות כמשתמש או כאפליקציית Chat.
- מרחב משותף ב-Google Chat שבו המשתמש המאומת או אפליקציית Chat שבאמצעותה מתבצעת השיחה הם חברים. כדי לבצע אימות באמצעות אפליקציית Chat, מוסיפים את אפליקציית Chat למרחב המשותף.
Apps Script
- חשבון Google Workspace בתוכנית Business או Enterprise עם גישה ל-Google Chat.
- מגדירים את הסביבה:
- יוצרים פרויקט ב-Google Cloud.
- מגדירים את מסך ההסכמה של OAuth.
- מפעילים ומגדירים את Google Chat API עם שם, סמל ותיאור לאפליקציית Chat.
- יוצרים פרויקט נפרד של Apps Script ומפעילים את שירות הצ'אט המתקדם.
- במדריך הזה, צריך להשתמש באימות משתמשים או אימות אפליקציות. כדי לבצע אימות בתור אפליקציית Chat, יוצרים פרטי כניסה של חשבון שירות. במאמר אימות ואישור בתור אפליקציית Google Chat מוסבר איך עושים זאת.
- בוחרים היקף הרשאה בהתאם לכך אם רוצים לבצע אימות כמשתמש או כאפליקציית Chat.
- מרחב משותף ב-Google Chat שבו המשתמש המאומת או אפליקציית Chat שבאמצעותה מתבצעת השיחה הם חברים. כדי לבצע אימות באמצעות אפליקציית Chat, מוסיפים את אפליקציית Chat למרחב המשותף.
קבלת פרטים על מינוי
כדי לקבל פרטים על המינוי ב-Google Chat, צריך להעביר את הפרטים הבאים בבקשה:
- באימות אפליקציה, מציינים את היקף ההרשאה
chat.bot
. באימות משתמש, מציינים את היקף ההרשאהchat.memberships.readonly
אוchat.memberships
. מומלץ לבחור את ההיקף המגביל ביותר שעדיין מאפשר לאפליקציה לפעול. - קוראים ל-method
GetMembership()
. - מעבירים את
name
של המינוי שרוצים לקבל. מקבלים את שם המועדון מהמשאב של המועדון ב-Google Chat.
קבלת מינוי באמצעות אימות משתמש
כך רוכשים מינוי עם אימות משתמש:
Node.js
Python
Java
Apps Script
כדי להריץ את הדוגמה הזו, מחליפים את הפרטים הבאים:
SPACE_NAME
: המזהה מ-name
של המרחב המשותף. אפשר לקבל את המזהה באמצעות הקריאה ל-methodListSpaces()
או מכתובת ה-URL של המרחב המשותף.MEMBER_NAME
: המזהה שרשוםname
של המנוי. אפשר לקבל את המזהה על ידי קריאה ל-methodListMemberships()
.
ממשק Chat API מחזיר מופע של Membership
עם פרטי החברות שצוינה.
קבלת מינוי באמצעות אימות באפליקציה
כך רוכשים מינוי באמצעות אימות באפליקציה:
Node.js
Python
Java
Apps Script
כדי להריץ את הדוגמה הזו, מחליפים את הפרטים הבאים:
SPACE_NAME
: המזהה מ-name
של המרחב המשותף. אפשר לקבל את המזהה באמצעות הקריאה ל-methodListSpaces()
או מכתובת ה-URL של המרחב המשותף.-
MEMBER_NAME
: המזהה מ-name
של המשתמש. אפשר לקבל את המזהה על ידי קריאה ל-methodListMemberships()
.
ממשק Chat API מחזיר מופע של Membership
עם פרטי החברות שצוינה.
הצגת פרטים על החברויות כאדמינים ב-Google Workspace
אדמינים ב-Google Workspace יכולים להפעיל את השיטה GetMembership()
כדי לאחזר פרטים על המינוי של כל משתמש מהארגון שלכם ב-Google Workspace.
כדי להפעיל את השיטה הזו כאדמינים ב-Google Workspace:
- קוראים לשיטה באמצעות אימות משתמש, ומציינים היקף הרשאה שתומך בקריאה לשיטה באמצעות הרשאות אדמין.
- בבקשה, מציינים את פרמטר השאילתה
useAdminAccess
עדtrue
.
למידע נוסף ולדוגמאות, ראו ניהול מרחבים משותפים ב-Google Chat כאדמינים ב-Google Workspace.
נושאים קשורים
- הצגת רשימת המשתתפים במרחב המשותף
- להזמין או להוסיף משתמש או אפליקציית Chat למרחב משותף.
- לעדכן את הסטטוס של משתמש במרחב משותף ב-Google Chat.
- להסיר משתמש או את אפליקציית Chat ממרחב משותף.