Method: subscriptions.list

Listet Google Workspace-Abos auf. Informationen zur Verwendung dieser Methode

HTTP-Anfrage

GET https://workspaceevents.googleapis.com/v1beta/subscriptions

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
pageSize

integer

Optional. Die maximale Anzahl von Abos, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück.

Wenn nicht angegeben oder auf 0 gesetzt, werden bis zu 50 Abos zurückgegeben.

Der Höchstwert ist 100. Wenn Sie einen Wert über 100 angeben, werden nur 100 Abos zurückgegeben.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen Aufruf zum Auflisten von Abos empfangen wurde. Geben Sie diesen Parameter an, um die nächste Seite abzurufen.

Beim Paginieren muss der Filterwert mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat. Die Übergabe eines anderen Werts kann zu unerwarteten Ergebnissen führen.
filter

string

Erforderlich. Ein Abfragefilter.

Sie können Abos nach Ereignistyp (event_types) und Zielressource (target_resource) filtern.

Sie müssen in Ihrer Abfrage mindestens einen Ereignistyp angeben. Wenn Sie nach mehreren Ereignistypen filtern möchten, verwenden Sie den Operator OR.

Wenn Sie nach Ereignistyp und Zielressource filtern möchten, verwenden Sie den Operator AND und geben Sie den vollständigen Ressourcennamen an, z. B. //chat.googleapis.com/spaces/{space}.

Die folgenden Abfragen sind beispielsweise gültig:

event_types:"google.workspace.chat.membership.v1.updated" OR
  event_types:"google.workspace.chat.message.v1.created"

event_types:"google.workspace.chat.message.v1.created" AND
  target_resource="//chat.googleapis.com/spaces/{space}"

( event_types:"google.workspace.chat.membership.v1.updated" OR
  event_types:"google.workspace.chat.message.v1.created" ) AND
  target_resource="//chat.googleapis.com/spaces/{space}"

Der Server lehnt ungültige Anfragen mit dem Fehler INVALID_ARGUMENT ab.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Die Antwortnachricht für SubscriptionsService.ListSubscriptions.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "subscriptions": [
    {
      object (Subscription)
    }
  ],
  "nextPageToken": string
}
Felder
subscriptions[]

object (Subscription)

Liste der Abos.
nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/chat.bot
  • 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
  • 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.