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 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 สามารถตั้งค่าด้วย "attributes" เป็นตัวเลือก ที่ด้านบน

พารามิเตอร์ 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);