Method: users.availability.patch

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

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

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

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

בקשת HTTP

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

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

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

פרמטרים
availability.name

string

מזהה. שם המשאב של הזמינות של המשתמש.

פורמט: users/{user}/availability

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

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

פרמטרים של שאילתה

פרמטרים
updateMask

string (FieldMask format)

חובה. רשימת השדות לעדכון. השדה היחיד שאפשר לעדכן הוא customStatus.

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

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

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