Products

如需本資源的方法清單,請見本頁結尾。

資源表示法

「產品」資源代表 Google Play 商店中的應用程式,至少有部分企業使用者可用。(某些應用程式僅限單一企業使用,所以我們不會向該企業以外的使用者提供這類應用程式的相關資訊)。

每項產品提供的資訊 (本地化名稱、圖示、完整的 Google Play 詳細資料頁面連結) 都有助於 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)
        ]
      }
    ]
  }
}
屬性名稱 說明 附註
appRestrictionsSchema nested object 應用程式限制結構定義
appRestrictionsSchema.kind string 已淘汰。

appRestrictionsSchema.restrictions[] list 構成這個結構定義的限制組合。
appRestrictionsSchema.restrictions[].defaultValue nested object 限制的預設值。bundlebundleArray 限制一律沒有預設值。
appRestrictionsSchema.restrictions[].defaultValue.type string 提供的值類型。

可接受的值為:
  • bool
  • bundle
  • bundleArray
  • choice
  • hidden
  • integer
  • multiselect
  • string
appRestrictionsSchema.restrictions[].defaultValue.valueBool boolean 布林值 - 只有在類型為 bool 時才會出現。
appRestrictionsSchema.restrictions[].defaultValue.valueInteger integer 整數值 - 只有在類型為整數時才會顯示這個值。
appRestrictionsSchema.restrictions[].defaultValue.valueMultiselect[] list 字串值清單:只有在類型為複選時才會顯示。
appRestrictionsSchema.restrictions[].defaultValue.valueString string 字串值 - 會顯示在類型字串、選項和隱藏中。
appRestrictionsSchema.restrictions[].description string 較長的限制說明,並詳細說明限制的影響。
appRestrictionsSchema.restrictions[].entryValue[] list 如果是 choicemultiselect 限制,則會列出可能的項目機器可讀取的值這些值應用於設定,不論是 choice 限制的單一 string 值,還是 multiselect 限制的 stringArray 中皆可使用。
appRestrictionsSchema.restrictions[].entry[] list 如果是 choicemultiselect 限制,則會列出可能的項目人類可讀的名稱
appRestrictionsSchema.restrictions[].key string 產品用來識別限制的專屬金鑰,例如「com.google.android.gm.fieldname」。
appRestrictionsSchema.restrictions[].nestedRestriction[] list 如果是 bundlebundleArray 限制,則會列出巢狀限制清單。bundle 限制一律以巢狀形式置於 bundleArray 限制中,bundleArray 限制則最多為兩個層級。
appRestrictionsSchema.restrictions[].restrictionType string 限制的類型。

可接受的值為:
  • bool
  • bundle
  • bundleArray
  • choice
  • hidden
  • integer
  • multiselect
  • string
appRestrictionsSchema.restrictions[].title string 限制的名稱。
appTracks[] list 企業可以看到這些足跡。
appTracks[].trackAlias string 可修改音軌的名稱。這個名稱會顯示在 Play 管理中心。
appTracks[].trackId string 專屬曲目 ID 無法變更。這個識別碼是 Play 管理中心網頁中顯示測試群組資訊的 releaseTrackId。
appVersion[] list 這項產品目前可用的應用程式版本。
appVersion[].isProduction boolean 如果這個版本是正式版 APK,則為「true」。
appVersion[].targetSdkVersion integer 這個應用程式指定的 SDK 版本 (與 APK 資訊清單中指定的版本相同)。詳情請參閱 http://developer.android.com/guide/topics/manifest/uses-sdk-element.html
appVersion[].track string 已淘汰,請改用 trackId

可接受的值為:
  • alpha
  • beta
  • production
appVersion[].trackId[] list 發布應用程式版本的追蹤 ID。取代 track 欄位 (已淘汰),但不會包含正式版群組 (請改為參閱 isProduction)。
appVersion[].versionCode integer 應用程式版本的專屬遞增 ID。
appVersion[].versionString string 應用程式開發人員在 Play 商店使用的字串,用於識別版本。這個字串不一定不重複或經過本地化 (例如字串可以是「1.4」)。
authorName string 商品作者的名稱 (例如應用程式開發人員)。
availableCountries[] list 此應用程式的適用國家/地區。
availableTracks[] list 已淘汰,請改用 appTracks
category string 應用程式類別 (例如 RACING、SOCIAL 等)
contentRating string 這個應用程式的內容分級。

