Products

Untuk daftar metode untuk resource ini, lihat bagian akhir halaman ini.

Representasi resource

Resource Produk mewakili aplikasi di Google Play Store yang tersedia untuk setidaknya beberapa pengguna di perusahaan. (Beberapa aplikasi dibatasi untuk satu perusahaan, dan informasi tentang aplikasi tersebut tidak tersedia di luar perusahaan tersebut.)

Informasi yang diberikan untuk setiap produk (nama, ikon, link yang dilokalkan ke halaman detail Google Play lengkap) dimaksudkan untuk memungkinkan representasi dasar produk dalam antarmuka pengguna 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)
        ]
      }
    ]
  }
}
Nama properti Nilai Deskripsi Catatan
appRestrictionsSchema nested object Skema pembatasan aplikasi
appRestrictionsSchema.kind string Tidak digunakan lagi.

appRestrictionsSchema.restrictions[] list Kumpulan batasan yang membentuk skema ini.
appRestrictionsSchema.restrictions[].defaultValue nested object Nilai default pembatasan. Pembatasan bundle dan bundleArray tidak pernah memiliki nilai default.
appRestrictionsSchema.restrictions[].defaultValue.type string Jenis nilai yang diberikan.

Nilai yang dapat diterima:
  • "bool"
  • "bundle"
  • "bundleArray"
  • "choice"
  • "hidden"
  • "integer"
  • "multiselect"
  • "string"
appRestrictionsSchema.restrictions[].defaultValue.valueBool boolean Nilai boolean - ini hanya akan ada jika jenisnya bool.
appRestrictionsSchema.restrictions[].defaultValue.valueInteger integer Nilai bilangan bulat - ini hanya akan ada jika jenisnya adalah bilangan bulat.
appRestrictionsSchema.restrictions[].defaultValue.valueMultiselect[] list Daftar nilai string - ini hanya akan ada jika jenisnya multi-pilihan.
appRestrictionsSchema.restrictions[].defaultValue.valueString string Nilai string - ini akan ada untuk string jenis, pilihan, dan tersembunyi.
appRestrictionsSchema.restrictions[].description string Deskripsi yang lebih lengkap tentang pembatasan, yang memberikan detail lebih lanjut tentang apa yang terpengaruh.
appRestrictionsSchema.restrictions[].entryValue[] list Untuk batasan choice atau multiselect, daftar kemungkinan nilai entri yang dapat dibaca mesin. Nilai ini harus digunakan dalam konfigurasi, baik sebagai nilai string tunggal untuk pembatasan choice atau dalam stringArray untuk batasan multiselect.
appRestrictionsSchema.restrictions[].entry[] list Untuk batasan choice atau multiselect, daftar kemungkinan nama entri yang dapat dibaca manusia.
appRestrictionsSchema.restrictions[].key string Kunci unik yang digunakan produk untuk mengidentifikasi pembatasan, misalnya "com.google.android.gm.fieldname".
appRestrictionsSchema.restrictions[].nestedRestriction[] list Daftar pembatasan bertingkat untuk bundle atau bundleArray. Batasan bundle selalu disusun bertingkat dalam batasan bundleArray, dan batasan bundleArray memiliki kedalaman maksimum dua level.
appRestrictionsSchema.restrictions[].restrictionType string Jenis pembatasan.

Nilai yang dapat diterima:
  • "bool"
  • "bundle"
  • "bundleArray"
  • "choice"
  • "hidden"
  • "integer"
  • "multiselect"
  • "string"
appRestrictionsSchema.restrictions[].title string Nama pembatasan.
appTracks[] list Jalur yang dapat dilihat oleh perusahaan.
appTracks[].trackAlias string Nama trek yang dapat diubah. Ini adalah nama yang terlihat di Konsol Play.
appTracks[].trackId string ID trek unik yang tidak dapat diubah. ID ini adalah releaseTrackId dalam URL halaman Konsol Play yang menampilkan informasi jalur.
appVersion[] list Versi aplikasi saat ini tersedia untuk produk ini.
appVersion[].isProduction boolean True jika versi ini adalah APK produksi.
appVersion[].targetSdkVersion integer Versi SDK yang ditargetkan aplikasi ini, seperti yang ditentukan dalam manifes APK. Lihat http://developer.android.com/guide/topics/manifes/uses-sdk-element.html
appVersion[].track string Tidak digunakan lagi, gunakan trackId sebagai gantinya.

Nilai yang dapat diterima:
  • "alpha"
  • "beta"
  • "production"
appVersion[].trackId[] list Melacak ID tempat versi aplikasi dipublikasikan. Mengganti kolom track (tidak digunakan lagi), tetapi tidak menyertakan jalur produksi (lihat isProduction sebagai gantinya).
appVersion[].versionCode integer ID unik yang meningkat untuk versi aplikasi.
appVersion[].versionString string String yang digunakan di Play Store oleh developer aplikasi untuk mengidentifikasi versi. String belum tentu unik atau dilokalkan (misalnya, string dapat berupa "1.4").
authorName string Nama penulis produk (misalnya, developer aplikasi).
availableCountries[] list Negara tempat aplikasi ini tersedia.
availableTracks[] list Tidak digunakan lagi, gunakan appTracks sebagai gantinya.
category string Kategori aplikasi (misalnya, RACING, SOSIAL, dll.)
contentRating string Rating konten untuk aplikasi ini.

Nilai yang dapat diterima:
  • "all"
  • "mature"
  • "preTeen"
  • "teen"
