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 元素互動,藉此接受顯示的權限,進而在 Products.approve 呼叫中將這個網址當做 approvalUrlInfo.approvalUrl 屬性來核准產品。這個網址最多只能用來顯示 1 天的權限。
取得
擷取要向企業管理員展示的產品詳細資料。
getAppRestrictionsSchema
擷取定義這項產品可設定屬性的結構定義。所有產品都有結構定義,但如果未定義受管理的設定,這個結構定義可能會空白。這個結構定義可用於填入 UI,讓管理員能夠設定產品。如要根據使用這個 API 取得的結構定義套用代管設定,請參閱「透過 Play 管理設定」。
getPermissions
擷取這個應用程式所需的 Android 應用程式權限。
list
尋找符合查詢且已核准的產品。如果沒有查詢,尋找已核准的所有產品。
取消核准
取消核准指定產品,以及相關的應用程式權限 (如有)