Method: subscriptions.patch

Aktualisiert oder verlängert ein Google Workspace-Abo. Informationen zur Verwendung dieser Methode 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

Optional. Nicht veränderbar. ID. Ressourcenname des Abos.

Format: subscriptions/{subscription}

Suchparameter

Parameter
updateMask

string (FieldMask format)

Optional. Das zu aktualisierende Feld. Wenn keine Angabe gemacht wird, werden alle in der Anfrage enthaltenen Felder aktualisiert.

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

  • expireTime: Der Zeitstempel für den Ablauf des Abos.
  • ttl: Die Gültigkeitsdauer (TTL) oder Dauer des Abos.

Wenn Sie das Abo vollständig ersetzen möchten (entspricht PUT), verwenden Sie *. Ausgelassene Felder werden mit leeren Werten aktualisiert.
validateOnly

boolean

Optional. Wenn dieser Wert auf true gesetzt ist, wird die Anfrage validiert und als 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.