description string Deskripsi promosi yang dilokalkan, jika tersedia.
detailsUrl string Link ke halaman detail Google Play (konsumen) untuk produk.
distributionChannel string Bagaimana dan kepada siapa paket tersebut tersedia. Nilai publicGoogleHosted berarti bahwa paket tersedia melalui Play Store dan tidak terbatas untuk perusahaan tertentu. Nilai privateGoogleHosted berarti bahwa paket ini adalah aplikasi pribadi (dibatasi untuk perusahaan), tetapi dihosting oleh Google. Nilai privateSelfHosted berarti bahwa paket ini adalah aplikasi pribadi (dibatasi untuk perusahaan) dan dihosting secara pribadi.

Nilai yang dapat diterima:
  • "privateGoogleHosted"
  • "privateSelfHosted"
  • "publicGoogleHosted"
features[] list Fitur penting (jika ada) dari produk ini.
fullDescription string Deskripsi app store lengkap yang dilokalkan, jika tersedia.
iarcGenericRating string Rating konten untuk aplikasi ini.

Nilai yang dapat diterima:
  • "eighteenYears"
  • "iarcGenericRatingUnspecified"
  • "sevenYears"
  • "sixteenYears"
  • "threeYears"
  • "twelveYears"
iconUrl string Link ke gambar yang dapat digunakan sebagai ikon produk. Gambar ini cocok untuk digunakan pada ukuran hingga 512 x 512 piksel.
kind string
lastUpdatedTimestampMillis long Perkiraan waktu (dalam 7 hari) terakhir kali aplikasi dipublikasikan, dinyatakan dalam milidetik sejak epoch.
minAndroidSdkVersion integer Android SDK minimum yang diperlukan untuk menjalankan aplikasi.
permissions[] list Daftar izin yang diperlukan oleh aplikasi.
permissions[].permissionId string String buram yang mengidentifikasi izin secara unik.
permissions[].state string Apakah izin telah diterima atau belum.

Nilai yang dapat diterima:
  • "accepted"
  • "required"
productId string String bentuk app:<package name>. Misalnya, app:com.google.android.gm mewakili aplikasi Gmail.
productPricing string Apakah produk ini gratis, gratis dengan pembelian dalam aplikasi, atau berbayar. Jika harganya tidak diketahui, artinya produk tersebut tidak tersedia secara umum lagi (meskipun mungkin masih tersedia bagi pemiliknya).

Nilai yang dapat diterima:
  • "free"
  • "freeWithInAppPurchase"
  • "paid"
recentChanges string Deskripsi perubahan terbaru yang dibuat pada aplikasi.
requiresContainerApp boolean Tidak digunakan lagi.
screenshotUrls[] list Daftar link screenshot yang mewakili aplikasi.
signingCertificate nested object Sertifikat yang digunakan untuk menandatangani produk ini.
signingCertificate.certificateHashSha1 string Hash SHA1 yang dienkode base64 urlsafe dari sertifikat. (Kolom ini tidak digunakan lagi dan akan digantikan dengan SHA2-256. Kolom tersebut tidak boleh digunakan dan dapat dihapus kapan saja.)

signingCertificate.certificateHashSha256 string Hash SHA2-256 yang dienkode base64 urlsafe untuk sertifikat.
smallIconUrl string Link ke gambar yang lebih kecil yang dapat digunakan sebagai ikon produk. Gambar ini cocok untuk digunakan hingga 128 x 128 piksel.
title string Nama produk.
workDetailsUrl string Link ke halaman detail Google Play terkelola untuk produk, untuk digunakan oleh admin Perusahaan.

Metode

setujui

Menyetujui produk yang ditentukan dan izin aplikasi yang relevan, jika ada. Jumlah maksimum produk yang dapat Anda setujui per pelanggan perusahaan adalah 1.000.

Untuk mempelajari cara menggunakan Google Play terkelola untuk mendesain dan membuat tata letak toko guna menampilkan produk yang disetujui kepada pengguna, lihat Desain Tata Letak Play Store.

generateApprovalUrl
Membuat URL yang dapat dirender dalam iframe untuk menampilkan izin (jika ada) produk. Admin perusahaan harus melihat izin ini dan menyetujuinya atas nama organisasinya agar dapat menyetujui produk tersebut.

Admin harus menerima izin yang ditampilkan dengan berinteraksi dengan elemen UI terpisah di konsol EMM, yang akan memicu penggunaan URL ini sebagai properti approvalUrlInfo.approvalUrl dalam panggilan Products.approve untuk menyetujui produk. URL ini hanya bisa digunakan untuk menampilkan izin selama maksimal 1 hari.
dapatkan
Mengambil detail produk untuk ditampilkan kepada admin perusahaan.
getAppRestrictionsSchema
Mengambil skema yang menentukan properti yang dapat dikonfigurasi untuk produk ini. Semua produk memiliki skema, tetapi skema ini dapat kosong jika konfigurasi terkelola belum ditentukan. Skema ini dapat digunakan untuk mengisi UI yang memungkinkan admin mengonfigurasi produk. Untuk menerapkan konfigurasi terkelola berdasarkan skema yang diperoleh menggunakan API ini, lihat Konfigurasi Terkelola melalui Play.
getPermissions
Mengambil izin aplikasi Android yang diperlukan oleh aplikasi ini.
list
Menemukan produk yang disetujui yang cocok dengan kueri, atau semua produk yang disetujui jika tidak ada kueri.
batalkan persetujuan
Membatalkan persetujuan produk yang ditentukan (dan izin aplikasi yang relevan, jika ada)