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)
        ]
      }
    ]
  }
}

資源名稱	值	說明	Notes
appRestrictionsSchema	nested object	應用程式限制結構定義
appRestrictionsSchema.kind	string	已淘汰。
appRestrictionsSchema.restrictions[]	list	構成這個結構定義的限制組合。
appRestrictionsSchema.restrictions[].defaultValue	nested object	限制的預設值。bundle 和 bundleArray 限制從未有預設值。
appRestrictionsSchema.restrictions[].defaultValue.type	string	提供的值的類型。 可接受的值如下： "bool" "bundle" "bundleArray" "choice" "hidden" "integer" "multiselect" "string"
appRestrictionsSchema.restrictions[].defaultValue.valueBool	boolean	布林值 - 只有在類型為布林值時才會顯示。
appRestrictionsSchema.restrictions[].defaultValue.valueInteger	integer	整數值 - 只有在類型為整數時才會顯示。
appRestrictionsSchema.restrictions[].defaultValue.valueMultiselect[]	list	字串值清單 - 只有在類型為多選功能時才會顯示。
appRestrictionsSchema.restrictions[].defaultValue.valueString	string	字串值 - 這會顯示在類型字串、選項和隱藏中。
appRestrictionsSchema.restrictions[].description	string	詳細說明限制，並詳細說明影響內容。
appRestrictionsSchema.restrictions[].entryValue[]	list	如為 choice 或 multiselect 限制，此為機器可讀取值的清單。這些值應在設定中使用，可做為 choice 限制的單一 string 值，或是做為 multiselect 限制的 stringArray 使用。
appRestrictionsSchema.restrictions[].entry[]	list	針對 choice 或 multiselect 限制，可能的項目易理解名稱清單。
appRestrictionsSchema.restrictions[].key	string	產品用來識別限制的專屬金鑰，例如「com.google.android.gm.fieldname」。
appRestrictionsSchema.restrictions[].nestedRestriction[]	list	如為 bundle 或 bundleArray 限制，則巢狀限制清單。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 無法修改。這個 ID 就是 Play 管理中心頁面網址，該頁面的網址會顯示測試群組資訊。
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 元素互動來接受顯示的權限，進而在 Products.approve 呼叫中觸發這個網址做為 approvalUrlInfo.approvalUrl 屬性來核准產品。這個網址只能用於顯示最多 1 天內的權限。 注意：這個項目已淘汰。新的整合項目無法使用這個方法，也可以參考我們的 新建議。

取得

擷取要向企業管理員顯示的產品詳細資料。

getAppRestrictionsSchema

擷取結構定義，為這項產品定義可設定屬性。所有產品都有結構定義，但如果未定義任何代管設定，這個結構定義可能會空白。這個結構定義可用於填入使用者介面，讓管理員設定產品。如要根據使用這個 API 取得的結構定義套用受管理的設定，請參閱透過 Play 的代管設定。

getPermissions

擷取這個應用程式需要的 Android 應用程式權限。

list

尋找與查詢相符的已核准產品。如果沒有查詢，則尋找所有已核准的產品。注意：這個項目已淘汰。新的整合項目無法使用這個方法，也可以參考我們的 新建議。

取消核准

取消核准指定產品，以及相關的應用程式權限 (如有) 注意：這個項目已淘汰。新的整合項目無法使用這個方法，也可以參考我們的 新建議。