Method: properties.list
Zwraca usługi podrzędne na określonym koncie nadrzędnym.
Usługi zostaną wykluczone, jeśli osoba dzwoniąca nie ma do nich dostępu. Obiekty usunięte warunkowo (czyli „przeznaczone do usunięcia”) są domyślnie wykluczone. Jeśli nie znaleziono żadnych odpowiednich usług, zwraca pustą listę.
Żądanie HTTP
GET https://analyticsadmin.googleapis.com/v1alpha/properties
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
Parametry |
filter |
string
Wymagane. Wyrażenie do filtrowania wyników zapytania. Do filtrowania dostępne są te pola: parent: (nazwa zasobu na koncie nadrzędnym lub w usłudze) lub ancestor: (nazwa zasobu na koncie nadrzędnym) lub firebase_project: (identyfikator lub numer połączonego projektu Firebase). Oto kilka przykładów filtrów:
| 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
Maksymalna liczba zwracanych zasobów. Usługa może zwrócić mniej niż tę wartość, nawet jeśli są dodatkowe strony. Jeśli nie podasz tej wartości, zwróci się maksymalnie 50 zasobów. Maksymalna wartość to 200 (wyższe wartości zostaną przymusowo zastąpione maksymalną).
|
pageToken |
string
Token strony otrzymany z poprzedniego wywołania funkcji properties.list . Podaj ten parametr, aby pobrać kolejną stronę. Podczas podziału na strony wszystkie inne parametry przekazane do funkcji properties.list muszą być zgodne z wywołaniem, które dostarczyło token strony.
|
showDeleted |
boolean
Określ, czy w wynikach mają być uwzględniane usunięte warunkowo (czyli „przeznaczone do usunięcia”) usługi. Właściwości można sprawdzić, aby określić, czy zostały usunięte.
|
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Odpowiedź na wywołanie RPC properties.list.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
{
"properties": [
{
object (Property )
}
],
"nextPageToken": string
} |
Pola |
properties[] |
object (Property )
Wyniki, które pasują do kryteriów filtra i są dostępne dla dzwoniącego.
|
nextPageToken |
string
token, który można wysłać jako pageToken , aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.
|
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics.edit
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-01-14 UTC.
[null,null,["Ostatnia aktualizacja: 2025-01-14 UTC."],[[["Lists all Google Analytics 4 properties under a specified parent account, excluding soft-deleted properties by default."],["Allows filtering by parent account, ancestor account, or linked Firebase project using the `filter` query parameter."],["Supports pagination with `pageSize` and `pageToken` parameters for retrieving large result sets."],["Requires authorization with either `analytics.readonly` or `analytics.edit` scopes."],["Returns an empty list if no matching properties are found or if the user lacks access."]]],["This describes how to list child properties under a parent account using a `GET` request to `https://analyticsadmin.googleapis.com/v1alpha/properties`. The request requires a filter parameter to specify the parent. Additional optional query parameters include `pageSize`, `pageToken`, and `showDeleted`. The request body must be empty. A successful response includes a list of `properties` and a `nextPageToken` for pagination. Authorization requires `analytics.readonly` or `analytics.edit` scopes.\n"]]