הגדרת 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 ומזינים את הפרטים הנדרשים הבאים:

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

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

    שדה תיאור
    פונקציונליות קבוצת שדות שקובעים איך אפליקציית Chat יכולה לתקשר עם משתמשים:
    • קבלת הודעות אישיות: המשתמשים יכולים למצוא את אפליקציית Chat ולשלוח לה הודעות ישירות ב-Google Chat.
    • הצטרפות למרחבים משותפים ולשיחות קבוצתיות: המשתמשים יכולים להוסיף את אפליקציית Chat למרחבים משותפים ולשיחות קבוצתיות.
    הגדרות חיבור נקודת הקצה של אפליקציית Chat, שהיא אחת מהאפשרויות הבאות:
    • כתובת ה-URL של האפליקציה: נקודת קצה מסוג 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.

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

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

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

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

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

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