- Requête HTTP
- Paramètres de chemin d'accès
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- AdUnit
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- Exemples
- Essayer
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 |
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 |
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 sont converties en 20 000. |
pageToken |
Valeur renvoyée par le dernier |
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 ( |
Champs | |
---|---|
adUnits[] |
Blocs d'annonces obtenus pour le compte demandé. |
nextPageToken |
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 |
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 |
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 |
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 |
ID de l'application à laquelle ce bloc d'annonces est associé, visible par des utilisateurs externes. Exemple: ca-app-pub-9876543210987654~0123456789 |
displayName |
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 |
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 acceptés 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[] |
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. |