MCP Tools Reference: Android Device Management MCP Server

Narzędzie: list_enterprises

Wyświetla listę firm dostępnych dla dzwoniącego.

Poniższy przykład pokazuje, jak za pomocą curl wywołać narzędzie list_enterprises MCP.

Żądanie 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
}'

Schemat wejściowy

Prośba o wyświetlenie firm zarządzanych przez EMM.

ListEnterprisesRequest

Zapis JSON 
{
  "projectId": string,
  "pageSize": integer,
  "pageToken": string,
  "view": enum (EnterpriseView)
}
Pola
projectId

string

Wymagane. Identyfikator projektu w chmurze, w którym znajduje się dostawca EMM zarządzający firmami.
pageSize

integer

Żądany rozmiar strony. Rzeczywisty rozmiar strony może być ograniczony do wartości minimalnej lub maksymalnej.
pageToken

string

Token identyfikujący stronę wyników zwróconych przez serwer.
view

enum (EnterpriseView)

Określa, które pola przedsiębiorstwa mają być zwracane. Ta metoda obsługuje tylko BASIC.

Schemat wyjściowy

Odpowiedź na prośbę o wyświetlenie listy firm.

ListEnterprisesResponse

Zapis JSON 
{
  "enterprises": [
    {
      object (Enterprise)
    }
  ],
  "nextPageToken": string
}
Pola
enterprises[]

object (Enterprise)

Lista przedsiębiorstw.
nextPageToken

string

Jeśli jest więcej wyników, token do pobrania następnej strony wyników.

Enterprise

Zapis 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)
}
Pola
name

string

Nazwa przedsiębiorstwa generowana przez serwer podczas tworzenia w formacie enterprises/{enterpriseId}.
enabledNotificationTypes[]

enum (NotificationType)

Typy powiadomień Google Pub/Sub włączone w przypadku firmy.
pubsubTopic

string

Temat, w którym publikowane są powiadomienia Pub/Sub, w formacie projects/{project}/topics/{topic}. To pole jest wymagane tylko wtedy, gdy włączone są powiadomienia Pub/Sub.
primaryColor

integer

Kolor w formacie RGB, który wskazuje dominujący kolor wyświetlany w interfejsie aplikacji do zarządzania urządzeniami. Składowe koloru są przechowywane w formacie (red << 16) | (green << 8) | blue, gdzie wartość każdej składowej mieści się w zakresie od 0 do 255 włącznie.
logo

object (ExternalData)

Obraz wyświetlany jako logo podczas udostępniania urządzenia. Obsługiwane typy to: image/bmp, image/gif, image/x-ico, image/jpeg, image/png, image/webp, image/vnd.wap.wbmp, image/x-adobe-dng.
enterpriseDisplayName

string

Nazwa przedsiębiorstwa wyświetlana użytkownikom. Maksymalna długość tego pola to 100 znaków.
termsAndConditions[]

object (TermsAndConditions)

Warunki, które należy zaakceptować podczas udostępniania urządzenia w tej firmie. Dla każdej wartości na tej liście generowana jest strona z warunkami.
appAutoApprovalEnabled
(deprecated)

boolean

Wycofane i nieużywane.
signinDetails[]

object (SigninDetail)

Dane logowania do przedsiębiorstwa.
contactInfo

object (ContactInfo)

dane kontaktowe firmy zarządzanej przez dostawcę usług EMM.
googleAuthenticationSettings

object (GoogleAuthenticationSettings)

Ustawienia uwierzytelniania użytkowników zapewnianego przez Google.
enterpriseType

enum (EnterpriseType)

Tylko dane wyjściowe. Rodzaj przedsiębiorstwa.
managedGooglePlayAccountsEnterpriseType

enum (ManagedGooglePlayAccountsEnterpriseType)

Tylko dane wyjściowe. Typ grupy kont zarządzanego Sklepu Google Play.
managedGoogleDomainType

enum (ManagedGoogleDomainType)

Tylko dane wyjściowe. Typ zarządzanej domeny Google.

Int32Value

Zapis JSON 
{
  "value": integer
}
Pola
value

integer

Wartość int32.

ExternalData

Zapis JSON 
{
  "url": string,
  "sha256Hash": string
}
Pola
url

string

Bezwzględny adres URL danych, który musi używać schematu http lub https. Aplikacja Android Device Policy nie podaje żadnych danych logowania w żądaniu GET, więc adres URL musi być publicznie dostępny. Umieszczenie w adresie URL długiego, losowego komponentu może uniemożliwić atakującym odkrycie tego adresu.
sha256Hash

string

Zaszyfrowany za pomocą algorytmu SHA-256 i zakodowany w formacie base64 identyfikator treści hostowanych pod adresem URL. Jeśli treść nie będzie zgodna z tym haszem, aplikacja Android Device Policy nie użyje danych.

TermsAndConditions

Zapis JSON 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
Pola
header

object (UserFacingMessage)

Krótki nagłówek, który pojawia się nad treścią HTML.
content

object (UserFacingMessage)

Prawidłowo sformatowany ciąg HTML. Będzie on analizowany na urządzeniu klienta za pomocą metody android.text.Html#fromHtml.

UserFacingMessage

Zapis JSON 
{
  "localizedMessages": {
    string: string,
    ...
  },
  "defaultMessage": string
}
Pola
localizedMessages

map (key: string, value: string)

