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

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

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

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

מושגים

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

מרחבים

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

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

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

חברים

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

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

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

הודעות

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

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

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

תגובות

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

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

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

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

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

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

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

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

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

חומר עזר בנושא משאבי מדיה (לא זמין ב-RPC):

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

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

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

אירועים ב-Spaces

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

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

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

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

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