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

Với iframe Google Play được quản lý, 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 để mang đến cho khách hàng trải nghiệm quản lý di động hợp nhất.

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

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ý ứng dụng riêng tư cho doanh nghiệp.
  • Ứ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 đế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.

Tất cả các trang được bật trong iframe theo mặc định, nhưng bạn có thể 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ó 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 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 biết cách truy xuất mã thông báo bằng cách sử dụng Thư viện ứng dụng API EMM của Google Play cho Java.

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

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 đưa mã thông báo được trả về cùng với các tham số khác vào khi hiển thị iframe trong bảng điều khiển.

Bước 2. Kết xuất 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 ra một iframe bên trong vùng chứa div. Bạn có thể đặt các thuộc tính muốn áp dụng cho thẻ iframe bằng tuỳ 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 thông 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 Nội dung mô tả
token Không áp dụng 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_APPSSTORE_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 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 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. Chế độ này không còn được dùng nữa, hãy dùng SELECT. Chế độ APPROVE chỉ hoạt động nếu bạn đặt PlaySearch.ApproveApps thành true trong mã thông báo web.
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ừ trong iframe.
FALSE: hộp tìm kiếm sẽ không được hiển thị.
search Tìm kiếm ứng dụng Không Chuỗi tìm kiếm. Nếu được chỉ định, iframe này sẽ chuyển quản trị viên CNTT đến các 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ệ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);