הגדרת אפליקציה של Google Chat

בדף הזה מוסבר איך להגדיר ולפרוס אפליקציית Google Chat כתוסף ל-Google Workspace.

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

דרישות מוקדמות

HTTP

Apps Script

כאן בוחרים שם לתצוגה, דמות ותיאור לאפליקציית Chat.

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

  • אפשר לאזכר את אפליקציית Chat באמצעות @ כדי לצרף אותה למרחב המשותף או לשלוח לה הודעה.
  • מוצאים את אפליקציית Chat ומתחילים אותה בצ'אט אישי. בתפריט האפליקציות, בצ'אטים האישיים מופיעים השם והדמות של אפליקציית Chat.
  • בשורת הכתיבה, המשתמשים יכולים לדפדף באפליקציות של Chat ולראות את השם, הדמות והתיאור שלהם.

לפני שמגדירים אפליקציית Chat, צריך להכין את הפרטים הבאים:

שדה תיאור פורמט
שם האפליקציה השם המוצג של אפליקציית Chat. עד 25 תווים אלפאנומריים
כתובת ה-URL של הדמות התמונה שמופיעה כדמות של אפליקציית Chat. כתובת URL מסוג HTTPS שמפנה לתמונה גרפית ריבועית (PNG או JPEG). הגודל המומלץ הוא 256 על 256 פיקסלים או יותר.
תיאור הסבר קצר על המטרה של אפליקציית Chat. עד 40 תווים אלפאנומריים

בקטע הבא מציינים את המידע הזה בהגדרות האישיות ב-Chat API.

איך מגדירים את אפליקציית Chat במסוף Google Cloud

אחרי שמקבלים את הפרטים של אפליקציית Chat, פותחים את הפרויקט ב-Cloud ומגדירים את ה-API של Chat:

  1. נכנסים לדף Chat API במסוף Google Cloud ולוחצים על הדף Configuration:

    כניסה לדף Chat API Configuration

  2. בקטע Application info ממלאים את השדות App name, Avatar URL ו-Description.

  3. בקטע Interactive features, לוחצים על Enable interactions (הפעלה של תכונות אינטראקטיביות) למצב מופעל ומבצעים את הפעולות הבאות:

    1. בקטע Functionality, מסמנים את התיבה אחת או יותר כדי שאפליקציית Chat תהיה זמינה להתקנה ולשימוש בה:

      • קבלת הודעות אישיות: המשתמשים יכולים להתקין את אפליקציית Chat ולשלוח לה הודעות במרחב ייעודי בין המשתמש לבין אפליקציית Chat.

      • הצטרפות למרחבים משותפים ולשיחות קבוצתיות: המשתמשים יכולים להוסיף את אפליקציית Chat ולתקשר איתה במרחבים משותפים עם כמה אנשים.

    2. בקטע Connection settings (הגדרות חיבור), בוחרים את הארכיטקטורה שבה רוצים להשתמש כדי לקבל אובייקטים של אירועים מ-Chat:

      • כדי להשתמש בשירות HTTP, בוחרים באפשרות HTTP endpoint ומספקים כתובת URL.
      • כדי להשתמש בפרויקט של Google Apps Script, בוחרים את Apps Script ומספקים מזהה פריסה לפרויקט.

    3. אופציונלי: כדי לקבל אובייקטים של אירועים ליותר מנקודת קצה או לפונקציה אחת, עוברים אל Connection settings (הגדרות חיבור) > Triggers (טריגרים) ומספקים או מעדכנים את פונקציות הקריאה החוזרת (callback) בטריגרים הבאים של Chat:

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

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

    5. בקטע Visibility (חשיפה), מציינים את כתובת האימייל שלכם כדי שתוכלו להתקין ולבדוק את אפליקציית Chat לפני הפרסום ב-Google Workspace Marketplace. אפשר לציין עד חמישה אנשים, או קבוצה אחת או יותר של קבוצות Google מהארגון שלכם ב-Google Workspace.

  4. אופציונלי: בקטע Logs, מסמנים את התיבה Log errors to Logging כדי להשתמש ב-Google Cloud Logging. למידע נוסף, תוכלו לקרוא את המאמר יומני שגיאות של שאילתות לגבי אפליקציות ל-Chat במאמרי העזרה של Chat API.

  5. לוחצים על שמירה.

אחרי שתשמרו את ההגדרות, כל מי שציינתם בהגדרה Visibility (חשיפה) של Chat API יוכל להתקין את אפליקציית Chat, לבדוק אותה או להשתמש בה. כדי להתחיל לבדוק את אפליקציית Chat ולנפות בה באגים, תוכלו לקרוא את המאמר בדיקת תכונות אינטראקטיביות של Google Chat במאמרי העזרה של Chat API.

שיקולים בנוגע לתוספים קיימים ל-Google Workspace

כדי להשתמש באפליקציות ל-Chat, צריך להשתמש בהגדרות אחרות בהשוואה לתוספים של Google Workspace שמרחיבים את השימוש באפליקציות אחרות של Google Workspace. אם התוסף יכול להרחיב את השימוש באפליקציות אחרות של Google Workspace, תוכלו להגדיר את אפליקציית Chat בהתאם לדרישות הבאות:

  • גם משתמשים פרטיים וגם אדמינים ב-Google Workspace צריכים להיות יכולים להתקין את התוסף מ-Marketplace. את הגדרות ההתקנה האלה קובעים ב-Google Workspace Marketplace SDK.
  • אפליקציות ל-Chat לא משתמשות בשם ובלוגו שהגדרתם לאפליקציות אחרות של Google Workspace באובייקט addons.common של המניפסט.
  • אי אפשר לשמור טיוטה של שינויים בהגדרות של Google Chat API אם מדובר בתוספים שפורסמו ב-Google Workspace Marketplace. אחרי שתעדכנו ושומרים את ההגדרות האישיות של Chat API, אפליקציית Chat המעודכנת תהיה זמינה לכל המשתמשים הקיימים. כדי לעדכן את הדף העסקי ב-Marketplace אפשר ליצור טיוטה לפני ששולחים את השינויים.

  • אם יצרתם את התוסף באמצעות Apps Script:

  • אם יצרתם את התוסף באמצעות שירות HTTP, צריך להשמיט את כל פרטי ההגדרות של אפליקציות ל-Chat במניפסט ובפריסות שיצרתם באמצעות Google Workspace Add-ons API. פריסות ה-HTTP שציינתם ב-Google Workspace Marketplace SDK משמשות רק באפליקציות אחרות של Google Workspace.