Method: users.availability.markAsDoNotDisturb

Помечает пользователя как DO_NOT_DISTURB в чате Google.

Устанавливает для пользователя состояние доступности DO_NOT_DISTURB до истечения указанного времени. В состоянии DO_NOT_DISTURB пользователи, как правило, не получают уведомлений.

Этот метод обновляет информацию о доступности только авторизованного пользователя.

Требуется аутентификация пользователя с указанием области авторизации :

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

HTTP-запрос

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

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
name

string

Обязательно. Имя ресурса, который нужно пометить как «Не беспокоить». Формат: users/{user}/availability

{user} — это идентификатор пользователя в API для работы с людьми или в API каталога Admin SDK. Например, users/123456789 .

Адрес электронной почты пользователя или имя пользователя me также могут использоваться в качестве псевдонима для обращения к вызывающему абоненту. Например, users/user@example.com или users/me .

Текст запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{

  "expireTime": string,
  "ttl": string
}
Поля
Required. The expiration for the DND availability state. The user will be marked as Away after expiration. This can be at most 1 year from the current time. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response:
expireTime

string ( Timestamp format)

Точное время истечения срока действия режима «Не беспокоить».

ttl

string ( Duration format)

Период времени с текущего момента до истечения срока действия режима «Не беспокоить».

Конец взаимоисключающих областей.

Ответный текст

В случае успеха тело ответа содержит экземпляр класса Availability .

Области полномочий

Требуется следующая область действия OAuth:

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

Для получения более подробной информации см. руководство по авторизации .