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

Với iframe Managed Google Play, bạn có thể nhúng Managed Google Play ngay trong bảng điều khiển EMM của bạn để cung cấp cho khách hàng một tính năng quản lý di động hợp nhất của bạn.

iframe trên Managed Google Play
Hình 1. iframe trên Managed Google Play hiển thị trang Ứng dụng tìm kiếm.

Iframe chứa thanh tiêu đề và 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 trên Google Chơi ứng dụng, 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 xuất bản và quản lý chế độ riêng tư cho doanh nghiệp của mình.
  • Ứng dụng web: Cho phép quản trị viên CNTT xuất bản và phân phối trang web lối tắt 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 thức hoạt động của ứng dụng được sắp xếp trong ứng dụng Cửa hàng Play trên thiết bị của người dùng.

Tất cả các trang được bật trong iframe theo mặc định nhưng có thể bị tắt riêng lẻ (xem phần Thêm iframe vào bảng điều khiển của bạn).

Tính năng

Phần này mô tả các tính năng có sẵn 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 Thêm iframe vào bảng điều khiển của bạn.

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

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

Để tạo mã thông báo web giúp xác định doanh nghiệp, hãy gọi Enterprises.createWebToken. Ví dụ sau cho thấy cách truy xuất mã thông báo bằng dịch vụ quản lý thiết bị di động doanh nghiệp (EMM) của Google Play Thư viện ứng dụng API 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 vô hiệu hoá Ứ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 phải bao gồm mã thông báo được trả về cùng với các thông số khác khi hiển thị iframe trong bảng điều khiển của bạn.

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

Dưới đây là ví dụ về cách hiển thị iframe trên Managed Play:

<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. Thuộc tính để áp dụng cho thẻ iframe, hãy đặt thuộc tính "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ố hiện có cho iframe có thể được 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 đầu tiên hiển thị khi iframe được hiển thị. Các giá trị có thể sử dụng là PLAY_SEARCH, WEB_APPS, PRIVATE_APPS và STORE_BUILDER (sắp xếp ứng dụng). Nếu không được chỉ định, thứ tự sau ưu tiên sẽ xác định trang nào được 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 phù hợp dùng để bản địa hoá nội dung trong iframe. Nếu không được chỉ định, giá trị mặc định 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à bắt đầu cụm từ tìm kiếm từ bên trong iframe.
FALSE: thì hộp tìm kiếm sẽ 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ẽ hướng quản trị viên CNTT đến kết quả tìm kiếm bằng chuỗi được chỉ định.

Bước 3. Xử lý các 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 ứ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 minh hoạ cách nghe onproductselect: 
iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);