Method: spaces.messages.replaceCards

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

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

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

נדרש אימות של האפליקציה עם היקף ההרשאות: - 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

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