פיתוח באמצעות Google Chat

בדף הזה מפורטת סקירה כללית על Google Chat API ועל אפליקציות ל-Google Chat.

סקירה כללית על Google Chat API

‫Chat API מורכב משירותי gRPC או משיטות ומשאבי REST שמאפשרים גישה ל-Chat, כולל מרחבים, משתתפים במרחבים, הודעות, תגובות להודעות, קבצים שמצורפים להודעות, אירועים במרחבים ומצבי קריאה של משתמשים.

מושגים

בקטע הבא מוגדרים השירותים, המשאבים והשיטות של Chat API:

מרחבים

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

הפניה למשאבים:

לדוגמה לשימוש, אפשר לעיין במאמר:

חברים

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

הפניה למשאבים:

לדוגמה לשימוש, אפשר לעיין במאמר:

הודעות

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

הפניה למשאבים:

לדוגמה לשימוש, אפשר לעיין במאמר:

תגובות

תגובות הן האמוג'י שאנשים משתמשים בהם כדי להגיב להודעה, כמו 👍,‏ 🚲 ו-🌞.

הפניה למשאבים:

לדוגמה לשימוש, אפשר לעיין במאמר:

סמלי אמוג'י מותאמים אישית

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

הפניה למשאבים:

מדיה וקבצים מצורפים

Media מייצג קובץ שהועלה ל-Google Chat, כמו תמונות, סרטונים ומסמכים.

הפניה למשאב מדיה (לא זמין ב-RPC):

קבצים מצורפים הם מקרים של מדיה (קבצים) שמצורפים להודעות.

הפניה למשאבים:

לדוגמה לשימוש, אפשר לעיין במאמר:

אירועים ב-Spaces

אירועים במרחב מייצגים שינויים במרחב או במשאבי הצאצא שלו, כולל המשתתפים, ההודעות והתגובות.

הפניה למשאבים:

לדוגמה לשימוש, אפשר לעיין במאמר:

מצבי קריאה של משתמשים

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

הפניה למשאב של סטטוס קריאה במרחב:

הפניה למשאב של מצב קריאת השרשור:

לדוגמה לשימוש, אפשר לעיין במאמר:

הגדרות ההתראות של המשתמשים במרחבים

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

הפניה למשאבים:

אימות

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

מידע נוסף על אימות ב-Chat זמין במאמר סקירה כללית על אימות.

ספריות לקוח

הדרך המומלצת לרוב המפתחים לקרוא ל-Google Chat API היא באמצעות ספריות הלקוח של Cloud שנתמכות באופן רשמי בשפה המועדפת עליכם, כמו Python,‏ Java או Node.js.

אם אתם כותבים קוד באמצעות Google Apps Script, אתם יכולים להשתמש בשירות המתקדם של Chat במקום להתקין ספריית לקוח.

פיתוח אפליקציות ל-Chat

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

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

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

  • אפליקציות אינטראקטיביות: מגיבות לאינטראקציה של המשתמשים, כמו תיוגים ב-@ או פקודות עם לוכסן (/), ומציגות מידע או מדריכות את המשתמשים בתהליך עבודה באמצעות כרטיסים ודיאלוגים.
  • אפליקציות של שורת פקודה או וווב-הוקים: שליחת הודעות יזומות, כמו אזעקות או התראות, ממערכת אחרת למרחב. המשתמשים לא יכולים ליצור אינטראקציה ישירה עם סוג האפליקציה הזה.
  • אפליקציות מבוססות-אירועים: אפשר להירשם לפעילות במרחב ב-Chat ולהגיב לה, למשל כשמשתמש חדש מצטרף למרחב. בתגובה לאירוע, האפליקציה יכולה לשלוח הודעה או לבצע פעולה אחרת.

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

רוצים לראות את Google Chat API בפעולה?
בערוץ Google Workspace Developers יש סרטונים עם טיפים, טריקים ומידע על התכונות החדשות.