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