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

डेटा के लिए ऐब्सलूट यूआरएल, जिसमें एचटीटीपी या एचटीटीपीएस स्कीम का इस्तेमाल किया जाना चाहिए. Android Device Policy ऐप्लिकेशन, जीईटी अनुरोध में कोई क्रेडेंशियल नहीं देती. इसलिए, यूआरएल ऐसा होना चाहिए जिसे कोई भी ऐक्सेस कर सके. यूआरएल में एक लंबे, रैंडम कॉम्पोनेंट को शामिल किया जा सकता है, ताकि हमलावर यूआरएल को न ढूंढ पाएं.
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 कॉन्फ़िगरेशन पास किया जाता है, तो यह पहले जैसे 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 वाले SigninDetail को SIGNIN_DETAIL_IS_DEFAULT पर सेट किया जाता है. इसका इस्तेमाल Google खाते को रजिस्टर करने के तरीके के लिए किया जाता है. एंटरप्राइज़ के signinDetails में से सिर्फ़ एक के लिए, defaultStatus को SIGNIN_DETAIL_IS_DEFAULT पर सेट किया जा सकता है. अगर किसी Enterprise में कम से कम एक signinDetails है और किसी में भी defaultStatus को SIGNIN_DETAIL_IS_DEFAULT पर सेट नहीं किया गया है, तो सूची में से पहले विकल्प को चुना जाएगा. साथ ही, defaultStatus को SIGNIN_DETAIL_IS_DEFAULT पर सेट किया जाएगा. अगर Enterprise के लिए कोई signinDetails तय नहीं किया गया है, तो Google खाते से डिवाइस को रजिस्टर नहीं किया जा सकेगा.
tokenTag

string

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 से उपयोगकर्ता की पुष्टि होना ज़रूरी है.

तरीके

create

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

delete

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

get

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

list

 यह नीति, ईएमएम से मैनेज किए जाने वाले एंटरप्राइज़ की सूची दिखाती है.

patch

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