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