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

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

iframe trên Managed Google Play
Hình 1. iframe 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. Từ 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 qua 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ý các ứ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 xuất bản và phân phối các lối tắt trên 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 (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 bài viết 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 Thư viện ứng dụng API EMM của Google Play 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 tắt Các ứ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 bao gồ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 của mình.

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. Bạn có thể đặt các thuộc tính sẽ áp dụng cho thẻ iframe bằng lựa chọn "thuộc tính" như trên.

Tham số URL

Bảng dưới đây liệt kê tất cả các tham số hiện có 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 Nội dung 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ể 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ự ư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 Một thẻ ngôn ngữ BCP 47 có định dạng hợp lệ, dùng để bản địa hoá nội dung trong iframe. Nếu không được 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à 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 dẫn 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ý 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ệnNội dung mô 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 bên dưới cho biết cách theo dõi onproductselect: 
iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);