Method: accounts.list

Liste tous les comptes pour l'utilisateur authentifié. Il peut s'agir de tous les comptes que possède l'utilisateur ou de ceux pour lesquels il dispose de droits de gestion.

Requête HTTP

GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
parentAccount

string

Facultatif. Nom de ressource du compte pour lequel la liste des comptes directement accessibles doit être récupérée. Cela n'a de sens que pour les organisations et les groupes d'utilisateurs. Si ce champ est vide, renvoie accounts.list pour l'utilisateur authentifié. accounts/{account_id}.
pageSize

integer

Facultatif. Nombre de comptes à extraire par page. La valeur par défaut et maximale est 20.
pageToken

string

Facultatif. Si une valeur est spécifiée, la page de comptes suivante est récupérée. Le pageToken est renvoyé lorsqu'un appel à accounts.list renvoie plus de résultats que la page demandée peut en contenir.
filter

string

Facultatif. Filtre contraignant les comptes à renvoyer. La réponse n'inclut que les entrées correspondant au filtre. Si filter est vide, aucune contrainte n'est appliquée et tous les comptes (paginés) sont récupérés pour le compte demandé.

Par exemple, une requête avec le filtre type=USER_GROUP ne renverra que les groupes d'utilisateurs.

Le champ type est le seul filtre compatible.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Message de réponse pour Accounts.ListAccounts.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "accounts": [
    {
      object (Account)
    }
  ],
  "nextPageToken": string
}
Champs
accounts[]

object (Account)

Ensemble de comptes auxquels l'utilisateur a accès. Le compte personnel de l'utilisateur effectuant la requête sera toujours le premier élément du résultat, sauf s'il est filtré.
nextPageToken

string

Si le nombre de comptes dépasse la taille de page demandée, ce champ est renseigné avec un jeton permettant d'extraire la page de comptes suivante lors d'un appel ultérieur à accounts.list. S'il n'y a plus de comptes, ce champ n'est pas présent dans la réponse.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/business.manage

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.