Method: spaces.messages.update

מעדכנים הודעה. יש הבדל בין השיטות 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)

חובה. הנתיבים של השדות לעדכון. צריך להפריד בין ערכים באמצעות פסיקים או להשתמש בפונקציה * כדי לעדכן את כל נתיבי השדות.

נתיבי השדות שנתמכים כרגע:
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

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