Mapa zawierająca pary <locale, message>, gdzie locale to prawidłowo sformułowany kod języka BCP 47, np. en-US, es-ES lub fr.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }
defaultMessage

string

Domyślny komunikat wyświetlany, jeśli nie określono zlokalizowanego komunikatu lub język użytkownika nie pasuje do żadnego z nich. Jeśli podano jakiekolwiek zlokalizowane wiadomości, należy podać domyślną wiadomość.

LocalizedMessagesEntry

Zapis JSON 
{
  "key": string,
  "value": string
}
Pola
key

string
value

string

SigninDetail

Zapis 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.
}
Pola
signinUrl

string

Adres URL logowania do uwierzytelniania, gdy urządzenie jest udostępniane za pomocą tokena rejestracji logowania. Punkt końcowy logowania powinien kończyć proces uwierzytelniania adresem URL w formacie https://enterprise.google.com/android/enroll?et= w przypadku udanego logowania lub https://enterprise.google.com/android/enroll/invalid w przypadku nieudanego logowania.
signinEnrollmentToken

string

Token rejestracji w całej firmie używany do wywoływania niestandardowego procesu logowania. To pole jest tylko do odczytu i jest generowane przez serwer.
qrCode

string

Ciąg znaków JSON, którego reprezentację w standardzie UTF-8 można wykorzystać do wygenerowania kodu QR w celu zarejestrowania urządzenia za pomocą tego tokena rejestracji. Aby zarejestrować urządzenie za pomocą NFC, rekord NFC musi zawierać zserializowaną java.util.Properties reprezentację właściwości w formacie JSON. To pole jest tylko do odczytu i jest generowane przez serwer.
allowPersonalUsage

enum (AllowPersonalUsage)

Określa, czy na urządzeniu skonfigurowanym za pomocą tego tokena rejestracyjnego można używać konta osobistego.

W przypadku urządzeń należących do firmy:

  • Włączenie użytku osobistego umożliwia użytkownikowi skonfigurowanie profilu służbowego na urządzeniu.
  • Wyłączenie użytku osobistego wymaga udostępnienia urządzenia jako w pełni zarządzanego.

W przypadku urządzeń należących do użytkownika:

  • Włączenie użytku osobistego umożliwia użytkownikowi skonfigurowanie profilu służbowego na urządzeniu.
  • Wyłączenie użytku osobistego uniemożliwi przygotowanie urządzenia do obsługi administracyjnej. Nie można wyłączyć użytku osobistego na urządzeniu należącym do użytkownika.
defaultStatus

enum (SigninDetailDefaultStatus)

Opcjonalnie. Określa, czy adres URL logowania ma być domyślnie używany w przypadku firmy. Do metody rejestracji konta Google używany jest parametr SigninDetail z wartością defaultStatus ustawioną na SIGNIN_DETAIL_IS_DEFAULT. Tylko jeden z signinDetails w firmie może mieć wartość defaultStatus ustawioną na SIGNIN_DETAIL_IS_DEFAULT. Jeśli Enterprise ma co najmniej 1 element signinDetails, a żaden z nich nie ma ustawionego parametru defaultStatus na SIGNIN_DETAIL_IS_DEFAULT, wybierany jest pierwszy element z listy i ustawiany jest parametr defaultStatus na SIGNIN_DETAIL_IS_DEFAULT. Jeśli dla Enterprise nie określono signinDetails, rejestracja urządzenia na koncie Google nie powiedzie się.

Pole zbiorcze _token_tag.

Pole _token_tag może mieć tylko jedną z tych wartości:
tokenTag

string

Metadane określone przez EMM, które pozwalają odróżnić instancje SigninDetail.

ContactInfo

Zapis JSON 
{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
Pola
contactEmail

string

Adres e-mail osoby kontaktowej, na który będziemy wysyłać ważne powiadomienia dotyczące zarządzanego Google Play.
dataProtectionOfficerName

string

Imię i nazwisko inspektora ochrony danych.
dataProtectionOfficerEmail

string

Adres e-mail inspektora ochrony danych. Adres e-mail jest zweryfikowany, ale nie potwierdzony.
dataProtectionOfficerPhone

string

Numer telefonu inspektora ochrony danych. Numer telefonu jest sprawdzany, ale nie weryfikowany.
euRepresentativeName

string

Imię i nazwisko przedstawiciela w Unii Europejskiej.
euRepresentativeEmail

string

Adres e-mail przedstawiciela w Unii Europejskiej. Adres e-mail jest zweryfikowany, ale nie potwierdzony.
euRepresentativePhone

string

Numer telefonu przedstawiciela w Unii Europejskiej. Numer telefonu jest prawidłowy, ale nie został zweryfikowany.

GoogleAuthenticationSettings

Zapis JSON 
{
  "googleAuthenticationRequired": enum (GoogleAuthenticationRequired)
}
Pola
googleAuthenticationRequired

enum (GoogleAuthenticationRequired)

Tylko dane wyjściowe. Określa, czy użytkownicy muszą być uwierzytelniani przez Google podczas procesu rejestracji. Administrator IT może określić, czy uwierzytelnianie Google jest włączone w przypadku urządzeń pracowników umysłowych w firmie. Tę wartość można ustawić tylko w konsoli administracyjnej Google. Uwierzytelnianie Google można stosować z signin_url. Jeśli uwierzytelnianie Google jest wymagane i określono signin_url, uwierzytelnianie Google zostanie uruchomione przed signin_url.

Adnotacje do narzędzi

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