Method: users.availability.markAsAway

מסמן את המשתמש כAWAY ב-Google Chat.

הסטטוס של המשתמש מוגדר כ'לא זמין' והפעילות של המשתמש לא משפיעה על הסטטוס.

השיטה הזו מעדכנת רק את הזמינות של המשתמש המאומת.

נדרש אימות משתמש עם הרשאת גישה:

  • https://www.googleapis.com/auth/chat.users.availability

בקשת HTTP

POST https://chat.googleapis.com/v1/{name=users/*/availability}:markAsAway

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

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

פרמטרים
name

string

חובה. שם המשאב של הזמינות שרוצים לסמן כ'לא זמין/ה'. פורמט: users/{user}/availability

‫{user} הוא המזהה של האדם ב-People API או ב-Admin SDK directory API. לדוגמה, users/123456789.

אפשר להשתמש בכתובת האימייל של המשתמש או ב-me שלו גם ככתובת אימייל חלופית כדי להתייחס למתקשר. לדוגמה, users/user@example.com או users/me.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

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

היקפי הרשאות

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

  • https://www.googleapis.com/auth/chat.users.availability

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