Method: organizations.list

Devuelve una lista de las organizaciones a las que el usuario tiene acceso.

Solicitud HTTP

GET https://marketingplatformadmin.googleapis.com/v1alpha/organizations

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

Parámetros de consulta

Parámetros
pageSize

integer

Opcional. Es la cantidad máxima de organizaciones que se pueden devolver en una llamada. El servicio puede mostrar menos que este valor.

Si no se especifica, se devolverán, como máximo, 50 organizaciones. El valor máximo es 1,000; valores superiores a 1,000 se convertirán en 1,000.

pageToken

string

Opcional. Es un token de página, recibido desde una llamada a organizations.list anterior. Proporciona esto para recuperar la página siguiente.

Cuando se pagina, todos los demás parámetros proporcionados a organizations.list deben coincidir con la llamada que proporcionó el token de la página.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es el mensaje de respuesta para la RPC de organizations.list.

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

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

object (Organization)

Es el recurso de organización al que tiene acceso el usuario, que incluye el ID y el nombre visible de la organización.

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.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/marketingplatformadmin.analytics.read
  • https://www.googleapis.com/auth/marketingplatformadmin.analytics.update