Products

Để biết danh sách các phương thức cho tài nguyên này, hãy xem ở cuối trang.

Biểu diễn tài nguyên

Tài nguyên Sản phẩm đại diện cho một ứng dụng trên Cửa hàng Google Play mà ít nhất một số người dùng trong doanh nghiệp có thể sử dụng. (Một số ứng dụng bị hạn chế đối với một doanh nghiệp duy nhất và không có thông tin nào về ứng dụng được cung cấp bên ngoài doanh nghiệp đó.)

Thông tin mà bạn cung cấp cho mỗi sản phẩm (tên, biểu tượng đã bản địa hoá, đường liên kết đến trang chi tiết đầy đủ trên Google Play) nhằm mục đích thể hiện cơ bản về sản phẩm trên giao diện người dùng 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)
        ]
      }
    ]
  }
}
Tên tài sản Giá trị Nội dung mô tả Ghi chú
appRestrictionsSchema nested object Giản đồ hạn chế ứng dụng
appRestrictionsSchema.kind string Không được tán thành.

appRestrictionsSchema.restrictions[] list Bộ hạn chế tạo nên giản đồ này.
appRestrictionsSchema.restrictions[].defaultValue nested object Giá trị mặc định của quy định hạn chế. Các quy tắc hạn chế bundle và bundleArray không bao giờ có giá trị mặc định.
appRestrictionsSchema.restrictions[].defaultValue.type string Loại giá trị đang được cung cấp.

Các giá trị được chấp nhận là:
  • "bool"
  • "bundle"
  • "bundleArray"
  • "choice"
  • "hidden"
  • "integer"
  • "multiselect"
  • "string"
appRestrictionsSchema.restrictions[].defaultValue.valueBool boolean Giá trị boolean này chỉ xuất hiện nếu kiểu dữ liệu là boolean.
appRestrictionsSchema.restrictions[].defaultValue.valueInteger integer Giá trị số nguyên – giá trị này chỉ xuất hiện nếu loại là số nguyên.
appRestrictionsSchema.restrictions[].defaultValue.valueMultiselect[] list Danh sách các giá trị chuỗi – danh sách này sẽ chỉ xuất hiện nếu loại là chọn nhiều.
appRestrictionsSchema.restrictions[].defaultValue.valueString string Giá trị chuỗi – giá trị này sẽ xuất hiện đối với các loại chuỗi, lựa chọn và bị ẩn.
appRestrictionsSchema.restrictions[].description string Nội dung mô tả dài hơn về quy định hạn chế nhằm cung cấp thêm thông tin chi tiết về những vấn đề ảnh hưởng đến quy định hạn chế đó.
appRestrictionsSchema.restrictions[].entryValue[] list Đối với các quy tắc hạn chế choice hoặc multiselect, danh sách các giá trị mà máy có thể đọc được của các mục nhập có thể. Bạn nên sử dụng các giá trị này trong cấu hình dưới dạng một giá trị string duy nhất cho quy tắc hạn chế choice hoặc trong stringArray cho quy tắc hạn chế multiselect.
appRestrictionsSchema.restrictions[].entry[] list Đối với các quy tắc hạn chế choice hoặc multiselect, danh sách tên mà con người có thể đọc được.
appRestrictionsSchema.restrictions[].key string Khoá duy nhất mà sản phẩm sử dụng để xác định quy định hạn chế, ví dụ: "com.google.android.gm.fieldname".
appRestrictionsSchema.restrictions[].nestedRestriction[] list Đối với các quy tắc hạn chế bundle hoặc bundleArray, đây là danh sách các quy tắc hạn chế lồng nhau. Giới hạn bundle luôn được lồng trong giới hạn bundleArray và giới hạn bundleArray sâu tối đa 2 cấp.
appRestrictionsSchema.restrictions[].restrictionType string Loại quy định hạn chế.

Các giá trị được chấp nhận là:
  • "bool"
  • "bundle"
  • "bundleArray"
  • "choice"
  • "hidden"
  • "integer"
  • "multiselect"
  • "string"
