MCP Tools Reference: Android Device Management MCP Server

الأداة: list_enterprises

تعرض هذه السمة المؤسسات التي يمكن للمتصل الوصول إليها.

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة list_enterprises MCP.

طلب 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
}'

مخطط الإدخال

طلب إدراج المؤسسات المُدارة من خلال إدارة الخدمات الجوّالة للمؤسسات (EMM)

ListEnterprisesRequest

تمثيل JSON 
{
  "projectId": string,
  "pageSize": integer,
  "pageToken": string,
  "view": enum (EnterpriseView)
}
الحقول
projectId

string

الحقل مطلوب. رقم تعريف مشروع السحابة الإلكترونية الخاص بإدارة الخدمات الجوّالة للمؤسسات
pageSize

integer

حجم الصفحة المطلوب. قد يتم تثبيت حجم الصفحة الفعلي على قيمة دنيا أو قصوى.
pageToken

string

رمز مميز يعرّف صفحة من النتائج التي يعرضها الخادم.
view

enum (EnterpriseView)

تحدّد هذه السمة حقول "المؤسسات" المطلوب عرضها. تتيح هذه الطريقة استخدام BASIC فقط.

مخطط النتائج

ردّ على طلب إدراج المؤسسات

ListEnterprisesResponse

تمثيل JSON 
{
  "enterprises": [
    {
      object (Enterprise)
    }
  ],
  "nextPageToken": string
}
الحقول
enterprises[]

object (Enterprise)

قائمة المؤسسات
nextPageToken

string

إذا كانت هناك نتائج إضافية، سيتم عرض رمز مميز لاسترداد الصفحة التالية من النتائج.

للمؤسسات

تمثيل 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

لون بتنسيق 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

اسم المؤسسة المعروض للمستخدمين لا يمكن أن يتألف هذا الحقل من أكثر من 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

عنوان URL الكامل للبيانات، ويجب أن يستخدم المخطط http أو https. لا يقدّم تطبيق Android Device Policy أي بيانات اعتماد في طلب GET، لذا يجب أن يكون عنوان URL متاحًا للجميع. قد يتم تضمين مكوّن عشوائي طويل في عنوان URL لمنع المهاجمين من اكتشافه.
sha256Hash

string

تجزئة SHA-256 بترميز base-64 للمحتوى المستضاف على عنوان URL إذا لم يتطابق المحتوى مع قيمة التجزئة هذه، لن يستخدم تطبيق "سياسة Android للأجهزة" البيانات.

TermsAndConditions

تمثيل JSON 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
الحقول
header

object (UserFacingMessage)

عنوان قصير يظهر فوق محتوى HTML
content

object (UserFacingMessage)

سلسلة HTML منسَّقة بشكلٍ سليم سيتم تحليلها على العميل باستخدام 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

عنوان URL لتسجيل الدخول من أجل المصادقة عند توفير الجهاز باستخدام رمز مميّز للتسجيل. يجب أن تنتهي نقطة نهاية تسجيل الدخول بعملية المصادقة بعنوان URL بالتنسيق https://enterprise.google.com/android/enroll?et= في حال تسجيل الدخول بنجاح، أو https://enterprise.google.com/android/enroll/invalid في حال تعذُّر تسجيل الدخول.
signinEnrollmentToken

string

رمز مميّز للتسجيل على مستوى المؤسسة يُستخدَم لتفعيل مسار تسجيل دخول مخصّص. هذا حقل للقراءة فقط ينشئه الخادم.
qrCode

string

سلسلة JSON يمكن استخدام تمثيلها بتنسيق UTF-8 لإنشاء رمز استجابة سريعة لتسجيل جهاز باستخدام رمز التسجيل هذا. لتسجيل جهاز باستخدام NFC، يجب أن يحتوي سجل NFC على تمثيل java.util.Properties للسمات في JSON. هذا حقل للقراءة فقط ينشئه الخادم.
allowPersonalUsage

enum (AllowPersonalUsage)

تتحكّم هذه السياسة في ما إذا كان مسموحًا بالاستخدام الشخصي على جهاز تم توفير إمكانية استخدامه باستخدام رمز التسجيل هذا.

بالنسبة إلى الأجهزة المملوكة للشركة:

  • تتيح إمكانية الاستخدام الشخصي للمستخدم إعداد ملف عمل على الجهاز.
  • يتطلّب إيقاف الاستخدام الشخصي أن يوفّر المستخدم الجهاز كجهاز مُدار بالكامل.

بالنسبة إلى الأجهزة الشخصية:

  • تتيح إمكانية الاستخدام الشخصي للمستخدم إعداد ملف عمل على الجهاز.
  • سيؤدي إيقاف الاستخدام الشخصي إلى منع الجهاز من توفير الموارد. لا يمكن إيقاف الاستخدام الشخصي على جهاز مملوك شخصيًا.
defaultStatus

enum (SigninDetailDefaultStatus)

اختياريّ. تحديد ما إذا كان يجب استخدام عنوان URL لتسجيل الدخول تلقائيًا للمؤسسة يتم استخدام SigninDetail مع ضبط defaultStatus على SIGNIN_DETAIL_IS_DEFAULT كطريقة لتسجيل حساب Google. يمكن أن يكون لدى signinDetails واحد فقط من signinDetails المؤسسة القيمة defaultStatus مضبوطة على SIGNIN_DETAIL_IS_DEFAULT. إذا كان Enterprise يتضمّن signinDetails واحدًا على الأقل ولم يتم ضبط defaultStatus على SIGNIN_DETAIL_IS_DEFAULT في أي منها، يتم اختيار العنصر الأول من القائمة ويتم ضبط defaultStatus على SIGNIN_DETAIL_IS_DEFAULT. في حال عدم تحديد signinDetails لـ Enterprise، سيتعذّر تسجيل الجهاز في حساب 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. يمكن استخدام مصادقة Google مع signin_url في حال كانت مصادقة Google مطلوبة وتم تحديد signin_url، سيتم تشغيل مصادقة Google قبل signin_url.

التعليقات التوضيحية للأدوات

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