Method: accounts.apps.list

  • You can list the apps under a specified AdMob account using a GET request to the provided URL.

  • The request requires the parent path parameter, specifying the resource name of the account.

  • Optional query parameters include pageSize for controlling the number of results and pageToken for pagination.

  • A successful response will include a list of App objects and potentially a nextPageToken for retrieving more results.

  • The request requires the https://www.googleapis.com/auth/admob.readonly OAuth scope for authorization.

List the apps under the specified AdMob account.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. Resource name of the account to list apps for. Example: accounts/pub-9876543210987654

Query parameters

Parameters
pageSize

integer

The maximum number of apps to return. If unspecified or 0, at most 10,000 apps will be returned. The maximum value is 20,000; values above 20,000 will be coerced to 20,000.
pageToken

string

The value returned by the last ListAppsResponse; indicates that this is a continuation of a prior apps.list call, and that the system should return the next page of data.

Request body

The request body must be empty.

Response body

Response for the apps list request.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "apps": [
    {
      object (App)
    }
  ],
  "nextPageToken": string
}
Fields
apps[]

object (App)

The resulting apps for the requested account.
nextPageToken

string

If not empty, indicates that there may be more apps for the request; this value should be passed in a new ListAppsRequest.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.

App

Describes an AdMob app for a specific platform (For example: Android or iOS).

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

string

Resource name for this app. Format is accounts/{publisherId}/apps/{app_id_fragment} Example: accounts/pub-9876543210987654/apps/0123456789
appId

string

The externally visible ID of the app which can be used to integrate with the AdMob SDK. This is a read only property. Example: ca-app-pub-9876543210987654~0123456789
platform

string

Describes the platform of the app. Limited to "IOS" and "ANDROID".
manualAppInfo

object (ManualAppInfo)

The information for an app that is not linked to any app store.

After an app is linked, this information is still retrivable. If no name is provided for the app upon creation, a placeholder name will be used.
linkedAppInfo

object (LinkedAppInfo)

Immutable. The information for an app that is linked to an app store.

This field is present if and only if the app is linked to an app store.
appApprovalState

enum (AppApprovalState)

Output only. The approval state for the app. The field is read-only.

ManualAppInfo

Information provided for manual apps which are not linked to an application store (Example: Google Play, App Store).

JSON representation 
{
  "displayName": string
}
Fields
displayName

string

The display name of the app as shown in the AdMob UI, which is provided by the user. The maximum length allowed is 80 characters.

LinkedAppInfo

Information from the app store if the app is linked to an app store.

JSON representation 
{
  "appStoreId": string,
  "displayName": string
}
Fields
appStoreId

string

The app store ID of the app; present if and only if the app is linked to an app store.

If the app is added to the Google Play store, it will be the application ID of the app. For example: "com.example.myapp". See https://developer.android.com/studio/build/application-id.

If the app is added to the Apple App Store, it will be app store ID. For example "105169111".

Note that setting the app store id is considered an irreversible action. Once an app is linked, it cannot be unlinked.
displayName

string

Output only. Display name of the app as it appears in the app store. This is an output-only field, and may be empty if the app cannot be found in the store.

AppApprovalState

The app approval states for a mobile app.

Enums
APP_APPROVAL_STATE_UNSPECIFIED Default value for an unset field. Do not use.
ACTION_REQUIRED The app requires additional user action to be approved. Please refer to https://support.google.com/admob/answer/10564477 for details and next steps.
IN_REVIEW The app is pending review.
APPROVED The app is approved and can serve ads.