Method: properties.list

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

Es werden nur GA4-Properties zurückgegeben. Unterkünfte werden ausgeschlossen, wenn der Aufrufer keinen Zugriff hat. Vorläufig gelöschte Properties (d. h. "trashed") sind standardmäßig ausgeschlossen. Gibt eine leere Liste zurück, wenn keine relevanten Eigenschaften 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. die übergeordnete 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, auch wenn es zusätzliche Seiten gibt. Wenn nicht angegeben, werden maximal 50 Ressourcen zurückgegeben. Der Maximalwert beträgt 200. (Höhere Werte werden auf das Maximum erzwungen)
pageToken

string

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

boolean

Gibt an, ob vorläufige Properties (d. h. "trashed") in die Ergebnisse aufgenommen werden sollen. Properties können geprüft werden, um festzustellen, ob sie gelöscht wurden oder nicht.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

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

Antwortnachricht für ListProperties RPC.

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

object (Property)

Ergebnisse, die den Filterkriterien entsprechen und für den Anrufer zugänglich waren.
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