Method: subscriptions.patch

Aktualisiert oder verlängert ein Google Workspace-Abo. Informationen zur Verwendung dieser Methode

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
subscription.name

string

Kennung. Ressourcenname des Abos.

Format: subscriptions/{subscription}

Suchparameter

Parameter
updateMask

string (FieldMask format)

Optional. Das zu aktualisierende Feld. Wird diese Option nicht angegeben, werden alle in der Anfrage enthaltenen Felder aktualisiert.

Sie können eines der folgenden Felder in einem Abo aktualisieren:

  • expireTime: Der Zeitstempel, der angibt, wann das Abo abläuft.
  • ttl: Die Gültigkeitsdauer (TTL) oder Laufzeit des Abos.
  • eventTypes: Die Liste der Ereignistypen, die für die Zielressource empfangen werden sollen.

Wenn Sie das Platzhalterzeichen * (entspricht PUT) verwenden, werden ausgelassene Felder auf leere Werte gesetzt und abgelehnt, wenn sie ungültig sind.
validateOnly

boolean

Optional. Wenn true festgelegt ist, wird die Anfrage validiert und in der Vorschau angezeigt, aber das Abo wird nicht aktualisiert.

Anfragetext

Der Anfragetext enthält eine Instanz von Subscription.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

  • Das Feld metadata enthält ein leeres Array.
  • Das Feld response enthält eine aktualisierte Instanz von Subscription.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • 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

Weitere Informationen finden Sie im Autorisierungsleitfaden.