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

ต้องระบุ รหัสโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ EMM ที่จัดการองค์กร
pageSize

integer

ขนาดหน้าที่ขอ ขนาดหน้าเว็บจริงอาจกำหนดเป็นค่าต่ำสุดหรือสูงสุด
pageToken

string

โทเค็นที่ระบุหน้าผลลัพธ์ที่เซิร์ฟเวอร์ส่งคืน
view

enum (EnterpriseView)

ระบุช่องของ Enterprise ที่จะแสดงผล วิธีนี้รองรับเฉพาะ 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

สีในรูปแบบ RGB ที่ระบุสีหลักที่จะแสดงใน UI ของแอปการจัดการอุปกรณ์ ระบบจะจัดเก็บคอมโพเนนต์สีดังนี้ (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)

ข้อมูลติดต่อขององค์กรที่จัดการโดย EMM
googleAuthenticationSettings

object (GoogleAuthenticationSettings)

การตั้งค่าสำหรับการตรวจสอบสิทธิ์ผู้ใช้ที่ Google จัดให้
enterpriseType

enum (EnterpriseType)

เอาต์พุตเท่านั้น ประเภทขององค์กร
managedGooglePlayAccountsEnterpriseType

enum (ManagedGooglePlayAccountsEnterpriseType)

เอาต์พุตเท่านั้น ประเภทของกลุ่มบัญชี Managed Google Play สำหรับองค์กร
managedGoogleDomainType

enum (ManagedGoogleDomainType)

เอาต์พุตเท่านั้น ประเภทของโดเมน Google ที่มีการจัดการ

Int32Value

การแสดง JSON 
{
  "value": integer
}
ช่อง
value

integer

ค่า int32

ExternalData

การแสดง JSON 
{
  "url": string,
  "sha256Hash": string
}
ช่อง
url

string

URL ที่สมบูรณ์ของข้อมูล ซึ่งต้องใช้ Scheme http หรือ https Device Policy ของ Android ไม่ได้ระบุข้อมูลเข้าสู่ระบบใดๆ ในคำขอ GET ดังนั้น URL จึงต้องเข้าถึงได้แบบสาธารณะ การใส่คอมโพเนนต์แบบสุ่มที่ยาวใน URL อาจใช้เพื่อป้องกันไม่ให้ผู้โจมตีค้นพบ URL
sha256Hash

string

แฮช SHA-256 ของเนื้อหาที่โฮสต์ใน URL ซึ่งเข้ารหัส Base64 หากเนื้อหาไม่ตรงกับแฮชนี้ Android Device Policy จะไม่ใช้ข้อมูล

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 ขององค์กรจะมี defaultStatus ที่ตั้งค่าเป็น SIGNIN_DETAIL_IS_DEFAULT ได้เพียง 1 รายการ หาก Enterprise มี signinDetails อย่างน้อย 1 รายการและไม่มีรายการใดตั้งค่า defaultStatus เป็น SIGNIN_DETAIL_IS_DEFAULT ระบบจะเลือกรายการแรกจากรายการและตั้งค่า defaultStatus เป็น SIGNIN_DETAIL_IS_DEFAULT หากไม่ได้ระบุ signinDetails สำหรับ Enterprise การลงทะเบียนอุปกรณ์ด้วยบัญชี Google จะล้มเหลว

ฟิลด์ Union _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

อีเมลสำหรับผู้ติดต่อ ซึ่งจะใช้เพื่อส่งประกาศสำคัญที่เกี่ยวข้องกับ Managed 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

คำอธิบายประกอบเครื่องมือ

คำแนะนำที่ทำลายล้าง: ❌ | คำแนะนำที่ทำซ้ำได้: ✅ | คำแนะนำแบบอ่านอย่างเดียว: ✅ | คำแนะนำแบบโลกเปิด: ❌