'पहले से तैयार डिवाइस' सुविधा वाले iframe की मदद से, 'पहले से तैयार डिवाइस' सुविधा को सीधे अपने ईएमएम कंसोल में एम्बेड किया जा सकता है. इससे ग्राहक, पहले से तैयार डिवाइस को आपके डीपीसी के साथ आसानी से कॉन्फ़िगर कर सकते हैं. iframe आपको 'पहले से तैयार डिवाइस' सुविधा वाले डिवाइस सेटअप के दौरान इस्तेमाल किए गए DPC और प्रॉविज़निंग को कॉन्फ़िगर करने की अनुमति देता है.
!['पहले से तैयार डिवाइस' सुविधा वाले iframe](https://developers.google.cn/static/android/work/play/emm-api/images/zt-iframe-home.png?authuser=6&hl=hi)
जब कोई आईटी एडमिन पहली बार iframe खोलता है, तो उसे अपने 'पहले से तैयार डिवाइस' वाले खाते को अपने एंटरप्राइज़ से लिंक करने के लिए कहा जाता है.
जब कोई आईटी एडमिन अपने एंटरप्राइज़ से 'पहले से तैयार डिवाइस' सुविधा वाले खाते को लिंक कर लेता है, तो iframe 'पहले से तैयार डिवाइस' वाले खातों की सूची दिखाएगा. वे एंटरप्राइज़ डिवाइसों के लिए, डिफ़ॉल्ट तौर पर 'पहले से तैयार डिवाइस' वाला कॉन्फ़िगरेशन सेट भी देख सकते हैं.
सुविधाएं
इस सेक्शन में, 'पहले से तैयार डिवाइस' सुविधा वाले iframe में उपलब्ध सुविधाओं के बारे में बताया गया है. iframe को एम्बेड करने और इन सुविधाओं को लागू करने के तरीके के बारे में जानकारी के लिए, अपने कंसोल में iframe जोड़ना देखें.
'पहले से तैयार डिवाइस' सुविधा वाले खाते को किसी एंटरप्राइज़ से लिंक करें
iframe की मदद से आईटी एडमिन, 'पहले से तैयार डिवाइस' वाले खाते और अपने एंटरप्राइज़ को लिंक कर सकता है. इस प्रक्रिया के तहत, आईटी एडमिन एक डिफ़ॉल्ट 'पहले से तैयार डिवाइस' प्रोफ़ाइल बनाता है, इसका इस्तेमाल 'पहले से तैयार डिवाइस' वाले खाते में मौजूद डिवाइसों पर किया जाता है. इस फ़्लो के बारे में नीचे बताया गया है.
अगर आईटी एडमिन ने पहले से ही अपने एंटरप्राइज़ के साथ 'पहले से तैयार डिवाइस' सुविधा वाले खाते को लिंक नहीं किया है, तो iframe खोलने पर उसे ऐसा करने के लिए कहा जाएगा.
![पहले से तैयार iframe लिंक करने का फ़्लो](https://developers.google.cn/static/android/work/play/emm-api/images/zt-iframe-link.png?authuser=6&hl=hi)
आईटी एडमिन को 'पहले से तैयार डिवाइस' सुविधा वाले खातों की सूची दिखती है. वह अपने एंटरप्राइज़ से लिंक करने के लिए, एक या उससे ज़्यादा खाते चुन सकते हैं.
!['पहले से तैयार डिवाइस' सुविधा वाले iframe खाते की सूची वाली स्क्रीन](https://developers.google.cn/static/android/work/play/emm-api/images/zt-iframe-choose-accounts.png?authuser=6&hl=hi)
![पहले से तैयार iframe कॉन्फ़िगरेशन स्क्रीन](https://developers.google.cn/static/android/work/play/emm-api/images/zt-iframe-show-dpc.png?authuser=6&hl=hi)
'पहले से तैयार डिवाइस' सुविधा वाले iframe, अपने-आप 'पहले से तैयार डिवाइस' सुविधा का कॉन्फ़िगरेशन जनरेट करते हैं. आईटी एडमिन इस कॉन्फ़िगरेशन में बदलाव नहीं कर सकता. इस कॉन्फ़िगरेशन में इस्तेमाल किए जाने के लिए, DPC या प्रॉविज़निंग अतिरिक्त चीज़ों को अपनी पसंद के मुताबिक बनाया जा सकता है. ऐसा करने के बारे में ज़्यादा जानने के लिए, iframe यूआरएल पैरामीटर देखें.
![ज़ीरो-टच iframe के इस्तेमाल की जानकारी देने वाली स्क्रीन](https://developers.google.cn/static/android/work/play/emm-api/images/zt-iframe-support-info.png?authuser=6&hl=hi)
आईटी एडमिन, सहायता से जुड़ी जानकारी डालता है. यह जानकारी, पहले से तैयार डिवाइसों के सेट अप होने पर दिखती है. जब आईटी एडमिन “सेव करें” पर क्लिक करता है, तो लिंक करने की प्रोसेस पूरी हो जाती है. इसके बाद, उपयोगकर्ता को 'पहले से तैयार डिवाइस' सुविधा वाले iframe के होम पेज पर रीडायरेक्ट कर दिया जाता है. यहां वह लिंक किए गए खातों को मैनेज कर सकता है.
'पहले से तैयार डिवाइस' सुविधा वाले खातों को देखें और मैनेज करें
iframe की मदद से आईटी एडमिन, पहले से लिंक किए गए 'पहले से तैयार डिवाइस' वाले खाते, डिफ़ॉल्ट 'पहले से तैयार डिवाइस' प्रोफ़ाइल, और सहायता की जानकारी देख सकता है. इसके अलावा, वे 'पहले से तैयार डिवाइस' सुविधा वाले दूसरे खातों को लिंक कर सकते हैं और 'पहले से तैयार डिवाइस' वाले खातों को अनलिंक कर सकते हैं.
उदाहरण के तौर पर, 'पहले से तैयार डिवाइस' सुविधा वाले iframe के होम पेज को देखने के लिए, पहली इमेज देखें.
'पहले से तैयार डिवाइस' सुविधा वाले पोर्टल में, लिंक किए गए खातों से जुड़े डिवाइस की जानकारी देखना
जब 'पहले से तैयार डिवाइस' सुविधा वाले खाते को किसी एंटरप्राइज़ से जोड़ा जाता है, तो 'पहले से तैयार डिवाइस' सुविधा वाले खाते के वे सभी डिवाइस अपने-आप कॉन्फ़िगर हो जाते हैं जिन्हें 'पहले से तैयार डिवाइस' सुविधा वाली प्रोफ़ाइल से कॉन्फ़िगर नहीं किया गया है.
'पहले से तैयार डिवाइस' सुविधा वाले कंसोल में, ये डिवाइस “एंटरप्राइज़ की डिफ़ॉल्ट प्रोफ़ाइल” कॉन्फ़िगरेशन के साथ दिखते हैं. आईटी एडमिन, 'पहले से तैयार डिवाइस' सुविधा वाले खाते के किसी भी डिवाइस पर, इस प्रोफ़ाइल को सेट और अनसेट कर सकता है. हालांकि, प्रोफ़ाइल में बदलाव नहीं किया जा सकता.
अगर 'पहले से तैयार डिवाइस' सुविधा वाले खाते को अनलिंक किया जाता है, तो “एंटरप्राइज़ की डिफ़ॉल्ट प्रोफ़ाइल” से कॉन्फ़िगर किए गए सभी डिवाइसों पर, यह प्रोफ़ाइल सेट नहीं होगी. इन डिवाइसों को किसी दूसरी प्रोफ़ाइल से कॉन्फ़िगर किया जा सकता है.
अपने कंसोल में iframe जोड़ना
पहला चरण: वेब टोकन जनरेट करना
एंटरप्राइज़ की पहचान करने वाला वेब टोकन जनरेट करने के लिए, Enterprises.createWebToken
को कॉल करें.
नीचे दिए गए उदाहरण में, Java के लिए Google Play ईएमएम एपीआई क्लाइंट लाइब्रेरी का इस्तेमाल करके, टोकन को वापस पाने का तरीका बताया गया है.
ध्यान दें कि 'पहले से तैयार डिवाइस' सुविधा वाले iframe, मैनेज किए जा रहे Play iframe से अलग होने चाहिए.
public AdministratorWebToken getAdministratorWebToken( String enterpriseId) throws IOException { AdministratorWebTokenSpec tokenSpec = new AdministratorWebTokenSpec(); tokenSpec.setParent("https://my-emm-console.com"); tokenSpec.setZeroTouch(new AdministratorWebTokenSpecZeroTouch()); return androidEnterprise .enterprise() .createWebToken(enterpriseId, tokenSpec) .execute(); }
अपने कंसोल में iframe को रेंडर करते समय, आपको अन्य पैरामीटर के साथ-साथ, लौटाए गए टोकन को भी शामिल करना होगा.
दूसरा चरण: iframe रेंडर करना
'पहले से तैयार डिवाइस' सुविधा वाले iframe को रेंडर करने के तरीके का उदाहरण यहां दिया गया है:
<script src="https://apis.google.com/js/api.js"></script>
<div id="container"></div>
<script>
gapi.load('gapi.iframes', function() {
var options = {
'url': 'https://enterprise.google.com/android/zero-touch/embedded/companyhome?token=web_token&dpcId=com.example.app',,
'where': document.getElementById('container'),
'attributes': { style: 'width: 600px; height:1000px', scrolling: 'yes'}
}
var iframe = gapi.iframes.getContext().openChild(options);
});
</script>
यह कोड, कंटेनर div के अंदर एक iframe जनरेट करता है. iframe टैग पर लागू किए जाने वाले एट्रिब्यूट को, ऊपर बताए गए 'एट्रिब्यूट' विकल्प के साथ सेट किया जा सकता है.
iframe यूआरएल पैरामीटर
नीचे दी गई टेबल में iframe के लिए उपलब्ध वे सभी पैरामीटर दिए गए हैं जिन्हें यूआरएल में यूआरएल पैरामीटर के तौर पर जोड़ा जा सकता है.उदाहरण के लिए:
https://enterprise.google.com/android/zero-touch/embedded/companyhome?token=TOKEN&dpcId=com.afwsamples.testdpc
पैरामीटर | ज़रूरी है | ब्यौरा |
---|---|---|
token |
हां | टोकन पहले चरण से मिला. |
dpcId |
हां | DPC ऐप्लिकेशन के पैकेज का नाम, जैसे कि com.example.app .
इसे सेट करना ज़रूरी है. DPC पहले से ही आपके ईएमएम के साथ जुड़ा होना चाहिए.
|
dpcExtras |
नहीं | यूआरएल में कोड में बदले गए JSON ऑब्जेक्ट में, अतिरिक्त प्रावधान किए गए हैं. डिवाइस सेटअप करने के दौरान, इन्हें DPC को भेजा जाता है. |
यूआरएल का उदाहरण, यह मानते हुए:
- एपीआई से मिला वेब टोकन:
abcde
- डीपीसी:
com.example
- DPC की अतिरिक्त सुविधाएं:
{“server”:“www.example.com”,“enterprise”:”example_id”}
https://enterprise.google.com/android/zero-touch/embedded/companyhome?token=abcde&dpcId=com.example&dpcExtras={“server”:“www.example.com”,“enterprise”:”example_id”}
यूआरएल को कोड में बदला गया, तो यह यूआरएल इस तरह होगा:
https://enterprise.google.com/android/zero-touch/embedded/companyhome?token=abcde&dpcId=com.example&dpcExtras=%7B%E2%80%9Cserver%E2%80%9D%3A%E2%80%9Cwww.example.com%E2%80%9D%2C%E2%80%9Centerprise%E2%80%9D%3A%E2%80%9Dexample_id%E2%80%9D%7D