Method: accounts.adUnits.list

Lister les blocs d'annonces du compte AdMob spécifié.

Requête HTTP

GET https://admob.googleapis.com/v1/{parent=accounts/*}/adUnits

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Nom de ressource du compte pour lequel lister les blocs d'annonces. Exemple : accounts/pub-9876543210987654

Paramètres de requête

Paramètres
pageSize

integer

Nombre maximal de blocs d'annonces à renvoyer. Si aucune valeur n'est spécifiée ou si la valeur est définie sur 0, 10 000 blocs d'annonces au maximum seront renvoyés. La valeur maximale est 20 000. Les valeurs supérieures sont réduites à 20 000.
pageToken

string

La valeur renvoyée par la dernière ressource ListAdUnitsResponse indique qu'il s'agit d'une continuation d'un appel adUnits.list précédent et que le système doit renvoyer la page de données suivante.

Corps de la requête

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

Corps de la réponse

Réponse à la demande de liste des blocs d'annonces.

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

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

object (AdUnit)

Blocs d'annonces résultant pour le compte demandé.
nextPageToken

string

Si cette valeur n'est pas vide, cela signifie qu'il peut y avoir d'autres blocs d'annonces pour la demande. Cette valeur doit être transmise dans un nouveau ListAdUnitsRequest.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/admob.readonly

Pour plus d'informations, consultez la OAuth 2.0 Overview.

AdUnit

Décrit un bloc d'annonces AdMob.

Représentation JSON 
{
  "name": string,
  "adUnitId": string,
  "appId": string,
  "displayName": string,
  "adFormat": string,
  "adTypes": [
    string
  ]
}
Champs
name

string

Nom de ressource de ce bloc d'annonces. Le format est accounts/{publisherId}/adUnits/{ad_unit_id_fragment}. Exemple : accounts/pub-9876543210987654/adUnits/0123456789
adUnitId

string

ID visible en externe du bloc d'annonces, qui peut être utilisé pour l'intégration au SDK AdMob. Il s'agit d'une propriété en lecture seule. Exemple : ca-app-pub-9876543210987654/0123456789
appId

string

ID visible en externe de l'application à laquelle ce bloc d'annonces est associé. Exemple : ca-app-pub-9876543210987654~0123456789
displayName

string

Nom à afficher du bloc d'annonces tel qu'il apparaît dans l'UI AdMob et tel qu'il est fourni par l'utilisateur. La longueur maximale autorisée est de 80 caractères.
adFormat

string

Format d'annonce du bloc d'annonces. Les valeurs possibles sont les suivantes :

"APP_OPEN" : format d'annonce à l'ouverture d'une application. "BANNER" : format d'annonce bannière. "BANNER_INTERSTITIAL" : ancien format pouvant être utilisé comme bannière ou comme interstitiel. Il n'est plus possible de créer ce format, mais les groupes de médiation peuvent le cibler. "INTERSTITIEL" : annonce plein écran. Les types d'annonces acceptés sont "RICH_MEDIA" et "VIDEO". "NATIVE" : format d'annonce native. "REWARDED" (AVEC RÉCOMPENSE) : annonce qui, une fois visionnée, déclenche un rappel pour vérifier la vue afin qu'une récompense puisse être attribuée à l'utilisateur. Les types d'annonces acceptés sont "RICH_MEDIA" (interactif) et vidéo (où la vidéo ne peut pas être exclue). "REWARDED_INTERSTITIAL" : format d'annonce interstitielle avec récompense. Ne prend en charge que le type d'annonce vidéo. Consultez https://support.google.com/admob/answer/9884467.
adTypes[]

string

Type de support publicitaire accepté par ce bloc d'annonces. Voici les valeurs possibles :

"RICH_MEDIA" : texte, image et autres contenus non vidéo. "VIDEO" : contenu multimédia vidéo.