במדריך הזה מוסבר איך להשתמש ב-method get()
במשאב Message
של Google Chat API כדי להציג פרטים על הודעת טקסט או הודעת כרטיס.
ב-Chat API, הודעה ב-Chat מיוצגת על ידי משאב Message
.
משתמשי Chat יכולים לשלוח רק הודעות שמכילות טקסט, אבל באפליקציות Chat אפשר להשתמש בתכונות רבות נוספות של הודעות, כולל הצגת ממשקי משתמש סטטיים או אינטראקטיביים, איסוף מידע ממשתמשים ושליחת הודעות באופן פרטי. מידע נוסף על תכונות ההודעות שזמינות ב-Chat API זמין בסקירה הכללית על הודעות ב-Google Chat.
דרישות מוקדמות
Node.js
- חשבון Google Workspace בתוכנית Business או Enterprise עם גישה ל-Google Chat.
- מגדירים את הסביבה:
- יוצרים פרויקט ב-Google Cloud.
- מגדירים את מסך ההסכמה של OAuth.
- מפעילים ומגדירים את Google Chat API עם שם, סמל ותיאור לאפליקציית Chat.
- מתקינים את ספריית הלקוח של Cloud ל-Node.js.
- יוצרים את פרטי הכניסה בהתאם לאופן שבו רוצים לבצע אימות בבקשה ל-Google Chat API:
- כדי לבצע אימות כמשתמש ב-Chat, צריך ליצור פרטי כניסה של מזהה לקוח OAuth ולשמור את פרטי הכניסה כקובץ JSON בשם
client_secrets.json
בספרייה המקומית. - כדי לבצע אימות בתור אפליקציית Chat, צריך ליצור פרטי כניסה לחשבון שירות ולשמור את פרטי הכניסה כקובץ JSON בשם
credentials.json
.
- כדי לבצע אימות כמשתמש ב-Chat, צריך ליצור פרטי כניסה של מזהה לקוח OAuth ולשמור את פרטי הכניסה כקובץ JSON בשם
- בוחרים היקף הרשאה בהתאם לכך אם רוצים לבצע אימות כמשתמש או כאפליקציית Chat.
- מרחב משותף ב-Google Chat שבו המשתמש המאומת או אפליקציית Chat שבאמצעותה מתבצעת השיחה הם חברים. כדי לבצע אימות באמצעות אפליקציית Chat, מוסיפים את אפליקציית Chat למרחב המשותף.
Python
- חשבון Google Workspace בתוכנית Business או Enterprise עם גישה ל-Google Chat.
- מגדירים את הסביבה:
- יוצרים פרויקט ב-Google Cloud.
- מגדירים את מסך ההסכמה של OAuth.
- מפעילים ומגדירים את Google Chat API עם שם, סמל ותיאור לאפליקציית Chat.
- מתקינים את ספריית הלקוח של Cloud ב-Python.
- יוצרים את פרטי הכניסה בהתאם לאופן שבו רוצים לבצע אימות בבקשה ל-Google Chat API:
- כדי לבצע אימות כמשתמש ב-Chat, צריך ליצור פרטי כניסה של מזהה לקוח OAuth ולשמור את פרטי הכניסה כקובץ JSON בשם
client_secrets.json
בספרייה המקומית. - כדי לבצע אימות בתור אפליקציית Chat, צריך ליצור פרטי כניסה לחשבון שירות ולשמור את פרטי הכניסה כקובץ JSON בשם
credentials.json
.
- כדי לבצע אימות כמשתמש ב-Chat, צריך ליצור פרטי כניסה של מזהה לקוח OAuth ולשמור את פרטי הכניסה כקובץ JSON בשם
- בוחרים היקף הרשאה בהתאם לכך אם רוצים לבצע אימות כמשתמש או כאפליקציית Chat.
- מרחב משותף ב-Google Chat שבו המשתמש המאומת או אפליקציית Chat שבאמצעותה מתבצעת השיחה הם חברים. כדי לבצע אימות באמצעות אפליקציית Chat, מוסיפים את אפליקציית Chat למרחב המשותף.
Java
- חשבון Google Workspace בתוכנית Business או Enterprise עם גישה ל-Google Chat.
- מגדירים את הסביבה:
- יוצרים פרויקט ב-Google Cloud.
- מגדירים את מסך ההסכמה של OAuth.
- מפעילים ומגדירים את Google Chat API עם שם, סמל ותיאור לאפליקציית Chat.
- מתקינים את ספריית הלקוח של Cloud עבור Java.
- יוצרים את פרטי הכניסה בהתאם לאופן שבו רוצים לבצע אימות בבקשה ל-Google Chat API:
- כדי לבצע אימות כמשתמש ב-Chat, צריך ליצור פרטי כניסה של מזהה לקוח OAuth ולשמור את פרטי הכניסה כקובץ JSON בשם
client_secrets.json
בספרייה המקומית. - כדי לבצע אימות בתור אפליקציית Chat, צריך ליצור פרטי כניסה לחשבון שירות ולשמור את פרטי הכניסה כקובץ JSON בשם
credentials.json
.
- כדי לבצע אימות כמשתמש ב-Chat, צריך ליצור פרטי כניסה של מזהה לקוח OAuth ולשמור את פרטי הכניסה כקובץ JSON בשם
- בוחרים היקף הרשאה בהתאם לכך אם רוצים לבצע אימות כמשתמש או כאפליקציית Chat.
- מרחב משותף ב-Google Chat שבו המשתמש המאומת או אפליקציית Chat שבאמצעותה מתבצעת השיחה הם חברים. כדי לבצע אימות באמצעות אפליקציית Chat, מוסיפים את אפליקציית Chat למרחב המשותף.
Apps Script
- חשבון Google Workspace בתוכנית Business או Enterprise עם גישה ל-Google Chat.
- מגדירים את הסביבה:
- יוצרים פרויקט ב-Google Cloud.
- מגדירים את מסך ההסכמה של OAuth.
- מפעילים ומגדירים את Google Chat API עם שם, סמל ותיאור לאפליקציית Chat.
- יוצרים פרויקט נפרד של Apps Script ומפעילים את שירות הצ'אט המתקדם.
- במדריך הזה, צריך להשתמש באימות משתמשים או אימות אפליקציות. כדי לבצע אימות בתור אפליקציית Chat, יוצרים פרטי כניסה של חשבון שירות. במאמר אימות והרשאה כאפליקציה של Google Chat מוסבר איך לעשות זאת.
- בוחרים היקף הרשאה בהתאם לכך אם רוצים לבצע אימות כמשתמש או כאפליקציית Chat.
- מרחב משותף ב-Google Chat שבו המשתמש המאומת או אפליקציית Chat שבאמצעותה מתבצעת השיחה הם חברים. כדי לבצע אימות באמצעות אפליקציית Chat, מוסיפים את אפליקציית Chat למרחב המשותף.
קבלת הודעה עם אימות משתמש
כדי לקבל פרטים על הודעה עם אימות משתמש, צריך להעביר את הפרטים הבאים בבקשה:
- מציינים את היקף ההרשאה
chat.messages.readonly
אוchat.messages
. - קוראים ל-method
GetMessage()
. - מגדירים את
name
לשם המשאב של ההודעה שרוצים לקבל.
בדוגמה הבאה מתקבלת הודעה עם אימות משתמש:
Node.js
Python
Java
Apps Script
כדי להריץ את הדוגמה הזו, מחליפים את הפרטים הבאים:
SPACE_NAME
: המזהה מ-name
של המרחב המשותף. אפשר לקבל את המזהה באמצעות הקריאה ל-methodListSpaces()
או מכתובת ה-URL של המרחב המשותף.MESSAGE_NAME
: המזהה מ-name
של ההודעה. אפשר לקבל את המזהה מגוף התגובה שמוחזר אחרי יצירת הודעה באופן אסינכררוני באמצעות Chat API, או באמצעות השם המותאם אישית שהוקצה להודעה בזמן היצירה.
ממשק Chat API מחזיר מופע של Message
עם פרטי ההודעה שצוינה.
קבלת הודעה עם אימות האפליקציה
כדי לקבל פרטים על הודעה עם אימות באפליקציה, צריך להעביר את הפרטים הבאים בבקשה:
- מציינים את היקף ההרשאה
chat.bot
. - קוראים ל-method
GetMessage()
. - מגדירים את
name
לשם המשאב של ההודעה שרוצים לקבל.
בדוגמה הבאה מתקבלת הודעה עם אימות אפליקציה:
Node.js
Python
Java
Apps Script
כדי להריץ את הדוגמה הזו, מחליפים את הפרטים הבאים:
SPACE_NAME
: המזהה מ-name
של המרחב המשותף. אפשר לקבל את המזהה באמצעות הקריאה ל-methodListSpaces()
או מכתובת ה-URL של המרחב המשותף.MESSAGE_NAME
: המזהה מ-name
של ההודעה. אפשר לקבל את המזהה מגוף התגובה שמוחזר אחרי יצירת הודעה באופן אסינכררוני באמצעות Chat API, או באמצעות השם המותאם אישית שהוקצה להודעה בזמן היצירה.
ממשק Chat API מחזיר מופע של Message
עם פרטי ההודעה שצוינה.