Listę metod dla tego zasobu znajdziesz na końcu tej strony.
Reprezentacje 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 w jednej firmie – informacje o nich nie są dostępne poza tą firmą).
Informacje podane w przypadku każdej usługi (zlokalizowana nazwa, ikona, link do pełnej strony z informacjami w Google Play) pozwalają w podstawowy sposób przedstawić daną usługę w interfejsie usług 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 | Notatki |
---|---|---|---|
appRestrictionsSchema |
nested object |
Schemat ograniczeń aplikacji | |
appRestrictionsSchema.kind |
string |
Wycofano. |
|
appRestrictionsSchema.restrictions[] |
list |
Zbiór ograniczeń tworzących ten schemat. | |
appRestrictionsSchema.restrictions[].defaultValue |
nested object |
Domyślna wartość ograniczenia. Ograniczenia bundle i bundleArray nigdy nie mają wartości domyślnej. |
|
appRestrictionsSchema.restrictions[].defaultValue.type |
string |
Typ podanej wartości.
Akceptowane wartości to:
|
|
appRestrictionsSchema.restrictions[].defaultValue.valueBool |
boolean |
Wartość logiczna – występuje tylko wtedy, gdy typem jest 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ągu 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 ona widoczna w przypadku typów „ciąg znaków”, „wyboru” i „ukrycia”. | |
appRestrictionsSchema.restrictions[].description |
string |
Dłuższy opis ograniczenia zawierający więcej informacji na temat jego wpływu. | |
appRestrictionsSchema.restrictions[].entryValue[] |
list |
W przypadku ograniczeń choice lub multiselect lista możliwych wpisów możliwych do odczytania przez komputer. Tych wartości należy używać w konfiguracji jako pojedynczej wartości string w przypadku ograniczenia choice lub stringArray w przypadku ograniczenia multiselect . |
|
appRestrictionsSchema.restrictions[].entry[] |
list |
W przypadku ograniczeń choice lub multiselect lista możliwych wpisów możliwa do odczytania przez człowieka. |
|
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 zagnieżdżonych ograniczeń. Ograniczenie bundle jest zawsze umieszczone w ograniczeniu bundleArray , a ograniczenie bundleArray ma maksymalnie 2 poziomy. |
|
appRestrictionsSchema.restrictions[].restrictionType |
string |
Rodzaj ograniczenia.
Akceptowane wartości to:
|
|
appRestrictionsSchema.restrictions[].title |
string |
Nazwa ograniczenia. | |
appTracks[] |
list |
Ścieżki widoczne dla firmy. | |
appTracks[].trackAlias |
string |
Nazwa ścieżki, którą można zmienić. Jest to nazwa widoczna w Konsoli Play. | |
appTracks[].trackId |
string |
Unikalny identyfikator ścieżki, którego nie można zmienić. Ten identyfikator jest identyfikatorem ReleaseTrackId w adresie URL strony w Konsoli Play, na której są wyświetlane informacje o utworze. | |
appVersion[] |
list |
Wersje aplikacji dostępne obecnie dla tego produktu. | |
appVersion[].isProduction |
boolean |
Wartość to „prawda”, jeśli ta wersja jest produkcyjnym pakietem APK. | |
appVersion[].targetSdkVersion |
integer |
Wersja pakietu SDK, na którą kierowana jest ta aplikacja, określona w pliku manifestu pliku APK. Więcej informacji: http://developer.android.com/guide/topics/manifest/uses-sdk-element.html | |
appVersion[].track |
string |
Wycofano. Zamiast niego użyj zasady trackId .
Akceptowane wartości to:
|
|
appVersion[].trackId[] |
list |
Identyfikatory śledzenia, w których opublikowano wersję aplikacji. Zastępuje pole track (wycofane), ale nie zawiera ścieżki produkcyjnej (zamiast tego patrz isProduction ). |
|
appVersion[].versionCode |
integer |
Unikalny 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 wyglądać tak: „1.4”). | |
authorName |
string |
Imię i nazwisko autora produktu (np. dewelopera aplikacji). | |
availableCountries[] |
list |
Kraje, w których ta aplikacja jest dostępna. | |
availableTracks[] |
list |
Wycofano. Zamiast niego użyj zasady appTracks . |
|
category |
string |
Kategoria aplikacji (np. Wyścigi, SPOŁECZNOŚCIOWE itp.) | |
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 |
W jaki sposób i komu udostępniono pakiet. Wartość publicGoogleHosted oznacza, że pakiet jest dostępny w Sklepie Play, a nie tylko dla określonej firmy. Wartość privateGoogleHosted oznacza, że pakiet jest aplikacją prywatną (ograniczoną do użytku firmowego), ale hostowaną przez Google. Wartość privateSelfHosted oznacza, że pakiet jest aplikacją prywatną (ograniczoną do użytku firmowego) i hostowaną prywatnie.
Akceptowane wartości to:
|
|
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óre może zostać użyte jako ikona produktu. Ten obraz jest odpowiedni do wykorzystania w rozmiarze do 512 x 512 pikseli. | |
kind |
string |
||
lastUpdatedTimestampMillis |
long |
Przybliżony czas (w ciągu 7 dni) od ostatniego opublikowania aplikacji, wyrażony w milisekundach od początku epoki. | |
minAndroidSdkVersion |
integer |
Minimalny pakiet SDK na Androida 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 |
czy uprawnienia zostały zaakceptowane.
Akceptowane wartości to:
|
|
productId |
string |
Ciąg znaków w formacie app:<package name> . Na przykład app:com.google.android.gm oznacza aplikację Gmail. |
|
productPricing |
string |
Określa, czy produkt jest bezpłatny, bezpłatny z zakupami w aplikacji lub płatny. Jeśli cena nie jest znana, oznacza to, że produkt nie jest już ogólnie dostępny (mimo że nadal może być dostępny dla właścicieli tego produktu).
Akceptowane wartości to:
|
|
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żywany do podpisywania tej usługi. | |
signingCertificate.certificateHashSha1 |
string |
Skrót SHA1 certyfikatu zakodowany w standardzie base64. To pole zostało wycofane i zastąpione SHA2-256. Nie należy ich używać i możesz je w każdej chwili usunąć). |
|
signingCertificate.certificateHashSha256 |
string |
Zakodowany w base64 urlsafe SHA2-256 certyfikatu. | |
smallIconUrl |
string |
Link do mniejszego zdjęcia, które może zostać użyte jako ikona produktu. Ten obraz jest odpowiedni do wykorzystania 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 Google Enterprise. |
Metody
- zatwierdź
-
Zatwierdza określony produkt i odpowiednie uprawnienia aplikacji, jeśli takie istnieją. Maksymalna liczba produktów, które możesz zatwierdzić na klienta firmowego, to 1000.
Aby dowiedzieć się, jak za pomocą zarządzanego Sklepu Google Play zaprojektować i utworzyć układ sklepu do wyświetlania zatwierdzonych produktów użytkownikom, przeczytaj artykuł Projektowanie układu sklepu.
- generateApprovalUrl
- Generuje adres URL, który może być renderowany w elemencie iframe, aby wyświetlić ewentualne uprawnienia produktu. Administrator firmy musi wyświetlić te uprawnienia i zaakceptować je w imieniu organizacji, aby zatwierdzić daną usługę.
Administratorzy powinni zaakceptować wyświetlane uprawnienia, korzystając z oddzielnego elementu 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 URL-a można używać do wyświetlania uprawnień maksymalnie przez 1 dzień. - pobierz
- Pobiera szczegóły produktu w celu wyświetlenia administratorowi firmy.
- getAppRestrictionsSchema
- Pobiera schemat, który definiuje konfigurowalne właściwości tej usługi. Wszystkie produkty 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 umożliwia administratorowi konfigurowanie usługi. Aby zastosować konfigurację zarządzaną na podstawie schematu uzyskanego za pomocą tego interfejsu API, zapoznaj się z sekcją Konfiguracje zarządzane w Google Play.
- getPermissions
- Pobiera uprawnienia aplikacji na Androida wymagane przez tę aplikację.
- list
- Znajduje zatwierdzone produkty pasujące do zapytania lub wszystkie zatwierdzone produkty, jeśli nie ma zapytania.
- Cofnij akceptację
- Cofanie zatwierdzenia określonej usługi (oraz odpowiednich uprawnień aplikacji, jeśli takie istnieją)