הגדרת Google Chat API

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

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

הגדרת Chat API

  1. במסוף Google Cloud, מחפשים את Google Chat API, לוחצים על Google Chat API ואז לוחצים על Manage (ניהול).

    כניסה ל-Chat API

  2. לוחצים על הכרטיסייה Configuration (הגדרה) ומזינים את הפרטים הנדרשים הבאים:

    • שם האפליקציה: השם שאנשים משתמשים בו במהלך האינטראקציה עם אפליקציית Chat.
    • כתובת URL של Avatar: כתובת URL מסוג HTTPS שמפנה לתמונת גרפיקה ריבועית (לדוגמה, PNG או JPEG), בגודל של לפחות 128x128, שמופיעה כדמות של אפליקציית Chat.
    • תיאור: תיאור של המטרה של אפליקציית Chat, שמופיע מתחת לשם של אפליקציית Chat.

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

    שדה תיאור
    פונקציונליות קבוצת שדות שקובעים איך אפליקציית Chat יכולה לתקשר עם המשתמשים:
    • קבלת הודעות אישיות: המשתמשים יכולים למצוא את אפליקציית Chat ולשלוח הודעות ישירות ב-Google Chat.
    • הצטרפות למרחבים משותפים ולשיחות קבוצתיות: המשתמשים יכולים להוסיף את אפליקציית Chat למרחבים משותפים ולשיחות קבוצתיות.
    הגדרות חיבור נקודת הקצה (endpoint) של אפליקציית Chat, שהיא אחת מהאפשרויות הבאות:
    • כתובת URL של האפליקציה: נקודת קצה (endpoint) מסוג HTTPS שמארחת את ההטמעה של אפליקציית Chat.
    • פרויקט Apps Script: מזהה פריסה של פרויקט Apps Script שמטמיע אפליקציית Chat.
    • שם הנושא ב-Cloud Pub/Sub: נושא Pub/Sub שאפליקציית Chat רשומה אליו כנקודת קצה.
    • Dialogflow: רישום של אפליקציית Chat בשילוב עם Dialogflow. מידע נוסף זמין במאמר יצירת אפליקציית Dialogflow ל-Google Chat שמבינה שפה טבעית.
    פקודות דרך שורת הפקודות פקודות שאפשר להציג למשתמשים ב-Google Chat. המשתמשים יכולים לראות את הפעולות העיקריות של אפליקציית Chat בתוך Google Chat, ולבחור פעולה ספציפית שהם רוצים לקיים איתה אינטראקציה. מידע נוסף זמין במאמר מענה לפקודות דרך שורת הפקודות כאפליקציה של Chat.
    תצוגות מקדימות של קישורים תבניות URL שאפליקציית Chat מזהה ומספקת תוכן נוסף בשביל המשתמשים ששולחים קישורים. מידע נוסף זמין במאמר תצוגה מקדימה של קישורים.
    חשיפה עד 5 אנשים או קבוצת Google אחת או יותר שיכולים לראות ולהתקין את אפליקציית Chat. אפשר להשתמש בשדה הזה כדי לבדוק את אפליקציית Chat או כדי לשתף את אפליקציית Chat עם הצוות שלך. מידע נוסף זמין בהגדרות החשיפה והפרסום באפליקציית Chat.

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

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

איך נותנים לאנשים אחרים הרשאה להגדיר אפליקציות ל-Chat

אפשר להעניק למשתמשים ספציפיים גישה לדף ההגדרות של אפליקציית Chat. להשתמש בתפקידים בעלים של אפליקציות ל-Chat וצפייה באפליקציות ל-Chat ב-IAM. משתמשים עם התפקידים האלה לא יכולים להיכנס לדף התצורה של אפליקציות ל-Chat באמצעות מרכז הבקרה APIs & Services. הם יכולים להיכנס לדף ההגדרות על ידי מעבר למסוף Google Cloud של הפרויקט המארח של אפליקציית Chat ב-Cloud, באופן הבא:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

כאשר PROJECT_ID הוא מזהה הפרויקט ב-Google Cloud שמארח את אפליקציית Chat.