Listę metod stosowanych w tym zasobie znajdziesz na końcu tej strony.
Reprezentacja zasobów
Zasób Produkty reprezentuje aplikację w Sklepie Google Play, która jest dostępna dla co najmniej niektórych użytkowników w firmie. Niektóre aplikacje są dostępne tylko dla jednej firmy i żadne informacje o nich nie są udostępniane poza nią.
Informacje o każdym produkcie (zlokalizowana nazwa, ikona, link do pełnej strony z informacjami w Google Play) mają na celu umożliwienie podstawowej reprezentacji produktu w interfejsie EMM.
{ "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) ] } ] } }
Nazwa usługi, | Wartość | Opis | Uwagi |
---|---|---|---|
appRestrictionsSchema |
nested object |
Schemat ograniczeń aplikacji | |
appRestrictionsSchema.kind |
string |
Wycofane. |
|
appRestrictionsSchema.restrictions[] |
list |
Zbiór ograniczeń składających się na ten schemat. | |
appRestrictionsSchema.restrictions[].defaultValue |
nested object |
Wartość domyślna ograniczenia. Ograniczenia bundle i bundleArray nigdy nie mają wartości domyślnej. |
|
appRestrictionsSchema.restrictions[].defaultValue.type |
string |
Typ podanej wartości.
Akceptowane wartości:
|
|
appRestrictionsSchema.restrictions[].defaultValue.valueBool |
boolean |
Wartość logiczna – będzie widoczna tylko wtedy, gdy typem będzie wartość logiczna. | |
appRestrictionsSchema.restrictions[].defaultValue.valueInteger |
integer |
Wartość całkowita – będzie widoczna tylko wtedy, gdy typem jest liczba całkowita. | |
appRestrictionsSchema.restrictions[].defaultValue.valueMultiselect[] |
list |
Lista wartości ciągów znaków – będzie widoczna tylko wtedy, gdy typ to wybór wielokrotny. | |
appRestrictionsSchema.restrictions[].defaultValue.valueString |
string |
Wartość ciągu znaków – będzie widoczna w przypadku typów: ciąg znaków, wybór i ukryte. | |
appRestrictionsSchema.restrictions[].description |
string |
Dłuższy opis ograniczenia, który zawiera więcej szczegółów na temat jego wpływu. | |
appRestrictionsSchema.restrictions[].entryValue[] |
list |
W przypadku ograniczeń choice lub multiselect jest to lista możliwych do odczytania dla komputera wartości wpisów. Te wartości powinny być używane w konfiguracji jako pojedyncza wartość string w przypadku ograniczenia choice lub stringArray w przypadku ograniczenia multiselect . |
|
appRestrictionsSchema.restrictions[].entry[] |
list |
W przypadku ograniczeń choice i multiselect jest to lista możliwych do odczytania przez człowieka nazw wpisów. |
|
appRestrictionsSchema.restrictions[].key |
string |
Unikalny klucz używany przez usługę do identyfikowania ograniczenia, np. „com.google.android.gm.fieldname”. | |
appRestrictionsSchema.restrictions[].nestedRestriction[] |
list |
W przypadku ograniczeń bundle lub bundleArray jest to lista ograniczeń zagnieżdżonych. Ograniczenie bundle jest zawsze zagnieżdżone w ograniczeniu bundleArray , a ograniczenie bundleArray ma maksymalnie 2 poziomy. |
|
appRestrictionsSchema.restrictions[].restrictionType |
string |
Rodzaj ograniczenia.
Akceptowane wartości:
|
|
appRestrictionsSchema.restrictions[].title |
string |
Nazwa ograniczenia. | |
appTracks[] |
list |
Ścieżki widoczne dla firmy. | |
appTracks[].trackAlias |
string |
Nazwa ścieżki, którą można modyfikować. Ta nazwa będzie widoczna w Konsoli Play. | |
appTracks[].trackId |
string |
Unikalny identyfikator utworu, którego nie można zmienić. Ten identyfikator to parametrreleaseTrackId w adresie URL strony konsoli programisty Google Play, która zawiera informacje o utworze. | |
appVersion[] |
list |
Wersje aplikacji są obecnie dostępne dla tej usługi. | |
appVersion[].isProduction |
boolean |
Prawda, jeśli ta wersja jest produkcyjnym plikiem APK. | |
appVersion[].targetSdkVersion |
integer |
Wersja pakietu SDK, na którą kierowana jest ta aplikacja, podana w pliku manifestu pliku APK. Patrz http://developer.android.com/guide/topics/manifest/uses-sdk-element.html | |
appVersion[].track |
string |
Wycofane. Użyj zamiast niego zasady trackId .
Akceptowane wartości:
|
|
appVersion[].trackId[] |
list |
Śledzenie identyfikatorów, w których opublikowana jest wersja aplikacji. Zastępuje pole track (wycofane), ale nie zawiera ścieżki produkcyjnej (zobacz isProduction ). |
|
appVersion[].versionCode |
integer |
Unikalny, rosnący identyfikator wersji aplikacji. | |
appVersion[].versionString |
string |
Ciąg znaków używany w Sklepie Play przez dewelopera aplikacji do identyfikacji wersji. Ciąg nie musi być unikalny ani zlokalizowany (np. może to być „1.4”). | |
authorName |
string |
Imię i nazwisko autora usługi (np. dewelopera aplikacji). | |
availableCountries[] |
list |
Kraje, w których ta aplikacja jest dostępna. | |
availableTracks[] |
list |
Wycofane. Użyj zamiast niego zasady appTracks . |
|
category |
string |
kategoria aplikacji (np. WYŚCIGI, SPOŁECZNOŚCIOWE); | |
contentRating |
string |
Ocena treści tej aplikacji.
Akceptowane wartości:
|
|
description |
string |
Zlokalizowany opis promocyjny, jeśli jest dostępny. | |
detailsUrl |
string |
Link do strony z informacjami o produkcie w Google Play (dla klientów indywidualnych). | |
distributionChannel |
string |
jak i komu jest udostępniany pakiet, Wartość publicGoogleHosted oznacza, że pakiet jest dostępny w Sklepie Play i nie jest ograniczony do konkretnej firmy. Wartość privateGoogleHosted oznacza, że pakiet jest aplikacją prywatną (dostępną tylko dla firm), ale hostowaną przez Google. Wartość privateSelfHosted oznacza, że pakiet jest aplikacją prywatną (dostępną tylko dla firm) i jest hostowany prywatnie.
Akceptowane wartości:
|
|
features[] |
list |
Istotne funkcje (jeśli występują) tego produktu. | |
fullDescription |
string |
Zlokalizowany pełny opis sklepu z aplikacjami, jeśli jest dostępny. | |
iarcGenericRating |
string |
Ocena treści tej aplikacji.
Akceptowane wartości:
|
|
iconUrl |
string |
Link do zdjęcia, którego można użyć jako ikony produktu. Ten obraz jest odpowiedni do użytku w rozmiarze do 512 x 512 pikseli. | |
kind |
string |
||
lastUpdatedTimestampMillis |
long |
Przybliżony czas (w ciągu 7 dni) ostatniego opublikowania aplikacji wyrażony w milisekundach od początku epoki. | |
minAndroidSdkVersion |
integer |
Minimalny pakiet Android SDK niezbędny do uruchomienia aplikacji. | |
permissions[] |
list |
Lista uprawnień wymaganych przez aplikację. | |
permissions[].permissionId |
string |
Nieprzejrzysty ciąg znaków jednoznacznie identyfikujący uprawnienie. | |
permissions[].state |
string |
Określa, czy uprawnienie zostało zaakceptowane.
Akceptowane wartości:
|
|
productId |
string |
Ciąg w formie app:<package name> . Na przykład app:com.google.android.gm reprezentuje aplikację Gmail. |
|
productPricing |
string |
Określa, czy produkt jest bezpłatny, płatny czy bezpłatny z zakupami w aplikacji. Jeśli cena jest nieznana, oznacza to, że produkt nie jest już ogólnie dostępny (chociaż może nadal być dostępny dla jego właścicieli).
Akceptowane wartości:
|
|
recentChanges |
string |
Opis ostatnich zmian w aplikacji. | |
requiresContainerApp |
boolean |
Rola wycofana. | |
screenshotUrls[] |
list |
Lista linków do zrzutów ekranu przedstawiających aplikację. | |
signingCertificate |
nested object |
Certyfikat użyty do podpisania tego produktu. | |
signingCertificate.certificateHashSha1 |
string |
Skrót SHA1 certyfikatu zakodowany w base64 w adresie URL. (To pole zostało wycofane i zastąpione jest SHA2-256. Nie należy z niego korzystać i w każdej chwili można go usunąć). |
|
signingCertificate.certificateHashSha256 |
string |
Identyfikator SHA2-256 certyfikatu zakodowany w base64 w adresie URL. | |
smallIconUrl |
string |
Link do mniejszego zdjęcia, które może być używane jako ikona produktu. Ten obraz jest odpowiedni do użytku w rozmiarze do 128 x 128 pikseli. | |
title |
string |
Nazwa produktu. | |
workDetailsUrl |
string |
Link do strony z informacjami o usłudze w zarządzanym Sklepie Google Play dla administratora firmy. |
Metody
- zatwierdź
Zatwierdź określoną usługę i odpowiednie uprawnienia aplikacji (jeśli istnieją). Maksymalna liczba usług, które możesz zatwierdzić na jednego klienta Enterprise, to 1000.
Aby dowiedzieć się, jak za pomocą zarządzanego Sklepu Google Play zaprojektować i utworzyć układ sklepu, który będzie wyświetlał zatwierdzone produkty użytkownikom, przeczytaj artykuł Projektowanie układu sklepu.
Uwaga: ten element został wycofany. Nowe integracje nie mogą korzystać z tej metody i można je znaleźć w naszych nowych zaleceniach.- generateApprovalUrl
- Generuje URL, który można wyrenderować w elemencie iframe, aby wyświetlić ewentualne uprawnienia usługi. Administrator firmy musi wyświetlić te uprawnienia i zaakceptować je w imieniu swojej organizacji, aby zatwierdzić daną usługę.
Administratorzy powinni zaakceptować wyświetlane uprawnienia przez interakcję z osobnym elementem interfejsu w konsoli EMM. To z kolei powinno spowodować użycie tego adresu URL jako właściwościapprovalUrlInfo.approvalUrl
w wywołaniuProducts.approve
w celu zatwierdzenia usługi. Tego adresu URL można używać do wyświetlania uprawnień maksymalnie przez 1 dzień. Uwaga: ten element został wycofany. Nowe integracje nie mogą korzystać z tej metody i można je znaleźć w naszych nowych zaleceniach. - pobierz
- Pobiera szczegółowe informacje o usłudze, aby je wyświetlić administratorowi firmy.
- getAppRestrictionsSchema
- Pobiera schemat definiujący właściwości możliwe do skonfigurowania tego produktu. Wszystkie usługi mają schemat, ale ten schemat może być pusty, jeśli nie zdefiniowano żadnych konfiguracji zarządzanych. Ten schemat może służyć do wypełniania interfejsu użytkownika, który pozwala administratorowi konfigurować usługę. Aby zastosować konfigurację zarządzaną na podstawie schematu uzyskanego za pomocą tego interfejsu API, przeczytaj sekcję Konfiguracje zarządzane w Google Play.
- getPermissions
- Pobiera uprawnienia aplikacji na Androida wymagane przez tę aplikację.
- list
- Wyszukuje zatwierdzone produkty pasujące do zapytania lub wszystkie zatwierdzone produkty, które pasują do zapytania. Uwaga: ten element został wycofany. Nowe integracje nie mogą korzystać z tej metody i można je znaleźć w naszych nowych zaleceniach.
- cofnij zatwierdzenie
- Cofa określony produkt (i odpowiednie uprawnienia aplikacji, jeśli istnieją) Uwaga: ten element został wycofany. Nowe integracje nie mogą korzystać z tej metody i można je znaleźć w naszych nowych zaleceniach.