אימות והרשאה של אפליקציות צ'אט ובקשות מ-Google Chat API

אימות והרשאה הם מנגנונים שמשמשים לאימות הזהות ולגישה למשאבים, בהתאמה. במאמר הזה מוסבר איך עובדים האימות וההרשאה באפליקציות ל-Chat ובבקשות מ-Chat API.

סקירה כללית של התהליך

הדיאגרמה הבאה מציגה את השלבים הכלליים של אימות והרשאה ב-Google Chat:

שלבים כלליים לאימות ולהרשאה ב-Google Chat
איור 1. שלבים כלליים לאימות ולהרשאה ב-Google Chat.

  1. מגדירים פרויקט ב-Google Cloud, מפעילים את Chat API ומגדירים את אפליקציית Chat: במהלך הפיתוח, יוצרים פרויקט ב-Google Cloud. בפרויקט ב-Google Cloud, מפעילים את Chat API, מגדירים את אפליקציית Chat ומגדירים אימות. מידע נוסף זמין במאמרים בנושא פיתוח ב-Google Workspace ויצירת אפליקציית צ'אט.

  2. שליחת קריאה ל-Chat API: כשהאפליקציה שולחת קריאה ל-Chat API, היא שולחת פרטי אימות ל-Chat API. אם האפליקציה מאומתת באמצעות חשבון שירות, פרטי הכניסה נשלחים כחלק מקוד האפליקציה. אם האפליקציה שלכם דורשת קריאה ל-Chat API באמצעות אימות משתמש שעדיין לא אושר, המשתמש יתבקש להיכנס לחשבון.

  3. בקשת משאבים: האפליקציה מבקשת גישה עם היקפי הרשאות שאתם מציינים במהלך הגדרת האימות.

  4. בקשת הסכמה: אם האפליקציה עוברת אימות בתור משתמש, Google מציגה מסך הסכמה ל-OAuth כדי שהמשתמש יוכל להחליט אם להעניק לאפליקציה גישה לנתונים המבוקשים. אימות באמצעות חשבון שירות לא דורש הסכמת משתמש.

  5. שליחת בקשה מאושרת למשאבים: אם המשתמש מסכים להיקפי ההרשאות, האפליקציה מאגדת את פרטי הכניסה ואת היקפי ההרשאות שאושרו על ידי המשתמש בבקשה. הבקשה נשלחת לשרת ההרשאות של Google כדי לקבל אסימון גישה.

  6. Google מחזירה אסימון גישה: אסימון הגישה מכיל רשימה של היקפי הרשאות שהוענקו. אם רשימת ההיקפים שמוחזרת מגבילה יותר מההיקפים המבוקשים, האפליקציה משביתה את כל התכונות שמוגבלות על ידי האסימון.

  7. גישה למשאבים המבוקשים: האפליקציה משתמשת בטוקן הגישה מ-Google כדי להפעיל את Chat API ולגשת למשאבים של Chat API.

  8. קבלת אסימון רענון (אופציונלי): אם האפליקציה שלכם צריכה לגשת ל-Google Chat API מעבר לתוחלת החיים של אסימון גישה יחיד, היא יכולה לקבל אסימון רענון. למידע נוסף, ראו שימוש ב-OAuth 2.0 לגישה ל-Google APIs.

  9. בקשת משאבים נוספים: אם האפליקציה צריכה גישה נוספת, היא מבקשת מהמשתמש להעניק לה היקפי גישה חדשים, וכתוצאה מכך מוגשת בקשה חדשה לקבלת אסימון גישה (שלבים 3-6).

מתי אפליקציות ל-Chat דורשות אימות

אפליקציות ל-Chat יכולות לשלוח הודעות בתגובה לאינטראקציה של משתמש, או באופן אסינכרוני. הן גם יכולות להשלים משימות בשם המשתמש, כמו יצירת מרחב ב-Chat או קבלת רשימה של אנשים במרחב ב-Chat.

אפליקציות צ'אט לא דורשות אימות כדי להגיב לאינטראקציה של משתמש, אלא אם אפליקציית הצ'אט קוראת ל-Chat API או ל-Google API אחר בזמן עיבוד התגובה.

