Enterprises

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

संसाधन के बारे में जानकारी

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

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

ईएमएम के तौर पर, ईएमएम कंसोल में इनमें से किसी एक या दोनों तरीकों का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, एंटरप्राइज़ बनाना लेख पढ़ें.

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ],
  "googleAuthenticationSettings": {
    "googleAuthenticationRequired": string,
    "dedicatedDevicesAllowed": string,
    "createdAt": {
      "seconds": long,
      "nanos": integer
    },
    "updatedAt": {
      "seconds": long,
      "nanos": integer
    }
  },
  "enterpriseType": string,
  "managedGoogleDomainType": string
}

प्रॉपर्टी का नाम	मान	ब्यौरा	नोट
administrator[]	list	एंटरप्राइज़ के एडमिन. यह सुविधा सिर्फ़ उन एंटरप्राइज़ के लिए उपलब्ध है जिन्हें ईएमएम की मदद से बनाया गया है.
administrator[].email	string	एडमिन का ईमेल पता.
enterpriseType	string	यह किस तरह का एंटरप्राइज़ है. इन वैल्यू का इस्तेमाल किया जा सकता है: "enterpriseTypeUnspecified" "managedGoogleDomain" "managedGooglePlayAccountsEnterprise"
googleAuthenticationSettings	nested object	Google की ओर से उपलब्ध कराई गई, उपयोगकर्ता की पुष्टि करने की सुविधा के लिए सेटिंग.
googleAuthenticationSettings.createdAt	nested object	सेटिंग को पहली बार बनाने या उसमें बदलाव करने का टाइमस्टैंप.
googleAuthenticationSettings.createdAt.nanos	integer	नैनोसेकंड रिज़ॉल्यूशन पर, एक सेकंड के नॉन-नेगेटिव फ़्रैक्शन. भिन्नात्मक वैल्यू वाली नेगेटिव सेकंड वैल्यू में, नैनोसेकंड की नॉन-नेगेटिव वैल्यू होनी चाहिए. यह 0 से लेकर 999,999,999 के बीच की कोई संख्या होनी चाहिए.
googleAuthenticationSettings.createdAt.seconds	long	यह Unix epoch 1970-01-01T00:00:00Z से यूटीसी समय के सेकंड को दिखाता है. यह 0001-01-01T00:00:00Z से 9999-12-31T23:59:59Z के बीच होना चाहिए.
googleAuthenticationSettings.dedicatedDevicesAllowed	string	क्या खास तरह के डिवाइसों को अनुमति दी गई है. इन वैल्यू का इस्तेमाल किया जा सकता है: "allowed" "dedicatedDevicesAllowedUnspecified" "disallowed"
googleAuthenticationSettings.googleAuthenticationRequired	string	इससे पता चलता है कि Google खाते से पुष्टि करना ज़रूरी है या नहीं. इन वैल्यू का इस्तेमाल किया जा सकता है: "googleAuthenticationRequiredUnspecified" "notRequired" "required"
googleAuthenticationSettings.updatedAt	nested object	सेटिंग में पिछली बार बदलाव किए जाने का टाइमस्टैंप.
googleAuthenticationSettings.updatedAt.nanos	integer	नैनोसेकंड रिज़ॉल्यूशन पर, एक सेकंड के नॉन-नेगेटिव फ़्रैक्शन. भिन्नात्मक वैल्यू वाली नेगेटिव सेकंड वैल्यू में, नैनोसेकंड की नॉन-नेगेटिव वैल्यू होनी चाहिए. यह 0 से लेकर 999,999,999 के बीच की कोई संख्या होनी चाहिए.
googleAuthenticationSettings.updatedAt.seconds	long	यह Unix epoch 1970-01-01T00:00:00Z से यूटीसी समय के सेकंड को दिखाता है. यह 0001-01-01T00:00:00Z से 9999-12-31T23:59:59Z के बीच होना चाहिए.
id	string	यह एंटरप्राइज़ का यूनीक आईडी होता है.
id	string	यह एंटरप्राइज़ का यूनीक आईडी होता है.
kind	string
managedGoogleDomainType	string	मैनेज किए जा रहे Google डोमेन का टाइप इन वैल्यू का इस्तेमाल किया जा सकता है: "managedGoogleDomainTypeUnspecified" "typeDomain" "typeTeam"
name	string	कंपनी का नाम. उदाहरण के लिए, "Example, Inc".
primaryDomain	string	कंपनी का प्राइमरी डोमेन, जैसे कि "example.com".

