iframe ของ Managed Google Play

iframe ของ Managed Google Play ช่วยให้คุณฝัง Managed Google Play ในคอนโซล EMM ได้โดยตรงเพื่อมอบประสบการณ์การจัดการอุปกรณ์เคลื่อนที่ที่เป็นหนึ่งเดียวให้กับลูกค้า

iframe ของ Managed Google Play
รูปที่ 1. iframe ของ Managed Google Play ที่แสดงหน้าแอป Search

iframe มีแถบชื่อและเมนูด้านข้างที่ขยายได้ ผู้ใช้จะไปยังหน้าต่างๆ ได้จากเมนู ดังนี้

  • ค้นหาแอป: ช่วยให้ผู้ดูแลระบบไอทีค้นหาและเรียกดูแอป Google Play, ดูรายละเอียดแอป และเลือกแอปได้
  • แอปส่วนตัว: ช่วยให้ผู้ดูแลระบบไอทีเผยแพร่และจัดการแอปส่วนตัวสำหรับองค์กรได้
  • เว็บแอป: ช่วยให้ผู้ดูแลระบบไอทีเผยแพร่และแจกจ่ายทางลัดเว็บไซต์เป็นแอปได้
  • จัดระเบียบแอป: ช่วยให้ผู้ดูแลระบบไอทีกำหนดค่าวิธีจัดระเบียบแอปในแอป Play Store ในอุปกรณ์ของผู้ใช้ได้

ทุกหน้าเปิดใช้ใน iframe โดยค่าเริ่มต้น แต่สามารถปิดใช้ทีละรายการได้ (ดูเพิ่ม iframe ลงในคอนโซล)


ฟีเจอร์

ส่วนนี้จะอธิบายถึงฟีเจอร์ที่มีใน iframe ของ Managed Google Play ดูข้อมูลเกี่ยวกับวิธีฝัง iframe และใช้งานฟีเจอร์เหล่านี้ได้ที่เพิ่ม iframe ลงในคอนโซล


เพิ่ม iframe ลงในคอนโซล

ขั้นตอนที่ 1 สร้างโทเค็นเว็บ

หากต้องการสร้างโทเค็นเว็บที่ระบุองค์กร ให้เรียกใช้ Enterprises.createWebToken ตัวอย่างต่อไปนี้แสดงวิธีเรียกโทเค็นโดยใช้ไลบรารีของไคลเอ็นต์ Google Play EMM API สำหรับ Java

ทุกหน้าใน iframe จะเปิดใช้โดยค่าเริ่มต้น เมื่อสร้างโทเค็นเว็บ คุณสามารถระบุหน้าที่จะปิดใช้ได้ ตัวอย่างด้านล่างจะปิดแอปส่วนตัว เว็บแอป และจัดระเบียบแอป

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();
}

คุณต้องรวมโทเค็นที่แสดงผลพร้อมกับพารามิเตอร์อื่นๆ เมื่อแสดงผล iframe ในคอนโซล

ขั้นตอนที่ 2 แสดงผล iframe

ตัวอย่างวิธีแสดงผล iframe ของ 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>

โค้ดนี้จะสร้าง iframe ภายในคอนเทนเนอร์ div แอตทริบิวต์ที่จะนำไปใช้กับแท็ก iframe นั้นตั้งค่าได้ด้วยตัวเลือก "แอตทริบิวต์" ตามด้านบน

พารามิเตอร์ของ URL

ตารางด้านล่างแสดงพารามิเตอร์ทั้งหมดที่พร้อมใช้งานสำหรับ iframe ที่เพิ่มลงใน URL เป็นพารามิเตอร์ของ URL ได้ เช่น

'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT&showsearchbox=TRUE',
พารามิเตอร์ หน้าเว็บ จำเป็น คำอธิบาย
token ไม่มีข้อมูล ได้ โทเค็นที่ส่งคืนจากขั้นตอนที่ 1
iframehomepage ไม่มีข้อมูล ไม่ได้ หน้าเริ่มต้นที่แสดงเมื่อมีการแสดงผล iframe ค่าที่เป็นไปได้คือ PLAY_SEARCH, WEB_APPS, PRIVATE_APPS และ STORE_BUILDER (จัดระเบียบแอป) หากไม่ได้ระบุไว้ ลําดับความสําคัญต่อไปนี้จะเป็นตัวกำหนดว่าหน้าเว็บใดจะแสดง: 1. PLAY_SEARCH, 2 PRIVATE_APPS, 3 WEB_APPS, 4 STORE_BUILDER.
locale ไม่มีข้อมูล ไม่ได้ แท็กภาษา BCP 47 ที่มีรูปแบบที่ดีซึ่งใช้เพื่อแปลเนื้อหาใน iframe หากไม่ได้ระบุไว้ ค่าเริ่มต้นจะเป็น en_US
mode ค้นหาแอป ไม่ได้ SELECT: ช่วยให้ผู้ดูแลระบบไอทีเลือกแอปได้
APPROVE (ค่าเริ่มต้น): ช่วยให้ผู้ดูแลระบบไอทีเลือก อนุมัติ และเลิกอนุมัติแอปได้
showsearchbox ค้นหาแอป ไม่ได้ TRUE (ค่าเริ่มต้น): แสดงช่องค้นหาและเริ่มการค้นหาจากภายใน iframe
FALSE: ช่องค้นหาจะไม่ปรากฏ
search ค้นหาแอป ไม่ได้ สตริงการค้นหา iframe จะนําผู้ดูแลระบบไอทีไปยังผลการค้นหาที่มีสตริงที่ระบุ หากระบุไว้

ขั้นตอนที่ 3 จัดการเหตุการณ์ iframe

นอกจากนี้คุณควรจัดการเหตุการณ์ต่อไปนี้ในการผสานรวมด้วย

เหตุการณ์คำอธิบาย
onproductselect ผู้ใช้เลือกหรืออนุมัติแอป ซึ่งจะแสดงออบเจ็กต์ที่มี
{
    "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".
}
    
ตัวอย่างด้านล่างแสดงวิธีฟัง onproductselect
iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);