כדי לשלוח הודעות אסינכרוניות או לבצע משימות בשם משתמש, אפליקציות ל-Chat שולחות בקשות RESTful ל-Chat API, שדורשות אימות והרשאה.

לא נדרש אימות כדי להגיב לאינטראקציות של משתמשים

אפליקציות ל-Google Chat לא צריכות לעבור אימות כמשתמש או כאפליקציית צ'אט כדי לקבל אירועי אינטראקציה ולהגיב להם באופן סינכרוני.

אפליקציות ל-Google Chat מקבלות אירועי אינטראקציה בכל פעם שמשתמש יוצר אינטראקציה עם אפליקציית Chat או מפעיל אותה, כולל:

  • משתמש שולח הודעה לאפליקציית צ'אט.
  • משתמש עושה אזכור @של אפליקציית צ'אט.
  • משתמש מפעיל אחת מהפקודות של אפליקציית Chat.

התרשים הבא מציג רצף של בקשה ותגובה בין משתמש ב-Chat לבין אפליקציית צ'אט:

לא נדרשת הרשאה לאירועי אינטראקציה עם אפליקציות צ'אט
איור 2. אירועי אינטראקציה עם אפליקציית צ'אט לא דורשים אימות.

  1. המשתמש שולח הודעה לאפליקציית Chat ב-Google Chat.
  2. ההודעה מועברת מ-Google Chat לאפליקציה.
  3. האפליקציה מקבלת את ההודעה, מעבדת אותה ומחזירה תשובה ל-Google Chat.
  4. ‫Google Chat מציג את התשובה למשתמש או במרחב.

הרצף הזה חוזר על עצמו לכל אירוע של אינטראקציה עם אפליקציית צ'אט.

הודעות אסינכרוניות דורשות אימות

הודעות אסינכרוניות מתרחשות כשאפליקציית צ'אט שולחת בקשה ל-Chat API, שדורשת אימות והרשאה.

באמצעות Chat API, אפליקציות ל-Chat יכולות לפרסם הודעות ב-Google Chat או להשלים משימות ולגשת לנתונים בשם המשתמש. לדוגמה, אחרי שאפליקציית צ'אט מזהה הפסקה זמנית בשירות של שרת, היא יכולה להפעיל את Chat API כדי:

  • יוצרים מרחב ב-Chat שמוקדש לחקירה ולתיקון של ההפסקה הזמנית בשירות.
  • להוסיף אנשים למרחב ב-Chat.
  • פרסמו הודעה במרחב ב-Chat כדי לספק פרטים על ההפסקה זמנית בשירות.

התרשים הבא מציג רצף של הודעות אסינכרוניות בין אפליקציית צ'אט לבין מרחב ב-Chat:

נדרש אימות להודעות אסינכרוניות
איור 3. כדי לשלוח הודעות אסינכרוניות, צריך לאמת את השולח.

  1. אפליקציית צ'אט יוצרת הודעה על ידי קריאה ל-Chat API באמצעות השיטה spaces.messages.create, וכוללת את פרטי הכניסה של המשתמש בבקשת ה-HTTP.
  2. Google Chat מאמתת את אפליקציית Chat באמצעות חשבון שירות או פרטי כניסה של משתמש.
  3. Google Chat מציג את ההודעה של האפליקציה במרחב ספציפי ב-Chat.

היקפי הגישה של Chat API

מגדירים את מסך ההסכמה של OAuth ובוחרים היקפי הרשאה כדי להגדיר איזה מידע יוצג למשתמשים ולבודקי האפליקציה, ורושמים את האפליקציה כדי שתוכלו לפרסם אותה בהמשך.

כדי להגדיר את רמת הגישה שניתנת לאפליקציה, צריך לזהות ולהצהיר על היקפי הרשאות. היקף הרשאות הוא מחרוזת URI של OAuth 2.0 שמכילה את שם האפליקציה של Google Workspace, את סוג הנתונים שהיא ניגשת אליהם ואת רמת הגישה.

היקפי הרשאות לא רגישים

קוד היקף תיאור
https://www.googleapis.com/auth/chat.bot

מאפשר לאפליקציות של Chat לצפות בצ'אטים ולשלוח הודעות.

היקף ההרשאות הזה תומך רק באימות אפליקציות באמצעות חשבונות שירות. אי אפשר לבצע אימות באמצעות פרטי כניסה של משתמשים או באמצעות מתן הרשאות גישה ברמת הדומיין באמצעות ההיקף הזה.

היקפים רגישים

קוד היקף תיאור
https://www.googleapis.com/auth/chat.spaces יצירת שיחות ומרחבים, קריאה או עריכה של מטא-נתונים (כולל הגדרות ההיסטוריה והגדרות הגישה) ב-Chat.
https://www.googleapis.com/auth/chat.spaces.create ליצור שיחות חדשות ב-Chat.
https://www.googleapis.com/auth/chat.spaces.readonly הצגת הצ'אט והמרחבים ב-Chat
https://www.googleapis.com/auth/chat.memberships לראות, להוסיף, לעדכן ולהסיר משתתפים בשיחות ב-Chat.
https://www.googleapis.com/auth/chat.memberships.app הוספה של האפליקציה לשיחות ב-Google Chat והסרתה מהן.
https://www.googleapis.com/auth/chat.memberships.readonly הצגת המשתתפים בשיחות ב-Chat.
https://www.googleapis.com/auth/chat.messages.create לכתוב ולשלוח הודעות ב-Chat.
https://www.googleapis.com/auth/chat.messages.reactions ראיית תגובות להודעות ב-Chat, הוספה ומחיקה שלהן.
https://www.googleapis.com/auth/chat.messages.reactions.create הוספת תגובות להודעות ב-Chat.
https://www.googleapis.com/auth/chat.messages.reactions.readonly גישה אל תגובות להודעות ב-Chat.
https://www.googleapis.com/auth/chat.users.readstate הצגה ושינוי של מועד הקריאה האחרון בשיחות ב-Chat.
https://www.googleapis.com/auth/chat.users.readstate.readonly הצגת זמן הקריאה האחרון של שיחות ב-Chat.
https://www.googleapis.com/auth/chat.admin.spaces.readonly לגשת לצ'אטים ולמרחבים שבבעלות הדומיין של האדמין ב-Chat.
https://www.googleapis.com/auth/chat.admin.spaces לצפות בצ'אטים ובמרחבים משותפים שנמצאים בדומיין של האדמין ב-Chat או לערוך אותם.
https://www.googleapis.com/auth/chat.admin.memberships.readonly לגשת לרשימות המשתתפים והמנהלים בשיחות ב-Chat שבבעלות הדומיין של האדמין.
https://www.googleapis.com/auth/chat.admin.memberships לגשת לרשימות של המשתתפים והמנהלים בשיחות שבבעלות הדומיין של האדמין ב-Chat, להוסיף משתמשים ומנהלים לשיחות, לעדכן את התפקידים שלהם ולהסיר אותם משיחות.
https://www.googleapis.com/auth/chat.app.spaces

יצירת שיחות ומרחבים, וקריאה או עריכה של מטא-נתונים (כולל הגדרות ההיסטוריה והגדרות הגישה) ב-Chat כאפליקציית צ'אט. נדרשת אישור אדמין.

היקף ההרשאות הזה תומך רק באימות אפליקציות באמצעות חשבונות שירות. אי אפשר לבצע אימות באמצעות פרטי כניסה של משתמשים או באמצעות מתן הרשאות גישה ברמת הדומיין באמצעות ההיקף הזה.
https://www.googleapis.com/auth/chat.app.spaces.create

יצירת שיחות ומרחבים חדשים ב-Chat כאפליקציית צ'אט. נדרשת אישור אדמין.

היקף ההרשאות הזה תומך רק באימות אפליקציות באמצעות חשבונות שירות. אי אפשר לבצע אימות באמצעות פרטי כניסה של משתמשים או באמצעות מתן הרשאות גישה ברמת הדומיין באמצעות ההיקף הזה.
https://www.googleapis.com/auth/chat.app.memberships

קריאה, הוספה, עדכון והסרה של חברים בשיחות ובמרחבים ב-Chat כאפליקציית צ'אט. נדרשת אישור אדמין.

היקף ההרשאות הזה תומך רק באימות אפליקציות באמצעות חשבונות שירות. אי אפשר לבצע אימות באמצעות פרטי כניסה של משתמשים או באמצעות מתן הרשאות גישה ברמת הדומיין באמצעות ההיקף הזה.
https://www.googleapis.com/auth/chat.customemojis הצגה, יצירה ומחיקה של אמוג'י בהתאמה אישית ב-Chat.
https://www.googleapis.com/auth/chat.customemojis.readonly קריאת אמוג'י מותאם אישית ב-Chat.
https://www.googleapis.com/auth/chat.users.spacesettings הצגה ועדכון של הגדרות המרחב של משתמשים ב-Chat.
https://www.googleapis.com/auth/chat.users.sections צפייה, יצירה, עדכון ומחיקה של הקטעים שלכם ב-Chat; העברה והרכבת רשימה של פריטי הקטעים שלכם ב-Chat.
https://www.googleapis.com/auth/chat.users.sections.readonly צפייה בקטעים שלכם ובפריטים שבהם ב-Chat.

היקפים מוגבלים

קוד היקף תיאור
https://www.googleapis.com/auth/chat.delete מחיקה של שיחות ומרחבים והסרת הגישה לקבצים משויכים ב-Chat.
https://www.googleapis.com/auth/chat.import ייבוא מרחבים, הודעות ומינויים אל Chat. מידע נוסף זמין במאמר בנושא אישור לאפליקציות ל-Chat לייבא נתונים
https://www.googleapis.com/auth/chat.messages גישה להודעות, כתיבה, שליחה, ועדכון ומחיקה שלהן, וגם גישה לתגובות להודעות והוספה ומחיקה שלהן.
https://www.googleapis.com/auth/chat.messages.readonly גישה להודעות ולתגובות ב-Chat.
https://www.googleapis.com/auth/chat.app.messages.readonly

הצגת הודעות ותגובות ב-Chat כאפליקציית צ'אט. נדרש אישור אדמין.

היקף ההרשאות הזה תומך רק באימות אפליקציות באמצעות חשבונות שירות. אי אפשר לבצע אימות באמצעות פרטי כניסה של משתמשים או באמצעות מתן הרשאות גישה ברמת הדומיין באמצעות ההיקף הזה.
https://www.googleapis.com/auth/chat.admin.delete מחיקת השיחות והמרחבים שבבעלות הדומיין של האדמין והסרת הגישה לקבצים המשויכים ב-Chat.
https://www.googleapis.com/auth/chat.app.delete

מחיקה של שיחות ומרחבים והסרת הגישה לקבצים משויכים ב-Chat כאפליקציית צ'אט. נדרשת אישור אדמין.

היקף ההרשאות הזה תומך רק באימות אפליקציות באמצעות חשבונות שירות. אי אפשר לבצע אימות באמצעות פרטי כניסה של משתמשים או באמצעות מתן הרשאות גישה ברמת הדומיין באמצעות ההיקף הזה.

ההיקפים בטבלאות הקודמות מציינים את הרגישות שלהם, בהתאם להגדרות הבאות:

אם האפליקציה שלכם דורשת גישה לממשקי Google API אחרים, תוכלו להוסיף גם את היקפי ההרשאות האלה. מידע נוסף על היקפי Google API זמין במאמר שימוש ב-OAuth 2.0 לגישה ל-Google APIs.

מידע נוסף על היקפי הרשאות לממשקי API של Google Workspace זמין במאמר הגדרת מסך הסכמה ל-OAuth ובחירת היקפי הרשאות.

סוגי האימות הנדרשים

יש שתי דרכים שבהן אפליקציות ל-Chat יכולות לבצע אימות והרשאה באמצעות Chat API:

אימות משתמשים
אימות משתמשים מאפשר לאפליקציית צ'אט לגשת לנתוני משתמשים ולהשלים פעולות בשם המשתמשים. היקפי הרשאות OAuth מציינים את הנתונים והפעולות המורשים. אלא אם אפליקציית צ'אט הותקנה על ידי האדמין או שניתנה לה הענקת הרשאות ברמת הדומיין, בפעם הראשונה שאפליקציית צ'אט מבצעת פעולה בשם משתמש, המשתמש צריך לאשר את אפליקציית צ'אט באמצעות מסך הסכמה ל-OAuth.
אימות אפליקציות

