Để 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ị | Mô tả | Ghi chú |
---|---|---|---|
appRestrictionsSchema |
nested object |
Giản đồ hạn chế ứng dụng | |
appRestrictionsSchema.kind |
string |
Không được dùng nữa. |
|
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à:
|
|
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ế của choice hoặc multiselect , đây là danh sách các mục nhập có thể có các giá trị mà máy có thể đọc được. 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ế của choice hoặc multiselect , đây là danh sách các mục nhập có thể có 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à:
|
|
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à:
|
|
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à:
|
|
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à:
|
|
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à:
|
|
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à:
|
|
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à:
|
|
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.
Tìm hiểu cách sử dụng Managed Google Play để thiết kế và tạo cửa hàng để hiển thị các sản phẩm được phê duyệt cho người dùng, xem Thiết kế bố cục cửa hàng.
- generateApprovalUrl
-
Tạo một URL có thể được hiển thị trong iframe để hiển thị
các quyền (nếu có) đối với 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 phải chấp nhận các quyền được hiển thị bằng cách tương tác với một phần tử 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 Tài sảnapprovalUrlInfo.approvalUrl
trong một Cuộc gọiProducts.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 thuộc tính này của Google. Tất cả sản phẩm đều có giản đồ, nhưng giản đồ này có thể trống nếu không có cấu hình được quản lý đã được xác định. Giản đồ này có thể được dùng để điền sẵn vào 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 cấu hình được quản lý dựa trên giản đồ có được bằng cách sử dụng API, hãy xem 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 những 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ó truy vấn.
- 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ó)