במדריך הזה מוסבר איך לפתח אפליקציה של Google Chat שעוזרת המשתמשים ב-Google Chat מנהלים את אנשי הקשר האישיים והעסקיים שלהם. לאיסוף מידע, אפליקציית Chat מציעה למשתמשים טופס ליצירת קשר בהודעות ובתיבות הדו-שיח של הכרטיסים.
איך רואים את אפליקציית Chat בפעולה?
-
איור 2. אפליקציית Chat פותחת תיבת דו-שיח שבה המשתמשים יכולים להזין את הפרטים של איש הקשר. -
איור 3. אפליקציית Chat מחזירה תיבת דו-שיח לאישור, שהמשתמשים יכולים לבדוק ולאשר את המידע לפני בתהליך הגשה. -
איור 4. אחרי שהמשתמש שולח את הטופס, אפליקציית Chat שולחת לו הודעת טקסט לאישור השליחה. -
איור 5. באפליקציית Chat המשתמשים גם מתבקשים להוסיף איש קשר מכרטיס בהודעה.
דרישות מוקדמות
- עסק או ארגון חשבון Google Workspace עם גישה אל Google Chat.
מטרות
- עיצוב ופיתוח של ממשקי משתמש (UI) בתור אובייקטים מסוג
card
, והצגת ממשקי המשתמש בהודעות ובתיבות דו-שיח. - לקבל ולעבד מידע שהמשתמשים שולחים באמצעות ווידג'טים להזנת נתונים בטופס.
- מענה לפקודות בלי קשר על ידי שליחה הודעות שמכילות טקסט, כרטיסים וווידג'טים של אביזרים.
ארכיטקטורה
אפליקציית Chat מובנית Google Apps Script ומשתמש בו אירועי אינטראקציה לעיבוד ולענות למשתמשים ב-Chat.
הדוגמה הבאה מראה איך משתמש בדרך כלל מקיים אינטראקציה עם אפליקציית Chat:
משתמש פותח צ'אט אישי באמצעות אפליקציית Chat, או מוסיף את אפליקציית Chat למרחב משותף קיים.
אפליקציית Chat מבקשת מהמשתמש להוסיף איש קשר באמצעות והם מציגים טופס ליצירת קשר
card
לאובייקט. כדי להציג את הטופס ליצירת קשר, צריך להשתמש באפליקציית Chat מגיב למשתמשים בדרכים הבאות:- להשיב לאזכורים באמצעות @ולצ'אטים אישיים עם הודעה בכרטיס מכיל את הטופס ליצירת קשר.
- התגובה לפקודת הקו
/addContact
היא פתיחת תיבת דו-שיח עם טופס יצירת הקשר. - תגובה לפקודה
/about
באמצעות הודעת טקסט עם הלחצן Add a contact (הוספת איש קשר) שהמשתמשים יכולים ללחוץ עליו כדי לפתוח תיבת דו-שיח עם טופס ליצירת קשר.
כשהמשתמש רואה את טופס יצירת הקשר, הוא מזין את פרטי הקשר בשדות ובווידג'טים הבאים:
- שם פרטי ושם משפחה:
textInput
לווידג'ט הזה שמקבל מחרוזות. - Birthdate (תאריך לידה:)
dateTimePicker
הווידג'ט שמקבל תאריכים בלבד. - סוג איש הקשר: ווידג'ט של
selectionInput
לחצני בחירה שמאפשר למשתמשים לבחור ולשלוח ערך מחרוזת יחיד (Personal
אוWork
). - הלחצן בדיקה ושליחה:
buttonList
מערך עם הווידג'טbutton
שהמשתמש לוחץ עליו כדי לשלוח את הערכים שהם מזינים.
- שם פרטי ושם משפחה:
אפליקציית Google Chat מטפלת באירוע אינטראקציה מסוג
CARD_CLICKED
כדי לעבד את הערכים שהמשתמש מזין, ומציגה את הערכים בכרטיס אישור.המשתמש בודק את כרטיס האישור ולוחץ על הלחצן שליחה. כדי להשלים את הפרטים ליצירת קשר.
אפליקציית Google Chat שולחת הודעת טקסט פרטית מאשר את ההגשה.
מכינים את הסביבה
בקטע הזה נסביר איך ליצור ולהגדיר פרויקט ב-Google Cloud עבור אפליקציית Chat.
יצירת פרויקט של Google Cloud
מסוף Google Cloud
- במסוף Google Cloud, נכנסים לתפריט > IAM & אדמין > יצירת פרויקט.
-
בשדה Project Name (שם הפרויקט), מזינים שם תיאורי לפרויקט.
אופציונלי: כדי לערוך את Project ID, לוחצים על Edit (עריכה). אי אפשר לשנות את מזהה הפרויקט אחרי היצירה שלו, לכן חשוב לבחור מזהה שיעמוד בצרכים שלכם לכל משך חיי הפרויקט.
- בשדה Location, לוחצים על Browse כדי להציג מיקומים פוטנציאליים לפרויקט. לאחר מכן לוחצים על בחירה.
- לוחצים על יצירה. במסוף Google Cloud עוברים לדף Dashboard ונוצר הפרויקט תוך כמה דקות.
CLI של gcloud
נכנסים ל-Google Cloud באחת מסביבות הפיתוח הבאות
CLI (gcloud
):
-
Cloud Shell: כדי להשתמש בטרמינל אונליין באמצעות ה-CLI של gcloud
כבר הוגדר, צריך להפעיל את Cloud Shell.
הפעלת Cloud Shell -
מעטפת מקומית: כדי להשתמש בסביבת פיתוח מקומית צריך להתקין ולהפעיל את ה-CLI של gcloud.
כדי ליצור פרויקט ב-Cloud, משתמשים בפקודהgcloud projects create
: מחליפים את PROJECT_ID על ידי הגדרת המזהה של הפרויקט שרוצים ליצור.gcloud projects create PROJECT_ID
הגדרת אימות והרשאה
כדי להשתמש באפליקציות של Google Chat, צריך להגדיר מסך הסכמה ל-OAuth כדי שהמשתמשים יוכלו לאשר את האפליקציה שלכם באפליקציות של Google Workspace, כולל Google Chat.
במדריך הזה פורסים אפליקציית Chat שמיועדת רק לשימוש פנימי או לשימוש פנימי, ולכן מותר להשתמש במידע placeholder עבור מסך הסכמה. לפני פרסום אפליקציית Chat, צריך להחליף placeholders עם מידע אמיתי.
במסוף Google Cloud, נכנסים אל תפריט > APIs & Services> OAuth consent screen.
בקטע סוג משתמש, בוחרים באפשרות פנימי ולוחצים על יצירה.
בשדה App name, מקלידים
Contact Manager
.בקטע User support email (אימייל לתמיכת משתמשים), בוחרים את כתובת האימייל שלכם או כתובת אחרת קבוצה ב-Google.
בקטע פרטים ליצירת קשר עם המפתח, מזינים את כתובת האימייל.
לוחצים על שמירה והמשך.
בדף היקפים לוחצים על שמירה והמשך. (ה אפליקציית Chat לא דורשת היקפי הרשאות OAuth).
מעיינים בסיכום ולוחצים על חזרה ללוח הבקרה.
יצירה ופריסה של אפליקציית Chat
בקטע הבא תעתיקו ותעדכנו פרויקט Apps Script שלם שמכיל את כל קוד האפליקציה הנדרש לאפליקציית Chat, כך שלא תצטרכו להעתיק ולהדביק כל קובץ.
לחלופין, אפשר להציג את הפרויקט כולו ב-GitHub.
לפניכם סקירה כללית של כל אחד מהקבצים:
main.gs
טיפול בכל הלוגיקה של האפליקציה, כולל אירועי אינטראקציה לגבי המועדים שבהם משתמשים שולחים הודעות לאפליקציית Chat, לוחצים על לחצנים הודעה באפליקציית Chat, או לפתוח ולסגור תיבות דו-שיח.
הצגת הקוד מהאפליקציה
main.gs
contactForm.gs
מכיל את הווידג'טים שמקבלים נתוני טפסים ממשתמשים. קלט הטופס הזה והווידג'טים מוצגים בכרטיסים שמופיעים בהודעות ובתיבות הדו-שיח.
הצגת הקוד מהאפליקציה
contactForm.gs
appsscript.json
מניפסט של Apps Script שמגדיר ומגדיר את פרויקט Apps Script לאפליקציית Chat.
הצגת קוד
appsscript.json
איתור מספר הפרויקט ב-Cloud והמזהה שלו
במסוף Google Cloud, נכנסים לפרויקט ב-Cloud.
לוחצים על סמל ההגדרות והכלים > הגדרות הפרויקט.
שימו לב לערכים בשדות Project number ו-Project ID. שלך להשתמש בהם בקטעים הבאים.
יצירת פרויקט Apps Script
כדי ליצור פרויקט Apps Script ולקשר אותו לפרויקט ב-Cloud:
- לוחצים על הלחצן הבא כדי לפתוח את פרויקט Apps Script ניהול אנשי קשר ב-Google Chat.
פתיחת הפרויקט - לוחצים על סקירה כללית.
- בדף הסקירה הכללית לוחצים על יצירת עותק.
נותנים שם לעותק של פרויקט Apps Script:
לוחצים על עותק של ניהול אנשי הקשר ב-Google Chat.
בשדה Project title, מקלידים
Contact Manager - Google Chat app
לוחצים על Rename.
הגדרת פרויקט Cloud של פרויקט Apps Script
- בפרויקט של Apps Script, לוחצים על Project Settings.
- בקטע פרויקט ב-Google Cloud Platform (GCP), לוחצים על שינוי פרויקט.
- בקטע מספר הפרויקט ב-GCP, מדביקים את מספר הפרויקט ב-Cloud.
- לוחצים על Set project (הגדרת פרויקט). הפרויקט ב-Cloud והפרויקט ב-Apps Script מקושרים עכשיו.
יצירת פריסה של Apps Script
עכשיו, אחרי שכל הקוד מוכן, פורסים את הפרויקט ב-Apps Script. משתמשים במזהה הפריסה כשמגדירים את של אפליקציית Chat ב-Google Cloud.
ב-Apps Script, פותחים את אפליקציית Chat פרויקט.
לוחצים על פריסה > פריסה חדשה.
אם האפשרות תוסף לא נבחרה, לצד בוחרים סוג, לוחצים על סוגי הפריסה ובוחרים באפשרות תוסף.
בקטע תיאור, מזינים תיאור של הגרסה הזו, למשל
Test of Contact Manager
.לוחצים על Deploy (פריסה). הדוחות של Apps Script בוצעו בהצלחה ומספק מזהה פריסה.
לוחצים על
Copy כדי להעתיק את מזהה הפריסה, ואז לוחצים על Done.
הגדרת אפליקציית Chat במסוף Google Cloud
בקטע הזה נסביר איך להגדיר את Google Chat API במסוף Google Cloud עם מידע על אפליקציית Chat, כולל מזהה הפריסה שיצרתם זה עתה מהפרויקט ב-Apps Script.
במסוף Google Cloud, לוחצים על תפריט. > מוצרים נוספים > Google Workspace > ספריית המוצרים > Google Chat API > ניהול > הגדרה.
בשדה App name, מקלידים
Contact Manager
.בשדה כתובת URL של הדמות, מקלידים
https://developers.google.com/chat/images/contact-icon.png
.בקטע תיאור, מקלידים
Manage your personal and business contacts
.מעבירים את המתג הפעלת תכונות אינטראקטיביות למצב פעיל.
בקטע פונקציונליות, מסמנים את התיבות קבלת הודעות 1:1. איך מצטרפים למרחבים משותפים ולשיחות קבוצתיות
בקטע הגדרות החיבור, בוחרים באפשרות Apps Script.
בקטע Deployment ID (מזהה הפריסה), מדביקים את מזהה הפריסה של Apps Script שהעתקתם בקטע הקודם כשיצרתם את פריסת Apps Script.
בקטע פקודות דרך שורת הפקודות, מגדירים את פקודות הלוכסן
/about
ו-/addContact
:- לוחצים על הוספת פקודה של שורת הפקודות כדי להגדיר את הפקודה הראשונה של הלוכסן.
- בשדה Name, מקלידים
/about
. - בשדה Command ID, מקלידים
1
. - בשדה תיאור, מקלידים
Learn how to use this Chat app to manage your contacts
. - בוחרים באפשרות פתיחה של תיבת דו-שיח.
- לוחצים על סיום.
- לוחצים על הוספת פקודה דרך שורת הפקודות כדי להגדיר פקודה נוספת דרך שורת הפקודות.
- בשדה Name, מקלידים
/addContact
- בשדה Command ID, מקלידים
2
. - בקטע תיאור, מקלידים
Submit information about a contact
. - בוחרים באפשרות פתיחה של תיבת דו-שיח.
- לוחצים על סיום.
בקטע חשיפה, מסמנים את התיבה האפליקציה הזו של Chat תהיה זמינה לאנשים ולקבוצות ספציפיים ב-YOUR DOMAIN ומזינים את כתובת האימייל שלכם.
בקטע Logs (יומנים), בוחרים באפשרות Log errors to Logging (רישום שגיאות ביומן).
לוחצים על שמירה. תופיע ההודעה 'ההגדרה נשמרה'.
אפליקציית Chat מוכנה להתקנה ולבדיקה ב-Chat.
בדיקת האפליקציה של Chat
כדי לבדוק את אפליקציית Chat, פותחים מרחב משותף בצ'אט אישי באפליקציה ושולחים הודעה:
פותחים את Google Chat באמצעות חשבון Google Workspace שבו אתם משתמשים. שקיבלת כשהוספת את עצמך כבודק נאמן.
- לוחצים על צ'אט חדש.
- בשדה אפשר לצרף אנשים, מקלידים את השם של מי שרוצים לצרף אפליקציית Chat.
בוחרים את אפליקציית Chat בתוצאות. A ההודעה תיפתח.
בצ'אט האישי החדש עם אפליקציית Chat: מקלידים
/addContact
ומקישים Enter.בתיבת הדו-שיח שנפתחת, מזינים את הפרטים ליצירת קשר:
- בשדה הטקסט First and last name, מזינים שם.
- בוחרים תאריך בחלונית לבחירת תאריך Birthdate.
- בקטע סוג הקשר, בוחרים בלחצן האפשרויות עבודה או אישי.
לוחצים על בדיקה ושליחה.
בתיבת הדו-שיח לאישור, בודקים את המידע ששלחת ולוחצים על שליחה. אפליקציית Chat מספקת תשובות בהודעת טקסט. שלפי ההודעה
✅ CONTACT NAME has been added to your contacts.
אפשר גם לבדוק ולשלוח את הטופס ליצירת קשר גם דרכים:
- משתמשים בפקודה
/about
. תקבלו תשובה באפליקציית הצ'אט עם הודעת טקסט ולחצן של ווידג'ט עם אביזרים עם הכיתובAdd a contact
. אפשר ללחוץ על הלחצן כדי לפתוח תיבת דו-שיח עם טופס ליצירת קשר. - שולחים לאפליקציית Chat הודעה בצ'אט אישי בלי להשתמש בפקודה עם קו נטוי, למשל
Hello
. אפליקציית Chat משיב על טקסט וכרטיס עם הטופס ליצירת קשר.
- משתמשים בפקודה
הסרת המשאבים
כדי להימנע מחיובים בחשבון Google Cloud בגלל השימוש במשאבים שנעשה במסגרת המדריך הזה, מומלץ למחוק את הפרויקט ב-Cloud.
- במסוף Google Cloud, עוברים לדף Manage resources. לוחצים על תפריט > IAM & Admin (אדמין) > לניהול משאבים
- ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על הסמל. מחיקה של .
- כדי למחוק את הפרויקט, כותבים את מזהה הפרויקט בתיבת הדו-שיח ולוחצים על Shut down.
נושאים קשורים
- מענה לפקודות של שורת הפקודות
- איסוף ועיבוד של מידע ממשתמשי Google Chat
- פתיחת תיבות דו-שיח אינטראקטיביות
- דוגמאות נוספות לאפליקציות של Google Chat