אימות אפליקציות מאפשר לאפליקציית צ'אט להשתמש בפרטי הכניסה של חשבון שירות, לגשת לנתונים ולהשלים פעולות בשם עצמה. מכיוון שאפליקציית צ'אט משתמשת בפרטי הכניסה שלה כדי לגשת למשאבים ולעבוד איתם, משתמשי קצה לא צריכים לאשר את קריאות ה-API של אפליקציית צ'אט, ואי אפשר להוסיף להיקפי ההרשאות של OAuth תחומי הרשאות של OAuth שתומכים בהרשאת האפליקציה במסך הסכמה ל-OAuth.

יש שני סוגים של היקפי הרשאות OAuth שתומכים באימות אפליקציות:

  • ‫https://www.googleapis.com/auth/chat.bot: אפליקציית צ'אט יכולה לקרוא לשיטות של Google Chat API שתומכות בהיקף ההרשאות הזה כדי ליצור, לעדכן, לקבל, לרשום או למחוק משאבים שיש לה גישה אליהם, כמו הודעות במרחבים שמשתמשי קצה מוסיפים אליהם את אפליקציית צ'אט. אפליקציית צ'אט יכולה להעניק לעצמה את היקף ההרשאה הזה, ולא נדרשת הרשאה ממנהל או ממשתמש קצה.
  • ‫https://www.googleapis.com/auth/chat.app.*: כדי להשתמש בהיקפי ההרשאות האלה, צריך לקבל אישור חד-פעמי מאדמין. כדי לקבל אישור מהאדמין, צריך להכין את חשבון השירות של אפליקציית Chat לקבלת אישור מהאדמין על ידי יצירת לקוח OAuth שתואם ל-Google Workspace Marketplace והגדרת האפליקציה ב-Google Workspace Marketplace SDK. ההיקפים האלה מאפשרים לאפליקציית צ'אט שלכם לקרוא לשיטות ספציפיות של Google Chat API. לדוגמה, ההרשאה chat.app.spaces.create מאפשרת לאפליקציות ליצור מרחבים ב-Chat.

אם שיטה מסוימת תומכת באימות משתמשים ובאימות אפליקציות, Chat API מחזיר תוצאות שונות בהתאם לסוג האימות שבו משתמשים:

  • באימות אפליקציות, השיטות מחזירות רק משאבים שאפליקציית צ'אט יכולה לגשת אליהם.
  • באימות משתמשים, השיטות מחזירות רק משאבים שהמשתמש יכול לגשת אליהם.

לדוגמה, הפעלת השיטה spaces.list() עם הרשאת גישה לאפליקציה מחזירה את רשימת המרחבים שאפליקציית הצ'אט חברה בהם. התקשרות אל spaces.list() עם הרשאת משתמש מחזירה את רשימת המרחבים שהמשתמש חבר בהם. בפועל, יכול להיות שתשתמשו בשני סוגי האימות כשאתם קוראים ל-Chat API, בהתאם לעיצוב ולתכונות של אפליקציית צ'אט שלכם.

לקריאות אסינכרוניות ל-Chat API

בטבלה הבאה מפורטים ה-methods של Chat API והיקפי ההרשאות הנתמכים שלהם:

שיטה אימות משתמשים נתמך אימות אפליקציה נתמך היקפי הרשאות נתמכים
מרחבים  
איך יוצרים מרחבים עם אימות משתמשים:
  • chat.spaces.create
  • chat.spaces
  • chat.import
עם אימות אפליקציות ואישור אדמין:
  • chat.app.spaces.create
  • chat.app.spaces
הגדרת מרחב — עם אימות משתמשים:
  • chat.spaces.create
  • chat.spaces
איך יוצרים מרחבים עם אימות משתמשים:
  • chat.spaces.readonly
  • chat.spaces
עם אימות משתמשים באמצעות הרשאות אדמין:
  • chat.admin.spaces.readonly
עם אימות אפליקציות:
  • chat.bot
עם אימות אפליקציות ואישור אדמין:
  • chat.app.spaces
הצגת רשימה של מרחבים עם אימות משתמשים:
  • chat.spaces.readonly
  • chat.spaces
עם אימות אפליקציות:
  • chat.bot
חיפוש מרחבים — עם אימות משתמשים באמצעות הרשאות אדמין:
  • chat.admin.spaces.readonly
