בדף הזה מפורטת סקירה כללית על פיתוח תוספים ל-Google Workspace שמרחיבים את Google Chat.
תוספים של Google Workspace שמרחיבים את Chat יכולים לעזור למשתמשים לבצע את הפעולות הבאות:
- להציג תצוגה מקדימה של קישורים מהודעות ב-Chat ולבצע פעולות מבלי לצאת מהשיחה.
- ביצוע משימות או אוטומציה שלהן באפליקציות של Google Workspace.
- לקבל התראות או התראות על כלים או שירותים חיצוניים.
איך פועלים התוספים של Google Workspace ב-Chat
ב-Chat, התוספים מופיעים למשתמשים כאפליקציות של Google Chat. כדי ליצור אינטראקציה עם משתמשים, אפליקציות צ'אט יכולות:
- לשלוח הודעות שמכילות טקסט, כרטיסים ורכיבי ממשק משתמש אינטראקטיביים.
- להשיב לפקודות דרך שורת הפקודה.
- פתיחת תיבות דו-שיח כדי לעזור למשתמשים להשלים תהליכים שכוללים כמה שלבים, כמו מילוי פרטים בטופס.
- אתם יכולים לצרף כרטיסים עם מידע שימושי להודעות כדי להציג תצוגה מקדימה של קישורים, ולאפשר למשתמשים לבצע פעולות ישירות מהשיחה.
שנתחיל?
כדי להתחיל לפתח תוספים ל-Google Workspace שפועלים ב-Chat, תוכלו לעיין במסמכים הבאים:
- כדאי לנסות מדריך למתחילים ליצירת אפליקציית Chat בסיסית באמצעות Google Apps Script או שירות HTTP.
- הגדרת אפליקציה ל-Chat והתכונות האינטראקטיביות שלה באמצעות Chat API.
- איך יוצרים ממשקי Chat באמצעות טריגרים, פעולות ואובייקטים של אירועים בתוספים
מגבלות ובעיות ידועות
התכונות הבאות של הצ'אט והתוספים לא זמינות:
- Dialogflow ו-Pub/Sub. כדי ליצור תוספים שמרחיבים את Chat, צריך להשתמש ב-Apps Script או בשירות HTTP.
- Card Service של Apps Script. כדי להשתמש בפעולות בצ'אט וליצור כרטיסים, צריך להחזיר אובייקטים של JSON במקום זאת. דוגמאות לכך מפורטות בקטע פתיחת תיבות דו-שיח אינטראקטיביות ובקטע תצוגה מקדימה של קישורים.
- כרטיסי הרשאה מותאמים אישית. כדי לאמת את השירות שלכם ולתת לו הרשאה מ-Chat, אפליקציית Chat צריכה להחזיר כרטיס הרשאה בסיסי.
- דפי הבית של התוספים בסרגל הצד של Chat. אם הגדרתם טריגר לדף הבית לתוסף, דף הבית יופיע רק בסרגל הצד של האפליקציות האחרות של Google Workspace שהתוסף מרחיב.
- דפי הבית של אפליקציית Chat, שמופיעים בכרטיסייה Home (דף הבית) של הצ'אטים האישיים באפליקציית Chat.
אם אתם מעדכנים תוסף קיים ל-Google Workspace, כדאי לשקול את דרישות ההגדרה הבאות לאפליקציות Chat:
- הגדרות ההתקנה של Google Workspace Marketplace חייבות לאפשר גם לאנשים פרטיים וגם לאדמינים ב-Google Workspace להתקין את התוסף.
- הגדרות תצורה נפוצות במניפסט של התוסף (
addons.common
) מתעלמות ב-Chat. כדי להגדיר את התוסף לעבודה ב-Chat, צריך להפעיל ולהגדיר את Chat API. במאמר הגדרת אפליקציית Google Chat מוסבר איך עושים את זה. - אם אתם מפתחים באמצעות שירות HTTP, עליכם להפעיל את Google Workspace add-ons API. המשאבים של REST
deployment
ו-project
חלים רק על פריסות של תוספים באפליקציות אחרות של Google Workspace. - כדי לפרוס ולבדוק תוסף ב-Chat, צריך להשתמש בהגדרה Visibility של Chat API. ההגדרות של החשיפה או הבדיקה שהגדרתם ב-Google Workspace Marketplace SDK לא יחולו. כדי לפרוס גרסה לבדיקה של התוסף ב-Chat, תוכלו לעיין במאמר בדיקת תכונות אינטראקטיביות לאפליקציות של Google Chat במסמכי העזרה של Chat API.
- אם התוספים שלכם פורסמו ב-Google Workspace Marketplace, לא תוכלו לשמור טיוטה של שינויים בהגדרות התצורה של Google Chat API. כשמעדכנים את הגדרות התצורה של Chat API, אפליקציית Chat המעודכנת זמינה באופן מיידי לכל המשתמשים הקיימים. כדי לעדכן את המוצר ב-Marketplace, תוכלו ליצור טיוטה לפני שליחת השינויים.