type MobileApplication (v202505)

  • Mobile applications can be added to a network for targeting purposes, originating from various app stores.

  • Key identifying fields for a mobile application include a unique ID, an application ID which is replacing the old ID, and a required display name.

  • Mobile applications are associated with app stores, and this can be specified during creation and is mutable for third-party stores.

  • The status of a mobile application, such as archival status, app store name, application code, developer name, platform, and whether it is free, are read-only attributes populated by Google.

  • The approval status of a mobile application determines if it can serve ads and includes statuses like DRAFT, UNCHECKED, APPROVED, DISAPPROVED, and APPEALING.
Service
MobileApplicationService
Dependencies
MobileApplicationPage createMobileApplications() updateMobileApplications()
▼
MobileApplication

A mobile application that has been added to or "claimed" by the network to be used for targeting purposes. These mobile apps can come from various app stores.

Namespace
https://www.google.com/apis/ads/publisher/v202505

Field

id

xsd:long

Uniquely identifies the mobile application. This attribute is read-only and is assigned by Google when a mobile application is claimed.

applicationId

xsd:long

Uniquely identifies the mobile application. This attribute is read-only and is assigned by Google when a mobile application is claimed. The id field is being deprecated in favor of this new ID space.

displayName

xsd:string

The display name of the mobile application. This attribute is required and has a maximum length of 255 characters.

appStoreId

xsd:string

The app store ID of the app to claim. This attribute is required for creation and then is read-only.

appStores

MobileApplicationStore[]

The app stores the mobile application belongs to. This attribute is required for creation and is mutable to allow for third party app store linking.

Enumerations
UNKNOWN
The value returned if the actual value is not exposed by the requested API version.
APPLE_ITUNES
GOOGLE_PLAY
ROKU
AMAZON_FIRETV
PLAYSTATION
XBOX
SAMSUNG_TV
AMAZON_APP_STORE
OPPO_APP_STORE
SAMSUNG_APP_STORE
VIVO_APP_STORE
XIAOMI_APP_STORE
LG_TV

isArchived

xsd:boolean

The archival status of the mobile application. This attribute is read-only.

appStoreName

xsd:string

The name of the application on the app store. This attribute is read-only and populated by Google.

applicationCode

xsd:string

The application code used to identify the app in the SDK. This attribute is read-only and populated by Google.

Note that the UI refers to this as "App ID".

developerName

xsd:string

The name of the developer of the mobile application. This attribute is read-only and populated by Google.

platform

MobileApplicationPlatform

The platform the mobile application runs on. This attribute is read-only and populated by Google.

Enumerations
UNKNOWN
The value returned if the actual value is not exposed by the requested API version.
ANDROID
IOS
ROKU
AMAZON_FIRETV
PLAYSTATION
XBOX
SAMSUNG_TV
LG_TV

isFree

xsd:boolean

Whether the mobile application is free on the app store it belongs to. This attribute is read-only and populated by Google.

downloadUrl

xsd:string

The download URL of the mobile application on the app store it belongs to. This attribute is read-only and populated by Google.

approvalStatus

MobileApplication.ApprovalS...

The approval status for the mobile application.

Enumerations
UNKNOWN
Unknown approval status.
DRAFT
The application is not yet ready for review.
UNCHECKED
The application has not yet been reviewed.
APPROVED
The application can serve ads.
DISAPPROVED
The application failed approval checks and it cannot serve any ads.
APPEALING
The application is disapproved but has a pending review status, signaling an appeal.