Products

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: "bool" "bundle" "bundleArray" "choice" "hidden" "integer" "multiselect" "string"
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: "bool" "bundle" "bundleArray" "choice" "hidden" "integer" "multiselect" "string"
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: "alpha" "beta" "production"
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: "all" "mature" "preTeen" "teen"
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: "privateGoogleHosted" "privateSelfHosted" "publicGoogleHosted"
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: "eighteenYears" "iarcGenericRatingUnspecified" "sevenYears" "sixteenYears" "threeYears" "twelveYears"
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: "accepted" "required"
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: "free" "freeWithInAppPurchase" "paid"
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

Eingestellt:Für neue Integrationen kann diese Methode nicht verwendet werden und sie können auf unsere neuen Empfehlungen verweisen.

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

Eingestellt:Für neue Integrationen kann diese Methode nicht verwendet werden und sie können auf unsere neuen Empfehlungen verweisen.

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 als approvalUrlInfo.approvalUrl-Attribut in einem Products.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

Eingestellt:Für neue Integrationen kann diese Methode nicht verwendet werden und sie können auf unsere neuen Empfehlungen verweisen.

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

Eingestellt:Für neue Integrationen kann diese Methode nicht verwendet werden und sie können auf unsere neuen Empfehlungen verweisen.

Ruft die für diese App erforderlichen Android-App-Berechtigungen ab.

list

Eingestellt:Für neue Integrationen kann diese Methode nicht verwendet werden und sie können auf unsere neuen Empfehlungen verweisen.

Findet genehmigte Produkte, die einer Abfrage entsprechen, oder alle genehmigten Produkte, wenn keine Abfrage vorhanden ist.

Genehmigung aufheben

Eingestellt:Für neue Integrationen kann diese Methode nicht verwendet werden und sie können auf unsere neuen Empfehlungen verweisen.

Die Genehmigung des angegebenen Produkts (und ggf. der entsprechenden App-Berechtigungen) wird aufgehoben