בדף הזה מוסבר איך ליצור אפליקציית צ'אט HTTP. יש דרכים שונות ליישם את הארכיטקטורה הזו. ב-Google Cloud, אפשר להשתמש ב-Cloud Functions, ב-Cloud Run וב-App Engine. במדריך הזה להתחלה מהירה, תכתבו ותפרסו פונקציה ב-Cloud Functions שהאפליקציה ל-Chat משתמשת בה כדי להגיב להודעה של משתמש.
באמצעות הארכיטקטורה הזו, אתם יכולים להגדיר את Chat כך שישתלב עם Google Cloud או עם שרת מקומי באמצעות HTTP, כמו שמוצג בתרשים הבא:
בתרשים שלמעלה, משתמש שמקיים אינטראקציה עם אפליקציית צ'אט HTTP, נהנה מזרימת המידע הבאה:
- משתמש שולח הודעה באפליקציית Chat, בצ'אט ישיר או במרחב ב-Chat.
- בקשת HTTP נשלחת לשרת אינטרנט שהוא מערכת בענן או מערכת מקומית שמכילה את הלוגיקה של אפליקציית Chat.
- אופציונלית, אפשר לשלב את הלוגיקה של אפליקציית Chat עם שירותי Google Workspace (כמו יומן Google ו-Sheets), עם שירותים אחרים של Google (כמו מפות Google, YouTube ו-Vertex AI) או עם שירותי אינטרנט אחרים (כמו מערכת לניהול פרויקטים או כלי לניהול כרטיסים).
- שרת האינטרנט שולח תגובת HTTP בחזרה לשירות של אפליקציית Chat ב-Chat.
- התשובה מועברת למשתמש.
- אופציונלית, אפליקציית Chat יכולה להתקשר אל Chat API כדי לפרסם הודעות באופן אסינכרוני או לבצע פעולות אחרות.
הארכיטקטורה הזו מאפשרת לכם להשתמש בספריות ובמרכיבים קיימים שכבר נמצאים במערכת, כי אפשר לעצב את אפליקציות הצ'אט האלה באמצעות שפות תכנות שונות.
מטרות
- מגדירים את הסביבה.
- יוצרים ופורסים פונקציה של Cloud Functions.
- מפרסמים את האפליקציה ב-Chat.
- בודקים את האפליקציה.
דרישות מוקדמות
- חשבון Google Workspace במהדורת Business או Enterprise עם גישה ל-Google Chat.
- פרויקט ב-Google Cloud שהחיוב בו מופעל. כדי לבדוק אם החיוב מופעל בפרויקט קיים, אפשר לעיין במאמר אימות סטטוס החיוב של הפרויקטים. כדי ליצור פרויקט ולהגדיר חיוב, אפשר לעיין במאמר בנושא יצירת פרויקט ב-Google Cloud.
הגדרת הסביבה
לפני שמשתמשים בממשקי Google API, צריך להפעיל אותם בפרויקט ב-Google Cloud. אפשר להפעיל ממשק API אחד או יותר בפרויקט יחיד ב-Google Cloud.במסוף Google Cloud, מפעילים את Google Chat API, 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 (יצירת פונקציה), מגדירים את הפונקציה:
- בקטע סביבה, בוחרים באפשרות פונקציית Cloud Run.
- בשדה שם הפונקציה, מזינים
QuickStartChatApp
. - בקטע אזור, בוחרים אזור.
- בקטע 'אימות', בוחרים באפשרות דרישת אימות.
- לוחצים על הבא.
בקטע סביבת זמן ריצה, בוחרים את הגרסה העדכנית ביותר של Node.js.
בקטע קוד מקור, בוחרים באפשרות עורך בתוך השורה.
בקטע נקודת כניסה, מוחקים את טקסט ברירת המחדל ומזינים
avatarApp
.מחליפים את התוכן של
index.js
בקוד הבא:לוחצים על פריסה.
Python
במסוף Google Cloud, נכנסים לדף Cloud Functions:
מוודאים שהפרויקט של אפליקציית Chat נבחר.
לוחצים על
יצירת פונקציה.בדף Create function (יצירת פונקציה), מגדירים את הפונקציה:
- בקטע סביבה, בוחרים באפשרות פונקציית Cloud Run.
- בשדה שם הפונקציה, מזינים
QuickStartChatApp
. - בקטע אזור, בוחרים אזור.
- בקטע 'אימות', בוחרים באפשרות דרישת אימות.
- לוחצים על הבא.
בקטע Runtime (זמן ריצה), בוחרים את הגרסה העדכנית ביותר של Python.
בקטע קוד מקור, בוחרים באפשרות עורך בתוך השורה.
בקטע נקודת כניסה, מוחקים את טקסט ברירת המחדל ומזינים
avatar_app
.מחליפים את התוכן של
main.py
בקוד הבא:לוחצים על פריסה.
Java
במסוף Google Cloud, נכנסים לדף Cloud Functions:
מוודאים שהפרויקט של אפליקציית Chat נבחר.
לוחצים על
יצירת פונקציה.בדף Create function (יצירת פונקציה), מגדירים את הפונקציה:
- בקטע סביבה, בוחרים באפשרות פונקציית Cloud Run.
- בשדה שם הפונקציה, מזינים
QuickStartChatApp
. - בקטע אזור, בוחרים אזור.
- בקטע 'אימות', בוחרים באפשרות דרישת אימות.
- לוחצים על הבא.
בקטע Runtime (זמן ריצה), בוחרים את הגרסה העדכנית ביותר של Java.
בקטע קוד מקור, בוחרים באפשרות עורך בתוך השורה.
בקטע נקודת כניסה, מוחקים את טקסט ברירת המחדל ומזינים
App
.שינוי השם של
src/main/java/com/example/Example.java
ל-src/main/java/AvatarApp.java
.מחליפים את התוכן של
AvatarApp.java
בקוד הבא:מחליפים את התוכן של
pom.xml
בקוד הבא:לוחצים על פריסה.
ייפתח דף הפרטים של Cloud Functions, והפונקציה שלכם תופיע עם שני אינדיקטורים של התקדמות: אחד בשביל הבנייה ואחד בשביל השירות. כששני סימני ההתקדמות נעלמים ומוחלפים בסימן וי, הפונקציה מוכנה לפריסה.
איך מאשרים ל-Google Chat להפעיל את הפונקציה
כדי לתת ל-Google Chat הרשאה להפעיל את הפונקציה, מוסיפים את חשבון השירות של Google Chat עם התפקיד Cloud Run Invoker.
במסוף Google Cloud, עוברים לדף Cloud Run:
ברשימת שירותי Cloud Run, מסמנים את התיבה לצד הפונקציה המקבלת. (לא לוחצים על הפונקציה עצמה).
לוחצים על הרשאות. נפתחת החלונית הרשאות.
לוחצים על Add principal.
בשדה New principals, מזינים
chat@system.gserviceaccount.com
.ברשימת התפקידים Select a role בוחרים באפשרות Cloud Run > Cloud Run Invoker.
לוחצים על שמירה.
פרסום האפליקציה ב-Google Chat
אחרי שפורסים את Cloud Function, פועלים לפי השלבים הבאים כדי להפוך אותה לאפליקציה ל-Google Chat:
במסוף Google Cloud, לוחצים על סמל התפריט > Cloud Functions.
מוודאים שהפרויקט שבו הפעלתם את Cloud Functions נבחר.
ברשימת הפונקציות, לוחצים על QuickStartChatApp.
לוחצים על הכרטיסייה Triggers (טריגרים).
בקטע HTTPS, מעתיקים את כתובת ה-URL.
מחפשים את Google Chat API ולוחצים על Google Chat API ואז על ניהול.
לוחצים על הגדרה ומגדירים את אפליקציית Google Chat:
- בשדה App name, מזינים
Quickstart App
. - בקטע כתובת ה-URL של הדמות, מזינים את הערך
https://developers.google.com/chat/images/quickstart-app-avatar.png
. - בשדה תיאור, מזינים
Quickstart app
. - בקטע פונקציונליות, בוחרים באפשרות הצטרפות למרחבים ולשיחות קבוצתיות.
- בקטע Connection settings (הגדרות חיבור), בוחרים באפשרות HTTP endpoint URL (כתובת URL של נקודת קצה מסוג HTTP) ומדביקים בתיבה את כתובת ה-URL של הטריגר של Cloud Function.
- בקטע קהל לאימות, בוחרים באפשרות כתובת URL של נקודת קצה HTTP.
- בקטע חשיפה, בוחרים באפשרות הפיכת האפליקציה הזו של Google Chat לזמינה לאנשים ולקבוצות ספציפיים בדומיין ומזינים את כתובת האימייל.
- בקטע יומנים, בוחרים באפשרות רישום שגיאות ביומן.
- בשדה App name, מזינים
לוחצים על שמירה.
אפליקציית Chat מוכנה לקבל הודעות ב-Chat ולענות עליהן.
בדיקת אפליקציית Chat
כדי לבדוק את אפליקציית Chat, פותחים מרחב לצ'אט ישיר עם אפליקציית Chat ושולחים הודעה:
פותחים את Google Chat באמצעות חשבון Google Workspace שציינתם כשנוספתם כבודקים מהימנים.
- לוחצים על צ'אט חדש.
- בשדה הוספת אדם אחד או יותר, מקלידים את השם של אפליקציית Chat.
בוחרים את אפליקציית Chat מתוך התוצאות. ייפתח צ'אט ישיר.
- בצ'אט הישיר החדש עם האפליקציה, כותבים
Hello
ולוחצים עלenter
.
התשובה באפליקציית Chat מכילה הודעת כרטיס שבה מוצגים השם ותמונת הפרופיל של השולח, כמו שרואים בתמונה הבאה:
כדי להוסיף בודקים מהימנים ולקבל מידע נוסף על בדיקת תכונות אינטראקטיביות, אפשר לעיין במאמר בנושא בדיקת תכונות אינטראקטיביות באפליקציות ל-Google Chat.
פתרון בעיות
כשמוחזרת שגיאה מאפליקציית Google Chat או מכרטיס, מוצגת בממשק של Chat ההודעה 'משהו השתבש'. או 'לא ניתן לעבד את הבקשה שלך'. לפעמים בממשק המשתמש של Chat לא מוצגת הודעת שגיאה, אבל אפליקציית Chat או הכרטיס מפיקים תוצאה לא צפויה. לדוגמה, יכול להיות שהודעה בכרטיס לא תופיע.
יכול להיות שלא תוצג הודעת שגיאה בממשק המשתמש של Chat, אבל אם הפעלתם את רישום השגיאות באפליקציות של Chat, תוכלו לראות הודעות שגיאה תיאוריות ונתוני יומן שיעזרו לכם לתקן את השגיאות. לקבלת עזרה בצפייה בשגיאות, באיתור באגים ובתיקון שלהן, אפשר לעיין במאמר פתרון בעיות ב-Google Chat.
הסרת המשאבים
כדי להימנע מחיובים בחשבון Google Cloud בגלל השימוש במשאבים שנעשה במסגרת המדריך הזה, מומלץ למחוק את פרויקט Cloud.
- במסוף Google Cloud, עוברים לדף Manage resources. לוחצים על תפריט > IAM & Admin > Manage Resources.
- ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על Delete .
- כדי למחוק את הפרויקט, כותבים את מזהה הפרויקט בתיבת הדו-שיח ולוחצים על Shut down.
נושאים קשורים
כדי להוסיף עוד תכונות לאפליקציית Chat, אפשר לעיין במאמרים הבאים: