इस संसाधन के तरीकों की सूची के लिए, इस पेज का अंत देखें.
रिसॉर्स प्रतिनिधित्व
एंटरप्राइज़ संसाधन, ईएमएम और किसी खास संगठन के बीच बाइंडिंग को दिखाता है. उस बाइंडिंग को इस एपीआई का इस्तेमाल करके, दो अलग-अलग तरीकों में से किसी एक से इस तरह इंस्टैंशिएट किया जा सकता है:
- Google की तरफ़ से मैनेज किए जा रहे डोमेन के ग्राहकों के लिए, इस प्रोसेस में
Enterprises.enroll
औरEnterprises.setAccount
का इस्तेमाल करना (Admin console और Google API कंसोल से मिले आर्टफ़ैक्ट के साथ) का इस्तेमाल करना शामिल है. साथ ही, ईएमएम में कम या ज़्यादा मैन्युअल प्रोसेस के ज़रिए सबमिट किया जाता है. - मैनेज किए जा रहे Google Play खाते का इस्तेमाल करने वाले ग्राहकों के लिए, इस प्रोसेस में 'मैनेज किए जा रहे Google Play साइन-अप यूज़र इंटरफ़ेस (यूआई)' के साथ
Enterprises.generateSignupUrl
औरEnterprises.completeSignup
का इस्तेमाल करना शामिल है, ताकि बाइंडिंग को मैन्युअल तरीके से बनाया जा सके.
{ "kind": "androidenterprise#enterprise", "id": string, "primaryDomain": string, "name": string, "administrator": [ { "email": string } ] }
प्रॉपर्टी का नाम | वैल्यू | ब्यौरा | ज़रूरी जानकारी |
---|---|---|---|
administrator[] |
list |
एंटरप्राइज़ के एडमिन. यह सुविधा सिर्फ़ ईएमएम से शुरू किए गए फ़्लो से बनाए गए एंटरप्राइज़ के लिए काम करती है. |
|
administrator[].email |
string |
एडमिन का ईमेल पता. | |
id |
string |
एंटरप्राइज़ का यूनीक आईडी. |
|
kind |
string |
||
name |
string |
एंटरप्राइज़ का नाम, जैसे कि "Example, Inc". | |
primaryDomain |
string |
एंटरप्राइज़ का प्राइमरी डोमेन, जैसे कि "example.com". |
तरीके
- acknowledgeNotificationSet
- Enterprises.Pull NotificationSet से मिली सूचनाओं को स्वीकार करता है, ताकि बाद में आने वाले कॉल के लिए एक जैसी सूचनाएं न मिलें.
- completeSignup
- यह पूरा करने के लिए टोकन और Enterprise टोकन की जानकारी देकर साइनअप की प्रक्रिया को पूरा करता है. किसी एंटरप्राइज़ टोकन के लिए, इस अनुरोध को एक से ज़्यादा बार नहीं जोड़ना चाहिए.
- createWebToken
- एम्बेड किए जा सकने वाले यूज़र इंटरफ़ेस (यूआई) को ऐक्सेस करने के लिए, यूनीक टोकन दिखाता है. वेब यूज़र इंटरफ़ेस (यूआई) जनरेट करने के लिए, जनरेट किए गए टोकन को 'कारोबार के लिए Google Play' JavaScript API में भेजें. हर टोकन का इस्तेमाल, सिर्फ़ एक यूज़र इंटरफ़ेस (यूआई) सेशन को शुरू करने के लिए किया जा सकता है. ज़्यादा जानकारी के लिए, JavaScript API दस्तावेज़ देखें.
- रजिस्ट्रेशन करें
- किसी एंटरप्राइज़ को ईएमएम कॉल करने के लिए रजिस्टर करें.
- generateSignupUrl
- साइन-अप यूआरएल जनरेट करता है.
- get
- किसी एंटरप्राइज़ के नाम और डोमेन को फिर से हासिल करता है.
- getServiceAccount
- सेवा खाता और क्रेडेंशियल दिखाता है. setAccount को कॉल करके सेवा खाते को एंटरप्राइज़ से जोड़ा जा सकता है. सेवा खाता
इस एंटरप्राइज़ और ईएमएम के लिए यूनीक है. साथ ही, अगर एंटरप्राइज़
अनबाउंड है, तो उसे मिटा दिया जाएगा. क्रेडेंशियल में निजी कुंजी का डेटा होता है और उन्हें सर्वर साइड पर सेव नहीं किया जाता.
इस तरीके को सिर्फ़ Enterprises.Enrollment या Enterprises.completesignup को कॉल करने और Enterprises.SetAccount को कॉल करने के बाद ही कॉल किया जा सकता है. हालांकि, अन्य मामलों में यह एक गड़बड़ी दिखाएगा.
पहली बार कॉल करने के बाद, नए और यूनीक क्रेडेंशियल जनरेट किए जाएंगे. साथ ही, पहले जनरेट किए गए क्रेडेंशियल अमान्य हो जाएंगे.
सेवा खाते के एंटरप्राइज़ से जुड़ने के बाद, इसे serviceAccountKeys संसाधन का इस्तेमाल करके मैनेज किया जा सकता है. - getStoreLayout
- एंटरप्राइज़ के लिए स्टोर लेआउट दिखाता है. अगर स्टोर का लेआउट सेट नहीं किया गया है, तो स्टोर लेआउट टाइप के तौर पर "बेसिक" दिखता है, कोई होम पेज नहीं.
- list
- डोमेन नेम के हिसाब से कोई एंटरप्राइज़ खोज रहा है. यह सिर्फ़ उन एंटरप्राइज़ के लिए काम करता है जिन्हें Google के बनाए गए फ़्लो से बनाया गया है. ईएमएम के ज़रिए शुरू किए गए फ़्लो से बनाए गए एंटरप्राइज़ के लिए, आईडी को खोजने की ज़रूरत नहीं होती, क्योंकि ईएमएम Enterprises.generatesignupUrl कॉल में दिए गए कॉलबैक में, एंटरप्राइज़ आईडी को पहचान लेता है.
- pullNotificationSet
- अनुरोध के लिए पुष्टि किए गए सेवा खाते से जुड़े एंटरप्राइज़ के लिए, सूचना सेट को खींचता है और दिखाता है. अगर कोई सूचना लंबित नहीं है, तो
सूचना सेट खाली हो सकती है.
लौटाए गए सूचना सेट को Enterprises.AcknowledgeNotificationsSet को कॉल करके, 20 सेकंड के अंदर स्वीकार करना ज़रूरी है. ऐसा तब तक होगा, जब तक सूचना सेट खाली न हो.
जिन सूचनाओं को 20 सेकंड के अंदर स्वीकार नहीं किया जाएगा उन्हें किसी दूसरे Pullसूचना सेट अनुरोध के जवाब में फिर से शामिल कर दिया जाएगा. जिन सूचनाओं को कभी स्वीकार नहीं किया जाएगा उन्हें Google Cloud Platform की Pub/Sub सिस्टम नीति के मुताबिक मिटा दिया जाएगा.
सूचनाएं पाने के लिए एक साथ कई अनुरोध किए जा सकते हैं. ऐसे में, अगर कोई सूचना 'मंज़ूरी बाकी है' होती है, तो उसे हर कॉलर के बीच बांटा जाएगा.
अगर कोई सूचना मौजूद नहीं है, तो सूचनाओं की एक खाली सूची दिखती है. ऐसा हो सकता है कि अनुरोध करने पर, ज़्यादा सूचनाएं मिलें. - sendTestPushNotification
- इस एंटरप्राइज़ के लिए, Google Cloud Pub/Sub सेवा के साथ ईएमएम इंटिग्रेशन की पुष्टि करने के लिए, जांच की सूचना भेजता है.
- setAccount
- वह खाता सेट करता है जिसका इस्तेमाल एपीआई की मदद से पुष्टि करने के लिए, एंटरप्राइज़ के तौर पर किया जाता है.
- setStoreLayout
- एंटरप्राइज़ के लिए स्टोर लेआउट सेट करता है. डिफ़ॉल्ट रूप से, storeLayoutType "बेसिक" पर सेट होता है और बेसिक स्टोर लेआउट चालू रहता है. बुनियादी लेआउट में सिर्फ़ ऐसे ऐप्लिकेशन शामिल होते हैं जिन्हें एडमिन ने मंज़ूरी दी हो. साथ ही, इन्हें उपयोगकर्ता के लिए उपलब्ध प्रॉडक्ट सेट में जोड़ा गया हो. इसके लिए, setAvailableProductSet कॉल का इस्तेमाल किया जा सकता है. पेज पर मौजूद ऐप्लिकेशन, उनकी प्रॉडक्ट आईडी की वैल्यू के हिसाब से क्रम में लगाए जाते हैं. अगर आपने स्टोर लेआउट (storeLayoutType = "कस्टम" को सेट करके और कोई होम पेज सेट करके) कस्टम स्टोर लेआउट बनाया है, तो बेसिक स्टोर लेआउट बंद हो जाता है.
- सेवा छोड़ना
- किसी एंटरप्राइज़ को ईएमएम कॉल करने की सुविधा से हटा देता है.