Method: accounts.adUnits.list

Permet de 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 répertorier les blocs d'annonces. Exemple: accounts/pub-9876543210987654

Paramètres de requête

Paramètres
pageSize

integer

Nombre maximal de blocs d'annonces à afficher. Si aucune valeur n'est spécifiée ou que la valeur est nulle, 10 000 blocs d'annonces au maximum seront renvoyés. La valeur maximale est 20 000. les valeurs supérieures à 20 000 seront réduites à 20 000.

pageToken

string

Valeur renvoyée par le dernier ListAdUnitsResponse. indique qu'il s'agit de la 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 de 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 obtenus pour le compte demandé.

nextPageToken

string

Si ce champ 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 en savoir plus, consultez la Présentation d'OAuth 2.0.

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 pour ce bloc d'annonces. Le format est le suivant : accounts/{publisherId}/adUnits/{ad_unit_id_fragment}. Exemple : accounts/pub-9876543210987654/adUnits/0123456789.

adUnitId

string

ID du bloc d'annonces visible par des utilisateurs externes, qui peut être utilisé pour intégrer le SDK AdMob. Cette propriété est en lecture seule. Exemple: ca-app-pub-9876543210987654/0123456789

appId

string

ID de l'application à laquelle ce bloc d'annonces est associé, visible par des utilisateurs externes. Exemple: ca-app-pub-9876543210987654~0123456789

displayName

string

Nom à afficher du bloc d'annonces, tel qu'il est indiqué dans l'interface utilisateur d'AdMob, 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 "BANNIÈRE" - Format de bannière. "BANNIÈRE_INTERSTITIELLE" - Ancien format pouvant être utilisé comme bannière ou interstitiel Vous ne pouvez plus créer ce format, mais il peut être ciblé par des groupes de médiation. "INTERSTITIEL" – Annonce en plein écran Les types d'annonces acceptés sont "RICH_MEDIA". et "VIDEO". "NATIF" - Format d'annonce native : "RÉCOMPENSÉE" – Une annonce qui, une fois vue, reçoit un rappel qui valide l'affichage afin qu'une récompense puisse être attribuée à l'utilisateur. Les types d'annonces pris en charge sont "RICH_MEDIA". (interactif) et les vidéos pour lesquelles la vidéo ne peut pas être exclue. "INTERSTITIAL_RÉCOMPENSÉ" - Format d'annonce interstitielle avec récompense. Compatible uniquement avec le type d'annonce vidéo. Consultez la page https://support.google.com/admob/answer/9884467.

adTypes[]

string

Type de support d'annonce compatible avec ce bloc d'annonces. Les valeurs possibles sont les suivantes:

RICH_MEDIA - Des textes, images et autres supports autres que vidéo. "VIDEO" - Supports vidéo.