Products

Bu kaynağa ilişkin yöntemlerin listesi için bu sayfanın sonuna bakın.

Kaynak temsilleri

Ürünler kaynağı, Google Play Store'da yer alan ve kuruluştaki en azından bazı kullanıcıların kullanımına sunulan bir uygulamayı temsil eder. (Bazı uygulamalar tek bir kuruluşla sınırlandırılmıştır ve ilgili kuruluşun dışında bunlarla ilgili bilgi sunulmaz.)

Her ürün için sağlanan bilgiler (yerelleştirilmiş ad, simge, Google Play'deki tam ayrıntılar sayfasının bağlantısı), ürünün EMM kullanıcı arayüzünde temel bir temsiline imkan tanımak amacıyla hazırlanmıştır.



{
  "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)
        ]
      }
    ]
  }
}
Mülk adı Değer Açıklama Notlar
appRestrictionsSchema nested object Uygulama kısıtlama şeması
appRestrictionsSchema.kind string Kullanımdan kaldırıldı.

appRestrictionsSchema.restrictions[] list Bu şemayı oluşturan kısıtlamalar grubu.
appRestrictionsSchema.restrictions[].defaultValue nested object Kısıtlamanın varsayılan değeri. bundle ve bundleArray kısıtlamalarının hiçbir zaman varsayılan değeri olmaz.
appRestrictionsSchema.restrictions[].defaultValue.type string Sağlanan değerin türü.

Kabul edilebilir değerler şunlardır:
  • "bool"
  • "bundle"
  • "bundleArray"
  • "choice"
  • "hidden"
  • "integer"
  • "multiselect"
  • "string"
appRestrictionsSchema.restrictions[].defaultValue.valueBool boolean Boole değeri: Bu değer yalnızca tür bool olduğunda görünür.
appRestrictionsSchema.restrictions[].defaultValue.valueInteger integer Tam sayı değeri: Bu değer, yalnızca tür tam sayıysa mevcut olur.
appRestrictionsSchema.restrictions[].defaultValue.valueMultiselect[] list Dize değerleri listesi: Bu liste yalnızca tür çoklu seçim ise görüntülenir.
appRestrictionsSchema.restrictions[].defaultValue.valueString string Dize değeri: Bu; dize, seçim ve gizli türleri için sunulacaktır.
appRestrictionsSchema.restrictions[].description string Kısıtlamanın neden etkilendiğine dair daha fazla ayrıntı veren, daha uzun bir açıklama.
appRestrictionsSchema.restrictions[].entryValue[] list choice veya multiselect kısıtlamaları için olası girişlerin makine tarafından okunabilir değerlerinin listesi. Bu değerler yapılandırmada choice kısıtlaması için tek bir string değeri veya multiselect kısıtlaması için stringArray değeri olarak kullanılmalıdır.
appRestrictionsSchema.restrictions[].entry[] list choice veya multiselect kısıtlamaları için olası girişlerin kullanıcılar tarafından okunabilir adlarının listesi.
appRestrictionsSchema.restrictions[].key string Ürünün kısıtlamayı tanımlamak için kullandığı benzersiz anahtar, ör. "com.google.android.gm.fieldname".
appRestrictionsSchema.restrictions[].nestedRestriction[] list bundle veya bundleArray kısıtlamaları için iç içe yerleştirilmiş kısıtlamaların listesi. bundle kısıtlaması her zaman bundleArray kısıtlamasının içine yerleştirilir ve bundleArray kısıtlaması en fazla iki düzey derinliğindedir.
appRestrictionsSchema.restrictions[].restrictionType string Kısıtlamanın türü.

Kabul edilebilir değerler şunlardır:
  • "bool"
  • "bundle"
  • "bundleArray"
  • "choice"
  • "hidden"
  • "integer"
  • "multiselect"
  • "string"
