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:

• Als Chat-App, indem Sie einen Autorisierungsbereich angeben, der mit chat.app beginnt, und eine einmalige Administratorgenehmigung erhalten. Weitere Informationen finden Sie unter Als Chat-App mit Administratorgenehmigung autorisieren.

• Als 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.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
• 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.