Method: subscriptions.patch

Actualiza o renueva una suscripción a Google Workspace. Si quieres obtener información para usar este método, consulta Cómo actualizar o renovar una suscripción a Google Workspace.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
subscription.name

string

Opcional. Inmutable. Identificador. Nombre del recurso de la suscripción.

Formato: subscriptions/{subscription}

Parámetros de consulta

Parámetros
updateMask

string (FieldMask format)

Opcional. El campo que se actualizará. Si se omite, actualiza los campos incluidos en la solicitud.

Puedes actualizar uno de los siguientes campos en una suscripción:

  • expireTime: Es la marca de tiempo del vencimiento de la suscripción.
  • ttl: El tiempo de actividad (TTL) o la duración de la suscripción.

Para reemplazar por completo la suscripción (el equivalente de PUT), usa *. Todos los campos omitidos se actualizan con valores vacíos.

validateOnly

boolean

Opcional. Si se configura como true, valida la solicitud y obtiene una vista previa de ella, pero no actualiza la suscripción.

Cuerpo de la solicitud

El cuerpo de la solicitud incluye una instancia de Subscription.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.

  • El campo metadata contiene un array vacío.
  • El campo response contiene una instancia actualizada de Subscription.

Permisos de autorización

Se necesita uno de los siguientes alcances de 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 obtener más información, consulta la guía de autorización.