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

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

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

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

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

  1. הגדרת פרויקט ב-Google Cloud, הפעלת Chat API והגדרת אפליקציית הצ'אט: במהלך הפיתוח, יוצרים פרויקט ב-Google Cloud. בפרויקט ב-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 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.

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

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

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

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

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

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

  • https://www.googleapis.com/auth/chat.bot: האפליקציה ל-Chat יכולה לקרוא לשיטות של 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 יש גישה אליהם.
  • באימות משתמש, השיטות מחזירות רק משאבים שלמשתמש יש גישה אליהם.

לדוגמה, אם מפעילים את השיטה 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.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 — —
קריאות חוזרות (callbacks) ב-Apps Script — —
Google Cloud Pub/Sub — —
איך עונים להודעות:
באופן סינכרוני, באמצעות אירוע אינטראקציה של אפליקציית Chat — —
באופן סינכרוני, באמצעות ערך החזרה של קריאה חוזרת (callback) של Apps Script — —
שליחת הודעות חדשות:
באמצעות תגובות לפעולות לפיתוח API (webhook) נכנסות — —