Method: subscriptions.patch

Aktualisiert oder verlängert ein Google Workspace-Abo. Informationen zum Verwenden dieser Methode

Bei einem Abo für eine Chat-Zielressource können Sie ein Abo so aktualisieren:

  • Eine Chat-App, indem Sie einen Autorisierungsbereich angeben, der mit chat.app beginnt, und eine einmalige Administratorgenehmigung erhalten (Developer Preview). Weitere Informationen

  • Ein Nutzer, indem Sie einen Autorisierungsbereich angeben, der app nicht im Namen enthält. Weitere Informationen finden Sie unter Als Chat-Nutzer autorisieren.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
subscription.name

string

ID. 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/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

Weitere Informationen finden Sie im Autorisierungsleitfaden.