Method: spaces.messages.patch

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

מעדכן הודעה. יש הבדל בין השיטה 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) חובה. נתיבי השדות לעדכון. צריך להפריד בין ערכים באמצעות פסיקים או להשתמש ב-* כדי לעדכן את כל נתיבי השדות. נתיבי שדות נתמכים בשלב זה: text attachment cards (נדרש אימות אפליקציה.) cardsV2 (נדרש אימות אפליקציה.) accessoryWidgets (נדרש אימות אפליקציה.)
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

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