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 einholen. Weitere Informationen

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

HTTP-Anfrage

PATCH https://workspaceevents.googleapis.com/v1/{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. Wenn 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 Sie für die Zielressource erhalten möchten.

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 der Wert auf 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.memberships.readonly
  • https://www.googleapis.com/auth/chat.app.messages.readonly
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.app.spaces.readonly
  • https://www.googleapis.com/auth/meetings.space.created
  • https://www.googleapis.com/auth/meetings.space.readonly

Weitere Informationen finden Sie im Autorisierungsleitfaden.