तरीके

acknowledgeNotificationSet

एंटरप्राइज़ से मिली सूचनाओं की पुष्टि करता है.PullNotificationSet का इस्तेमाल करके, यह पुष्टि की जाती है, ताकि बाद में किए जाने वाले कॉल में वही सूचनाएं न मिलें.

completeSignup

साइनअप फ़्लो पूरा करता है. इसके लिए, वह कंप्लीशन टोकन और एंटरप्राइज़ टोकन तय करता है. किसी Enterprise टोकन के लिए, इस अनुरोध को एक से ज़्यादा बार कॉल नहीं किया जाना चाहिए.

createWebToken

यह एम्बेड किए जा सकने वाले यूज़र इंटरफ़ेस (यूआई) को ऐक्सेस करने के लिए, एक यूनीक टोकन दिखाता है. वेब यूज़र इंटरफ़ेस (यूआई) जनरेट करने के लिए, जनरेट किए गए टोकन को Managed Google Play JavaScript API में पास करें. हर टोकन का इस्तेमाल सिर्फ़ एक यूज़र इंटरफ़ेस (यूआई) सेशन शुरू करने के लिए किया जा सकता है. ज़्यादा जानकारी के लिए, JavaScript API से जुड़ा दस्तावेज़ देखें.

रजिस्टर करें

यह कॉलिंग ईएमएम के साथ किसी एंटरप्राइज़ को रजिस्टर करता है.

generateEnterpriseUpgradeUrl

यह मैनेज किए जा रहे Google Play खातों वाले मौजूदा एंटरप्राइज़ को मैनेज किए जा रहे Google डोमेन में अपग्रेड करने के लिए, एंटरप्राइज़ अपग्रेड यूआरएल जनरेट करता है. ज़्यादा जानकारी के लिए, एंटरप्राइज़ खाते को अपग्रेड करने से जुड़ी गाइड देखें.

generateSignupUrl

साइन-अप यूआरएल जनरेट करता है.

पाएं

यह किसी एंटरप्राइज़ का नाम और डोमेन वापस पाता है.

getServiceAccount

यह सेवा खाता और क्रेडेंशियल दिखाता है. setAccount को कॉल करके, सेवा खाते को एंटरप्राइज़ से बाइंड किया जा सकता है. यह सेवा खाता, इस एंटरप्राइज़ और ईएमएम के लिए यूनीक होता है. एंटरप्राइज़ को अनलिंक करने पर, इसे मिटा दिया जाएगा. क्रेडेंशियल में निजी कुंजी का डेटा होता है. इन्हें सर्वर-साइड पर सेव नहीं किया जाता.

इस तरीके को सिर्फ़ Enterprises.Enroll या Enterprises.CompleteSignup को कॉल करने के बाद और Enterprises.SetAccount को कॉल करने से पहले कॉल किया जा सकता है. ऐसा न करने पर, यह गड़बड़ी दिखाएगा.

पहली बार कॉल करने के बाद, अगली बार कॉल करने पर क्रेडेंशियल का नया और यूनीक सेट जनरेट होगा. साथ ही, पहले जनरेट किए गए क्रेडेंशियल अमान्य हो जाएंगे.

सेवा खाते को एंटरप्राइज़ से बाइंड करने के बाद, इसे serviceAccountKeys संसाधन का इस्तेमाल करके मैनेज किया जा सकता है.

ध्यान दें: कुंजी बनाने के बाद, आपको 60 सेकंड या उससे ज़्यादा समय तक इंतज़ार करना पड़ सकता है. इसके बाद ही, कुंजी का इस्तेमाल करके कोई अन्य कार्रवाई की जा सकती है. अगर कुंजी बनाने के तुरंत बाद, उससे कोई कार्रवाई करने की कोशिश की जाती है और आपको गड़बड़ी का मैसेज मिलता है, तो एक्स्पोनेंशियल बैकऑफ़ के साथ अनुरोध को फिर से भेजें

.

getStoreLayout

