Method: subscriptions.patch

• Solicitação HTTP
• Parâmetros de caminho
• Parâmetros de consulta
• Corpo da solicitação
• Corpo da resposta
• Escopos de autorização

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:

• Um app do Chat que se inscreve em eventos do espaço em que ele é membro especificando um escopo de autorização que começa com chat.app e recebendo uma aprovação única do administrador. Para saber mais, consulte Autorizar como um app do Chat com aprovação do administrador.

• Prévia para desenvolvedores: um app do Chat se inscreve em todos os eventos de uma organização do Google Workspace especificando um escopo de autorização que começa com chat.app.all e recebendo uma aprovação única do administrador. Para saber mais, consulte Inscrever-se em todos os eventos do Google Chat em uma organização do Workspace .

• Um usuário especificando um escopo de autorização que não inclui app no nome. Para saber mais, consulte Autorizar como um usuário do Chat.

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 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.memberships.readonly
• https://www.googleapis.com/auth/chat.app.all.memberships.readonly
• https://www.googleapis.com/auth/chat.app.messages.readonly
• https://www.googleapis.com/auth/chat.app.all.messages.readonly
• https://www.googleapis.com/auth/chat.app.spaces
• https://www.googleapis.com/auth/chat.app.spaces.readonly
• https://www.googleapis.com/auth/chat.app.all.spaces.readonly
• https://www.googleapis.com/auth/chat.app.all.users.readstate.readonly
• 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.