REST Resource: enterprises

संसाधन: एंटरप्राइज़

एंटरप्राइज़ पर लागू किया गया कॉन्फ़िगरेशन.

JSON के काेड में दिखाना 
{
  "name": string,
  "enabledNotificationTypes": [
    enum (NotificationType)
  ],
  "pubsubTopic": string,
  "primaryColor": integer,
  "logo": {
    object (ExternalData)
  },
  "enterpriseDisplayName": string,
  "termsAndConditions": [
    {
      object (TermsAndConditions)
    }
  ],
  "appAutoApprovalEnabled": boolean,
  "signinDetails": [
    {
      object (SigninDetail)
    }
  ],
  "contactInfo": {
    object (ContactInfo)
  },
  "googleAuthenticationSettings": {
    object (GoogleAuthenticationSettings)
  },
  "enterpriseType": enum (EnterpriseType),
  "managedGooglePlayAccountsEnterpriseType": enum (ManagedGooglePlayAccountsEnterpriseType),
  "managedGoogleDomainType": enum (ManagedGoogleDomainType)
}
फ़ील्ड
name

string

यह उस एंटरप्राइज़ का नाम होता है जिसे सर्वर, एंटरप्राइज़ बनाते समय जनरेट करता है. यह � के फ़ॉर्म में होता है.enterprises/{enterpriseId}
enabledNotificationTypes[]

enum (NotificationType)

Google Pub/Sub की सूचनाएं किस तरह की हैं, जिन्हें एंटरप्राइज़ के लिए चालू किया गया है.
pubsubTopic

string

वह विषय जिस पर Pub/Sub सूचनाएं पब्लिश की जाती हैं. यह projects/{project}/topics/{topic} फ़ॉर्मैट में होता है. यह फ़ील्ड सिर्फ़ तब ज़रूरी होता है, जब Pub/Sub सूचनाएं पाने की सुविधा चालू हो.
primaryColor

integer

आरजीबी फ़ॉर्मैट में मौजूद एक रंग, जो डिवाइस मैनेजमेंट ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) में मुख्य रंग के तौर पर दिखाया जाता है. कलर कॉम्पोनेंट इस तरह से सेव किए जाते हैं: (red << 16) | (green << 8) | blue. इसमें हर कॉम्पोनेंट की वैल्यू 0 से 255 के बीच होती है.
enterpriseDisplayName

string

उपयोगकर्ताओं को दिखने वाले एंटरप्राइज़ का नाम. इस फ़ील्ड की लंबाई ज़्यादा से ज़्यादा 100 वर्णों की है.
termsAndConditions[]

object (TermsAndConditions)

इस एंटरप्राइज़ के लिए डिवाइस उपलब्ध कराते समय, इन नियमों और शर्तों को स्वीकार करना ज़रूरी है. इस सूची में मौजूद हर वैल्यू के लिए, शर्तों का एक पेज जनरेट किया जाता है.
appAutoApprovalEnabled
(deprecated)

boolean

यह सुविधा अब काम नहीं करती और इसका इस्तेमाल नहीं किया जाता.
signinDetails[]

object (SigninDetail)

बड़े कारोबार के साइन-इन की जानकारी.
contactInfo

object (ContactInfo)

ईएमएम की मदद से मैनेज किए जा रहे एंटरप्राइज़ की संपर्क जानकारी.
googleAuthenticationSettings

object (GoogleAuthenticationSettings)

Google की ओर से उपलब्ध कराई गई, उपयोगकर्ता की पुष्टि करने की सुविधा के लिए सेटिंग.
enterpriseType

enum (EnterpriseType)

सिर्फ़ आउटपुट के लिए. यह किस तरह का एंटरप्राइज़ है.
managedGooglePlayAccountsEnterpriseType

enum (ManagedGooglePlayAccountsEnterpriseType)

सिर्फ़ आउटपुट के लिए. मैनेज किए जा रहे Google Play खातों वाले एंटरप्राइज़ का टाइप.
managedGoogleDomainType

enum (ManagedGoogleDomainType)

सिर्फ़ आउटपुट के लिए. मैनेज किए गए Google डोमेन का टाइप.

