Method: properties.list

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

Es werden nur GA4-Properties zurückgegeben. Eigenschaften werden ausgeschlossen, wenn der Aufrufer keinen Zugriff hat. Vorläufig gelöschte Eigenschaften (d. h. in den Papierkorb verschobene Elemente) sind standardmäßig ausgeschlossen. Gibt eine leere Liste zurück, wenn keine relevanten Unterkünfte gefunden werden.

HTTP-Anfrage

GET https://analyticsadmin.googleapis.com/v1alpha/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 bzw. 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 von 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 keine Vorgabe erfolgt, 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 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, über den das Seitentoken bereitgestellt wurde.

showDeleted

boolean

Gibt an, ob vorläufig gelöschte Properties (d. h. im Papierkorb) in den Ergebnissen enthalten sein sollen. Attribute können überprüft werden, um festzustellen, ob sie gelöscht wurden oder nicht.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für Properties.list-RPC.

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 Aufrufer 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