Method: accounts.apps.list

Permet de lister les applications associées au compte AdMob spécifié.

Requête HTTP

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

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 applications. Exemple: accounts/pub-9876543210987654

Paramètres de requête

Paramètres
pageSize

integer

Nombre maximal d'applications à afficher. Si aucune valeur n'est spécifiée ou si elle est égale à 0, 10 000 applications au maximum seront renvoyées. La valeur maximale est 20 000. Les valeurs supérieures à 20 000 sont forcées à 20 000.
pageToken

string

Valeur renvoyée par le dernier ListAppsResponse. Elle indique qu'il s'agit de la suite d'un appel apps.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 requête de liste d'applications.

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

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

object (App)

Les applications obtenues pour le compte demandé.
nextPageToken

string

Si ce champ n'est pas vide, il peut y avoir d'autres applications pour la requête. Cette valeur doit être transmise dans un nouveau ListAppsRequest.

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.

Application

Décrit une application AdMob pour une plate-forme spécifique (Android ou iOS, par exemple).

Représentation JSON 
{
  "name": string,
  "appId": string,
  "platform": string,
  "manualAppInfo": {
    object (ManualAppInfo)
  },
  "linkedAppInfo": {
    object (LinkedAppInfo)
  },
  "appApprovalState": enum (AppApprovalState)
}
Champs
name

string

Nom de la ressource pour cette application. Le format est le suivant : accounts/{publisherId}/apps/{app_id_fragment}. Exemple : accounts/pub-9876543210987654/apps/0123456789
appId

string

ID de l'application, 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
platform

string

Décrit la plate-forme de l'application. Limitée à "IOS" et "ANDROID".
manualAppInfo

object (ManualAppInfo)

Informations concernant une application qui n'est associée à aucune plate-forme de téléchargement d'applications.

Une fois qu'une application est associée, ces informations restent accessibles. Si aucun nom n'est fourni pour l'application lors de sa création, un nom d'espace réservé sera utilisé.
linkedAppInfo

object (LinkedAppInfo)

Immuable. Informations concernant une application associée à une plate-forme de téléchargement d'applications.

Ce champ n'est visible que si et seulement si l'application est associée à une plate-forme de téléchargement d'applications.
appApprovalState

enum (AppApprovalState)

Uniquement en sortie. État d'approbation de l'application. Ce champ est en lecture seule.

ManualAppInfo

Informations fournies pour les applications manuelles qui ne sont pas associées à une plate-forme de téléchargement d'applications (par exemple, Google Play ou App Store).

Représentation JSON 
{
  "displayName": string
}
Champs
displayName

string

Nom à afficher de l'application tel qu'il est indiqué dans l'interface utilisateur AdMob, fournie par l'utilisateur. La longueur maximale autorisée est de 80 caractères.

LinkedAppInfo

Informations issues de la plate-forme de téléchargement d'applications si l'application est associée à une plate-forme de téléchargement d'applications.

Représentation JSON 
{
  "appStoreId": string,
  "displayName": string
}
Champs
appStoreId

string

ID de l'application sur la plate-forme de téléchargement d'applications (présent si et seulement si l'application est associée à une plate-forme de téléchargement d'applications).

Si l'application est ajoutée au Google Play Store, il s'agit de son ID (par exemple, "com.example.monappli"). Consultez https://developer.android.com/studio/build/application-id.

Si l'application est ajoutée à l'App Store d'Apple, il s'agit de son ID. Exemple : "105169111".

Notez que la définition de l'ID de la plate-forme de téléchargement d'applications est considérée comme une action irréversible. Une fois qu'une application est associée, elle ne peut pas être dissociée.
displayName

string

Uniquement en sortie. Nom à afficher de l'application tel qu'il apparaît sur la plate-forme de téléchargement d'applications. Ce champ n'est disponible qu'en sortie. Il peut être vide si l'application est introuvable sur le Play Store.

AppApprovalState

États d'approbation d'une application mobile

Enums
APP_APPROVAL_STATE_UNSPECIFIED Valeur par défaut pour un champ non défini. Ne l'utilisez pas.
ACTION_REQUIRED L'application nécessite une action supplémentaire de l'utilisateur pour être approuvée. Pour en savoir plus et connaître la marche à suivre, consultez la page https://support.google.com/admob/answer/10564477.
IN_REVIEW L'application est en attente d'examen.
APPROVED L'application est approuvée et peut diffuser des annonces.