NotificationType

डिवाइस मैनेजमेंट सर्वर, Google Pub/Sub के ज़रिए किस तरह की सूचनाएं भेज सकता है.

Enums
NOTIFICATION_TYPE_UNSPECIFIED इस वैल्यू को अनदेखा कर दिया जाता है.
ENROLLMENT यह सूचना तब भेजी जाती है, जब कोई डिवाइस रजिस्टर करता है.
COMPLIANCE_REPORT

समर्थन नहीं होना या रुकना.
STATUS_REPORT यह सूचना तब भेजी जाती है, जब कोई डिवाइस स्टेटस रिपोर्ट भेजता है.
COMMAND यह सूचना तब भेजी जाती है, जब डिवाइस के लिए कोई निर्देश पूरा हो जाता है.
USAGE_LOGS जब डिवाइस BatchUsageLogEvents भेजता है, तब यह सूचना भेजी जाती है.
ENTERPRISE_UPGRADE किसी एंटरप्राइज़ खाते को अपग्रेड करने के लिए भेजी गई सूचना. एंटरप्राइज़ अपग्रेड, Managed Google Play Accounts Enterprise को Managed Google Domains में अपग्रेड करने की प्रोसेस है.

ExternalData

डेटा को किसी बाहरी जगह पर होस्ट किया गया हो. इस डेटा को Android Device Policy ऐप्लिकेशन को डाउनलोड करना होता है. साथ ही, हैश से इसकी पुष्टि करनी होती है.

JSON के काेड में दिखाना 
{
  "url": string,
  "sha256Hash": string
}
फ़ील्ड
url

string

डेटा का पूरा यूआरएल. इसमें एचटीटीपी या एचटीटीपीएस स्कीम का इस्तेमाल करना ज़रूरी है. Android Device Policy, GET अनुरोध में कोई क्रेडेंशियल नहीं देता है. इसलिए, यूआरएल को सार्वजनिक तौर पर ऐक्सेस किया जा सकता है. यूआरएल में लंबा और रैंडम कॉम्पोनेंट शामिल करने से, हमलावरों को यूआरएल का पता लगाने से रोका जा सकता है.
sha256Hash

string

यूआरएल पर होस्ट किए गए कॉन्टेंट का base-64 एन्कोड किया गया SHA-256 हैश. अगर कॉन्टेंट इस हैश से मेल नहीं खाता है, तो Android Device Policy इस डेटा का इस्तेमाल नहीं करेगी.

TermsAndConditions

नियम और शर्तों वाला पेज, जिसे सेवा चालू करने के दौरान स्वीकार करना होगा.

JSON के काेड में दिखाना 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
फ़ील्ड
header

object (UserFacingMessage)

यह एचटीएमएल कॉन्टेंट के ऊपर दिखने वाला छोटा हेडर होता है.
content

object (UserFacingMessage)

अच्छी तरह से फ़ॉर्मैट की गई एचटीएमएल स्ट्रिंग. इसे क्लाइंट पर android.text.Html#fromHtml के साथ पार्स किया जाएगा.

SigninDetail

यह एक ऐसा संसाधन है जिसमें किसी एंटरप्राइज़ के लिए साइन इन करने की जानकारी होती है. किसी एंटरप्राइज़ के लिए SigninDetail मैनेज करने के लिए, enterprises का इस्तेमाल करें.

किसी एंटरप्राइज़ के लिए, हमारे पास कई SigninDetail हो सकते हैं. इनकी पहचान, इन तीन फ़ील्ड (signinUrl, allowPersonalUsage, tokenTag) के कॉम्बिनेशन से की जाती है. कोई भी व्यक्ति, एक जैसे (signinUrl, allowPersonalUsage, tokenTag) वाले दो SigninDetail नहीं बना सकता. (tokenTag एक वैकल्पिक फ़ील्ड है).

