בקטע הזה נסביר איך אפליקציה של Google Chat יכולה להפעיל את Chat API, שמאפשר לאפליקציות של Chat לבצע פעולות כמו ליצור מרחב משותף, להוסיף אנשים אליו ולפרסם הודעה.
אימות
כדי לקרוא ל-Chat API נדרש אימות. כל שיטה של Chat API דורשת אימות משתמש (כדי לבצע פעולות או לגשת לנתונים בשם משתמש) או אימות אפליקציה (כדי לבצע פעולות או לגשת לנתונים כאפליקציית Chat). שיטות מסוימות תומכות גם באימות משתמשים וגם באימות אפליקציות.
למידע נוסף על אימות ב-Chat, קראו את הסקירה הכללית על אימות.
ספריות לקוח
הדרך המומלצת לרוב המפתחים לבצע קריאה ל-Google Chat API היא באמצעות ספריות הלקוח של Cloud הנתמכות באופן רשמי בשפה המועדפת עליכם, כמו Python, Java או Node.js.
אם אתם כותבים קוד באמצעות Google Apps Script, תוכלו להשתמש בשירות Chat המתקדם במקום להתקין ספריית לקוח.
מושגים ב-Google Chat API
שירותי gRPC או משאבים ושיטות של REST מעניקים גישה למרחבים משותפים ב-Chat, למשתתפים במרחבים, להודעות, לתגובות להודעות, לקבצים מצורפים להודעות, לאירועים במרחבים ולמצבי קריאה של משתמשים.
- מרחבים
מרחבים משותפים הם מקומות שבהם אנשים ואפליקציות יכולים להתכתב ולשתף קבצים. יש כמה סוגים של מרחבים משותפים. צ'אטים אישיים (DM) הם שיחות בין שני משתמשים או בין משתמש לאפליקציית Chat. צ'אטים קבוצתיים הם שיחות בין שלושה משתמשים או יותר לאפליקציות Chat. מרחבים משותפים עם שם הם מקומות קבועים שבהם אנשים שולחים הודעות, משתפים קבצים ועובדים יחד.
הפניה למשאב:
דוגמאות לשימוש:
- חברים
משתמשים הם משתמשים ואפליקציות ל-Chat שהצטרפו למרחב המשותף או שהוזמנו אליו.
הפניה למשאב:
דוגמאות לשימוש:
- הודעות
הודעות כוללות הודעות טקסט וכרטיסים שפורסמו במרחבים משותפים. אפשר לצרף קבצים להודעות. אנשים יכולים להגיב להודעות על ידי הוספת אמוג'י אליהן.
הפניה למשאב:
דוגמאות לשימוש:
- תגובות
תגובות מייצגות את האמוג'י שאנשים משתמשים בהם כדי להגיב להודעה, כמו 👍, 🚲 ו-🌞.
הפניה למשאב:
דוגמאות לשימוש:
- סמלי אמוג'י בהתאמה אישית (גרסת Developer Preview)
אמוג'י בהתאמה אישית מייצגים אמוג'י בהתאמה אישית שנוצרו ושותפו בארגון ב-Google Chat. אפשר לכלול אמוג'י בהתאמה אישית בתוכן של הודעה או להשתמש בהם כדי להגיב להודעה.
הפניה למשאב:
- מדיה וקבצים מצורפים
מדיה מייצגת קובץ שהועלו ל-Google Chat, כמו תמונות, סרטונים ומסמכים.
הפניה למשאב מדיה (לא זמינה ב-RPC):
קבצים מצורפים הם פריטים של מדיה (קבצים) שמצורפים להודעות.
הפניה למשאב:
דוגמאות לשימוש:
- אירועים ב-Spaces
אירועים במרחב משותף מייצגים שינויים במרחב המשותף או במשאבים הצאצאים שלו, כולל המשתתפים, ההודעות והתגובות.
הפניה למשאב:
דוגמאות לשימוש:
- מצבי קריאה של משתמשים
מצבי קריאה של משתמשים הם משאבים ייחודיים שמייצגים פרטים על ההודעה האחרונה שקורא משתמש ספציפי במרחב משותף ב-Google Chat או בשרשור של הודעה.
הפניה למשאב של מצב הקריאה של המרחב המשותף:
הפניה למשאב של מצב הקריאה של שרשור:
דוגמאות לשימוש:
- הגדרות התראות במרחב המשתמשים (גרסת Developer Preview)
הגדרות התראות של משתמש במרחב משותף הן משאבים ייחודיים שמייצגים הגדרות התראות ספציפיות של משתמשים במרחב משותף ב-Google Chat.
הפניה למשאב:
נושאים קשורים
- כאן תוכלו למצוא דוגמאות לאפליקציות של Google Chat שיעזרו לכם להתחיל להשתמש ב-Chat API.
בנוסף לקריאה ל-Chat API, אפליקציות Chat יכולות גם:
- לקבל אירועי אינטראקציה באפליקציית Chat ולהגיב להם, כמו הודעות שנשלחות לאפליקציית Google Chat, בזמן אמת.
- להירשם לאירועים ב-Google Chat כדי לבצע פעולות או להגיב כשמתרחשות פעילויות או שינויים מסוימים ב-Chat, כמו הודעות חדשות ושינויים במצב החברות.