Method: mediaPlanners.list

Liste tous les comptes de planificateur média auxquels l'appelant a accès.

Pour les conservateurs, cette opération renvoie tous les planificateurs média qui ont accepté les conditions d'utilisation des conservateurs.

Pour les autres comptes, toute tentative de liste des planificateurs média renvoie 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 planificateurs média à renvoyer. Si aucune valeur n'est spécifiée, 100 planificateurs média au maximum sont renvoyés. La valeur maximale est 500. Les valeurs supérieures à 500 sont forcées à 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 liste de l'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 des informations sur le compte de planificateur média.

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 planificateurs média.
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.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

MediaPlanner

Représente un compte de planificateur média.

Représentation JSON 
{
  "accountId": string,
  "name": string,
  "displayName": string,
  "ancestorNames": [
    string
  ]
}
Champs
accountId
(deprecated)

string

Uniquement en sortie. ID de compte du planificateur média.
name

string

Identifiant. Nom de ressource unique du planificateur média. Format: mediaPlanners/{mediaPlannerAccountId}. Peut être utilisé pour filtrer la réponse de la méthode mediaPlanners.list.
displayName

string

Uniquement en sortie. Nom à afficher du planificateur média. Peut être utilisé pour filtrer la réponse de la méthode [mediaPlanners.list][google.ads.authorizedbuyers.marketplace.v1main.MediaPlanners.ListMediaPlanners].
ancestorNames[]

string

Uniquement en sortie. Noms des ancêtres du planificateur média. Format: mediaPlanners/{mediaPlannerAccountId}. Peut être utilisé pour filtrer la réponse de la méthode mediaPlanners.list.