Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.
Ressourcendarstellungen
Eine Produktressource stellt eine App im Google Play Store dar, die für mindestens einige Nutzer im Unternehmen verfügbar ist. Einige Apps sind auf ein einzelnes Unternehmen beschränkt und Informationen zu den Apps sind außerhalb dieses Unternehmens nicht verfügbar.
Die zu jedem Produkt bereitgestellten Informationen (lokalisierter Name, Symbol, Link zur vollständigen Google Play-Detailseite) sollen eine grundlegende Darstellung des Produkts innerhalb einer EMM-Benutzeroberfläche ermöglichen.
{ "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) ] } ] } }
Property-Name | Wert | Beschreibung | Hinweise |
---|---|---|---|
appRestrictionsSchema |
nested object |
Das Anwendungseinschränkungsschema | |
appRestrictionsSchema.kind |
string |
Eingestellt. |
|
appRestrictionsSchema.restrictions[] |
list |
Die Einschränkungen, aus denen dieses Schema besteht. | |
appRestrictionsSchema.restrictions[].defaultValue |
nested object |
Der Standardwert der Einschränkung. Einschränkungen für bundle und bundleArray haben niemals einen Standardwert. |
|
appRestrictionsSchema.restrictions[].defaultValue.type |
string |
Der Typ des bereitgestellten Werts.
Zulässige Werte sind:
|
|
appRestrictionsSchema.restrictions[].defaultValue.valueBool |
boolean |
Boolescher Wert. Er ist nur vorhanden, wenn der Typ "bool" ist. | |
appRestrictionsSchema.restrictions[].defaultValue.valueInteger |
integer |
Ganzzahlwert. Dieser ist nur vorhanden, wenn der Typ eine Ganzzahl ist. | |
appRestrictionsSchema.restrictions[].defaultValue.valueMultiselect[] |
list |
Die Liste der Stringwerte. Diese ist nur vorhanden, wenn als Typ „Mehrfachauswahl“ ausgewählt wurde. | |
appRestrictionsSchema.restrictions[].defaultValue.valueString |
string |
Stringwert: Dieser steht für die Typen „string“, „choice“ und „hidden“ zur Verfügung. | |
appRestrictionsSchema.restrictions[].description |
string |
Eine ausführlichere Beschreibung der Einschränkung mit weiteren Informationen zu den Auswirkungen. | |
appRestrictionsSchema.restrictions[].entryValue[] |
list |
Für Einschränkungen vom Typ choice oder multiselect die Liste der maschinenlesbaren Werte der möglichen Einträge. Diese Werte sollten in der Konfiguration verwendet werden, entweder als einzelner string -Wert für eine choice -Einschränkung oder in einer stringArray für eine multiselect -Einschränkung. |
|
appRestrictionsSchema.restrictions[].entry[] |
list |
Für Einschränkungen vom Typ choice oder multiselect die Liste der visuell lesbaren Namen möglicher Einträge. |
|
appRestrictionsSchema.restrictions[].key |
string |
Der eindeutige Schlüssel, mit dem das Produkt die Einschränkung identifiziert, z.B. „com.google.android.gm.fieldname“. | |
appRestrictionsSchema.restrictions[].nestedRestriction[] |
list |
Für Einschränkungen vom Typ bundle oder bundleArray die Liste der verschachtelten Einschränkungen. Eine bundle -Einschränkung ist immer in einer bundleArray -Einschränkung verschachtelt und eine bundleArray -Einschränkung hat maximal zwei Ebenen. |
|
appRestrictionsSchema.restrictions[].restrictionType |
string |
Die Art der Einschränkung.
Zulässige Werte sind:
|
|
appRestrictionsSchema.restrictions[].title |
string |
Der Name der Einschränkung. | |
appTracks[] |
list |
Die für das Unternehmen sichtbaren Tracks. | |
appTracks[].trackAlias |
string |
Ein änderbarer Name für einen Titel. Das ist der sichtbare Name in der Play Console. | |
appTracks[].trackId |
string |
Nicht änderbare, eindeutige Titel-ID Diese ID ist die ReleaseTrackId in der URL der Play Developer Console-Seite, auf der die Titelinformationen angezeigt werden. | |
appVersion[] |
list |
Derzeit verfügbare App-Versionen für dieses Produkt. | |
appVersion[].isProduction |
boolean |
"True", wenn diese Version ein Produktions-APK ist. | |
appVersion[].targetSdkVersion |
integer |
Die SDK-Version, auf die diese App ausgerichtet ist, wie im Manifest des APK angegeben. Siehe http://developer.android.com/guide/topics/manifest/uses-sdk-element.html | |
appVersion[].track |
string |
Verworfen, verwenden Sie stattdessen trackId .
Zulässige Werte sind:
|
|
appVersion[].trackId[] |
list |
Tracking-IDs, in denen die App-Version veröffentlicht wurde. Ersetzt das Feld track (eingestellt), enthält aber nicht den Produktions-Track (siehe stattdessen isProduction ). |
|
appVersion[].versionCode |
integer |
Eindeutige, zunehmende Kennung für die App-Version. | |
appVersion[].versionString |
string |
Der String, der vom App-Entwickler im Play Store verwendet wird, um die Version zu identifizieren. Der String ist nicht unbedingt eindeutig oder lokalisiert (z. B. „1.4“). | |
authorName |
string |
Der Name des Autors des Produkts, z. B. des App-Entwicklers. | |
availableCountries[] |
list |
Die Länder, in denen diese App verfügbar ist. | |
availableTracks[] |
list |
Verworfen, verwenden Sie stattdessen appTracks . |
|
category |
string |
Die App-Kategorie (z. B. RACING, SOZIALE NETZWERKE) | |
contentRating |
string |
Die Altersfreigabe für diese App.
Zulässige Werte sind:
|
|
description |
string |
Die lokalisierte Werbebeschreibung, falls verfügbar | |
detailsUrl |
string |
Ein Link zur Google Play-Detailseite für das Produkt. | |
distributionChannel |
string |
Wie und wem das Paket zur Verfügung gestellt wird Der Wert publicGoogleHosted bedeutet, dass das Paket im Play Store verfügbar und nicht auf ein bestimmtes Unternehmen beschränkt ist. Der Wert privateGoogleHosted bedeutet, dass das Paket eine private App ist (auf ein Unternehmen beschränkt), aber von Google gehostet wird. Der Wert privateSelfHosted bedeutet, dass das Paket eine private App (auf ein Unternehmen beschränkt) ist und privat gehostet wird.
Zulässige Werte sind:
|
|
features[] |
list |
Nennenswerte Merkmale dieses Produkts (falls vorhanden) | |
fullDescription |
string |
Die lokalisierte vollständige Beschreibung des App-Shops, falls verfügbar | |
iarcGenericRating |
string |
Die Altersfreigabe für diese App.
Zulässige Werte sind:
|
|
iconUrl |
string |
Ein Link zu einem Bild, das als Symbol für das Produkt verwendet werden kann. Dieses Bild eignet sich für eine Größe von bis zu 512 x 512 Pixel. | |
kind |
string |
||
lastUpdatedTimestampMillis |
long |
Die ungefähre Zeit (innerhalb von 7 Tagen) der letzten Veröffentlichung der App, in Millisekunden seit Epoche. | |
minAndroidSdkVersion |
integer |
Das Android-SDK, das mindestens zum Ausführen der App erforderlich ist. | |
permissions[] |
list |
Eine Liste der Berechtigungen, die für die App erforderlich sind. | |
permissions[].permissionId |
string |
Ein intransparenter String, der die Berechtigung eindeutig identifiziert. | |
permissions[].state |
string |
Gibt an, ob die Berechtigung akzeptiert wurde oder nicht.
Zulässige Werte sind:
|
|
productId |
string |
Ein String im Format app:<package name> . app:com.google.android.gm steht beispielsweise für die Gmail App. |
|
productPricing |
string |
Gibt an, ob das Produkt kostenlos, kostenlos in Verbindung mit In-App-Käufen oder kostenpflichtig ist. Wenn der Preis nicht bekannt ist, bedeutet dies, dass das Produkt nicht mehr allgemein verfügbar ist, auch wenn es für die Eigentümer des Produkts möglicherweise noch verfügbar ist.
Zulässige Werte sind:
|
|
recentChanges |
string |
Eine Beschreibung der letzten Änderungen an der App. | |
requiresContainerApp |
boolean |
Veraltet. | |
screenshotUrls[] |
list |
Eine Liste mit Screenshot-Links, die die App darstellen. | |
signingCertificate |
nested object |
Das Zertifikat, mit dem dieses Produkt signiert wurde. | |
signingCertificate.certificateHashSha1 |
string |
Der mit base64 URLsafe codierte SHA1-Hash-Wert des Zertifikats. Dieses Feld wird zugunsten von SHA2-256 eingestellt. Es sollte nicht verwendet werden und kann jederzeit entfernt werden. |
|
signingCertificate.certificateHashSha256 |
string |
Der mit base64 URLsafe codierte SHA2-256-Hash-Wert des Zertifikats. | |
smallIconUrl |
string |
Ein Link zu einem kleineren Bild, das als Symbol für das Produkt verwendet werden kann. Dieses Bild ist für eine Größe von bis zu 128 x 128 Pixel geeignet. | |
title |
string |
Der Name des Produkts. | |
workDetailsUrl |
string |
Ein Link zur Managed Play Store-Detailseite für das Produkt, die von einem Enterprise-Administrator verwendet werden kann. |
Methoden
- genehmigen
-
Genehmigt das angegebene Produkt und gegebenenfalls die relevanten App-Berechtigungen. Pro Unternehmenskunde können Sie maximal 1.000 Produkte genehmigen.
Informationen dazu, wie Sie mit Managed Google Play ein Store-Layout erstellen und Ihren Nutzern genehmigte Produkte präsentieren können, finden Sie unter Layoutdesign für den Store.
- generateApprovalUrl
-
Erzeugt eine URL, die in einem iFrame gerendert werden kann, um gegebenenfalls die Berechtigungen eines Produkts anzuzeigen. Ein Unternehmensadministrator muss diese Berechtigungen anzeigen und im Namen seiner Organisation akzeptieren, um das Produkt zu genehmigen.
Administratoren sollten die angezeigten Berechtigungen akzeptieren, indem sie mit einem separaten UI-Element in der EMM-Konsole interagieren. Dadurch wird wiederum die Verwendung dieser URL alsapprovalUrlInfo.approvalUrl
-Attribut in einemProducts.approve
-Aufruf ausgelöst, um das Produkt zu genehmigen. Diese URL kann nur bis zu einem Tag lang zum Anzeigen von Berechtigungen verwendet werden. - get
- Ruft Details zu einem Produkt ab, die einem Unternehmensadministrator angezeigt werden sollen.
- getAppRestrictionsSchema
- Ruft das Schema ab, das die konfigurierbaren Eigenschaften für dieses Produkt definiert. Alle Produkte haben ein Schema. Dieses Schema ist jedoch möglicherweise leer, wenn keine verwalteten Konfigurationen definiert wurden. Mit diesem Schema kann eine UI ausgefüllt werden, mit der ein Administrator das Produkt konfigurieren kann. Informationen zum Anwenden einer verwalteten Konfiguration anhand des Schemas, das mit dieser API abgerufen wurde, finden Sie unter Verwaltete Konfigurationen über Google Play.
- getPermissions
- Ruft die für diese App erforderlichen Android-App-Berechtigungen ab.
- list
- Findet genehmigte Produkte, die einer Abfrage entsprechen, oder alle genehmigten Produkte, wenn keine Abfrage vorhanden ist.
- Genehmigung aufheben
- Die Genehmigung des angegebenen Produkts (und ggf. der entsprechenden App-Berechtigungen) wird aufgehoben