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)
  }
}
फ़ील्ड
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 की ओर से उपयोगकर्ता की पुष्टि करने की सेटिंग.

NotificationType

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

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

समर्थन नहीं होना या रुकना.
STATUS_REPORT जब कोई डिवाइस स्टेटस रिपोर्ट जारी करता है, तब भेजी जाने वाली सूचना.
COMMAND डिवाइस को दिया गया निर्देश पूरा होने पर भेजी जाने वाली सूचना.
USAGE_LOGS डिवाइस से BatchUsageLogEvents भेजे जाने पर सूचना भेजी जाती है.

ExternalData

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

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

string

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

string

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

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 कॉन्फ़िगरेशन पास हो जाता है, तो यह वही signinEnrollmentToken और qrCode दिखाता है.
  • अगर हम एक जैसे कई 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

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

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 ने कर ली हो.

तरीके

create

 एंटरप्राइज़ बनाता है.

delete

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

get

 एंटरप्राइज़ मिलता है.

list

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

patch

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