Method: properties.list

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

Nur „GA4“ zurückgegeben. Wenn der Aufrufer keinen Zugriff hat, werden Eigenschaften ausgeschlossen. Vorläufig gelöschte Properties (d. h. aus dem Papierkorb) werden standardmäßig ausgeschlossen. Gibt eine leere Liste zurück, wenn keine relevanten Properties gefunden werden.

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 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 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 Maximalwert ist 200. (Höhere Werte werden auf das Maximum gesetzt.)
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, in dem das Seitentoken bereitgestellt wurde.
showDeleted

boolean

Gibt an, ob vorläufig gelöschte (d. h. aus dem Papierkorb) gelöschte Properties in die Ergebnisse einbezogen werden. Eigenschaften 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 entsprachen 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