עדכון המרחב עם אימות משתמשים:
  • chat.spaces
  • chat.import
עם אימות משתמשים באמצעות הרשאות אדמין:
  • chat.admin.spaces
עם אימות אפליקציות ואישור אדמין:
  • chat.app.spaces
מחיקת מרחב עם אימות משתמשים:
  • chat.delete
  • chat.import
עם אימות משתמשים באמצעות הרשאות אדמין:
  • chat.admin.delete
עם אימות אפליקציות ואישור אדמין:
  • chat.app.delete
השלמת תהליך הייבוא של מרחב — עם אימות משתמשים:
  • chat.import
איך מוצאים צ'אטים ישירים עם אימות משתמשים:
  • chat.spaces.readonly
  • chat.spaces
עם אימות אפליקציות:
  • chat.bot
חברים  
יצירת חבר עם אימות משתמשים:
  • chat.memberships
  • chat.memberships.app
  • chat.import
עם אימות משתמשים באמצעות הרשאות אדמין:
  • chat.admin.memberships
עם אימות אפליקציות ואישור אדמין:
  • chat.app.memberships
קבלת חברות במועדון עם אימות משתמשים:
  • chat.memberships.readonly
  • chat.memberships
עם אימות אפליקציות:
  • chat.bot
עם אימות משתמשים באמצעות הרשאות אדמין:
  • chat.admin.memberships.readonly
חברים ברשימה עם אימות משתמשים:
  • chat.memberships.readonly
  • chat.memberships
  • chat.import
עם אימות אפליקציות:
  • chat.bot
עם אימות משתמשים באמצעות הרשאות אדמין:
  • chat.admin.memberships.readonly
מחיקת חברים עם אימות משתמשים:
  • chat.memberships
  • chat.memberships.app
  • chat.import
עם אימות משתמשים באמצעות הרשאות אדמין:
  • chat.admin.memberships
עם אימות אפליקציות ואישור אדמין:
  • chat.app.memberships
עדכון של משתמשים במרחב עם אימות משתמשים:
  • chat.memberships
  • chat.import
עם אימות משתמשים באמצעות הרשאות אדמין:
  • chat.admin.memberships
עם אימות אפליקציות ואישור אדמין:
  • chat.app.memberships
הודעות  
יצירת הודעה עם אימות משתמשים:
  • chat.messages.create
  • chat.messages
  • chat.import
עם אימות אפליקציות:
  • chat.bot
קבלת הודעה עם אימות משתמשים:
  • chat.messages.readonly
  • chat.messages
עם אימות אפליקציות:
  • chat.bot
עם אימות אפליקציות ואישור אדמין (זמין בתצוגה מקדימה למפתחים):
  • chat.app.messages.readonly
הצגת רשימת ההודעות עם אימות משתמשים:
  • chat.messages.readonly
  • chat.messages
  • chat.import
עם אימות אפליקציות ואישור אדמין (זמין בתצוגה מקדימה למפתחים):
  • chat.app.messages.readonly
עדכון הודעה עם אימות משתמשים:
  • chat.messages
  • chat.import
עם אימות אפליקציות:
  • chat.bot
איך מוחקים הודעות עם אימות משתמשים:
  • chat.messages
  • chat.import
עם אימות אפליקציות:
  • chat.bot
עדכון כרטיסים בהודעה — באמצעות אימות אפליקציות:
  • chat.bot
תגובות  
יצירת תגובה — עם אימות משתמשים:
  • chat.messages.reactions.create
  • chat.messages.reactions
  • chat.messages
  • chat.import
הצגת רשימת התגובות באמוג'י — עם אימות משתמשים:
  • chat.messages.reactions.readonly
  • chat.messages.reactions
  • chat.messages.readonly
  • chat.messages
מחיקת תגובה באמוג'י — עם אימות משתמשים:
  • chat.messages.reactions
  • chat.messages
  • chat.import
סמלי אמוג'י מותאמים אישית  
איך יוצרים אמוג'י בהתאמה אישית — עם אימות משתמשים:
  • chat.customemojis
מחיקת אמוג'י בהתאמה אישית — עם אימות משתמשים:
  • chat.customemojis
איך מקבלים אמוג'י בהתאמה אישית — עם אימות משתמשים:
  • chat.customemojis
  • chat.customemojis.readonly
