MCP Tools Reference: Android Device Management MCP Server

ابزار: get_enterprise

یک شرکت برای شناسه شرکت داده شده دریافت می‌کند. به شناسه شرکت در فیلد نام نیاز دارد (مثلاً enterprises/{enterpriseId}).

مثال زیر نحوه استفاده از curl برای فراخوانی ابزار get_enterprise MCP را نشان می‌دهد.

درخواست کرل 
                  
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": "get_enterprise",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

طرحواره ورودی

درخواست برای دریافت یک شرکت. تمام فیلدهای موجود را برمی‌گرداند.

درخواست دریافت سازمانی

نمایش JSON 
{
  "name": string
}
فیلدها
name

string

نام شرکت به شکل enterprises/{enterpriseId} .

طرحواره خروجی

پیکربندی اعمال شده برای یک شرکت.

تصدی

نمایش 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

موضوعی که اعلان‌های انتشار/زیرمجموعه در آن منتشر می‌شوند، در قالب projects/{project}/topics/{topic} . این فیلد فقط در صورتی الزامی است که اعلان‌های انتشار/زیرمجموعه فعال باشند .

primaryColor

integer

رنگی با فرمت RGB که نشان دهنده رنگ غالب برای نمایش در رابط کاربری برنامه مدیریت دستگاه است. اجزای رنگ به صورت زیر ذخیره می‌شوند: (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

نام شرکت که به کاربران نمایش داده می‌شود. حداکثر طول این فیلد ۱۰۰ کاراکتر است.

termsAndConditions[]

object ( TermsAndConditions )

شرایط و ضوابطی که هنگام تهیه دستگاه برای این شرکت باید پذیرفته شوند. برای هر مقدار در این لیست، صفحه‌ای از شرایط ایجاد می‌شود.

appAutoApprovalEnabled
(deprecated)

boolean

مستهلک و بلااستفاده.

signinDetails[]

object ( SigninDetail )

جزئیات ورود به سیستم شرکت.

contactInfo

object ( ContactInfo )

اطلاعات تماس سازمانی یک شرکت تحت مدیریت EMM.

googleAuthenticationSettings

object ( GoogleAuthenticationSettings )

تنظیمات مربوط به احراز هویت کاربر ارائه شده توسط گوگل.

enterpriseType

enum ( EnterpriseType )

فقط خروجی. نوع شرکت.

managedGooglePlayAccountsEnterpriseType

enum ( ManagedGooglePlayAccountsEnterpriseType )

فقط خروجی. نوع حساب‌های گوگل پلی مدیریت‌شده‌ی سازمانی.

managedGoogleDomainType

enum ( ManagedGoogleDomainType )

فقط خروجی. نوع دامنه مدیریت‌شده گوگل.

Int32Value

نمایش JSON 
{
  "value": integer
}
فیلدها
value

integer

مقدار int32.

داده‌های خارجی

نمایش JSON 
{
  "url": string,
  "sha256Hash": string
}
فیلدها
url

string

آدرس اینترنتی (URL) مطلق به داده‌ها، که باید از طرح http یا https استفاده کند. خط‌مشی دستگاه اندروید هیچ گونه اعتبارنامه‌ای را در درخواست GET ارائه نمی‌دهد، بنابراین URL باید به صورت عمومی قابل دسترسی باشد. گنجاندن یک جزء طولانی و تصادفی در URL می‌تواند برای جلوگیری از کشف URL توسط مهاجمان استفاده شود.

sha256Hash

string

هش SHA-256 با کدگذاری پایه ۶۴ از محتوای میزبانی شده در url. اگر محتوا با این هش مطابقت نداشته باشد، خط‌مشی دستگاه اندروید از داده‌ها استفاده نخواهد کرد.

شرایط و ضوابط

نمایش JSON 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
فیلدها
header

object ( UserFacingMessage )

یک سربرگ کوتاه که بالای محتوای HTML ظاهر می‌شود.

content

object ( UserFacingMessage )

یک رشته HTML با قالب‌بندی مناسب. این رشته با استفاده از android.text.Html#fromHtml در سمت کلاینت تجزیه و تحلیل خواهد شد.

کاربرFacingMessage

نمایش 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

جزئیات ورود

نمایش 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

URL ورود برای احراز هویت زمانی که دستگاه با توکن ثبت نام ورود تجهیز شده است. نقطه پایانی ورود باید جریان احراز هویت را با URL ای به شکل https://enterprise.google.com/android/enroll?et= به پایان برساند. برای ورود موفقیت‌آمیز، یا برای ورود ناموفق، به آدرس https://enterprise.google.com/android/enroll/invalid مراجعه کنید.

signinEnrollmentToken

string

یک توکن ثبت‌نام در سطح سازمانی که برای راه‌اندازی جریان ورود سفارشی استفاده می‌شود. این یک فیلد فقط خواندنی است که توسط سرور تولید می‌شود.

qrCode

string

یک رشته JSON که نمایش UTF-8 آن می‌تواند برای تولید یک کد QR جهت ثبت دستگاه با این توکن ثبت استفاده شود. برای ثبت دستگاه با استفاده از NFC، رکورد NFC باید حاوی یک نمایش سریالی java.util.Properties از ویژگی‌های موجود در JSON باشد. این یک فیلد فقط خواندنی است که توسط سرور تولید می‌شود.

allowPersonalUsage

enum ( AllowPersonalUsage )

کنترل می‌کند که آیا استفاده شخصی در دستگاهی که با این توکن ثبت نام ارائه شده است، مجاز است یا خیر.

برای دستگاه‌های متعلق به شرکت:

  • فعال کردن حالت استفاده شخصی به کاربر اجازه می‌دهد تا یک پروفایل کاری روی دستگاه تنظیم کند.
  • غیرفعال کردن استفاده شخصی مستلزم آن است که کاربر دستگاه را به عنوان یک دستگاه کاملاً مدیریت‌شده ارائه دهد.

برای دستگاه‌های شخصی:

  • فعال کردن حالت استفاده شخصی به کاربر اجازه می‌دهد تا یک پروفایل کاری روی دستگاه تنظیم کند.
  • غیرفعال کردن استفاده شخصی مانع از ارائه خدمات به دستگاه می‌شود. امکان غیرفعال کردن استفاده شخصی در دستگاه شخصی وجود ندارد.
defaultStatus

enum ( SigninDetailDefaultStatus )

اختیاری. اینکه آیا URL ورود باید به طور پیش‌فرض برای شرکت استفاده شود یا خیر. SigninDetail با defaultStatus تنظیم شده روی SIGNIN_DETAIL_IS_DEFAULT برای روش ثبت‌نام حساب گوگل استفاده می‌شود. فقط یکی از signinDetails های یک شرکت می‌تواند defaultStatus تنظیم شده روی SIGNIN_DETAIL_IS_DEFAULT داشته باشد. اگر یک Enterprise حداقل یک signinDetails داشته باشد و defaultStatus هیچ‌کدام از آنها روی SIGNIN_DETAIL_IS_DEFAULT تنظیم نشده باشد، اولین مورد از لیست انتخاب می‌شود و defaultStatus را روی SIGNIN_DETAIL_IS_DEFAULT تنظیم کرده است. اگر هیچ signinDetails برای Enterprise مشخص نشده باشد، ثبت‌نام دستگاه حساب گوگل با شکست مواجه خواهد شد.

فیلد یونیون _token_tag .

_token_tag فقط می‌تواند یکی از موارد زیر باشد:

tokenTag

string

یک فراداده مشخص شده توسط EMM برای تمایز بین نمونه‌های SigninDetail .

اطلاعات تماس

نمایش 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

شماره تلفن نماینده اتحادیه اروپا. شماره تلفن اعتبارسنجی شده اما تأیید نشده است.

تنظیمات احراز هویت گوگل

نمایش JSON 
{
  "googleAuthenticationRequired": enum (GoogleAuthenticationRequired)
}
فیلدها
googleAuthenticationRequired

enum ( GoogleAuthenticationRequired )

فقط خروجی. اینکه آیا کاربران در طول فرآیند ثبت نام نیاز به احراز هویت توسط گوگل دارند یا خیر. مدیر فناوری اطلاعات می‌تواند مشخص کند که آیا احراز هویت گوگل برای دستگاه‌های کارکنان دانش‌محور برای سازمان فعال است یا خیر. این مقدار فقط از طریق کنسول مدیریت گوگل قابل تنظیم است. احراز هویت گوگل را می‌توان با signin_url استفاده کرد. در صورتی که احراز هویت گوگل مورد نیاز باشد و signin_url مشخص شده باشد، احراز هویت گوگل قبل از signin_url اجرا خواهد شد.

حاشیه‌نویسی ابزار

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ✅ | راهنمایی فقط خواندنی: ✅ | راهنمایی جهان باز: ❌