Si deseas obtener una lista de métodos para este recurso, consulta el final de esta página.
Representaciones de recursos
Un recurso Productos representa una app en Google Play Store que está disponible para, al menos, algunos usuarios de la empresa. Algunas apps están restringidas a una sola empresa y no hay información sobre ellas disponible fuera de esa empresa.
La información que se proporciona para cada producto (nombre localizado, ícono, vínculo a la página de detalles completa de Google Play) tiene como objetivo proporcionar una representación básica del producto en una interfaz de usuario de EMM.
{ "kind": "androidenterprise#product", "productId": string, "title": string, "authorName": string, "iconUrl": string, "smallIconUrl": string, "detailsUrl": string, "workDetailsUrl": string, "requiresContainerApp": boolean, "appVersion": [ { "versionString": string, "versionCode": integer, "track": string, "targetSdkVersion": integer, "trackId": [ string ], "isProduction": boolean } ], "distributionChannel": string, "productPricing": string, "signingCertificate": { "certificateHashSha256": string, "certificateHashSha1": string }, "availableTracks": [ string ], "appTracks": [ { "trackId": string, "trackAlias": string } ], "description": string, "fullDescription": string, "screenshotUrls": [ string ], "category": string, "recentChanges": string, "minAndroidSdkVersion": integer, "contentRating": string, "lastUpdatedTimestampMillis": long, "permissions": [ { "permissionId": string, "state": string } ], "availableCountries": [ string ], "features": [ string ], "iarcGenericRating": string, "appRestrictionsSchema": { "kind": string, "restrictions": [ { "key": string, "title": string, "restrictionType": string, "description": string, "entry": [ string ], "entryValue": [ string ], "defaultValue": { "type": string, "valueBool": boolean, "valueString": string, "valueInteger": integer, "valueMultiselect": [ string ] }, "nestedRestriction": [ (AppRestrictionsSchemaRestriction) ] } ] } }
Nombre de la propiedad | Valor | Descripción | Notas |
---|---|---|---|
appRestrictionsSchema |
nested object |
El esquema de restricción de apps | |
appRestrictionsSchema.kind |
string |
Obsoleto. |
|
appRestrictionsSchema.restrictions[] |
list |
El conjunto de restricciones que conforman este esquema. | |
appRestrictionsSchema.restrictions[].defaultValue |
nested object |
Es el valor predeterminado de la restricción. Las restricciones bundle y bundleArray nunca tienen un valor predeterminado. |
|
appRestrictionsSchema.restrictions[].defaultValue.type |
string |
Es el tipo del valor que se proporciona.
Los valores aceptables son los siguientes:
|
|
appRestrictionsSchema.restrictions[].defaultValue.valueBool |
boolean |
El valor booleano: Solo estará presente si el tipo es bool. | |
appRestrictionsSchema.restrictions[].defaultValue.valueInteger |
integer |
El valor de número entero (esto solo estará presente si el tipo es un número entero) | |
appRestrictionsSchema.restrictions[].defaultValue.valueMultiselect[] |
list |
La lista de valores de string (esto solo estará presente si el tipo es de selección múltiple) | |
appRestrictionsSchema.restrictions[].defaultValue.valueString |
string |
El valor de cadena: estará presente para los tipos de cadena, opción y oculta. | |
appRestrictionsSchema.restrictions[].description |
string |
Es una descripción más larga de la restricción con más detalles sobre lo que afecta. | |
appRestrictionsSchema.restrictions[].entryValue[] |
list |
Para las restricciones choice o multiselect , es la lista de valores legibles por máquina de las entradas posibles. Estos valores se deben usar en la configuración, ya sea como un solo valor string para una restricción choice o en stringArray para una restricción multiselect . |
|
appRestrictionsSchema.restrictions[].entry[] |
list |
Para las restricciones choice o multiselect , es la lista de nombres legibles de las entradas posibles. |
|
appRestrictionsSchema.restrictions[].key |
string |
La clave única que usa el producto para identificar la restricción, p.ej., “com.google.android.gm.fieldname”. | |
appRestrictionsSchema.restrictions[].nestedRestriction[] |
list |
En el caso de las restricciones bundle o bundleArray , es la lista de restricciones anidadas. Una restricción bundle siempre se anida dentro de una restricción de bundleArray , y una restricción de bundleArray tiene como máximo dos niveles de profundidad. |
|
appRestrictionsSchema.restrictions[].restrictionType |
string |
Es el tipo de restricción.
Los valores aceptables son los siguientes:
|
|
appRestrictionsSchema.restrictions[].title |
string |
Es el nombre de la restricción. | |
appTracks[] |
list |
Los segmentos visibles para la empresa | |
appTracks[].trackAlias |
string |
Es el nombre modificable de una pista. Este es el nombre visible en Play Developer Console. | |
appTracks[].trackId |
string |
Identificador único de pista no modificable Este identificador es el releaseTrackId de la URL de la página de Play Developer Console que muestra la información del segmento. | |
appVersion[] |
list |
Versiones de la app disponibles actualmente para este producto | |
appVersion[].isProduction |
boolean |
Es verdadero si esta versión es un APK de producción. | |
appVersion[].targetSdkVersion |
integer |
Es la versión del SDK a la que se orienta esta app, como se especifica en el manifiesto del APK. Consulta http://developer.android.com/guide/topics/manifest/uses-sdk-element.html | |
appVersion[].track |
string |
obsoleta: Usa trackId en su lugar.
Los valores aceptables son los siguientes:
|
|
appVersion[].trackId[] |
list |
Los IDs de seguimiento en los que se publica la versión de la app. Reemplaza el campo track (obsoleto), pero no incluye el segmento de producción (consulta isProduction ). |
|
appVersion[].versionCode |
integer |
Es el identificador único de aumento para la versión de la app. | |
appVersion[].versionString |
string |
Es la string que usa el desarrollador de la app en Play Store para identificar la versión. La string no necesariamente es única o localizada (por ejemplo, podría ser “1.4”). | |
authorName |
string |
Indica el nombre del autor del producto (por ejemplo, el desarrollador de la app). | |
availableCountries[] |
list |
Los países en los que está disponible esta app. | |
availableTracks[] |
list |
obsoleta: Usa appTracks en su lugar. |
|
category |
string |
La categoría de la app (p. ej., RACING, SOCIAL, etcétera) | |
contentRating |
string |
Corresponde a la clasificación del contenido de esta app.
Los valores aceptables son los siguientes:
|
|
description |
string |
Es la descripción promocional localizada, si está disponible. | |
detailsUrl |
string |
Un vínculo a la página de detalles de Google Play (consumidor) del producto. | |
distributionChannel |
string |
Cómo y para quiénes se pone a disposición el paquete El valor publicGoogleHosted significa que el paquete está disponible a través de Play Store y no está restringido a una empresa específica. El valor privateGoogleHosted significa que el paquete es una app privada (restringida a una empresa), pero alojada por Google. El valor privateSelfHosted significa que el paquete es una app privada (restringida a una empresa) y está alojada de forma privada.
Los valores aceptables son los siguientes:
|
|
features[] |
list |
Características notables (si corresponde) de este producto. | |
fullDescription |
string |
Es la descripción completa y localizada de la tienda de aplicaciones (si está disponible). | |
iarcGenericRating |
string |
Corresponde a la clasificación del contenido de esta app.
Los valores aceptables son los siguientes:
|
|
iconUrl |
string |
Es un vínculo a una imagen que se puede usar como ícono del producto. Esta imagen es adecuada para usar hasta 512 px x 512 px. | |
kind |
string |
||
lastUpdatedTimestampMillis |
long |
Hora aproximada (en 7 días) de la última publicación de la app, expresada en milisegundos desde la época. | |
minAndroidSdkVersion |
integer |
El SDK de Android mínimo necesario para ejecutar la app. | |
permissions[] |
list |
Una lista de los permisos que requiere la app. | |
permissions[].permissionId |
string |
Es una string opaca que identifica de forma exclusiva el permiso. | |
permissions[].state |
string |
Si el permiso se aceptó o no
Los valores aceptables son los siguientes:
|
|
productId |
string |
Una string con el formato app:<package name> . Por ejemplo, app:com.google.android.gm representa la app de Gmail. |
|
productPricing |
string |
Indica si este producto es gratuito, gratuito con compras directas desde la aplicación o pagado. Si se desconoce el precio, significa que el producto ya no está disponible de forma general (aunque pueda estar disponible para las personas que lo poseen).
Los valores aceptables son los siguientes:
|
|
recentChanges |
string |
Es una descripción de los cambios recientes que se hicieron en la app. | |
requiresContainerApp |
boolean |
Ya no está disponible. | |
screenshotUrls[] |
list |
Una lista de vínculos de capturas de pantalla que representan la app | |
signingCertificate |
nested object |
Es el certificado que se usó para firmar este producto. | |
signingCertificate.certificateHashSha1 |
string |
El hash SHA1 con codificación URLsegura en base64 del certificado. (Este campo dejó de estar disponible y se reemplazó por SHA2-256. No se debe usar y se puede quitar en cualquier momento). |
|
signingCertificate.certificateHashSha256 |
string |
El hash SHA2-256 con codificación URLsegura en base64 del certificado. | |
smallIconUrl |
string |
Es un vínculo a una imagen más pequeña que se puede usar como ícono del producto. Esta imagen es adecuada para usar hasta 128 px x 128 px. | |
title |
string |
Es el nombre del producto. | |
workDetailsUrl |
string |
Un vínculo a la página de detalles de Google Play administrado del producto para que lo use un administrador empresarial. |
Métodos
- aprobar
Aprueba el producto especificado y los permisos de la app pertinentes (si los hay). La cantidad máxima de productos que puedes aprobar por cliente empresarial es de 1,000.
Si deseas obtener información para usar Google Play administrado a fin de diseñar y crear un diseño de tienda a fin de mostrar productos aprobados a los usuarios, consulta Diseño de la tienda.
Nota: Este elemento dejó de estar disponible. Las integraciones nuevas no pueden usar este método y pueden consultar nuestras recomendaciones nuevas.- generateApprovalUrl
- Genera una URL que se puede renderizar en un iframe para mostrar los permisos (si los hay) de un producto. Un administrador empresarial debe ver estos permisos y aceptarlos en nombre de su organización para aprobar ese producto.
Los administradores deben aceptar los permisos que se muestran interactuando con un elemento de la IU separado en la consola de EMM, que, a su vez, debe activar el uso de esta URL como la propiedadapprovalUrlInfo.approvalUrl
en una llamada aProducts.approve
para aprobar el producto. Esta URL solo se puede usar para mostrar permisos por un máximo de 1 día. Nota: Este elemento dejó de estar disponible. Las integraciones nuevas no pueden usar este método y pueden consultar nuestras recomendaciones nuevas. - obtener
- Recupera los detalles de un producto para mostrárselos a un administrador empresarial.
- getAppRestrictionsSchema
- Recupera el esquema que define las propiedades configurables de este producto. Todos los productos tienen un esquema, pero este puede estar vacío si no se definió ninguna configuración administrada. Este esquema se puede usar para propagar una IU que permita que un administrador configure el producto. Para aplicar una configuración administrada basada en el esquema que se obtuvo con esta API, consulta Configuraciones administradas a través de Play.
- getPermissions
- Recupera los permisos de la app para Android que requiere esta app.
- list
- Encuentra los productos aprobados que coinciden con una consulta o todos los productos aprobados si no existe una. Nota: Este elemento dejó de estar disponible. Las integraciones nuevas no pueden usar este método y pueden consultar nuestras recomendaciones nuevas.
- no aprobar
- Anula la aprobación del producto especificado (y los permisos relevantes de la app, si los hubiera). Nota: Este elemento dejó de estar disponible. Las integraciones nuevas no pueden usar este método y pueden consultar nuestras recomendaciones nuevas.