Method: accounts.apps.list

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

Paramètres de requête

Paramètres
pageSize

integer

Nombre maximal d'applications à renvoyer. Si ce paramètre n'est pas spécifié ou est défini sur 0, 10 000 applications au maximum sont renvoyées. 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 ListAppsResponse indique qu'il s'agit d'une 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 des 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 résultantes pour le compte demandé.
nextPageToken

string

Si cette valeur n'est pas vide, cela signifie qu'il peut y avoir d'autres applications pour la demande. 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 plus d'informations, consultez la OAuth 2.0 Overview.

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 accounts/{publisherId}/apps/{app_id_fragment}. Exemple : accounts/pub-9876543210987654/apps/0123456789
appId

string

ID de l'application visible en externe, qui peut être utilisé pour l'intégrer au SDK AdMob. Il s'agit d'une propriété 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 sur 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 de substitution sera utilisé.
linkedAppInfo

object (LinkedAppInfo)

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

Ce champ est présent 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, App Store).

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

string

Nom à afficher de l'application dans l'UI AdMob, fourni par l'utilisateur. La longueur maximale autorisée est de 80 caractères.

LinkedAppInfo

Informations provenant de la plate-forme de téléchargement d'applications si l'application y est associée.

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

string

ID de l'application sur la plate-forme de téléchargement d'applications. Cet ID est 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 l'ID application de l'application. Par exemple : "com.example.myapp". 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 App Store. Par 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, vous ne pouvez plus la dissocier.
displayName

string

Uniquement en sortie. Nom à afficher de l'application tel qu'il apparaît dans l'App Store. 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 pour 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, veuillez consulter 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.