Patch: इस ऑपरेशन से, SigninDetails की मौजूदा सूची को SigninDetails की नई सूची से अपडेट किया जाता है.

  • अगर सेव किया गया SigninDetail कॉन्फ़िगरेशन पास हो जाता है, तो यह उसी SigninDetail और qrCode को दिखाता है.signinEnrollmentToken
  • अगर हम एक जैसे कई SigninDetail कॉन्फ़िगरेशन पास करते हैं जिन्हें सेव नहीं किया जाता है, तो यह उन SigninDetail कॉन्फ़िगरेशन में से पहले कॉन्फ़िगरेशन को सेव करेगा.
  • अगर कॉन्फ़िगरेशन पहले से मौजूद है, तो हम किसी खास पैच एपीआई कॉल में एक से ज़्यादा बार इसका अनुरोध नहीं कर सकते. ऐसा करने पर, डुप्लीकेट कुंजी की गड़बड़ी दिखेगी और पूरी कार्रवाई पूरी नहीं हो पाएगी.
  • अगर हम अनुरोध से कुछ SigninDetail कॉन्फ़िगरेशन हटा देते हैं, तो वे स्टोरेज से भी हट जाएंगे. इसके बाद, हम उसी SigninDetail कॉन्फ़िगरेशन के लिए, एक और signinEnrollmentToken और qrCode का अनुरोध कर सकते हैं.
JSON के काेड में दिखाना 
{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "defaultStatus": enum (SigninDetailDefaultStatus),
  "tokenTag": string
}
फ़ील्ड
signinUrl

string

यह साइन-इन यूआरएल, पुष्टि करने के लिए होता है. इसका इस्तेमाल तब किया जाता है, जब डिवाइस को साइन-इन एनरोलमेंट टोकन के साथ प्रोविज़न किया गया हो. साइन-इन एंडपॉइंट को पुष्टि करने की प्रोसेस पूरी करनी चाहिए. इसके लिए, लॉगिन होने पर https://enterprise.google.com/android/enroll?et= फ़ॉर्मैट वाला यूआरएल इस्तेमाल करना चाहिए. वहीं, लॉगिन न होने पर https://enterprise.google.com/android/enroll/invalid फ़ॉर्मैट वाला यूआरएल इस्तेमाल करना चाहिए.
signinEnrollmentToken

string

यह पूरे एंटरप्राइज़ के लिए इस्तेमाल किया जाने वाला एनरोलमेंट टोकन है. इसका इस्तेमाल, कस्टम साइन-इन फ़्लो को ट्रिगर करने के लिए किया जाता है. यह सर्वर से जनरेट किया गया रीड-ओनली फ़ील्ड है.
qrCode

string

यह एक JSON स्ट्रिंग है. इसके UTF-8 वर्शन का इस्तेमाल करके, एक क्यूआर कोड जनरेट किया जा सकता है. इस क्यूआर कोड को स्कैन करके, डिवाइस को इस रजिस्ट्रेशन टोकन के साथ रजिस्टर किया जा सकता है. एनएफ़सी का इस्तेमाल करके किसी डिवाइस को रजिस्टर करने के लिए, एनएफ़सी रिकॉर्ड में JSON में मौजूद प्रॉपर्टी का क्रम से लगाया गया java.util.Properties होना चाहिए. यह सर्वर से जनरेट किया गया रीड-ओनली फ़ील्ड है.
allowPersonalUsage

enum (AllowPersonalUsage)

इस नीति से यह कंट्रोल किया जाता है कि इस रजिस्ट्रेशन टोकन से प्रावधान किए गए डिवाइस पर, निजी इस्तेमाल की अनुमति है या नहीं.

कंपनी के मालिकाना हक वाले डिवाइसों के लिए:

  • निजी इस्तेमाल की सुविधा चालू करने पर, उपयोगकर्ता को डिवाइस पर वर्क प्रोफ़ाइल सेट अप करने की अनुमति मिलती है.
  • निजी इस्तेमाल की सुविधा बंद करने के लिए, उपयोगकर्ता को डिवाइस को पूरी तरह से मैनेज किए जा रहे डिवाइस के तौर पर सेट अप करना होगा.

