בדף הזה מוסבר איך יוצרים אפליקציית 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 כדי לפרסם הודעות באופן אסינכרוני או לבצע פעולות אחרות.
הארכיטקטורה הזו מאפשרת להשתמש בספריות וברכיבים קיימים שכבר קיימים במערכת, כי אפשר לעצב את אפליקציות Chat בשפות תכנות שונות.
מטרות
- הגדרת הסביבה.
- יצירה ופריסה של פונקציה של Cloud Functions.
- מפרסמים את האפליקציה ב-Chat.
- בדיקת האפליקציה
דרישות מוקדמות
- חשבון Google Workspace עם גישה ל-Google Chat בארגון ב-Google Workspace שמאפשר הפעלות לא מאומתות של פונקציות ב-Google Cloud.
- פרויקט ב-Google Cloud.
- חשוב לוודא שהפעלת את החיוב בפרויקט שלך ב-Cloud. איך מאמתים את סטטוס החיוב של הפרויקטים?
הגדרת הסביבה
כדי להשתמש ב-Google APIs, צריך להפעיל אותם בפרויקט ב-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 console, נכנסים לדף Cloud Functions:
ודאו שבחרתם בפרויקט של אפליקציית Chat.
לוחצים על
יצירת פונקציה.בדף Create function, מגדירים את הפונקציה:
- בקטע סביבה, בוחרים באפשרות דור שני.
- בקטע שם הפונקציה, מזינים
QuickStartChatApp
. - בקטע אזור, בוחרים אזור.
- בקטע 'אימות', בוחרים באפשרות לאפשר הפעלות לא מאומתות.
- לוחצים על הבא.
בקטע Runtime, בוחרים באפשרות Node.js 20.
בקטע קוד מקור, בוחרים באפשרות עורך מוטבע.
בנקודת הכניסה, מוחקים את טקסט ברירת המחדל ומזינים
helloChat
.מחליפים את התוכן של
index.js
בקוד הבא:לוחצים על פריסה.
Python
ב Google Cloud console, נכנסים לדף Cloud Functions:
ודאו שבחרתם בפרויקט של אפליקציית Chat.
לוחצים על
יצירת פונקציה.בדף Create function, מגדירים את הפונקציה:
- בקטע שם הפונקציה, מזינים
QuickStartChatApp
. - בקטע Trigger type (סוג הטריגר), בוחרים באפשרות HTTP (HTTP).
- בקטע 'אימות', בוחרים באפשרות לאפשר הפעלות לא מאומתות.
- לוחצים על שמירה.
- לוחצים על הבא.
- בקטע שם הפונקציה, מזינים
ב-Runtime, בוחרים באפשרות Python 3.10.
בקטע קוד מקור, בוחרים באפשרות עורך מוטבע.
בנקודת הכניסה, מוחקים את טקסט ברירת המחדל ומזינים
hello_chat
.מחליפים את התוכן של
main.py
בקוד הבא:לוחצים על פריסה.
Java
ב Google Cloud console, נכנסים לדף Cloud Functions:
ודאו שבחרתם בפרויקט של אפליקציית Chat.
לוחצים על
יצירת פונקציה.בדף Create function, מגדירים את הפונקציה:
- בקטע שם הפונקציה, מזינים
QuickStartChatApp
. - בקטע Trigger type (סוג הטריגר), בוחרים באפשרות HTTP (HTTP).
- בקטע 'אימות', בוחרים באפשרות לאפשר הפעלות לא מאומתות.
- לוחצים על שמירה.
- לוחצים על הבא.
- בקטע שם הפונקציה, מזינים
בקטע Runtime, בוחרים באפשרות Java 11.
בקטע קוד מקור, בוחרים באפשרות עורך מוטבע.
בנקודת הכניסה, מוחקים את טקסט ברירת המחדל ומזינים
HelloChat
.משנים את השם של
src/main/java/com/example/Example.java
לשםsrc/main/java/HelloChat.java
.מחליפים את התוכן של
HelloChat.java
בקוד הבא:מחליפים את התוכן של
pom.xml
בקוד הבא:לוחצים על פריסה.
דף הפרטים של Cloud Functions ייפתח והפונקציה תופיע עם שני מדדי התקדמות: אחד ל-build והשני לשירות. כששני מדדי ההתקדמות נעלמים ומוחלפים בסימן וי, הפונקציה נפרסת ומוכנה לשימוש.
פרסום האפליקציה ב-Google Chat
אחרי שפורסים את הפונקציה של Cloud Functions, כדי להפוך אותה לאפליקציית Google Chat:
במסוף Google Cloud, לוחצים על סמל התפריט > Cloud Functions.
מוודאים שהפרויקט שבו הפעלתם את Cloud Functions נבחר.
ברשימת הפונקציות, לוחצים על QuickStartChatApp.
לוחצים על הכרטיסייה Triggers (טריגרים).
בקטע HTTPS מעתיקים את כתובת ה-URL.
מחפשים את Google Chat API, לוחצים על Google Chat API ואז על ניהול.
לוחצים על הגדרה ומגדירים את אפליקציית Google Chat:
- בקטע שם האפליקציה, מזינים
Quickstart App
. - בקטע כתובת URL של הדמות, מזינים
https://developers.google.com/chat/images/quickstart-app-avatar.png
. - בתיאור, מזינים
Quickstart app
. - בקטע פונקציונליות, בוחרים באפשרות קבלת הודעות אישיות ובאפשרות הצטרפות למרחבים משותפים ולשיחות קבוצתיות.
- בקטע Connection settings (הגדרות חיבור), בוחרים באפשרות App URL ומדביקים בתיבה את כתובת ה-URL של הטריגר של הפונקציה של Cloud Functions.
- בקטע חשיפה, בחר באפשרות הפוך את אפליקציית Google Chat הזו לזמינה לקבוצות ולאנשים ספציפיים בדומיין שלך, והזן את כתובת האימייל שלך.
- בקטע Logs (יומנים), בוחרים באפשרות Log errors to Logging.
- בקטע שם האפליקציה, מזינים
לוחצים על שמירה.
אפליקציית 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 ואדמין > ניהול משאבים.
- ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על Delete .
- כדי למחוק את הפרויקט, כותבים את מזהה הפרויקט בתיבת הדו-שיח ולוחצים על Shut down.
נושאים קשורים
תוכלו להיעזר בפתרונות הבאים כדי להוסיף עוד תכונות לאפליקציית Chat: