iframe Google Play được quản lý

Với iframe Google Play được quản lý, bạn có thể nhúng Google Play được quản lý trực tiếp vào bảng điều khiển EMM để mang đến cho khách hàng trải nghiệm quản lý thiết bị di động hợp nhất.

iframe Managed Google Play
Hình 1. Iframe Google Play được quản lý hiển thị trang Tìm kiếm ứng dụng.

Iframe chứa một thanh tiêu đề và một trình đơn bên có thể mở rộng. Trên trình đơn, người dùng có thể chuyển đến các trang khác nhau:

  • Tìm kiếm ứng dụng: Cho phép quản trị viên CNTT tìm kiếm và duyệt xem các ứng dụng trên Google Play, xem thông tin chi tiết về ứng dụng và chọn ứng dụng.
  • Ứng dụng riêng tư: Cho phép quản trị viên CNTT phát hành và quản lý ứng dụng riêng tư cho doanh nghiệp của họ.
  • Ứng dụng web: Cho phép quản trị viên CNTT phát hành và phân phối lối tắt trang web dưới dạng ứng dụng.
  • Sắp xếp ứng dụng: Cho phép quản trị viên CNTT định cấu hình cách sắp xếp ứng dụng trong ứng dụng Cửa hàng Play trên thiết bị của người dùng.

Theo mặc định, tất cả các trang đều được bật trong iframe, nhưng bạn có thể tắt từng trang một (xem phần Thêm iframe vào bảng điều khiển).

Tính năng

Phần này mô tả các tính năng có trong iframe Managed Google Play. Để biết thông tin về cách nhúng iframe và triển khai các tính năng này, hãy xem phần Thêm iframe vào bảng điều khiển.

Thêm iframe vào bảng điều khiển

Bước 1. Tạo mã thông báo web

Để tạo mã thông báo web xác định doanh nghiệp, hãy gọi Enterprises.createWebToken. Ví dụ sau đây cho biết cách truy xuất mã thông báo bằng Thư viện ứng dụng API EMM của Google Play dành cho Java.

Theo mặc định, tất cả các trang trong iframe đều được bật. Khi tạo mã thông báo web, bạn có thể chỉ định(các) trang cần tắt. Ví dụ bên dưới sẽ tắt các chế độ Ứng dụng riêng tư, Ứng dụng web và Sắp xếp ứng dụng.

public AdministratorWebToken getAdministratorWebToken(
        String enterpriseId) throws IOException {
    AdministratorWebTokenSpec tokenSpec = new AdministratorWebTokenSpec();
    tokenSpec.setParent("https://my-emm-console.com");
    tokenSpec.setPlaySearch(new AdministratorWebTokenSpecPlaySearch());
    tokenSpec.setPrivateApps(new AdministratorWebTokenSpecPrivateApps().setEnabled(false));
    tokenSpec.setWebApps(new AdministratorWebTokenSpecWebApps().setEnabled(false));
    tokenSpec.setStoreBuilder(new AdministratorWebTokenSpecStoreBuilder().setEnabled(false));
    return androidEnterprise
        .enterprise()
        .createWebToken(enterpriseId, tokenSpec)
        .execute();
}

Bạn cần thêm mã thông báo được trả về cùng với các tham số khác khi hiển thị iframe trong bảng điều khiển.

Bước 2. Hiển thị iframe

Dưới đây là ví dụ về cách hiển thị iframe Play được quản lý:

<script src="https://apis.google.com/js/api.js"></script>
<div id="container"></div>
<script>
  gapi.load('gapi.iframes', function() {
    var options = {
      'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT',
      'where': document.getElementById('container'),
      'attributes': { style: 'width: 600px; height:1000px', scrolling: 'yes'}
    }

    var iframe = gapi.iframes.getContext().openChild(options);
  });
</script>

Mã này tạo một iframe bên trong vùng chứa div. Bạn có thể đặt các thuộc tính sẽ áp dụng cho thẻ iframe bằng tuỳ chọn "thuộc tính", như ở trên.

Thông số URL

Bảng dưới đây liệt kê tất cả các tham số có sẵn cho iframe mà bạn có thể thêm vào URL dưới dạng tham số URL, ví dụ:

'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT&showsearchbox=TRUE',
Thông số Trang Bắt buộc Mô tả
token Không áp dụng Có Mã thông báo được trả về từ Bước 1.
iframehomepage Không áp dụng Không Trang ban đầu hiển thị khi iframe được kết xuất. Các giá trị có thể là PLAY_SEARCH, WEB_APPS, PRIVATE_APPS và STORE_BUILDER (sắp xếp ứng dụng). Nếu bạn không chỉ định, thứ tự ưu tiên sau đây sẽ xác định trang nào sẽ hiển thị: 1. PLAY_SEARCH, 2. PRIVATE_APPS, 3. WEB_APPS, 4. STORE_BUILDER.
locale Không áp dụng Không Thẻ ngôn ngữ BCP 47 được định dạng đúng cách dùng để bản địa hoá nội dung trong iframe. Nếu bạn không chỉ định, giá trị mặc định sẽ là en_US.
mode Tìm kiếm ứng dụng Không SELECT: cho phép quản trị viên CNTT chọn ứng dụng.
APPROVE (mặc định): cho phép quản trị viên CNTT chọn, phê duyệt và huỷ phê duyệt ứng dụng.
showsearchbox Tìm kiếm ứng dụng Không TRUE (mặc định): hiển thị hộp tìm kiếm và khởi tạo truy vấn tìm kiếm từ bên trong iframe.
FALSE: hộp tìm kiếm không xuất hiện.
search Tìm kiếm ứng dụng Không Chuỗi tìm kiếm. Nếu được chỉ định, iframe sẽ chuyển hướng quản trị viên CNTT đến kết quả tìm kiếm bằng chuỗi đã chỉ định.

Bước 3. Xử lý sự kiện iframe

Bạn cũng nên xử lý các sự kiện sau trong quá trình tích hợp.

Sự kiệnMô tả
onproductselect Người dùng chọn hoặc phê duyệt một ứng dụng. Thao tác này sẽ trả về một đối tượng chứa:
{
    "packageName": The package name of the app, e.g. "com.google.android.gm",
    "productId": The product ID of the app, e.g. "app:com.google.android.gm",
    "action": The type of action performed on the document. Possible values are:
    "approved", "unapproved" or "selected." If you implement the iframe in SELECT
    mode, the only possible value is "selected".
}
Mẫu dưới đây cho thấy cách nghe onproductselect: 
iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);