Method: spaces.messages.patch

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

מעדכנים הודעה. יש הבדל בין השיטה patch לבין השיטה update. ה-method patch משתמשת בבקשת patch, וה-method 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. מזהה ההודעה שצוין חייב להיות הוקצה על ידי הלקוח, אחרת הבקשה תיכשל.

גוף הבקשה

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

גוף התשובה

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

היקפי ההרשאות

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

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

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