Method: spaces.messages.patch

מעדכן הודעה. יש הבדל בין השיטה patch לבין השיטה update. השיטה patch משתמשת בבקשת patch ואילו השיטה update משתמשת בבקשת put. מומלץ להשתמש בשיטה patch. לדוגמה, בקטע עדכון הודעה.

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

בקשת HTTP

PATCH 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, אחרת הבקשה תיכשל.

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

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

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