בקטע הזה מוסבר איך אפליקציית Google Chat יכולה להתקשר ל-Chat API, שמאפשר לאפליקציות ל-Chat לבצע פעולות כמו: ליצור מרחב, להוסיף אליו אנשים ולפרסם הודעה.
אימות
כדי לשלוח קריאה ל-Chat API, צריך לבצע אימות. כל אחד רכיב ה-method של 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 שהצטרפו או שהם הוזמנו למרחב המשותף.
הפניה למשאבים:
דוגמאות לשימוש:
- הודעות
הודעות כוללות טקסט וגם כרטיס הודעות שפורסמו במרחבים המשותפים. אפשר לצרף קבצים להודעות. אנשים יכולים לצרף אמוג'י כדי להגיב להודעות.
הפניה למשאבים:
דוגמאות לשימוש:
- תגובות
תגובות מייצגות את האמוג'י שבו אנשים משתמשים כדי להגיב להודעות, למשל. 👍, 🚲 ו 🌞.
הפניה למשאבים:
דוגמאות לשימוש:
- מדיה וקבצים מצורפים
מדיה מייצגת קובץ שהועלה ל-Google Chat, כמו תמונות, סרטונים מסמכים.
הפניה למשאבי מדיה (לא זמינה ב-RPC):
קבצים מצורפים הם מופעים של מדיה (קבצים) שמצורפים להודעות.
הפניה למשאבים:
דוגמאות לשימוש:
- אירועים במרחב המשותף
אירועים במרחב המשותף מייצגים שינויים במרחב או ואת המשאבים לילדים, כולל החברים, ההודעות והתגובות.
הפניה למשאבים:
דוגמאות לשימוש:
- מצבי קריאה של משתמשים
מצבי קריאה של משתמשים הם משאבים מסוג סינגלטון שמייצגים פרטים על ההודעה האחרונה שנקראה של משתמש מסוים במרחב ב-Google Chat או בהודעה של שרשור.
הפניה למשאבי מצב של קריאת רווח:
הפניה למשאבי מצב של קריאת שרשורים:
דוגמאות לשימוש:
נושאים קשורים
- דוגמאות לאפליקציות של Google Chat להתחיל להשתמש ב-Chat API.
נוסף לקריאה ל-Chat API, אפליקציות צ'אט יכולות גם:
- לקבל אירועי אינטראקציה באפליקציית Chat ולהגיב עליהם, כמו הודעות שנשלחות לאפליקציית Google Chat, בזמן אמת.
- הרשמה לאירועים ב-Google Chat לנקוט פעולה או להשיב כאשר שמתרחשים ב-Chat פעילויות או שינויים, כמו הודעות חדשות שינויים במינוי.