Method: accounts.apps.list

Permet de lister les applications du 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 à renvoyer. Si aucune valeur n'est spécifiée ou si la valeur est 0, 10 000 applications au maximum sont renvoyées. 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 ListAppsResponse. indique qu'il s'agit de la continuation 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)

Applications obtenues pour le compte demandé.

nextPageToken

string

Si ce champ n'est pas vide, cela signifie que d'autres applications sont peut-être disponibles 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 (par exemple, Android ou iOS).

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

string

Nom de 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é à "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 l'application associée, ces informations restent récupérables. Si aucun nom n'est fourni pour l'application lors de sa création, un nom d'espace réservé est 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 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. Le 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, 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, fourni 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. ne s'affiche que 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 l'identifiant de l'application. 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 l'ID de l'App Store. Exemple : "105169111".

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

displayName

string

Uniquement en sortie. Nom à afficher pour l'application, tel qu'il apparaît sur la plate-forme de téléchargement d'applications. Il s'agit d'un champ en sortie uniquement. Il peut être vide si l'application est introuvable dans le Play Store.

AppApprovalState

États d'approbation d'une application mobile

Enums
APP_APPROVAL_STATE_UNSPECIFIED Valeur par défaut d'un champ non défini. Ne pas utiliser.
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.