निजी डिवाइसों के लिए:

  • निजी इस्तेमाल की सुविधा चालू करने पर, उपयोगकर्ता को डिवाइस पर वर्क प्रोफ़ाइल सेट अप करने की अनुमति मिलती है.
  • निजी इस्तेमाल की सुविधा बंद करने पर, डिवाइस का प्रावधान नहीं किया जा सकेगा. निजी तौर पर इस्तेमाल किए जाने वाले डिवाइस पर, निजी इस्तेमाल को बंद नहीं किया जा सकता.
defaultStatus

enum (SigninDetailDefaultStatus)

ज़रूरी नहीं. क्या साइन-इन यूआरएल का इस्तेमाल, एंटरप्राइज़ के लिए डिफ़ॉल्ट रूप से किया जाना चाहिए. defaultStatus को SIGNIN_DETAIL_IS_DEFAULT पर सेट करने वाले SigninDetail का इस्तेमाल, Google खाते में रजिस्टर करने के तरीके के लिए किया जाता है. किसी एंटरप्राइज़ के सिर्फ़ एक signinDetails के लिए, defaultStatus को SIGNIN_DETAIL_IS_DEFAULT पर सेट किया जा सकता है. अगर किसी Enterprise में कम से कम एक signinDetails है और उनमें से किसी के लिए भी defaultStatus को SIGNIN_DETAIL_IS_DEFAULT पर सेट नहीं किया गया है, तो सूची में मौजूद पहले signinDetails को चुना जाएगा और उसके लिए defaultStatus को SIGNIN_DETAIL_IS_DEFAULT पर सेट किया जाएगा. अगर Enterprise के लिए कोई signinDetails नहीं दिया गया है, तो Google खाते से डिवाइस रजिस्टर नहीं हो पाएगा.
tokenTag

string

EMM की ओर से तय किया गया मेटाडेटा, ताकि SigninDetail के इंस्टेंस के बीच अंतर किया जा सके.

SigninDetailDefaultStatus

क्या साइन-इन यूआरएल का इस्तेमाल, एंटरप्राइज़ के लिए डिफ़ॉल्ट रूप से किया जाना चाहिए.

Enums
SIGNIN_DETAIL_DEFAULT_STATUS_UNSPECIFIED SIGNIN_DETAIL_IS_NOT_DEFAULT के बराबर.
SIGNIN_DETAIL_IS_DEFAULT एंटरप्राइज़ के लिए, साइन-इन यूआरएल का इस्तेमाल डिफ़ॉल्ट रूप से किया जाएगा.
SIGNIN_DETAIL_IS_NOT_DEFAULT साइन-इन यूआरएल का इस्तेमाल, डिफ़ॉल्ट रूप से एंटरप्राइज़ के लिए नहीं किया जाएगा.

ContactInfo

मैनेज किए जा रहे Google Play एंटरप्राइज़ के लिए संपर्क जानकारी.

