בדף הזה מוסבר איך יוצרים אפליקציית HTTP ל-Chat. יש כמה דרכים ליישם את הארכיטקטורה הזו. ב-Google Cloud, יכולים להשתמש ב-Cloud Functions, ב-Cloud Run וב-App Engine. במדריך למתחילים הזה לכתוב ולפרוס פונקציה של Cloud Functions שאפליקציית Chat משתמשת בה כדי לענות להודעות של משתמשים.
בעזרת הארכיטקטורה תוכלו להגדיר ש-Chat ישתלב עם ב-Google Cloud או בשרת מקומי באמצעות HTTP, כמו שמוצג את התרשים הבא:
בתרשים הקודם, משתמש יוצר אינטראקציה עם HTTP אפליקציית Chat כוללת את הפרטים הבאים:
- משתמש שולח הודעה ב-Chat אל אפליקציית Chat, בצ'אט אישי או מרחב ב-Chat.
- בקשת HTTP נשלחת לשרת אינטרנט שהוא הענן או מערכת מקומית שמכילה את אפליקציית Chat בלוגיקה.
- לחלופין, אפשר לשלב את הלוגיקה של אפליקציית Chat עם שירותי Google Workspace (כמו יומן ו Sheets), שירותי Google אחרים (כמו מפות Google, YouTube ו-Vertex AI) או בשירותי אינטרנט אחרים (כמו פרויקט או כלי מכירת הכרטיסים).
- שרת האינטרנט שולח תגובת HTTP חזרה אל שירות של אפליקציית Chat ב-Chat.
- התשובה תימסר למשתמש.
- (אופציונלי) אפליקציית Chat יכולה לקרוא Chat API כדי לפרסם הודעות באופן אסינכרוני או לבצע ב-AI.
הארכיטקטורה הזו מספקת לך את הגמישות להשתמש בספריות קיימות שכבר קיימים במערכת שלך, כי אתם יכולים להשתמש בשפות תכנות שונות כדי לעצב אפליקציות ל-Chat.
מטרות
- מגדירים את הסביבה.
- ליצור ולפרוס פונקציה ב-Cloud Functions.
- לפרסם את האפליקציה ב-Chat.
- בדיקת האפליקציה.
דרישות מוקדמות
- עסק או ארגון חשבון Google Workspace עם גישה אל Google Chat.
- פרויקט ב-Google Cloud שמופעל בו חיוב. כדי לבדוק אם החיוב מופעל בפרויקט קיים: ראה אימות סטטוס החיוב של הפרויקטים שלכם. כדי ליצור פרויקט ולהגדיר חיוב: יוצרים פרויקט ב-Google Cloud.
הגדרת הסביבה
לפני שמשתמשים ב-Google APIs, צריך להפעיל אותם בפרויקט ב-Google Cloud. אפשר להפעיל ממשק API אחד או יותר בפרויקט אחד ב-Google Cloud.במסוף Google Cloud, מפעילים את ה-API של Google Chat, Cloud Build API, Cloud Functions API, Cloud Pub/Sub API, Cloud Logging API, Artifact Registry API ו-Cloud Run API.
יצירה ופריסה של פונקציה ב-Cloud Functions
יצירה ופריסה של פונקציה ב-Cloud Functions שיוצרת כרטיס Chat באמצעות השם המוצג ותמונת הדמות של השולח. כאשר אפליקציית Chat מקבלת הודעה, היא מפעילה את הפונקציה משיב עם הכרטיס.
כדי ליצור ולפרוס את הפונקציה באפליקציית Chat: מבצעים את השלבים הבאים:
Node.js
במסוף Google Cloud, נכנסים לדף Cloud Functions:
צריך לוודא שהפרויקט באפליקציית Chat נבחר.
לוחצים על
Create Function.בדף Create function, מגדירים את הפונקציה:
- בסביבה, בוחרים באפשרות דור שני.
- בשדה Function name, מזינים
QuickStartChatApp
. - בקטע Region, בוחרים אזור.
- בקטע 'אימות', בוחרים באפשרות דרישת אימות.
- לוחצים על הבא.
בקטע Runtime, בוחרים את הגרסה העדכנית ביותר של Node.js.
בקטע קוד מקור, בוחרים באפשרות עורך מוטבע.
בקטע נקודת כניסה, מוחקים את טקסט ברירת המחדל ומזינים
helloChat
.מחליפים את התוכן של
index.js
בקוד הבא:לוחצים על Deploy (פריסה).
Python
במסוף Google Cloud, נכנסים לדף Cloud Functions:
צריך לוודא שהפרויקט באפליקציית Chat נבחר.
לוחצים על
Create Function.בדף Create function, מגדירים את הפונקציה:
- בסביבה, בוחרים באפשרות דור שני.
- בשדה Function name, מזינים
QuickStartChatApp
. - בקטע Region, בוחרים אזור.
- בקטע 'אימות', בוחרים באפשרות דרישת אימות.
- לוחצים על הבא.
בקטע סביבת זמן הריצה, בוחרים את הגרסה העדכנית ביותר של Python.
בקטע קוד מקור, בוחרים באפשרות עורך מוטבע.
בקטע נקודת כניסה, מוחקים את טקסט ברירת המחדל ומזינים
hello_chat
.מחליפים את התוכן של
main.py
בקוד הבא:לוחצים על Deploy (פריסה).
Java
במסוף Google Cloud, נכנסים לדף Cloud Functions:
צריך לוודא שהפרויקט באפליקציית Chat נבחר.
לוחצים על
Create Function.בדף Create function, מגדירים את הפונקציה:
- בסביבה, בוחרים באפשרות דור שני.
- בשדה Function name, מזינים
QuickStartChatApp
. - בקטע Region, בוחרים אזור.
- בקטע 'אימות', בוחרים באפשרות דרישת אימות.
- לוחצים על הבא.
בקטע סביבת זמן הריצה, בוחרים בגרסה העדכנית ביותר של Java.
בקטע קוד מקור, בוחרים באפשרות עורך מוטבע.
בקטע נקודת כניסה, מוחקים את טקסט ברירת המחדל ומזינים
HelloChat
.שינוי השם של
src/main/java/com/example/Example.java
לשםsrc/main/java/HelloChat.java
.מחליפים את התוכן של
HelloChat.java
בקוד הבא:מחליפים את התוכן של
pom.xml
בקוד הבא:לוחצים על Deploy (פריסה).
דף הפרטים של Cloud Functions ייפתח, והפונקציה תופיע עם מדדי התקדמות: אחד ל-build ואחד לשירות. כששניהם מחווני ההתקדמות נעלמים ומוחלפים בסימן וי, הפונקציה נפרס ומוכן.
איך נותנים ל-Google Chat הרשאה להפעיל את הפונקציה
כדי לתת ל-Google Chat הרשאה להפעיל את הפונקציה, צריך להוסיף את Google Chat חשבון שירות עם התפקיד Cloud Run Invoker.
במסוף Google Cloud, נכנסים לדף Cloud Run:
ברשימת השירותים של Cloud Run, מסמנים את התיבה שליד מותאמת אישית. (אין ללחוץ על הפונקציה עצמה).
לוחצים על הרשאות. החלונית Permissions תיפתח.
לוחצים על Add principal.
בשדה New principals, מזינים
chat@system.gserviceaccount.com
.בקטע Select a role, בוחרים Cloud Run > Cloud Run Invoker
לוחצים על שמירה.
פרסום האפליקציה ב-Google Chat
לאחר פריסת הפונקציה של Cloud Functions, עליכם לבצע את השלבים הבאים כדי להפוך אותה אפליקציית Google Chat:
במסוף Google Cloud, לוחצים על 'תפריט'. > Cloud Functions.
צריך לוודא שהפרויקט שבו הפעלתם את Cloud Functions הוא נבחר.
ברשימת הפונקציות, לוחצים על QuickStartChatApp.
לוחצים על הכרטיסייה Triggers (טריגרים).
מעתיקים את כתובת ה-URL בקטע HTTPS.
חיפוש Google Chat API ולוחצים על Google Chat API ואז על ניהול.
לוחצים על הגדרות אישיות ומגדירים את אפליקציית Google Chat:
- בשדה App name, מזינים
Quickstart App
. - בשדה כתובת URL של הדמות, מזינים
https://developers.google.com/chat/images/quickstart-app-avatar.png
. - בשדה Description, מזינים
Quickstart app
. - בקטע פונקציונליות, בוחרים באפשרות קבלת הודעות 1:1 ואז איך מצטרפים למרחבים משותפים ולשיחות קבוצתיות
- בקטע הגדרות חיבור, בוחרים באפשרות כתובת URL של האפליקציה ומדביקים את כתובת ה-URL של את הטריגר של הפונקציה של Cloud Functions.
- בקטע Authentication Audience (קהל אימות), בוחרים באפשרות App URL (כתובת ה-URL של האפליקציה).
- בקטע חשיפה, בוחרים אפליקציית Google Chat הזו תהיה זמינה לאנשים ספציפיים קבוצות בדומיין שלך ולהזין את כתובת האימייל שלך.
- בקטע Logs (יומנים), בוחרים באפשרות Log errors to Logging (רישום שגיאות ביומן).
- בשדה App name, מזינים
לוחצים על שמירה.
אפליקציית Chat מוכנה לקבל ולהשיב הודעות ב-Chat.
בדיקת האפליקציה של Chat
כדי לבדוק את אפליקציית Chat, צריך לפתוח מרחב בצ'אט אישי עם אפליקציית Chat ושולחים הודעה:
פותחים את Google Chat באמצעות חשבון Google Workspace שבו אתם משתמשים. שקיבלת כשהוספת את עצמך כבודק נאמן.
- לוחצים על צ'אט חדש.
- בשדה אפשר לצרף אנשים, מקלידים את השם של מי שרוצים לצרף אפליקציית Chat.
בוחרים את אפליקציית Chat הרצויה מהתוצאות. A ההודעה תיפתח.
- בצ'אט האישי החדש עם האפליקציה, מקלידים
Hello
ומקישים עלenter
.
התשובה של אפליקציית Chat מכילה הודעה בכרטיס שמציגה את שם השולח ותמונת הדמות של השולח, כפי שניתן לראות בתמונה הבאה:
כדי להוסיף בודקים נאמנים ולקבל מידע נוסף על בדיקת תכונות אינטראקטיביות: בדיקת תכונות אינטראקטיביות עבור אפליקציות ב-Google Chat.
פתרון בעיות
כשאפליקציית Google Chat או אפליקציית Google Chat הפונקציה card מחזירה שגיאה, בממשק של Chat מוצגת ההודעה "משהו השתבש". או "לא ניתן לעבד את הבקשה שלך". לפעמים בממשק המשתמש של Chat לא מציגה הודעות שגיאה, אבל אפליקציית Chat או והכרטיס מפיק תוצאה לא צפויה: לדוגמה, הודעה בכרטיס יופיעו.
יכול להיות שלא תופיע הודעת שגיאה בממשק המשתמש של Chat, אבל יש הודעות שגיאה תיאוריות ונתוני יומן זמינים כדי לעזור לכם לתקן שגיאות כשמופעלת רישום שגיאות ביומן של אפליקציות ל-Chat. לקבלת עזרה בצפייה, לניפוי באגים ולתיקון שגיאות: פתרון בעיות ותיקון שגיאות ב-Google Chat
הסרת המשאבים
כדי להימנע מצבירת חיובים בחשבון Google Cloud עבור במשאבים שנעשה בהם שימוש במדריך הזה, מומלץ למחוק את פרויקט בענן.
- במסוף Google Cloud, עוברים לדף Manage resources. לוחצים על תפריט > IAM & Admin (אדמין) > לניהול משאבים
- ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על הסמל. מחיקה של .
- כדי למחוק, כותבים את מזהה הפרויקט בתיבת הדו-שיח ולוחצים על Shut down. את הפרויקט.
נושאים קשורים
כדי להוסיף עוד פיצ'רים לאפליקציית Chat, כדאי לבדוק את הבאים: