Method: spaces.messages.update

• בקשת HTTP
• פרמטרים של נתיב
• פרמטרים של שאילתה
• גוף הבקשה
• גוף התשובה
• היקפי הרשאה
• רוצים לנסות?

מעדכנים הודעה. יש הבדל בין השיטות patch ו-update. ה-method patch משתמשת בבקשת patch, וה-method update משתמשת בבקשת put. אנחנו ממליצים להשתמש בשיטה patch. דוגמה לכך מופיעה במאמר עדכון הודעה.

יש תמיכה בסוגי האימות הבאים:

• אימות אפליקציות

• אימות משתמשים

כשמשתמשים באימות אפליקציה, הבקשות יכולות לעדכן רק הודעות שנוצרו על ידי אפליקציית Chat שבה מתבצעת הקריאה.

בקשת HTTP

PUT https://chat.googleapis.com/v1/{message.name=spaces/*/messages/*}

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים

message.name

string מזהה. שם המשאב של ההודעה. פורמט: spaces/{space}/messages/{message} {space} הוא המזהה של המרחב שבו ההודעה פורסמה ו-{message} הוא מזהה שהוקצה על ידי המערכת להודעה. לדוגמה, spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB. אם מגדירים מזהה בהתאמה אישית בזמן יצירת ההודעה, אפשר להשתמש במזהה הזה כדי לציין את ההודעה בבקשה. לשם כך, מחליפים את {message} בערך מהשדה clientAssignedMessageId. לדוגמה, spaces/AAAAAAAAAAA/messages/client-custom-name. מידע נוסף זמין במאמר מתן שם להודעה.

פרמטרים של שאילתה

פרמטרים
updateMask	string (FieldMask format) חובה. הנתיבים של השדות לעדכון. צריך להפריד בין ערכים באמצעות פסיקים או להשתמש בפונקציה * כדי לעדכן את כל נתיבי השדות. נתיבי השדות שנתמכים כרגע: text attachment cards (נדרש אימות אפליקציה). cardsV2 (נדרש אימות אפליקציה). accessoryWidgets (נדרש אימות אפליקציה).
allowMissing	boolean זה שינוי אופציונלי. אם true וההודעה לא נמצאה, תיווצר הודעה חדשה והמערכת תתעלם מ-updateMask. מזהה ההודעה שצוין צריך להיות client-assigned, אחרת הבקשה תיכשל.

גוף הבקשה

גוף הבקשה מכיל מופע של Message.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של Message.

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

• https://www.googleapis.com/auth/chat.bot
• https://www.googleapis.com/auth/chat.import
• https://www.googleapis.com/auth/chat.messages

מידע נוסף זמין במדריך ההרשאות.