MCP Tools Reference: Android Device Management MCP Server

टूल: list_enterprises

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

यहां दिए गए सैंपल में, curl का इस्तेमाल करके list_enterprises एमसीपी टूल को शुरू करने का तरीका बताया गया है.

Curl अनुरोध 
                  
curl --location 'https://androidmanagement.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_enterprises",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

इनपुट स्कीमा

ईएमएम की मदद से मैनेज किए जा रहे एंटरप्राइज़ को सूची में शामिल करने का अनुरोध.

ListEnterprisesRequest

JSON के काेड में दिखाना 
{
  "projectId": string,
  "pageSize": integer,
  "pageToken": string,
  "view": enum (EnterpriseView)
}
फ़ील्ड
projectId

string

ज़रूरी है. कारोबारों को मैनेज करने वाले ईएमएम का Cloud प्रोजेक्ट आईडी.
pageSize

integer

अनुरोध किए गए पेज का साइज़. पेज का असल साइज़, कम से कम या ज़्यादा से ज़्यादा वैल्यू पर सेट किया जा सकता है.
pageToken

string

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

enum (EnterpriseView)

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

आउटपुट स्कीमा

उद्यमों की सूची बनाने के अनुरोध का जवाब.

ListEnterprisesResponse

JSON के काेड में दिखाना 
{
  "enterprises": [
    {
      object (Enterprise)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
enterprises[]

object (Enterprise)

उद्यमों की सूची.
nextPageToken

string

अगर ज़्यादा नतीजे मौजूद हैं, तो नतीजों का अगला पेज पाने के लिए टोकन.

Enterprise

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 के बीच होती है.
logo

object (ExternalData)

डिवाइस प्रोविज़निंग के दौरान, लोगो के तौर पर दिखाई गई इमेज. इमेज के लिए इस्तेमाल किए जा सकने वाले टाइप: image/bmp, image/gif, image/x-ico, image/jpeg, image/png, image/webp, image/vnd.wap.wbmp, image/x-adobe-dng.
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 डोमेन का टाइप.

Int32Value

JSON के काेड में दिखाना 
{
  "value": integer
}
फ़ील्ड
value

integer

int32 वैल्यू.

ExternalData

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

string

डेटा का पूरा यूआरएल. इसमें http या https स्कीम का इस्तेमाल किया जाना चाहिए. 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 के साथ पार्स किया जाएगा.

UserFacingMessage

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

map (key: string, value: string)

यह एक ऐसा मैप होता है जिसमें <locale, message> जोड़े होते हैं. इसमें locale, BCP 47 भाषा का सही फ़ॉर्मैट वाला कोड होता है. जैसे, en-US, es-ES या fr.

एक ऑब्जेक्ट, जिसमें "key": value जोड़े की सूची शामिल हो. उदाहरण: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
defaultMessage

string

अगर कोई स्थानीय मैसेज नहीं दिया गया है या उपयोगकर्ता की जगह की जानकारी, स्थानीय मैसेज से मेल नहीं खाती है, तो डिफ़ॉल्ट मैसेज दिखाया जाता है. अगर स्थानीय भाषा के मुताबिक तैयार किए गए मैसेज दिए जाते हैं, तो डिफ़ॉल्ट मैसेज देना ज़रूरी है.

LocalizedMessagesEntry

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

string
value

string

SigninDetail

JSON के काेड में दिखाना 
{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "defaultStatus": enum (SigninDetailDefaultStatus),

  // Union field _token_tag can be only one of the following:
  "tokenTag": string
  // End of list of possible types for union field _token_tag.
}
फ़ील्ड
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)

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

यूनियन फ़ील्ड _token_tag.

_token_tag इनमें से सिर्फ़ एक हो सकता है:
tokenTag

string

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

ContactInfo

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

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

enum (GoogleAuthenticationRequired)

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

टूल एनोटेशन

बदलाव करने वाला हिंट: ❌ | एक ही बार लागू होने वाला हिंट: ✅ | सिर्फ़ पढ़ने वाला हिंट: ✅ | ओपन वर्ल्ड हिंट: ❌