REST Resource: enterprises

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

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

जेएसओएन के काेड में दिखाना 
{
  "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)
  }
}
फ़ील्ड
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)

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

NotificationType

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

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

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

ExternalData

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

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

string

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

string

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

TermsAndConditions

प्रावधान के दौरान स्वीकार किया जाने वाला नियम और शर्तें पेज.

जेएसओएन के काेड में दिखाना 
{
  "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 का अनुरोध कर सकते हैं.
जेएसओएन के काेड में दिखाना 
{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "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)

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

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

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

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

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

string

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

ContactInfo

'कारोबार के लिए Google Play एंटरप्राइज़' के लिए संपर्क की जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "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

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

तरीके

create

 एंटरप्राइज़ बनाने के लिए.

delete

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

get

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

list

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

patch

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