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

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

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

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

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

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

  2. שליחת קריאה ל-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 API או ל-Google API אחר בזמן עיבוד התגובה.

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

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

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

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

  • משתמש שולח הודעה לאפליקציה ל-Chat.
  • משתמש מתייג אפליקציית צ'אט באמצעות @.
  • המשתמש מפעיל את אחת מהפקודות של האפליקציה ל-Chat.

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

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

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

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

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

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

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

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

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

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

  1. אפליקציית Chat יוצרת הודעה על ידי קריאה ל-Chat API באמצעות ה-method‏ 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 כאפליקציה ל-Chat. נדרש אישור אדמין.

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

https://www.googleapis.com/auth/chat.app.spaces.readonly

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

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

https://www.googleapis.com/auth/chat.app.spaces.create

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

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

https://www.googleapis.com/auth/chat.app.memberships

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

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

https://www.googleapis.com/auth/chat.app.memberships.readonly

לראות את רשימת המשתתפים בשיחות ובמרחבים ב-Chat כאפליקציה ל-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, להעביר את הפריטים שבחלקים ולהציג רשימה שלהם.
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 כאפליקציה ל-Chat. נדרש אישור של אדמין.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

בטבלה הבאה מפורטות השיטות של 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.readonly
  • chat.messages
עדכון הודעה עם אימות משתמש:
  • chat.messages
  • chat.import
אימות באפליקציה:
  • chat.bot
איך מוחקים הודעות עם אימות משתמש:
  • chat.messages
  • chat.import
אימות באפליקציה:
  • chat.bot
הצמדת הודעה — עם אימות משתמש:
  • chat.spaces.pins
  • chat.spaces
ביטול ההצמדה של הודעה — עם אימות משתמש:
  • chat.spaces.pins
  • chat.spaces
הצגת רשימה של הודעות מוצמדות — עם אימות משתמש:
  • chat.spaces.pins.readonly
  • chat.spaces.readonly
  • chat.spaces.pins
  • chat.spaces
עדכון כרטיסים בהודעה — באמצעות אפליקציית אימות:
  • 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.readstate
הגדרות של מרחב המשתמש
איך מקבלים את הגדרת ההתראות של משתמש במרחב משותף — עם אימות משתמש:
  • chat.users.spacesettings
איך משנים את הגדרת ההתראות של המשתמשים במרחב המשותף — עם אימות משתמש:
  • chat.users.spacesettings
אירועים במרחבים משותפים
קבלת אירועים במרחב משותף — באימות משתמשים, צריך להשתמש בהיקף שמבוסס על סוג האירוע:
  • לאירועים שקשורים להודעות:
    • 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
קטעים  
יצירת קטע — עם אימות משתמש:
  • chat.users.sections
מחיקת קטע — עם אימות משתמש:
  • chat.users.sections
רשימת קטעים — עם אימות משתמש:
  • chat.users.sections
  • chat.users.sections.readonly
עדכון קטע — עם אימות משתמש:
  • chat.users.sections
מיקום של קטע — עם אימות משתמש:
  • chat.users.sections
פריטים באזור  
העברת פריט בחלק — עם אימות משתמש:
  • chat.users.sections
פריטים ברשימה — עם אימות משתמש:
  • chat.users.sections
  • chat.users.sections.readonly

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

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

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