JSON के काेड में दिखाना 
{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
फ़ील्ड
contactEmail

string

संपर्क करने के लिए ईमेल पता. इसका इस्तेमाल, मैनेज किए जा रहे Google Play से जुड़ी ज़रूरी सूचनाएं भेजने के लिए किया जाएगा.
dataProtectionOfficerName

string

डेटा सुरक्षा अधिकारी का नाम.
dataProtectionOfficerEmail

string

डेटा सुरक्षा अधिकारी का ईमेल पता. ईमेल की पुष्टि हो गई है, लेकिन इसकी पुष्टि नहीं हुई है.
dataProtectionOfficerPhone

string

डेटा सुरक्षा अधिकारी का फ़ोन नंबर. फ़ोन नंबर की पुष्टि हो गई है, लेकिन इसकी पुष्टि नहीं हुई है.
euRepresentativeName

string

ईयू (यूरोपीय संघ) के प्रतिनिधि का नाम.
euRepresentativeEmail

string

ईयू (यूरोपीय संघ) के प्रतिनिधि का ईमेल पता. ईमेल की पुष्टि हो गई है, लेकिन इसकी पुष्टि नहीं हुई है.
euRepresentativePhone

string

ईयू प्रतिनिधि का फ़ोन नंबर. फ़ोन नंबर की पुष्टि हो गई है, लेकिन उसे सत्यापित नहीं किया गया है.

GoogleAuthenticationSettings

इसमें Google की ओर से उपलब्ध कराई गई, उपयोगकर्ता की पुष्टि करने की सेटिंग होती हैं.

JSON के काेड में दिखाना 
{
  "googleAuthenticationRequired": enum (GoogleAuthenticationRequired)
}
फ़ील्ड
googleAuthenticationRequired

enum (GoogleAuthenticationRequired)

सिर्फ़ आउटपुट के लिए. क्या रजिस्ट्रेशन की प्रोसेस के दौरान, उपयोगकर्ताओं की पुष्टि Google से करानी होगी. आईटी एडमिन यह तय कर सकता है कि नॉलेज वर्कर के डिवाइसों के लिए, Google की पुष्टि करने की सुविधा चालू है या नहीं. इस वैल्यू को सिर्फ़ Google Admin Console के ज़रिए सेट किया जा सकता है. Google की पुष्टि करने की सुविधा का इस्तेमाल signinUrl के साथ किया जा सकता है. अगर Google की पुष्टि करने की सुविधा ज़रूरी है और signinUrl तय किया गया है, तो Google की पुष्टि करने की सुविधा, signinUrl से पहले लॉन्च की जाएगी.

GoogleAuthenticationRequired

यह सेटिंग तय करती है कि इस एंटरप्राइज़ के लिए, Google खाते से पुष्टि करना ज़रूरी है या नहीं.

Enums
GOOGLE_AUTHENTICATION_REQUIRED_UNSPECIFIED इस वैल्यू का इस्तेमाल नहीं किया जाता.
NOT_REQUIRED Google खाते से पुष्टि करने की ज़रूरत नहीं है.
REQUIRED उपयोगकर्ता की पुष्टि Google से होनी चाहिए.

EnterpriseType

यह किस तरह का एंटरप्राइज़ है.

Enums
ENTERPRISE_TYPE_UNSPECIFIED इस वैल्यू का इस्तेमाल नहीं किया जाता.
MANAGED_GOOGLE_DOMAIN यह एंटरप्राइज़, मैनेज किए जा रहे Google डोमेन से जुड़ा है.
MANAGED_GOOGLE_PLAY_ACCOUNTS_ENTERPRISE एंटरप्राइज़, कारोबार के लिए Google Play खाते वाला एंटरप्राइज़ है.

ManagedGooglePlayAccountsEnterpriseType

मैनेज किए जा रहे Google Play खातों वाले एंटरप्राइज़ का टाइप.

Enums
MANAGED_GOOGLE_PLAY_ACCOUNTS_ENTERPRISE_TYPE_UNSPECIFIED मैनेज किए जा रहे कारोबार के लिए Google Play खातों के एंटरप्राइज़ का टाइप नहीं बताया गया है.
CUSTOMER_MANAGED एंटरप्राइज़ को ग्राहक मैनेज करता है
EMM_MANAGED यह एंटरप्राइज़, ईएमएम की मदद से मैनेज किया जाता है (बंद कर दिया गया है).

ManagedGoogleDomainType

मैनेज किए गए Google डोमेन का टाइप.

Enums
MANAGED_GOOGLE_DOMAIN_TYPE_UNSPECIFIED मैनेज किए गए Google डोमेन का टाइप नहीं बताया गया है.
TYPE_TEAM मैनेज किया गया Google डोमेन, ईमेल से पुष्टि की गई टीम है.
TYPE_DOMAIN मैनेज किए जा रहे Google डोमेन की पुष्टि हो चुकी है.

तरीके

create

 यह फ़ंक्शन, एंटरप्राइज़ बनाता है.

delete

 यह किसी एंटरप्राइज़ और उससे जुड़े सभी खातों और डेटा को हमेशा के लिए मिटा देता है.

generateEnterpriseUpgradeUrl

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

get

 एंटरप्राइज़ को ऐक्सेस करता है.

list

 ईएमएम से मैनेज किए जा रहे एंटरप्राइज़ की सूची बनाता है.

patch

 किसी एंटरप्राइज़ को अपडेट करता है.