यह फ़ंक्शन, एंटरप्राइज़ के लिए स्टोर लेआउट दिखाता है. अगर स्टोर लेआउट सेट नहीं किया गया है, तो यह "basic" को स्टोर लेआउट टाइप के तौर पर दिखाता है. साथ ही, कोई होम पेज नहीं दिखाता.

list

यह फ़ंक्शन, डोमेन नाम के हिसाब से किसी एंटरप्राइज़ की जानकारी ढूंढता है. यह सुविधा सिर्फ़ उन एंटरप्राइज़ के लिए उपलब्ध है जिन्हें Google ने बनाया है. ईएमएम की मदद से बनाए गए एंटरप्राइज़ के लिए, आईडी को खोजने की ज़रूरत नहीं होती. ऐसा इसलिए, क्योंकि ईएमएम को Enterprises.generateSignupUrl कॉल में बताए गए कॉलबैक में एंटरप्राइज़ आईडी की जानकारी मिलती है.

pullNotificationSet

यह अनुरोध के लिए पुष्टि किए गए सेवा खाते से जुड़े उद्यमों के लिए, सूचनाओं का सेट वापस लाता है. अगर कोई सूचना नहीं है, तो सूचना सेट खाली हो सकता है.
सूचनाओं के सेट को वापस पाने के लिए, Enterprises.AcknowledgeNotificationSet को कॉल करके 20 सेकंड के अंदर इसकी पुष्टि करनी होगी. हालांकि, अगर सूचनाओं का सेट खाली है, तो इसकी पुष्टि करने की ज़रूरत नहीं है.
जिन सूचनाओं को 20 सेकंड के अंदर स्वीकार नहीं किया जाता है उन्हें PullNotificationSet के किसी दूसरे अनुरोध के जवाब में फिर से शामिल कर दिया जाएगा. जिन सूचनाओं को कभी स्वीकार नहीं किया जाता उन्हें Google Cloud Platform Pub/Sub सिस्टम की नीति के मुताबिक मिटा दिया जाएगा.
सूचनाएं पाने के लिए, एक साथ कई अनुरोध किए जा सकते हैं. ऐसे में, अगर कोई सूचना लंबित है, तो उसे कॉल करने वाले हर व्यक्ति के साथ शेयर किया जाएगा.
अगर कोई सूचना मौजूद नहीं है, तो सूचनाओं की खाली सूची दिखती है. इसके बाद किए गए अनुरोधों के लिए, सूचनाएं उपलब्ध होने पर आपको ज़्यादा सूचनाएं मिल सकती हैं.

sendTestPushNotification

यह इस एंटरप्राइज़ के लिए, Google Cloud Pub/Sub सेवा के साथ ईएमएम इंटिग्रेशन की पुष्टि करने के लिए, एक टेस्ट सूचना भेजता है.

setAccount

यह उस खाते को सेट करता है जिसका इस्तेमाल, एपीआई में एंटरप्राइज़ के तौर पर पुष्टि करने के लिए किया जाएगा.

setStoreLayout

इससे एंटरप्राइज़ के लिए स्टोर का लेआउट सेट किया जाता है. डिफ़ॉल्ट रूप से, storeLayoutType को "basic" पर सेट किया जाता है. साथ ही, स्टोर का बेसिक लेआउट चालू होता है. बेसिक लेआउट में सिर्फ़ वे ऐप्लिकेशन शामिल होते हैं जिन्हें एडमिन ने मंज़ूरी दी है. साथ ही, उन्हें उपयोगकर्ता के लिए उपलब्ध प्रॉडक्ट सेट में जोड़ा गया है. इसके लिए, setAvailableProductSet कॉल का इस्तेमाल किया जाता है. इस पेज पर मौजूद ऐप्लिकेशन, उनके प्रॉडक्ट आईडी की वैल्यू के हिसाब से क्रम में लगाए जाते हैं. अगर आपने कस्टम स्टोर लेआउट बनाया है (storeLayoutType = "custom" सेट करके और होम पेज सेट करके), तो बुनियादी स्टोर लेआउट बंद हो जाता है.

अनरजिस्टर करें

यह कॉल करने वाले ईएमएम से किसी एंटरप्राइज़ को ऑप्ट आउट करता है.