appRestrictionsSchema.restrictions[].title string Tên quy định hạn chế.
appTracks[] list Các tuyến đường mà doanh nghiệp có thể nhìn thấy.
appTracks[].trackAlias string Tên có thể sửa đổi cho bản nhạc. Đây là tên hiển thị trong Play Console.
appTracks[].trackId string Giá trị nhận dạng theo dõi duy nhất và không thể sửa đổi. Giá trị nhận dạng này là releaseTrackId trong URL của trang Play Console hiển thị thông tin về bản nhạc.
appVersion[] list Các phiên bản ứng dụng hiện có cho sản phẩm này.
appVersion[].isProduction boolean Đúng nếu phiên bản này là APK phát hành chính thức.
appVersion[].targetSdkVersion integer Phiên bản SDK mà ứng dụng này nhắm đến, như đã chỉ định trong tệp kê khai của tệp APK. Xem http://developer.android.com/guide/topics/manifest/uses-sdk-element.html
appVersion[].track string Không dùng nữa, chuyển sang dùng trackId.

Các giá trị được chấp nhận là:
  • "alpha"
  • "beta"
  • "production"
appVersion[].trackId[] list Theo dõi mã nhận dạng của phiên bản ứng dụng được xuất bản. Thay thế trường track (không dùng nữa) nhưng không bao gồm kênh phát hành công khai (xem isProduction).
appVersion[].versionCode integer Giá trị nhận dạng tăng dần riêng biệt cho phiên bản ứng dụng.
appVersion[].versionString string Chuỗi mà nhà phát triển ứng dụng sử dụng trong Cửa hàng Play để xác định phiên bản. Chuỗi này không nhất thiết phải là duy nhất hoặc đã bản địa hoá (ví dụ: chuỗi có thể là "1.4").
authorName string Tên tác giả của sản phẩm (ví dụ: nhà phát triển ứng dụng).
availableCountries[] list Các quốc gia có ứng dụng này.
availableTracks[] list Không dùng nữa, chuyển sang dùng appTracks.
category string Danh mục ứng dụng (ví dụ: ĐUA, XÃ HỘI, v.v.)
contentRating string Mức phân loại nội dung của ứng dụng này.

Các giá trị được chấp nhận là:
  • "all"
  • "mature"
  • "preTeen"
  • "teen"
description string Mô tả quảng cáo được bản địa hóa, nếu có.
detailsUrl string Đường liên kết đến trang chi tiết của sản phẩm trên Google Play (dành cho người tiêu dùng).
distributionChannel string Cách thức và đối tượng cung cấp gói. Giá trị publicGoogleHosted có nghĩa là gói được cung cấp thông qua Cửa hàng Play và không bị hạn chế đối với một doanh nghiệp cụ thể. Giá trị privateGoogleHosted có nghĩa là gói là một ứng dụng riêng tư (chỉ dành cho doanh nghiệp) nhưng được Google lưu trữ. Giá trị privateSelfHosted có nghĩa là gói là một ứng dụng riêng tư (chỉ dành cho doanh nghiệp) và được lưu trữ riêng tư.

Các giá trị được chấp nhận là:
  • "privateGoogleHosted"
  • "privateSelfHosted"
  • "publicGoogleHosted"
features[] list Các đặc điểm đáng chú ý (nếu có) của sản phẩm này.
fullDescription string Mô tả toàn bộ cửa hàng ứng dụng đã bản địa hoá, nếu có.
iarcGenericRating string Mức phân loại nội dung của ứng dụng này.

Các giá trị được chấp nhận là:
  • "eighteenYears"
  • "iarcGenericRatingUnspecified"
  • "sevenYears"
  • "sixteenYears"
  • "threeYears"
  • "twelveYears"
iconUrl string Đường liên kết đến hình ảnh có thể dùng làm biểu tượng cho sản phẩm. Hình ảnh này phù hợp để sử dụng có kích thước tối đa là 512 px x 512 px.
kind string
lastUpdatedTimestampMillis long Thời gian gần đúng (trong vòng 7 ngày) mà ứng dụng được xuất bản lần gần đây nhất, được biểu thị bằng mili giây kể từ thời gian bắt đầu của hệ thống.
minAndroidSdkVersion integer SDK Android tối thiểu cần thiết để chạy ứng dụng.
permissions[] list Danh sách các quyền mà ứng dụng yêu cầu.
permissions[].permissionId string Một chuỗi mờ xác định duy nhất quyền này.
permissions[].state string Liệu quyền đã được chấp nhận hay chưa.