可接受的值為:
  • all
  • mature
  • preTeen
  • teen
description string 本地化的宣傳說明 (如有)。
detailsUrl string 產品的 Google Play (消費者) 詳細資料頁面連結。
distributionChannel string 套件的供應方式和對象。publicGoogleHosted 值表示套件可透過 Play 商店取得,而不僅限特定企業使用。privateGoogleHosted 值表示套件是私人應用程式 (僅限企業),但由 Google 代管。值 privateSelfHosted 表示套件是私人應用程式 (僅限企業使用) 且是私人代管。

可接受的值為:
  • privateGoogleHosted
  • privateSelfHosted
  • publicGoogleHosted
features[] list 這項產品值得注意的功能 (如有)。
fullDescription string 本地化的完整應用程式商店說明 (如有)。
iarcGenericRating string 這個應用程式的內容分級。

可接受的值為:
  • eighteenYears
  • iarcGenericRatingUnspecified
  • sevenYears
  • sixteenYears
  • threeYears
  • twelveYears
iconUrl string 可當做產品圖示的圖片連結。此圖片的大小上限為 512 x 512 像素。
kind string
lastUpdatedTimestampMillis long 應用程式上次發布後的大致時間 (在 7 天內),以 Epoch 紀元時間起算的毫秒數表示。
minAndroidSdkVersion integer 執行應用程式所需的最低 Android SDK 版本。
permissions[] list 應用程式要求的權限清單。
permissions[].permissionId string 用來識別權限的不透明字串。
permissions[].state string 權限是否已接受。

可接受的值為:
  • accepted
  • required
productId string 格式為 app:<package name> 的字串。舉例來說,app:com.google.android.gm 代表 Gmail 應用程式。
productPricing string 產品狀態為免費、免費且包含應用程式內購項目,還是付費商品。如果價格不明,代表該產品並未全面開放購買 (即使擁有該產品的使用者仍可能能購買)。

可接受的值為:
  • free
  • freeWithInAppPurchase
  • paid
recentChanges string 應用程式近期變更的說明。
requiresContainerApp boolean 已淘汰。
screenshotUrls[] list 代表應用程式的螢幕截圖連結清單。
signingCertificate nested object 用來簽署這項產品的憑證。
signingCertificate.certificateHashSha1 string 憑證的 Base64 網址安全編碼 SHA1 雜湊。(這個欄位已淘汰,並改用 SHA2-256。請勿使用,且隨時可以移除。

signingCertificate.certificateHashSha256 string 採用 Base64 網址安全編碼憑證的 SHA2-256 雜湊。
smallIconUrl string 可用來做為產品圖示的小型圖片連結。此圖片的尺寸上限為 128 x 128 像素。
title string 產品名稱。
workDetailsUrl string 可供企業管理員使用的產品 Google Play 管理版詳細資料頁面連結。

方法

核准

核准指定產品及相關應用程式權限 (如有)。 每位企業客戶可核准的產品數量上限 1,000 次

瞭解如何使用 Google Play 管理版設計及建立商店 以便向使用者顯示已核准的產品, 請參閱「儲存版面配置設計」。

generateApprovalUrl
產生可在 iframe 中顯示的網址,以顯示 權限 (如果有的話)。企業管理員必須查看 並代表其所屬機構接受這些權限 核准該產品

管理員應由下列員工接受顯示的權限: 與 EMM 控制台中的個別 UI 元素互動 會觸發將這個網址做為 approvalUrlInfo.approvalUrl 房源 Products.approve,請對方核准產品。 這個網址最多只能用來顯示 1 天的權限。
取得
擷取要向企業管理員展示的產品詳細資料。
getAppRestrictionsSchema
擷取定義可設定屬性的結構定義 產品。所有產品都有結構定義,但如果沒有結構定義,這個結構定義可能會留空 並已定義受管理的設定。這個結構定義可用於 填入使用者介面,以便管理員設定產品。 如要根據使用這項指令取得的結構定義,套用受管理的設定 API,請參閱 透過 Play 管理受管理的設定
getPermissions
擷取這個應用程式所需的 Android 應用程式權限。
list
尋找符合查詢條件的已核准產品,或是所有已核准的產品 沒有查詢的話
取消核准
取消核准指定產品 (以及相關的應用程式權限 (如有))