Method: mediaPlanners.list

Répertorie tous les comptes de média-planner auxquels l'appelant a accès.

Pour les curateurs, cela renverra tous les média-planners qui ont accepté les conditions d'utilisation des curateurs.

Pour les autres comptes, toute tentative de lister les plans média renverra une erreur.

Requête HTTP

GET https://curationpartners.googleapis.com/v1/mediaPlanners

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
pageSize

integer

Nombre maximal de média-planners à renvoyer. Si aucune valeur n'est spécifiée, 100 média-planners au maximum sont renvoyés. La valeur maximale est 500. Les valeurs supérieures sont réduites à 500.

pageToken

string

Facultatif. Jeton identifiant une page de résultats que le serveur doit renvoyer.Cette valeur est reçue d'un appel mediaPlanners.list précédent dans ListMediaPlannersResponse.nextPageToken.

filter

string

Chaîne de requête facultative utilisant la syntaxe de filtrage de la liste d'API Cloud. Les colonnes compatibles avec le filtrage sont les suivantes :

  • name
  • displayName
  • ancestorNames

Corps de la requête

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

Corps de la réponse

Réponse contenant les informations du compte du média-planner.

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

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

object (MediaPlanner)

Liste des média-planners.

nextPageToken

string

Jeton pouvant être transmis à un appel ultérieur de la méthode mediaPlanners.list pour récupérer la page de résultats suivante dans ListMediaPlannersRequest.page_token.

Champs d'application des autorisations

Requiert le champ d'application OAuth suivant :

  • https://www.googleapis.com/auth/curation-partners