Method: subscriptions.patch

Обновляет или продлевает подписку на Google Workspace. Чтобы узнать, как использовать этот метод, см. раздел Обновление или продление подписки на Google Workspace .

HTTP-запрос

PATCH https://workspaceevents.googleapis.com/v1/{subscription.name=subscriptions/*}

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

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

Параметры
subscription.name

string

Необязательный. Неизменяемый. Идентификатор. Имя ресурса подписки.

Формат: subscriptions/{subscription}

Параметры запроса

Параметры
updateMask

string ( FieldMask format)

Необязательный. Поле для обновления. Если этот параметр опущен, обновляются все поля, включенные в запрос.

Вы можете обновить одно из следующих полей в подписке:

  • expireTime : временная метка истечения срока действия подписки.
  • ttl : срок жизни (TTL) или продолжительность подписки.
  • eventTypes : список типов событий, которые нужно получить о целевом ресурсе.

Чтобы полностью заменить подписку (эквивалент PUT ), используйте * . Любые пропущенные поля обновляются пустыми значениями.

validateOnly

boolean

Необязательный. Если установлено значение true , проверяется и просматривается запрос, но не обновляется подписка.

Тело запроса

Тело запроса содержит экземпляр Subscription .

Тело ответа

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

  • Поле metadata содержит пустой массив.
  • Поле response содержит обновленный экземпляр Subscription .

Области авторизации

Требуется одна из следующих областей OAuth:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/meetings.space.created
  • https://www.googleapis.com/auth/meetings.space.readonly

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