Method: subscriptions.patch

Aktualisiert oder verlängert ein Google Workspace-Abo. Weitere Informationen finden Sie unter Google Workspace-Abo aktualisieren oder verlängern.

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 dieses Attribut weggelassen, werden alle in der Anfrage enthaltenen Felder aktualisiert.

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

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

Verwenden Sie *, um das Abo vollständig zu ersetzen (entspricht PUT). Ausgelassene Felder werden mit leeren Werten aktualisiert.
validateOnly

boolean

Optional. Wenn true festgelegt ist, wird die Anfrage validiert und eine Vorschau angezeigt, das Abo wird jedoch 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 Leitfaden zur Autorisierung.