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.

Solicitação HTTP

PATCH https://workspaceevents.googleapis.com/v1/{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 time to live (TTL) ou a duração da assinatura.
  • eventTypes: a lista de tipos de eventos que serão recebidos sobre o recurso de destino.

Para substituir totalmente a assinatura (o equivalente a PUT), use *. Os campos omitidos são atualizados com valores vazios.
validateOnly

boolean

Opcional. Se definido como true, valida e visualiza a 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/meetings.space.created
  • https://www.googleapis.com/auth/meetings.space.readonly

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