Products

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: "bool" "bundle" "bundleArray" "choice" "hidden" "integer" "multiselect" "string"
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: "bool" "bundle" "bundleArray" "choice" "hidden" "integer" "multiselect" "string"
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: "alpha" "beta" "production"
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: "all" "mature" "preTeen" "teen"
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: "privateGoogleHosted" "privateSelfHosted" "publicGoogleHosted"
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: "eighteenYears" "iarcGenericRatingUnspecified" "sevenYears" "sixteenYears" "threeYears" "twelveYears"
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: "accepted" "required"
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: "free" "freeWithInAppPurchase" "paid"
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ści approvalUrlInfo.approvalUrl w wywołaniu Products.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.