Method: subscriptions.patch

Actualiza o renueva una suscripción a Google Workspace. Para obtener más información sobre cómo usar este método, consulta Cómo actualizar o renovar una suscripción a Google Workspace.

En el caso de una suscripción a un recurso de destino de chat, puedes actualizarla de la siguiente manera:

Solicitud HTTP

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

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

Parámetros de ruta

Parámetros
subscription.name

string

Es el identificador. Es el nombre del recurso de la suscripción.

Formato: subscriptions/{subscription}

Parámetros de consulta

Parámetros
updateMask

string (FieldMask format)

Opcional. Es el campo que se actualizará. Si se omite, se actualizan todos los campos incluidos en la solicitud.

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

  • expireTime: Es la marca de tiempo en la que vence la suscripción.
  • ttl: Es el tiempo de actividad (TTL) o la duración de la suscripción.
  • eventTypes: Es la lista de tipos de eventos que se recibirán sobre el recurso de destino.

Cuando se usa el comodín * (equivalente a PUT), los campos omitidos se establecen en valores vacíos y se rechazan si no son válidos.
validateOnly

boolean

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

Cuerpo de la solicitud

El cuerpo de la solicitud contiene 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 permisos 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/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 obtener más información, consulta la Guía de autorización.