Method: subscriptions.patch

• HTTP-Anfrage
• Pfadparameter
• Suchparameter
• Anfragetext
• Antworttext
• Autorisierungsbereiche

Aktualisiert oder verlängert ein Google Workspace-Abo. Informationen zur Verwendung dieser Methode finden Sie unter Google Workspace-Abo aktualisieren oder verlängern.

Bei einem Abo für eine Chat-Zielress/1}ource können Sie ein Abo so aktualisieren:

• Eine Chat-App, die Ereignisse in Projektbereichen abonniert, in denen die App Mitglied ist. Dazu müssen Sie einen Autorisierungsbereich angeben, der mit chat.app beginnt, und eine einmalige Administratorgenehmigung einholen. Weitere Informationen finden Sie unter Als Chat-App mit Administratorgenehmigung autorisieren.

• Entwicklervorschau: Eine Chat-App, die alle Ereignisse in einer Google Workspace-Organisation abonniert. Dazu müssen Sie einen Autorisierungsbereich angeben, der mit chat.app.all beginnt, und eine einmalige Administratorgenehmigung einholen. Weitere Informationen finden Sie unter Alle Google Chat-Ereignisse in einer Workspace-Organisation abonnieren .

• Ein Nutzer, indem Sie einen Autorisierungsbereich angeben, dessen Name nicht app 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, 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. Wenn Sie das Platzhalterzeichen * verwenden (entspricht PUT), werden ausgelassene Felder auf leere Werte gesetzt und abgelehnt, wenn sie ungültig sind.
validateOnly	boolean Optional. Wenn auf true gesetzt, 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.all.memberships.readonly
• https://www.googleapis.com/auth/chat.app.messages.readonly
• https://www.googleapis.com/auth/chat.app.all.messages.readonly
• https://www.googleapis.com/auth/chat.app.spaces
• https://www.googleapis.com/auth/chat.app.spaces.readonly
• https://www.googleapis.com/auth/chat.app.all.spaces.readonly
• https://www.googleapis.com/auth/chat.app.all.users.readstate.readonly
• 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.