Method: properties.list

Gibt untergeordnete Properties unter dem angegebenen übergeordneten Konto zurück.

Nur „GA4“-Properties werden zurückgegeben. Attribute werden ausgeschlossen, wenn der Aufrufer keinen Zugriff hat. Vorläufig gelöschte Properties (d. h. „verschobene“) werden standardmäßig ausgeschlossen. Gibt eine leere Liste zurück, wenn keine relevanten Unterkünfte gefunden wurden.

HTTP-Anfrage

GET https://analyticsadmin.googleapis.com/v1beta/properties

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
filter

string

Erforderlich. Ein Ausdruck zum Filtern der Anfrageergebnisse. Folgende Felder können gefiltert werden: parent:(der Ressourcenname des übergeordneten Kontos bzw. der zugehörigen Property) oder ancestor:(der Ressourcenname des übergeordneten Kontos) oder firebase_project:(die ID oder Nummer des verknüpften Firebase-Projekts). Beispiele für Filter:

| Filter                      | Description                               |
|-----------------------------|-------------------------------------------|
| parent:accounts/123         | The account with account id: 123.       |
| parent:properties/123       | The property with property id: 123.       |
| ancestor:accounts/123       | The account with account id: 123.         |
| firebase_project:project-id | The firebase project with id: project-id. |
| firebase_project:123        | The firebase project with number: 123.    |
pageSize

integer

Die maximale Anzahl von Ressourcen, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück, selbst wenn es zusätzliche Seiten gibt. Wenn nichts angegeben ist, werden maximal 50 Ressourcen zurückgegeben. Der Höchstwert beträgt 200 (höhere Werte werden auf den Höchstwert erzwungen)

pageToken

string

Ein Seitentoken, das von einem vorherigen properties.list-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen. Bei der Paginierung müssen alle anderen an properties.list bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

showDeleted

boolean

Gibt an, ob Properties in den Ergebnissen vorläufig gelöscht werden sollen (z. B. „trashed“). Properties können überprüft werden, um festzustellen, ob sie gelöscht wurden.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

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

Antwortnachricht für Properties.list RPC.

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

object (Property)

Ergebnisse, die den Filterkriterien entsprechen und für den Anrufer zugänglich sind.

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/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit