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 für jedes Produkt bereitgestellten Informationen (lokalisierter Name, Symbol, Link zur vollständigen Google Play-Detailseite) sollen eine einfache 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: <ph type="x-smartling-placeholder">
|
|
appRestrictionsSchema.restrictions[].defaultValue.valueBool |
boolean |
Boolescher Wert, der nur vorhanden ist, 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 |
Der 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 möglichen Einträge maschinenlesbare Werte. 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 möglichen Einträge für Menschen lesbare Namen. |
|
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: <ph type="x-smartling-placeholder">
|
|
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: <ph type="x-smartling-placeholder">
|
|
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: <ph type="x-smartling-placeholder">
|
|
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: <ph type="x-smartling-placeholder">
|
|
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: <ph type="x-smartling-placeholder">
|
|
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: <ph type="x-smartling-placeholder">
|
|
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 die Preise nicht bekannt sind, 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: <ph type="x-smartling-placeholder">
|
|
recentChanges |
string |
Eine Beschreibung der letzten Änderungen an der App. | |
requiresContainerApp |
boolean |
Verworfen. | |
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. Er 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. Die maximale Anzahl von Produkten, die Sie pro Unternehmenskunde genehmigen können 1.000.
Hier erfahren Sie, wie Sie mit Managed Google Play einen Store gestalten und erstellen können. um genehmigte Produkte für Ihre Nutzenden anzuzeigen, siehe Store Layout Design (Design des Store-Layouts).
- generateApprovalUrl
-
Generiert eine URL, die in einem iFrame zur Anzeige des
Berechtigungen für ein Produkt. Ein Unternehmensadministrator muss diese ansehen
und diese im Namen ihrer Organisation akzeptieren, um
Produkt genehmigen können.
Administratoren sollten die angezeigten Berechtigungen akzeptieren, indem sie mit einem separaten UI-Element in der EMM-Konsole interagieren, die die Verwendung dieser URL alsapprovalUrlInfo.approvalUrl
-Property in einemProducts.approve
-Aufruf zum Genehmigen des Produkts. 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 Element definiert Produkt. Alle Produkte haben ein Schema. Dieses Schema ist jedoch möglicherweise leer, wenn keine verwaltete Konfigurationen wurden definiert. Mit diesem Schema können Sie eine Benutzeroberfläche darstellen, auf der ein Administrator das Produkt konfigurieren kann. So wenden Sie eine verwaltete Konfiguration basierend auf dem Schema an, das mit diesem API 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 Suchanfrage 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.