Method: accounts.apps.list

Elenca le app dell'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. Nome della risorsa dell'account per cui elencare le app. Esempio: accounts/pub-9876543210987654

Parametri di ricerca

Parametri
pageSize

integer

Il numero massimo di app da restituire. Se il valore 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 costretti a 20.000.

pageToken

string

Il valore restituito dall'ultimo ListAppsResponse; indica che si tratta di una 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 di elenco di 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 trasmesso in un nuovo ListAppsRequest.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

App

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

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

string

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

appId

string

L'ID dell'app visibile esternamente 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. Limitata a "IOS" e "ANDROID".

manualAppInfo

object (ManualAppInfo)

Le informazioni di un'app che non è collegata a uno store.

Dopo aver collegato un'app, queste informazioni possono ancora essere recuperate. Se non viene fornito alcun nome per l'app al momento della creazione, verrà utilizzato un nome segnaposto.

linkedAppInfo

object (LinkedAppInfo)

Immutabile. Le informazioni di 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 che non sono collegate a uno store (ad esempio Google Play, App Store).

Rappresentazione JSON
{
  "displayName": string
}
Campi
displayName

string

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

LinkedAppInfo

Informazioni provenienti 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". Visita la pagina https://developer.android.com/studio/build/application-id.

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

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

displayName

string

Solo output. Il nome visualizzato dell'app così come appare nello store. Questo è un campo di solo output e potrebbe essere vuoto se non è possibile trovare l'app nello store.

AppApprovalState

Gli stati di approvazione di un'app mobile.

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