Products

Untuk daftar metode untuk resource ini, lihat 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 tidak ada informasi tentangnya yang tersedia di luar perusahaan tersebut.)

Informasi yang diberikan untuk setiap produk (nama yang dilokalkan, ikon, link 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 Notes
appRestrictionsSchema nested object Skema pembatasan aplikasi
appRestrictionsSchema.kind string Tidak digunakan lagi.

appRestrictionsSchema.restrictions[] list Serangkaian 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 adalah:
  • "bool"
  • "bundle"
  • "bundleArray"
  • "choice"
  • "hidden"
  • "integer"
  • "multiselect"
  • "string"
appRestrictionsSchema.restrictions[].defaultValue.valueBool boolean Nilai boolean - ini hanya akan ada jika jenis bool.
appRestrictionsSchema.restrictions[].defaultValue.valueInteger integer Nilai bilangan bulat - ini hanya akan ada jika jenisnya bilangan bulat.
appRestrictionsSchema.restrictions[].defaultValue.valueMultiselect[] list Daftar nilai string - ini hanya akan ada jika jenisnya adalah 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 panjang 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 batasan choice maupun di 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 Untuk pembatasan bundle atau bundleArray, daftar pembatasan bertingkat. Batasan bundle selalu disusun bertingkat dalam batasan bundleArray, dan batasan bundleArray maksimal dua tingkat.
appRestrictionsSchema.restrictions[].restrictionType string Jenis pembatasan.

Nilai yang dapat diterima adalah:
  • "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 yang dapat diubah untuk trek. Nama ini dapat dilihat di Konsol Play.
appTracks[].trackId string ID trek unik yang tidak dapat diubah. ID ini adalah releaseTrackId di URL halaman konsol developer Play yang menampilkan informasi jalur.
appVersion[] list Versi aplikasi yang 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/manifest/uses-sdk-element.html
appVersion[].track string Tidak digunakan lagi, gunakan trackId sebagai gantinya.

Nilai yang dapat diterima adalah:
  • "alpha"
  • "beta"
  • "production"
appVersion[].trackId[] list ID pelacakan tempat versi aplikasi dipublikasikan. Mengganti kolom track (tidak digunakan lagi), tetapi tidak menyertakan jalur produksi (sebagai gantinya, lihat isProduction).
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 tidak harus unik atau dilokalkan (misalnya, string bisa 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, BALAP, SOSIAL, dll.)
contentRating string Rating konten untuk aplikasi ini.

Nilai yang dapat diterima adalah:
  • "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 disediakan. Nilai publicGoogleHosted berarti bahwa paket tersedia melalui Play Store dan tidak terbatas untuk perusahaan tertentu. Nilai privateGoogleHosted berarti bahwa paket tersebut adalah aplikasi pribadi (dibatasi untuk perusahaan), tetapi dihosting oleh Google. Nilai privateSelfHosted berarti bahwa paket tersebut adalah aplikasi pribadi (dibatasi untuk perusahaan) dan dihosting secara pribadi.

Nilai yang dapat diterima adalah:
  • "privateGoogleHosted"
  • "privateSelfHosted"
  • "publicGoogleHosted"
features[] list Fitur yang 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 adalah:
  • "eighteenYears"
  • "iarcGenericRatingUnspecified"
  • "sevenYears"
  • "sixteenYears"
  • "threeYears"
  • "twelveYears"
iconUrl string Link ke gambar yang dapat digunakan sebagai ikon produk. Gambar ini cocok digunakan dengan ukuran hingga 512x512 piksel.
kind string
lastUpdatedTimestampMillis long Perkiraan waktu (dalam 7 hari) aplikasi terakhir 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 adalah:
  • "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 lagi tersedia (meskipun mungkin masih tersedia untuk orang yang memilikinya).

Nilai yang dapat diterima adalah:
  • "free"
  • "freeWithInAppPurchase"
  • "paid"
recentChanges string Deskripsi perubahan terbaru yang dilakukan 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 digantikan dengan SHA2-256. Konten ini tidak boleh digunakan dan dapat dihapus kapan saja.)

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

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 guna mendesain dan membuat tata letak toko guna menampilkan produk yang disetujui kepada pengguna, lihat Desain Tata Letak Toko.

Catatan: Item ini sudah tidak digunakan lagi. Integrasi baru tidak dapat menggunakan metode ini dan dapat merujuk ke rekomendasi baru kami.
generateApprovalUrl
Menghasilkan 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 menyetujui izin yang ditampilkan dengan berinteraksi dengan elemen UI terpisah di konsol EMM, yang pada akhirnya akan memicu penggunaan URL ini sebagai properti approvalUrlInfo.approvalUrl dalam panggilan Products.approve untuk menyetujui produk. URL ini hanya dapat digunakan untuk menampilkan izin hingga 1 hari. Catatan: Item ini sudah tidak digunakan lagi. Integrasi baru tidak dapat menggunakan metode ini dan dapat merujuk ke rekomendasi baru kami.
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 mungkin kosong jika tidak ada konfigurasi terkelola yang 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. Catatan: Item ini sudah tidak digunakan lagi. Integrasi baru tidak dapat menggunakan metode ini dan dapat merujuk ke rekomendasi baru kami.
batalkan persetujuan
Membatalkan persetujuan produk yang ditentukan (dan izin aplikasi yang relevan, jika ada) Catatan: Item ini sudah tidak digunakan lagi. Integrasi baru tidak dapat menggunakan metode ini dan dapat merujuk ke rekomendasi baru kami.