Enterprises

इस संसाधन के तरीकों की सूची के लिए, इस पेज का अंत देखें.

रिसॉर्स प्रतिनिधित्व

एंटरप्राइज़ संसाधन, ईएमएम और किसी खास संगठन के बीच बाइंडिंग को दिखाता है. उस बाइंडिंग को इस एपीआई का इस्तेमाल करके, दो अलग-अलग तरीकों में से किसी एक से इस तरह इंस्टैंशिएट किया जा सकता है:

  • Google की तरफ़ से मैनेज किए जा रहे डोमेन के ग्राहकों के लिए, इस प्रोसेस में Enterprises.enroll और Enterprises.setAccount का इस्तेमाल करना (Admin console और Google API कंसोल से मिले आर्टफ़ैक्ट के साथ) का इस्तेमाल करना शामिल है. साथ ही, ईएमएम में कम या ज़्यादा मैन्युअल प्रोसेस के ज़रिए सबमिट किया जाता है.
  • मैनेज किए जा रहे Google Play खाते का इस्तेमाल करने वाले ग्राहकों के लिए, इस प्रोसेस में 'मैनेज किए जा रहे Google Play साइन-अप यूज़र इंटरफ़ेस (यूआई)' के साथ Enterprises.generateSignupUrl और Enterprises.completeSignup का इस्तेमाल करना शामिल है, ताकि बाइंडिंग को मैन्युअल तरीके से बनाया जा सके.
ईएमएम के तौर पर, ईएमएम कंसोल में दोनों तरीकों में से किसी एक या दोनों के साथ काम किया जा सकता है. ज़्यादा जानकारी के लिए, Enterprise बनाएं देखें.

{
  "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 = "कस्टम" को सेट करके और कोई होम पेज सेट करके) कस्टम स्टोर लेआउट बनाया है, तो बेसिक स्टोर लेआउट बंद हो जाता है.
सेवा छोड़ना
किसी एंटरप्राइज़ को ईएमएम कॉल करने की सुविधा से हटा देता है.