Các giá trị được chấp nhận là:
  • "accepted"
  • "required"
productId string Một chuỗi có dạng app:<package name>. Ví dụ: app:com.google.android.gm đại diện cho ứng dụng Gmail.
productPricing string Sản phẩm này là miễn phí, miễn phí khi mua hàng trong ứng dụng hay có tính phí. Nếu giá không xác định, thì tức là sản phẩm không còn được cung cấp rộng rãi (mặc dù người sở hữu sản phẩm có thể vẫn được cung cấp sản phẩm này).

Các giá trị được chấp nhận là:
  • "free"
  • "freeWithInAppPurchase"
  • "paid"
recentChanges string Nội dung mô tả về những thay đổi gần đây đối với ứng dụng.
requiresContainerApp boolean Không dùng nữa.
screenshotUrls[] list Danh sách các đường liên kết ảnh chụp màn hình đại diện cho ứng dụng.
signingCertificate nested object Chứng chỉ dùng để ký sản phẩm này.
signingCertificate.certificateHashSha1 string Hàm băm SHA1 được mã hoá bằng url base64 của chứng chỉ. (Trường này không còn được dùng nữa và thay vào đó là SHA2-256. Đừng sử dụng và có thể bị xoá bất cứ lúc nào.)

signingCertificate.certificateHashSha256 string Hàm băm SHA2-256 được mã hoá bằng url base64 của chứng chỉ.
smallIconUrl string Đường liên kết đến một hình ảnh nhỏ hơn có thể dùng làm biểu tượng cho sản phẩm. Hình ảnh này phù hợp để sử dụng có kích thước tối đa là 128 px x 128 px.
title string Tên sản phẩm.
workDetailsUrl string Đường liên kết đến trang chi tiết của sản phẩm Managed Google Play dành cho quản trị viên doanh nghiệp.

Phương thức

phê duyệt

Phê duyệt sản phẩm được chỉ định và các quyền liên quan cho ứng dụng, nếu có. Số lượng sản phẩm tối đa mà bạn có thể phê duyệt cho mỗi khách hàng doanh nghiệp là 1.000 sản phẩm.

Nếu bạn muốn tìm hiểu cách sử dụng Managed Google Play để thiết kế và tạo bố cục cửa hàng nhằm hiển thị các sản phẩm được phê duyệt cho người dùng, hãy xem phần Store Layout Design (Thiết kế bố cục cửa hàng).

generateApprovalUrl
Tạo một URL có thể hiển thị trong iframe để hiển thị các quyền (nếu có) của một sản phẩm. Quản trị viên doanh nghiệp phải xem và chấp nhận các quyền này thay mặt cho tổ chức của họ để phê duyệt sản phẩm đó.

Quản trị viên cần chấp nhận các quyền hiển thị bằng cách tương tác với một thành phần trên giao diện người dùng riêng biệt trong bảng điều khiển EMM, sau đó sẽ kích hoạt việc sử dụng URL này làm thuộc tính approvalUrlInfo.approvalUrl trong lệnh gọi Products.approve để phê duyệt sản phẩm. URL này chỉ có thể dùng để hiển thị quyền trong tối đa 1 ngày.
nhận
Truy xuất thông tin chi tiết của một sản phẩm để hiển thị cho quản trị viên doanh nghiệp.
getAppRestrictionsSchema
Truy xuất giản đồ xác định các thuộc tính có thể định cấu hình cho sản phẩm này. Tất cả sản phẩm đều có giản đồ, nhưng giản đồ này có thể trống nếu bạn chưa xác định cấu hình được quản lý. Giản đồ này có thể dùng để điền sẵn giao diện người dùng cho phép quản trị viên định cấu hình sản phẩm. Để áp dụng một cấu hình được quản lý dựa trên giản đồ có được bằng cách sử dụng API này, hãy xem phần Cấu hình được quản lý thông qua Play.
getPermissions
Truy xuất các quyền cho ứng dụng Android mà ứng dụng này yêu cầu.
list
Tìm các sản phẩm được phê duyệt khớp với cụm từ tìm kiếm hoặc tất cả sản phẩm được phê duyệt nếu không có cụm từ tìm kiếm.
huỷ phê duyệt
Từ chối sản phẩm được chỉ định (và các quyền liên quan cho ứng dụng, nếu có)