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 ได้ด้วยตัวเลือก "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);