Method: subscriptions.patch

Atualiza ou renova uma assinatura do Google Workspace. Para saber como usar esse método, consulte Atualizar ou renovar uma assinatura do Google Workspace.

Para uma assinatura em um recurso de destino do Chat, é possível atualizar uma assinatura como:

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
subscription.name

string

Identificador. Nome do recurso da assinatura.

Formato: subscriptions/{subscription}

Parâmetros de consulta

Parâmetros
updateMask

string (FieldMask format)

Opcional. O campo a ser atualizado. Se omitido, atualiza todos os campos incluídos na solicitação.

É possível atualizar um dos seguintes campos em uma assinatura:

  • expireTime: o carimbo de data/hora em que a assinatura expira.
  • ttl: o tempo de vida (TTL) ou a duração da assinatura.
  • eventTypes: a lista de tipos de eventos a serem recebidos sobre o recurso de destino.

Ao usar o caractere curinga * (equivalente a PUT), os campos omitidos são definidos como valores vazios e rejeitados se forem inválidos.
validateOnly

boolean

Opcional. Se definido como true, valida e mostra uma prévia da solicitação, mas não atualiza a assinatura.

Corpo da solicitação

O corpo da solicitação contém uma instância de Subscription.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

  • O campo metadata contém uma matriz vazia.
  • O campo response contém uma instância atualizada de Subscription.

Escopos de autorização

Requer um dos seguintes escopos do 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/chat.app.memberships
  • https://www.googleapis.com/auth/chat.app.messages.readonly
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/meetings.space.created
  • https://www.googleapis.com/auth/meetings.space.readonly
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

Para mais informações, consulte o guia de autorização.