Products

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:
  • "bool"
  • "bundle"
  • "bundleArray"
  • "choice"
  • "hidden"
  • "integer"
  • "multiselect"
  • "string"
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:
  • "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 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:
  • "alpha"
  • "beta"
  • "production"
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:
  • "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 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:
  • "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ó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:
  • "accepted"
  • "required"
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:
  • "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ż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ści approvalUrlInfo.approvalUrl w wywołaniu Products.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ą)