Method: properties.list

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Muestra propiedades secundarias en la cuenta principal especificada.

Solo se mostrarán las propiedades "GA4". Se excluirán las propiedades si el emisor no tiene acceso. Las propiedades de eliminación gradual (es decir, &trateded") se excluyen de forma predeterminada. Muestra una lista vacía si no se encuentran propiedades relevantes.

Solicitud HTTP

GET https://analyticsadmin.googleapis.com/v1beta/properties

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de consulta

Parámetros
filter

string

Obligatorio. Una expresión para filtrar los resultados de la solicitud. Los campos aptos para filtrar son: parent:(el nombre de recurso de la cuenta o propiedad superior), ancestor:(el nombre de recurso de la cuenta principal) o firebase_project:(el ID o número del proyecto de Firebase vinculado). Algunos ejemplos de filtros:

| 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

La cantidad máxima de recursos que se mostrarán. El servicio puede mostrar menos de este valor, incluso si hay páginas adicionales. Si no se especifica, se mostrarán 50 recursos como máximo. El valor máximo es 200; (los valores más altos se forzarán al máximo)

pageToken

string

Un token de página, recibido desde una llamada ListProperties anterior. Proporciona esto para recuperar la página siguiente. Al paginar, todos los demás parámetros proporcionados a ListProperties deben coincidir con la llamada que proporcionó el token de la página.

showDeleted

boolean

Indica si se deben incluir propiedades soft-deleted (es decir, "trashed") en los resultados. Las propiedades se pueden inspeccionar para determinar si se borran o no.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Mensaje de respuesta para la RPC de ListProperties

Representación JSON
{
  "properties": [
    {
      object (Property)
    }
  ],
  "nextPageToken": string
}
Campos
properties[]

object (Property)

Resultados que coinciden con los criterios de filtro y que el emisor puede acceder a ellos.

nextPageToken

string

Un token, que se puede enviar como pageToken para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

Alcances de la autorización

Se necesita uno de los siguientes alcances de OAuth:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit