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 Uwagi
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 pozycji czytelne dla komputera. 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 pozycji zrozumiałe dla człowieka.
appRestrictionsSchema.restrictions[].key string Unikalny klucz używany przez usługę do identyfikacji 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 aplikacji.

Akceptowane wartości to:
  • „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 aplikacji.

Akceptowane wartości to:
  • „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 każdego klienta korporacyjnego wynosi 1000.

Dowiedz się, jak zaprojektować i utworzyć sklep w zarządzanym Sklepie Google Play. układ tak, aby wyświetlać zatwierdzone produkty użytkownikom, Więcej informacji: Store Layout Design.

generateApprovalUrl
Generuje adres URL, który może być renderowany w elemencie iframe w celu wyświetlenia ewentualne uprawnienia do usługi. Administrator firmy musi je wyświetlić uprawnień i akceptować je w imieniu swojej organizacji w celu aby zatwierdzić dany produkt.

Administratorzy powinni zaakceptować wyświetlane uprawnienia do wchodzą w interakcję z osobnym elementem interfejsu konsoli EMM, co z kolei powinien wywoływać użycie tego adresu URL jako właściwość approvalUrlInfo.approvalUrl w Products.approve zadzwoń do zatwierdzenia produktu. 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 tego elementu usługi. Wszystkie produkty mają schemat, ale jeśli go nie, ten schemat może być pusty Zdefiniowano konfiguracje zarządzane. Tego schematu można użyć do: wypełniają interfejs użytkownika, który umożliwia administratorowi konfigurowanie usługi. Aby zastosować konfigurację zarządzaną na podstawie schematu uzyskanego za pomocą tego API, patrz 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. w przypadku braku zapytania.
Cofnij akceptację
Cofnie zatwierdzenie określonego produktu (oraz odpowiednich uprawnień aplikacji, jeśli dotyczy)