Method: accounts.apps.list

Elenca le app nell'account AdMob specificato.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Il nome della risorsa dell'account per cui elencare le app. Esempio: accounts/pub-9876543210987654

Parametri di query

Parametri
pageSize

integer

Il numero massimo di app da restituire. Se non specificato o pari a 0, verranno restituite al massimo 10.000 app. Il valore massimo è 20.000; i valori superiori a 20.000 verranno forzati a 20.000.
pageToken

string

Il valore restituito dall'ultima ListAppsResponse indica che si tratta della continuazione di una chiamata apps.list precedente e che il sistema deve restituire la pagina di dati successiva.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta alla richiesta dell'elenco delle app.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "apps": [
    {
      object (App)
    }
  ],
  "nextPageToken": string
}
Campi
apps[]

object (App)

Le app risultanti per l'account richiesto.
nextPageToken

string

Se non è vuoto, indica che potrebbero esserci altre app per la richiesta; questo valore deve essere passato in un nuovo ListAppsRequest.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/admob.readonly

Per saperne di più, consulta la OAuth 2.0 Overview.

App

Descrive un'app AdMob per una piattaforma specifica (ad esempio Android o iOS).

Rappresentazione JSON 
{
  "name": string,
  "appId": string,
  "platform": string,
  "manualAppInfo": {
    object (ManualAppInfo)
  },
  "linkedAppInfo": {
    object (LinkedAppInfo)
  },
  "appApprovalState": enum (AppApprovalState)
}
Campi
name

string

Nome della risorsa per questa app. Il formato è accounts/{publisherId}/apps/{app_id_fragment}. Esempio: accounts/pub-9876543210987654/apps/0123456789
appId

string

L'ID visibile esternamente dell'app, che può essere utilizzato per l'integrazione con l'SDK AdMob. Questa è una proprietà di sola lettura. Esempio: ca-app-pub-9876543210987654~0123456789
platform

string

Descrive la piattaforma dell'app. Limitato a "IOS" e "ANDROID".
manualAppInfo

object (ManualAppInfo)

Le informazioni per un'app che non è collegata a nessuno store.

Una volta collegata un'app, queste informazioni sono comunque recuperabili. Se non viene fornito un nome per l'app al momento della creazione, verrà utilizzato un nome segnaposto.
linkedAppInfo

object (LinkedAppInfo)

Immutabile. Le informazioni per un'app collegata a uno store.

Questo campo è presente solo se l'app è collegata a uno store.
appApprovalState

enum (AppApprovalState)

Solo output. Lo stato di approvazione dell'app. Il campo è di sola lettura.

ManualAppInfo

Informazioni fornite per le app manuali non collegate a uno store (ad esempio Google Play, App Store).

Rappresentazione JSON 
{
  "displayName": string
}
Campi
displayName

string

Il nome visualizzato dell'app mostrato nell'interfaccia utente di AdMob, fornito dall'utente. La lunghezza massima consentita è di 80 caratteri.

LinkedAppInfo

Informazioni dallo store se l'app è collegata a uno store.

Rappresentazione JSON 
{
  "appStoreId": string,
  "displayName": string
}
Campi
appStoreId

string

L'ID store dell'app, presente se e solo se l'app è collegata a uno store.

Se l'app viene aggiunta al Google Play Store, sarà l'ID applicazione dell'app. Ad esempio: "com.example.myapp". Consulta https://developer.android.com/studio/build/application-id.

Se l'app viene aggiunta all'Apple App Store, sarà l'ID store. Ad esempio, "105169111".

Tieni presente che l'impostazione dell'ID store è considerata un'azione irreversibile. Una volta collegata un'app, non può essere scollegata.
displayName

string

Solo output. Nome visualizzato dell'app così come appare nello store. Questo è un campo di solo output e potrebbe essere vuoto se l'app non viene trovata nello store.

AppApprovalState

Gli stati di approvazione dell'app per un'app mobile.

Enum
APP_APPROVAL_STATE_UNSPECIFIED Valore predefinito per un campo non impostato. Non utilizzare.
ACTION_REQUIRED L'app richiede un'ulteriore azione dell'utente per essere approvata. Per dettagli e passaggi successivi, consulta la pagina https://support.google.com/admob/answer/10564477.
IN_REVIEW L'app è in attesa di revisione.
APPROVED L'app è approvata e può pubblicare annunci.