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.

Per un abbonamento a una risorsa di destinazione di Chat, puoi aggiornare un abbonamento come segue:

Richiesta HTTP

PATCH https://workspaceevents.googleapis.com/v1beta/{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.

Puoi aggiornare uno dei seguenti campi di un abbonamento:

  • expireTime: il timestamp della scadenza dell'abbonamento.
  • ttl: La durata (TTL) dell'abbonamento.
  • eventTypes: L'elenco dei tipi di eventi da ricevere sulla risorsa di destinazione.

Quando utilizzi il carattere jolly * (equivalente a PUT), i campi omessi vengono impostati su valori vuoti e rifiutati se non sono validi.
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/chat.app.memberships
  • https://www.googleapis.com/auth/chat.app.messages.readonly
  • https://www.googleapis.com/auth/chat.app.spaces
  • 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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.