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 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">
    </ph>
  • bool
  • bundle
  • bundleArray
  • choice
  • hidden
  • integer
  • multiselect
  • string
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">
    </ph>
  • 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: <ph type="x-smartling-placeholder">
    </ph>
  • 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: <ph type="x-smartling-placeholder">
    </ph>
  • 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: <ph type="x-smartling-placeholder">
    </ph>
  • 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: <ph type="x-smartling-placeholder">
    </ph>
  • 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: <ph type="x-smartling-placeholder">
    </ph>
  • 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 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">
    </ph>
  • free
  • freeWithInAppPurchase
  • paid
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 als approvalUrlInfo.approvalUrl-Property in einem Products.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.