הצגת רשימה של סמלי אמוג'י מותאמים אישית — עם אימות משתמשים:
  • chat.customemojis
  • chat.customemojis.readonly
מדיה וקבצים מצורפים  
העלאת מדיה כקובץ מצורף — עם אימות משתמשים:
  • chat.messages.create
  • chat.messages
  • chat.import
הורדת מדיה עם אימות משתמשים:
  • chat.messages.readonly
  • chat.messages
עם אימות אפליקציות:
  • chat.bot
איך מורידים קובץ מצורף להודעה — באמצעות אימות אפליקציות:
  • chat.bot
מצבי קריאה של משתמשים
קבלת סטטוס הקריאה של משתמש במרחב — עם אימות משתמשים:
  • chat.users.readstate
  • chat.users.readstate.readonly
עדכון סטטוס הקריאה של משתמש במרחב — עם אימות משתמשים:
  • chat.users.readstate
קבלת מצב הקריאה של שרשור של משתמש — עם אימות משתמשים:
  • chat.users.readstate
  • chat.users.readstate.readonly
הגדרות המרחב של המשתמש
קבלת הגדרת ההתראות של משתמש במרחב — עם אימות משתמשים:
  • chat.users.spacesettings
איך מעדכנים את הגדרת ההתראות של משתמש במרחב — עם אימות משתמשים:
  • chat.users.spacesettings
אירועים ב-Spaces
קבלת אירועים במרחב — באימות משתמשים, חובה להשתמש בהיקף שמבוסס על סוג האירוע:
  • לאירועים שקשורים להודעות:
    • chat.messages
    • chat.messages.readonly
  • לאירועים שקשורים לתגובות באמוג'י:
    • chat.messages.reactions
    • chat.messages.reactions.readonly
    • chat.messages
    • chat.messages.readonly
  • לאירועים שקשורים למועדון החברים:
    • chat.memberships
    • chat.memberships.readonly
  • לאירועים שקשורים למרחב:
    • chat.spaces
    • chat.spaces.readonly
הצגת רשימה של אירועים במרחב — באימות משתמשים, צריך להשתמש בהיקף לכל סוג אירוע שכלול בבקשה:
  • לאירועים שקשורים להודעות:
    • chat.messages
    • chat.messages.readonly
  • לאירועים שקשורים לתגובות באמוג'י:
    • chat.messages.reactions
    • chat.messages.reactions.readonly
    • chat.messages
    • chat.messages.readonly
  • לאירועים שקשורים למועדון החברים:
    • chat.memberships
    • chat.memberships.readonly
  • לאירועים שקשורים למרחב:
    • chat.spaces
    • chat.spaces.readonly
Sections  
יצירת אוסף — עם אימות משתמשים:
  • chat.users.sections
מחיקת קטע — עם אימות משתמשים:
  • chat.users.sections
List sections — עם אימות משתמשים:
  • chat.users.sections
  • chat.users.sections.readonly
עדכון קטע — עם אימות משתמשים:
  • chat.users.sections
שינוי המיקום של קטע — עם אימות משתמשים:
  • chat.users.sections
Section Items  
העברת פריט בקטע — עם אימות משתמשים:
  • chat.users.sections
פריטים ברשימת הקורסים — עם אימות משתמשים:
  • chat.users.sections
  • chat.users.sections.readonly

לאירועי אינטראקציה עם אפליקציית צ'אט

בטבלה הבאה מפורטות דרכים נפוצות שבהן משתמשים מקיימים אינטראקציה עם אפליקציות ל-Chat, ומוסבר אם נדרש אימות או אם הוא נתמך:

תרחיש לא נדרש אימות אימות משתמשים נתמך אימות אפליקציה נתמך
קבלת הודעות מאת:
אירועים של אינטראקציה עם אפליקציות צ'אט — —
קריאות חוזרות (callback) ב-Apps Script — —
‫Google Cloud Pub/Sub — —
איך עונים להודעות
באופן סינכרוני, באמצעות אירוע אינטראקציה של אפליקציית Chat — —
באופן סינכרוני, באמצעות ערך החזרה של קריאה חוזרת (callback) ב-Apps Script — —
שליחת הודעות חדשות:
עם webhooks נכנסים — —