Method: properties.list

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

Es werden nur GA4-Properties zurückgegeben. Wenn der Aufrufer keinen Zugriff hat, werden Eigenschaften ausgeschlossen. Vorläufig gelöschte Properties (d. h. im Papierkorb befindliche Properties) werden standardmäßig ausgeschlossen. Wenn keine relevanten Properties gefunden werden, wird eine leere Liste zurückgegeben.

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:(Ressourcenname des übergeordneten Kontos/der übergeordneten Property), ancestor:(Ressourcenname des übergeordneten Kontos) oder firebase_project:(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 der Ressourcen, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück, auch wenn zusätzliche Seiten vorhanden sind. Wenn nicht angegeben, werden maximal 50 Ressourcen zurückgegeben. Der Höchstwert ist 200. Höhere Werte werden auf den Höchstwert festgelegt.
pageToken

string

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

boolean

Gibt an, ob vormals gelöschte Properties (d. h. im Papierkorb befindliche Properties) in die Ergebnisse eingeschlossen werden sollen. Sie können prüfen, ob Properties gelöscht wurden.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für den RPC-Vorgang „properties.list“

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

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