Method: subscriptions.patch

Aggiorna o rinnova un abbonamento a Google Workspace. Per scoprire come utilizzare questo metodo, consulta Aggiornare o rinnovare un abbonamento a Google Workspace.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
subscription.name

string

Identificatore. Nome della risorsa dell'abbonamento.

Formato: subscriptions/{subscription}

Parametri di query

Parametri
updateMask

string (FieldMask format)

(Facoltativo) Il campo da aggiornare. Se omesso, aggiorna tutti i campi inclusi nella richiesta.

In un abbonamento puoi aggiornare uno dei seguenti campi:

  • expireTime: il timestamp della data di scadenza dell'abbonamento.
  • ttl: il time-to-live (TTL) o la durata dell'abbonamento.
  • eventTypes: l'elenco dei tipi di eventi da ricevere relativi alla risorsa di destinazione.

Per sostituire completamente l'abbonamento (l'equivalente di PUT), utilizza *. Eventuali campi omessi vengono aggiornati con valori vuoti.
validateOnly

boolean

(Facoltativo) Se impostato su true, convalida e visualizza l'anteprima della richiesta, ma non aggiorna l'abbonamento.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di Subscription.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

  • Il campo metadata contiene un array vuoto.
  • Il campo response contiene un'istanza aggiornata di Subscription.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti 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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.