הגדרת 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 של הדמות: כתובת URL מסוג HTTPS שמפנה לתמונה גרפית מרובעת (לדוגמה, PNG או JPEG), לפחות 128x128, שמופיעה הדמות שלך באפליקציית Chat.
    • Description: תיאור של המטרה של אפליקציית Chat שמופיעה מתחת לשם של אפליקציית 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 מחזירה הודעת שגיאה. צריך לבחור תיבת הסימון רישום שגיאות ביומן. מידע נוסף זמין במאמר הבא: שאילתות על יומני שגיאה של אפליקציות ל-Chat.

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

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

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

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

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