Wichtig:Wir akzeptieren keine neuen Registrierungen für die Play EMM API mehr. Weitere Informationen

Diese Seite wurde von der Cloud Translation API übersetzt.

Products

Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.

Ressourcendarstellungen

Eine Produktressource steht für eine App im Google Play Store, die für mindestens einige Nutzer im Unternehmen verfügbar ist. Einige Apps sind auf ein einzelnes Unternehmen beschränkt. Außerhalb dieses Unternehmens werden keine Informationen über sie verfügbar gemacht.

Die für jedes Produkt bereitgestellten Informationen (lokaler 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
`appRestrictionsSchema`	`nested object`	Das App-Einschrä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. Die Einschränkungen `bundle` und `bundleArray` haben nie 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`	Der boolesche Wert – dieser ist nur vorhanden, wenn der Typ „boole“ lautet.
`appRestrictionsSchema.restrictions[].defaultValue.valueInteger`	`integer`	Ganzzahlwert: Dieser Wert ist nur vorhanden, wenn der Typ „Ganzzahl“ ist.
`appRestrictionsSchema.restrictions[].defaultValue.valueMultiselect[]`	`list`	Die Liste der Stringwerte. Diese ist nur vorhanden, wenn der Typ „Mehrfachauswahl“ ist.
`appRestrictionsSchema.restrictions[].defaultValue.valueString`	`string`	Der Zeichenfolgenwert: Dieser ist für die Typen "Zeichenfolge", "Auswahl" und "Ausgeblendet" vorhanden.
`appRestrictionsSchema.restrictions[].description`	`string`	Eine ausführlichere Beschreibung der Einschränkung mit genaueren Angaben zu den Auswirkungen.
`appRestrictionsSchema.restrictions[].entryValue[]`	`list`	Für `choice`- oder `multiselect`-Einschränkungen 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 Einschränkung vom Typ `choice` oder als `stringArray` für eine Einschränkung vom Typ `multiselect`.
`appRestrictionsSchema.restrictions[].entry[]`	`list`	Für `choice`- oder `multiselect`-Einschränkungen die Liste der für Menschen lesbaren Namen der möglichen 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`	Bei Einschränkungen vom Typ `bundle` oder `bundleArray` ist dies die Liste verschachtelter Einschränkungen. Eine `bundle`-Einschränkung ist immer innerhalb einer `bundleArray`-Einschränkung verschachtelt und eine `bundleArray`-Einschränkung hat höchstens zwei Ebenen.
`appRestrictionsSchema.restrictions[].restrictionType`	`string`	Der Typ 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 Track. Das ist der in der Play Console angezeigte Name.
`appTracks[].trackId`	`string`	Nicht änderbare, eindeutige Track-ID. Diese ID ist die „releaseTrackId“ in der URL der Seite der Play Developer Console, auf der die Titelinformationen angezeigt werden.
`appVersion[]`	`list`	App-Versionen, die derzeit für dieses Produkt verfügbar sind.
`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 APKs 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`	Track-IDs, in denen die App-Version veröffentlicht ist. Ersetzt das Feld `track` (eingestellt), enthält aber nicht den Produktions-Track (siehe stattdessen `isProduction`).
`appVersion[].versionCode`	`integer`	Eindeutige Kennung für die App-Version.
`appVersion[].versionString`	`string`	Der String, den der App-Entwickler im Play Store verwendet, um die Version zu identifizieren. Die Zeichenfolge ist nicht unbedingt eindeutig oder lokalisiert. Die Zeichenfolge könnte beispielsweise "1.4" lauten.
`authorName`	`string`	Der Name des Produktherstellers, z. B. der App-Entwickler.
`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 usw.)
`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 (für Verbraucher).
`distributionChannel`	`string`	Wie und wem das Paket zur Verfügung gestellt wird Der Wert `publicGoogleHosted` bedeutet, dass das Paket im Play Store verfügbar ist und nicht auf ein bestimmtes Unternehmen beschränkt ist. Der Wert `privateGoogleHosted` bedeutet, dass das Paket eine private App ist, die auf ein Unternehmen beschränkt ist, aber von Google gehostet wird. Der Wert `privateSelfHosted` bedeutet, dass das Paket eine private App ist, die auf ein Unternehmen beschränkt ist und privat gehostet wird. Zulässige Werte sind: "`privateGoogleHosted`" "`privateSelfHosted`" "`publicGoogleHosted`"
`features[]`	`list`	Erwähnenswerte Funktionen dieses Produkts (falls vorhanden).
`fullDescription`	`string`	Die lokalisierte vollständige App-Shop-Beschreibung, 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 kann mit bis zu 512 x 512 Pixel verwendet werden.
`kind`	`string`
`lastUpdatedTimestampMillis`	`long`	Die ungefähre Zeit (innerhalb von 7 Tagen), während der die App zuletzt veröffentlicht wurde, ausgedrückt in Millisekunden seit der UNIX-Epoche.
`minAndroidSdkVersion`	`integer`	Das Android SDK, das mindestens zum Ausführen der App erforderlich ist.
`permissions[]`	`list`	Eine Liste der für die App erforderlichen Berechtigungen.
`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>`. Beispielsweise steht `app:com.google.android.gm` für die Gmail App.
`productPricing`	`string`	Gibt an, ob dieses Produkt kostenlos, kostenlos mit In-App-Käufen oder kostenpflichtig ist. Wenn der Preis unbekannt ist, bedeutet dies, dass das Produkt nicht mehr allgemein verfügbar ist (auch wenn es möglicherweise noch für Personen verfügbar ist, die es besitzen). Zulässige Werte sind: "`free`" "`freeWithInAppPurchase`" "`paid`"
`recentChanges`	`string`	Eine Beschreibung der letzten Änderungen, die an der App vorgenommen wurden.
`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 base64-urlsafe-codierte SHA1-Hash des Zertifikats. Dieses Feld wird zugunsten von SHA2-256 eingestellt. Es sollte nicht verwendet werden und kann jederzeit entfernt werden.
`signingCertificate.certificateHashSha256`	`string`	Der base64-URLsafe-codierte SHA2-256-Hash des Zertifikats.
`smallIconUrl`	`string`	Ein Link zu einem kleineren Bild, das als Symbol für das Produkt verwendet werden kann. Dieses Bild kann mit bis zu 128 x 128 Pixel verwendet werden.
`title`	`string`	Der Name des Produkts.
`workDetailsUrl`	`string`	Ein Link zur Managed Google Play-Detailseite für das Produkt, das von einem Enterprise-Administrator verwendet werden kann.

Methoden

genehmigen

Genehmigt das angegebene Produkt und die relevanten App-Berechtigungen, falls vorhanden. Pro Unternehmenskunde können maximal 1.000 Produkte genehmigt werden.

Informationen zur Verwendung von Managed Google Play zum Entwerfen und Erstellen eines Store-Layouts, um Nutzern genehmigte Produkte anzuzeigen, finden Sie unter Store-Layoutdesign.

Hinweis: Dieses Element wurde eingestellt. In neuen Integrationen kann diese Methode nicht verwendet werden. Weitere Informationen finden Sie in unseren neuen Empfehlungen.

generateApprovalUrl

Generiert eine URL, die in einem iFrame gerendert werden kann, um die Berechtigungen eines Produkts (falls vorhanden) anzuzeigen. Ein Unternehmensadministrator muss diese Berechtigungen aufrufen und im Namen seiner Organisation akzeptieren, um das Produkt genehmigen zu können.

Administratoren sollten die angezeigten Berechtigungen akzeptieren, indem sie mit einem separaten UI-Element in der EMM-Konsole interagieren, das wiederum die Verwendung dieser URL als approvalUrlInfo.approvalUrl-Property in einem Products.approve-Aufruf zur Produktgenehmigung auslösen sollte. Mit dieser URL können Berechtigungen maximal einen Tag lang angezeigt werden. Hinweis: Dieses Element wurde eingestellt. In neuen Integrationen kann diese Methode nicht verwendet werden. Weitere Informationen finden Sie in unseren neuen Empfehlungen.

Erhalten

Ruft Produktdetails ab, damit sie einem Unternehmensadministrator angezeigt werden können.

getAppRestrictionsSchema

Ruft das Schema ab, das die konfigurierbaren Eigenschaften für dieses Produkt definiert. Alle Produkte haben ein Schema. Dieses Schema kann jedoch leer sein, wenn keine verwalteten Konfigurationen definiert wurden. Mit diesem Schema kann eine UI ausgefüllt werden, über die 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 Play.

getPermissions

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

list

Findet genehmigte Produkte, die mit einer Abfrage übereinstimmen, oder alle genehmigten Produkte, wenn keine Abfrage vorhanden ist. Hinweis: Dieses Element wurde eingestellt. In neuen Integrationen kann diese Methode nicht verwendet werden. Weitere Informationen finden Sie in unseren neuen Empfehlungen.

Genehmigung aufheben

Die Genehmigung für das angegebene Produkt (und ggf. die entsprechenden App-Berechtigungen) wird aufgehoben. Hinweis: Dieses Element wurde eingestellt. In neuen Integrationen kann diese Methode nicht verwendet werden. Weitere Informationen finden Sie in unseren neuen Empfehlungen.