appRestrictionsSchema.restrictions[].title string Kısıtlamanın adı.
appTracks[] list Kuruluşun görebildiği parçalar.
appTracks[].trackAlias string Bir parça için değiştirilebilir ad. Bu, Play Console'da görünen addır.
appTracks[].trackId string Değiştirilemez, benzersiz parça tanımlayıcısı. Bu tanımlayıcı, Play Developer Console sayfasının URL'sinde parça bilgilerini gösteren publishTrackId'dir.
appVersion[] list Bu ürün için şu anda kullanılabilen uygulama sürümleri.
appVersion[].isProduction boolean Bu sürüm bir üretim APK'sıysa doğru değerini alır.
appVersion[].targetSdkVersion integer APK'nın manifest dosyasında belirtildiği şekilde, bu uygulamanın hedeflediği SDK sürümü. http://developer.android.com/guide/topics/manifest/uses-sdk-element.html adresine bakın.
appVersion[].track string Kullanımdan kaldırıldı, bunun yerine trackId kullanın.

Kabul edilebilir değerler şunlardır:
  • "alpha"
  • "beta"
  • "production"
appVersion[].trackId[] list Uygulama sürümünün yayınlandığı izleme kimlikleri. track alanını değiştirir (kullanımdan kaldırıldı), ancak üretim kanalını içermez (bunun yerine isProduction adresine bakın).
appVersion[].versionCode integer Uygulama sürümü için artan benzersiz tanımlayıcı.
appVersion[].versionString string Uygulama geliştirici tarafından Play Store'da sürümü tanımlamak için kullanılan dize. Dizenin benzersiz veya yerel olması gerekmez (örneğin, dize "1.4" olabilir).
authorName string Ürünü yazan kişinin adı (örneğin, uygulama geliştirici).
availableCountries[] list Bu uygulamanın kullanılabildiği ülkeler.
availableTracks[] list Kullanımdan kaldırıldı, bunun yerine appTracks kullanın.
category string Uygulama kategorisi (ör. YARIŞ, SOSYAL vb.)
contentRating string Bu uygulama için içerik derecelendirmesi.

Kabul edilebilir değerler şunlardır:
  • "all"
  • "mature"
  • "preTeen"
  • "teen"
description string Varsa yerelleştirilmiş tanıtım açıklaması
detailsUrl string Ürünün (tüketici) Google Play ayrıntıları sayfasının bağlantısı.
distributionChannel string Paketin nasıl ve kime sunulduğu. publicGoogleHosted değeri, paketin Play Store'da mevcut olduğu ve belirli bir kuruluşla sınırlı olmadığı anlamına gelir. privateGoogleHosted değeri, paketin Google tarafından barındırılan özel bir uygulama (bir kuruluşla kısıtlanmış) olduğu anlamına gelir. privateSelfHosted değeri, paketin özel bir uygulama (bir kuruluşla sınırlıdır) olduğu ve gizli olarak barındırıldığı anlamına gelir.

Kabul edilebilir değerler şunlardır:
  • "privateGoogleHosted"
  • "privateSelfHosted"
  • "publicGoogleHosted"
features[] list Bu ürünün önemli özellikleri (varsa).
fullDescription string Yerelleştirilmiş tam uygulama mağazası açıklaması (varsa).
iarcGenericRating string Bu uygulama için içerik derecelendirmesi.

Kabul edilebilir değerler şunlardır:
  • "eighteenYears"
  • "iarcGenericRatingUnspecified"
  • "sevenYears"
  • "sixteenYears"
  • "threeYears"
  • "twelveYears"
iconUrl string Ürünün simgesi olarak kullanılabilecek bir resmin bağlantısı. Bu resim, en fazla 512 piksel x 512 pikselde kullanıma uygundur.
kind string
lastUpdatedTimestampMillis long Uygulamanın en son yayınlandığı yaklaşık süre (7 gün içinde). Dönemden bu yana milisaniye cinsinden ifade edilir.
minAndroidSdkVersion integer Uygulamayı çalıştırmak için gereken minimum Android SDK'sı.
permissions[] list Uygulamanın gerektirdiği izinlerin listesi.
permissions[].permissionId string İzni benzersiz şekilde tanımlayan opak bir dize.
permissions[].state string İznin kabul edilip edilmediği.

Kabul edilebilir değerler şunlardır:
  • "accepted"
  • "required"
productId string app:<package name> biçiminde bir dize. Örneğin app:com.google.android.gm simgesi Gmail uygulamasını temsil eder.
productPricing string Bu ürünün ücretsiz, uygulama içi satın alma olanağı sunan ücretsiz veya ücretli olup olmadığı. Fiyatlandırma bilinmiyorsa bu durum, ürünün artık genel olarak satışa sunulmadığı anlamına gelir (ürünün sahibi olan kullanıcılar tarafından hâlâ mevcut olsa bile).

