Method: spaces.messages.replaceCards

החלפת הכרטיסים שכלולים בהודעה.

אפליקציית צ'אט יכולה להחליף כרטיסים בהודעה שנכתבה על ידי אדם רק אם ההודעה כבר מכילה כרטיסים, והכרטיסים נוצרו על ידי האפליקציה.

אם האפליקציה מחליפה את הכרטיסים ברשימה ריקה, הכרטיסים מוסרים. אחרי שמסירים את הכרטיסים, האפליקציה לא יכולה להוסיף אותם בחזרה להודעה.

נדרש אימות אפליקציה עם היקף ההרשאות: - https://www.googleapis.com/auth/chat.bot

בקשת HTTP

POST https://chat.googleapis.com/v1/{name=spaces/*/messages/*}:replaceCards

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
name

string

חובה. שם המשאב של ההודעה.

פורמט: spaces/{space}/messages/{message}

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "cardsV2": [
    {
      object (CardWithId)
    }
  ]
}
שדות
cardsV2[]

object (CardWithId)

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

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יהיה ריק.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

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