REST Resource: customers.apps.android

  • The AppDetails resource represents details about different types of apps including Chrome, Android, and web apps.

  • The resource includes fields such as name, display name, description, app ID, type, publisher, and various timestamps.

  • AppDetails provides information about whether an app is paid, its homepage and privacy policy URIs, and its review number and rating.

  • The resource can contain specific information for Chrome apps (like permissions and site access) or Android apps (like permissions).

  • A partial service error for an app is indicated by the serviceError field, which follows the standard Google RPC Status model.

Resource: AppDetails

Resource representing app details.

JSON representation 
{
  "name": string,
  "displayName": string,
  "description": string,
  "appId": string,
  "revisionId": string,
  "type": enum (AppItemType),
  "iconUri": string,
  "detailUri": string,
  "firstPublishTime": string,
  "latestPublishTime": string,
  "publisher": string,
  "isPaidApp": boolean,
  "homepageUri": string,
  "privacyPolicyUri": string,
  "reviewNumber": string,
  "reviewRating": number,
  "serviceError": {
    object (Status)
  },
  "categoryIds": [
    string
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "chromeAppInfo": {
    object (ChromeAppInfo)
  },
  "androidAppInfo": {
    object (AndroidAppInfo)
  }
  // End of mutually exclusive fields.
}
Fields
name

string

Output only. Format: name=customers/{customerId}/apps/{chrome|android|web}/{appId}@{version}
displayName

string

Output only. App's display name.
description

string

Output only. App's description.
appId

string

Output only. Unique store identifier for the item. Examples: "gmbmikajjgmnabiglmofipeabaddhgne" for the Save to Google Drive Chrome extension, "com.google.android.apps.docs" for the Google Drive Android app.
revisionId

string

Output only. App version. A new revision is committed whenever a new version of the app is published.
type

enum (AppItemType)

Output only. App type.
iconUri

string

Output only. A link to an image that can be used as an icon for the product.
detailUri

string

Output only. The uri for the detail page of the item.
firstPublishTime

string (Timestamp format)

Output only. First published time.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
latestPublishTime

string (Timestamp format)

Output only. Latest published time.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
publisher

string

Output only. The publisher of the item.
isPaidApp

boolean

Output only. Indicates if the app has to be paid for OR has paid content.
homepageUri

string

Output only. Home page or Website uri.
privacyPolicyUri

string

Output only. The URI pointing to the privacy policy of the app, if it was provided by the developer. Version-specific field that will only be set when the requested app version is found.
reviewNumber

string (int64 format)

Output only. Number of reviews received. Chrome Web Store review information will always be for the latest version of an app.
reviewRating

number

Output only. The rating of the app (on 5 stars). Chrome Web Store review information will always be for the latest version of an app.
serviceError

object (Status)

Output only. Information about a partial service error if applicable.
categoryIds[]

string

Output only. The category IDs of the app, which are the same as stored in the Web Store item. It's expected that there is only one category ID.
The following is a list of mutually exclusive fields. At most one of the fields will be set in a response:
chromeAppInfo

object (ChromeAppInfo)

Output only. Chrome Web Store app information.
androidAppInfo

object (AndroidAppInfo)

Output only. Android app information.
End of mutually exclusive fields.

AppItemType

App type.

Enums
APP_ITEM_TYPE_UNSPECIFIED App type unspecified.
CHROME Chrome app.
ANDROID ARC++ app.
WEB Web app.

ChromeAppInfo

Chrome Web Store app information.

JSON representation 
{
  "minUserCount": integer,
  "permissions": [
    {
      object (ChromeAppPermission)
    }
  ],
  "siteAccess": [
    {
      object (ChromeAppSiteAccess)
    }
  ],
  "type": enum (ItemType),
  "riskAssessment": {
    object (RiskAssessmentData)
  },
  "supportEnabled": boolean,
  "isTheme": boolean,
  "googleOwned": boolean,
  "isCwsHosted": boolean,
  "kioskEnabled": boolean,
  "isKioskOnly": boolean,
  "isExtensionPolicySupported": boolean,
  "manifestVersion": string
}
Fields
minUserCount

integer

Output only. The minimum number of users using this app.
permissions[]

object (ChromeAppPermission)

Output only. Every custom permission requested by the app. Version-specific field that will only be set when the requested app version is found.
siteAccess[]

object (ChromeAppSiteAccess)

Output only. Every permission giving access to domains or broad host patterns. ( e.g. www.google.com). This includes the matches from content scripts as well as hosts in the permissions node of the manifest. Version-specific field that will only be set when the requested app version is found.
type

enum (ItemType)

Output only. Types of an item in the Chrome Web Store
riskAssessment

object (RiskAssessmentData)

Output only. Contains risk assessment data for the Chrome extension.
supportEnabled

boolean

Output only. The app developer has enabled support for their app. Version-specific field that will only be set when the requested app version is found.
isTheme

boolean

Output only. Whether the app or extension is a theme.
googleOwned

boolean

Output only. Whether the app or extension is built and maintained by Google. Version-specific field that will only be set when the requested app version is found.
isCwsHosted

boolean

Output only. Whether the app or extension is in a published state in the Chrome Web Store.
kioskEnabled

boolean

Output only. Whether this app is enabled for Kiosk mode on ChromeOS devices
isKioskOnly

boolean

Output only. Whether the app is only for Kiosk mode on ChromeOS devices
isExtensionPolicySupported

boolean

Output only. Whether an app supports policy for extensions.
manifestVersion

string (int64 format)

Output only. The version of this extension's manifest.

ChromeAppPermission

Permission requested by a Chrome app or extension.

JSON representation 
{
  "type": string,
  "documentationUri": string,
  "accessUserData": boolean
}
Fields
type

string

Output only. The type of the permission.
documentationUri

string

Output only. If available, a URI to a page that has documentation for the current permission.
accessUserData

boolean

Output only. If available, whether this permissions grants the app/extension access to user data.

ChromeAppSiteAccess

Represent one host permission.

JSON representation 
{
  "hostMatch": string
}
Fields
hostMatch

string

Output only. This can contain very specific hosts, or patterns like "*.com" for instance.

ItemType

Whether an item in the Chrome Web Store is an extension.

Enums
ITEM_TYPE_UNSPECIFIED Unspecified ItemType.
EXTENSION Chrome Extensions.
OTHERS Any other type than extension.

RiskAssessmentData

Risk assessment data about an extension/app.

JSON representation 
{
  "entries": [
    {
      object (RiskAssessmentEntry)
    }
  ],
  "overallRiskLevel": enum (RiskLevel)
}
Fields
entries[]

object (RiskAssessmentEntry)

Individual risk assessments.
overallRiskLevel

enum (RiskLevel)

Overall assessed risk level across all entries. This will be the highest risk level from all entries.

RiskAssessmentEntry

One risk assessment entry.

JSON representation 
{
  "provider": enum (RiskAssessmentProvider),
  "riskAssessment": {
    object (RiskAssessment)
  },
  "riskLevel": enum (RiskLevel)
}
Fields
provider

enum (RiskAssessmentProvider)

Output only. The risk assessment provider from which this entry comes from.
riskAssessment

object (RiskAssessment)

Output only. The details of the provider's risk assessment.
riskLevel

enum (RiskLevel)

Output only. The bucketed risk level for the risk assessment.

RiskAssessmentProvider

Risk assessment providers.

Enums
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED Default value when no provider is specified.
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR

Deprecated: Please use other risk score providers instead. CRXcavator.
RISK_ASSESSMENT_PROVIDER_SPIN_AI

Deprecated: Please use RISK_ASSESSMENT_PROVIDER_SPIN_AI_V2 instead. Spin.Ai.
RISK_ASSESSMENT_PROVIDER_LAYERX LayerX Security.
RISK_ASSESSMENT_PROVIDER_SPIN_AI_V2 Spin.AI V2.

RiskAssessment

Risk assessment for a Chrome extension.

JSON representation 
{
  "assessment": string,
  "detailsUrl": string,
  "version": string
}
Fields
assessment

string

Risk assessment for the extension. Currently, this is a numerical value, and its interpretation is specific to each risk assessment provider.
detailsUrl

string

A URL that a user can navigate to for more information about the risk assessment.
version

string

The version of the extension that this assessment applies to.

RiskLevel

Bucketed risk level for an extension/app.

Enums
RISK_LEVEL_UNSPECIFIED Risk level not specified.
RISK_LEVEL_LOW Extension that represents a low risk.
RISK_LEVEL_MEDIUM Extension that represents a medium risk.
RISK_LEVEL_HIGH Extension that represents a high risk.

AndroidAppInfo

Android app information.

JSON representation 
{
  "permissions": [
    {
      object (AndroidAppPermission)
    }
  ]
}
Fields
permissions[]

object (AndroidAppPermission)

Output only. Permissions requested by an Android app.

AndroidAppPermission

Permission requested by an Android app.

JSON representation 
{
  "type": string
}
Fields
type

string

Output only. The type of the permission.

Methods

get

 Get a specific app for a customer by its resource name.