Kabul edilebilir değerler şunlardır:
  • "free"
  • "freeWithInAppPurchase"
  • "paid"
recentChanges string Uygulamada yapılan son değişikliklerin açıklaması.
requiresContainerApp boolean Kullanımdan kaldırıldı.
screenshotUrls[] list Uygulamayı temsil eden ekran görüntüsü bağlantılarının bir listesi.
signingCertificate nested object Bu ürünü imzalamak için kullanılan sertifika.
signingCertificate.certificateHashSha1 string Sertifikanın base64 urlsafe olarak kodlanmış SHA1 karması. (Bu alan, SHA2-256 olması için kullanımdan kaldırılmıştır. Bu bağlantı kullanılmamalıdır ve herhangi bir zamanda kaldırılabilir.)

signingCertificate.certificateHashSha256 string Sertifikanın base64 urlsafe olarak kodlanmış SHA2-256 karması.
smallIconUrl string Ürünün simgesi olarak kullanılabilecek daha küçük bir resmin bağlantısı. Bu resim, en fazla 128 piksel x 128 pikselde kullanıma uygundur.
title string Ürünün adı.
workDetailsUrl string Ürünün Enterprise yöneticisi tarafından kullanılması için Managed Google Play ayrıntılar sayfasının bağlantısı.

Yöntemler

onaylamak

Belirtilen ürünü ve varsa ilgili uygulama izinlerini onaylar. Kurumsal müşteri başına onaylayabileceğiniz maksimum ürün sayısı 1.000'dir.

Onaylı ürünleri kullanıcılarınıza göstermek amacıyla mağaza düzeni tasarlayıp oluşturmak için Managed Google Play'i nasıl kullanacağınızı öğrenmek için Mağaza Düzeni Tasarımı konusuna bakın.

Not: Bu öğe kullanımdan kaldırıldı. Yeni entegrasyonlar bu yöntemi kullanamaz ve yeni önerilerimize başvurabilir.
generateApprovalUrl
Bir ürünün izinlerini (varsa) görüntülemek için iframe'de oluşturulabilecek bir URL oluşturur. Kuruluş yöneticisi, ürünü onaylamak için bu izinleri görüntülemeli ve kuruluşu adına kabul etmelidir.

Yöneticiler, EMM konsolunda ayrı bir kullanıcı arayüzü öğesiyle etkileşime geçerek görüntülenen izinleri kabul etmelidir. Ardından, bu URL'nin ürünü onaylamak için bir Products.approve çağrısında approvalUrlInfo.approvalUrl özelliği olarak kullanılması gerekir. Bu URL yalnızca en fazla 1 günlük izinleri görüntülemek için kullanılabilir. Not: Bu öğe kullanımdan kaldırıldı. Yeni entegrasyonlar bu yöntemi kullanamaz ve yeni önerilerimize başvurabilir.
al
Kuruluş yöneticisine göstermek üzere bir ürünün ayrıntılarını alır.
getAppRestrictionsSchema
Bu ürünün yapılandırılabilir özelliklerini tanımlayan şemayı alır. Tüm ürünlerin bir şeması vardır ancak yönetilen yapılandırma tanımlanmamışsa bu şema boş olabilir. Bu şema, yöneticinin ürünü yapılandırmasına olanak tanıyan bir kullanıcı arayüzünü doldurmak için kullanılabilir. Bu API kullanılarak edinilen şemaya dayalı bir yönetilen yapılandırma uygulamak için Play üzerinden yönetilen yapılandırmalar bölümüne göz atın.
getPermissions
Bu uygulama için gereken Android uygulama izinlerini alır.
list
Bir sorguyla eşleşen onaylanmış ürünleri veya sorgu yoksa onaylanmış tüm ürünleri bulur. Not: Bu öğe kullanımdan kaldırıldı. Yeni entegrasyonlar bu yöntemi kullanamaz ve yeni önerilerimize başvurabilir.
onaylama
Belirtilen ürünün (ve varsa ilgili uygulama izinleri) onayını kaldırır Not: Bu öğe kullanımdan kaldırıldı. Yeni entegrasyonlar bu yöntemi kullanamaz ve yeni önerilerimize başvurabilir.