MCP Tools Reference: Android Device Management MCP Server

Araç: get_enterprise

Belirli bir kuruluş kimliği için kuruluş alır. Ad alanında kuruluş kimliği (ör. enterprises/{enterpriseId}) gerekir.

Aşağıdaki örnekte, curl kullanılarak get_enterprise MCP aracının nasıl çağrılacağı gösterilmektedir.

Curl Request 
                  
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
}'

Giriş Şeması

Bir işletme edinme isteğinde bulunma Kullanılabilir tüm alanları döndürür.

GetEnterpriseRequest

JSON gösterimi 
{
  "name": string
}
Alanlar
name

string

İşletmenin adı enterprises/{enterpriseId} biçiminde.

Çıkış Şeması

Yapılandırma bir kuruluşa uygulanır.

Kurumsal

JSON gösterimi 
{
  "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)
}
Alanlar
name

string

Oluşturma sırasında sunucu tarafından oluşturulan ve enterprises/{enterpriseId} biçimindeki işletmenin adı.
enabledNotificationTypes[]

enum (NotificationType)

Kuruluş için etkinleştirilen Google Pub/Sub bildirimlerinin türleri.
pubsubTopic

string

Pub/Sub bildirimlerinin yayınlandığı konu (projects/{project}/topics/{topic} biçiminde). Bu alan yalnızca Pub/Sub bildirimleri etkinse gereklidir.
primaryColor

integer

Cihaz yönetimi uygulaması kullanıcı arayüzünde gösterilecek baskın rengi belirten RGB biçiminde bir renk. Renk bileşenleri şu şekilde depolanır: (red << 16) | (green << 8) | blue. Her bileşenin değeri 0 ile 255 arasında (0 ve 255 dahil) olmalıdır.
logo

object (ExternalData)

Cihaz temel hazırlığı sırasında logo olarak gösterilen resim. Desteklenen türler: image/bmp, image/gif, image/x-ico, image/jpeg, image/png, image/webp, image/vnd.wap.wbmp, image/x-adobe-dng.
enterpriseDisplayName

string

Kullanıcılara gösterilen işletmenin adı. Bu alanın maksimum uzunluğu 100 karakterdir.
termsAndConditions[]

object (TermsAndConditions)

Bu işletme için bir cihaz sağlarken kabul edilmesi gereken hükümler ve koşullar. Bu listedeki her değer için bir terimler sayfası oluşturulur.
appAutoApprovalEnabled
(deprecated)

boolean

Kullanımdan kaldırıldı ve kullanılmıyor.
signinDetails[]

object (SigninDetail)

Kuruluşun oturum açma bilgileri.
contactInfo

object (ContactInfo)

EMM tarafından yönetilen bir işletmenin kurumsal iletişim bilgileri.
googleAuthenticationSettings

object (GoogleAuthenticationSettings)

Google tarafından sağlanan kullanıcı kimlik doğrulama ayarları.
enterpriseType

enum (EnterpriseType)

Yalnızca çıkış. İşletmenin türü.
managedGooglePlayAccountsEnterpriseType

enum (ManagedGooglePlayAccountsEnterpriseType)

Yalnızca çıkış. Managed Google Play Accounts grubunun türü.
managedGoogleDomainType

enum (ManagedGoogleDomainType)

Yalnızca çıkış. Yönetilen Google alanının türü.

Int32Value

JSON gösterimi 
{
  "value": integer
}
Alanlar
value

integer

int32 değeri.

ExternalData

JSON gösterimi 
{
  "url": string,
  "sha256Hash": string
}
Alanlar
url

string

Verilere yönelik mutlak URL. Bu URL'de http veya https şeması kullanılmalıdır. Android Device Policy, GET isteğinde herhangi bir kimlik bilgisi sağlamadığından URL'ye herkese açık olarak erişilebilmelidir. URL'ye uzun ve rastgele bir bileşen eklemek, saldırganların URL'yi keşfetmesini önlemek için kullanılabilir.
sha256Hash

string

URL'de barındırılan içeriğin base-64 kodlu SHA-256 karması. İçerik bu karma ile eşleşmezse Android Device Policy verileri kullanmaz.

TermsAndConditions

JSON gösterimi 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
Alanlar
header

object (UserFacingMessage)

HTML içeriğinin üzerinde görünen kısa bir başlık.
content

object (UserFacingMessage)

İyi biçimlendirilmiş bir HTML dizesi. Bu değer, android.text.Html#fromHtml ile istemcide ayrıştırılır.

UserFacingMessage

JSON gösterimi 
{
  "localizedMessages": {
    string: string,
    ...
  },
  "defaultMessage": string
}
Alanlar
localizedMessages

map (key: string, value: string)

Yerel ayarın, en-US, es-ES veya fr gibi iyi biçimlendirilmiş bir BCP 47 dil kodu olduğu <locale, message> çiftlerini içeren bir harita.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
defaultMessage

string

Yerelleştirilmiş mesaj belirtilmediğinde veya kullanıcının yerel ayarı yerelleştirilmiş mesajlardan herhangi biriyle eşleşmediğinde gösterilen varsayılan mesaj. Yerelleştirilmiş mesajlar sağlanıyorsa varsayılan bir mesaj sağlanmalıdır.

LocalizedMessagesEntry

JSON gösterimi 
{
  "key": string,
  "value": string
}
Alanlar
key

string
value

string

SigninDetail

JSON gösterimi 
{
  "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.
}
Alanlar
signinUrl

string

Cihaz, oturum açma kayıt jetonuyla sağlandığında kimlik doğrulama için kullanılan oturum açma URL'si. Oturum açma uç noktası, kimlik doğrulama akışını başarılı bir giriş için https://enterprise.google.com/android/enroll?et= biçiminde bir URL ile, başarısız bir giriş için ise https://enterprise.google.com/android/enroll/invalid biçiminde bir URL ile tamamlamalıdır.
signinEnrollmentToken

string

Özel oturum açma akışını tetiklemek için kullanılan, kuruluş genelinde geçerli bir kayıt jetonu. Bu, sunucu tarafından oluşturulan salt okunur bir alandır.
qrCode

string

UTF-8 gösterimi, bir cihazı bu kayıt jetonuyla kaydetmek için QR kodu oluşturmak üzere kullanılabilen bir JSON dizesi. NFC kullanarak bir cihazı kaydetmek için NFC kaydı, JSON'daki özelliklerin seri hale getirilmiş bir java.util.Properties gösterimini içermelidir. Bu, sunucu tarafından oluşturulan salt okunur bir alandır.
allowPersonalUsage

enum (AllowPersonalUsage)

Bu kayıt jetonuyla sağlanan bir cihazda kişisel kullanıma izin verilip verilmeyeceğini kontrol eder.

Şirkete ait cihazlar için:

  • Kişisel kullanımın etkinleştirilmesi, kullanıcının cihazda iş profili oluşturmasına olanak tanır.
  • Kişisel kullanımı devre dışı bırakmak için kullanıcının cihazı tümüyle yönetilen cihaz olarak sağlaması gerekir.

Şahıslara ait cihazlar için:

  • Kişisel kullanımın etkinleştirilmesi, kullanıcının cihazda iş profili oluşturmasına olanak tanır.
  • Kişisel kullanımın devre dışı bırakılması, cihazın temel hazırlığının yapılmasını engeller. Kişisel kullanım, kişisel olarak sahip olunan cihazlarda devre dışı bırakılamaz.
defaultStatus

enum (SigninDetailDefaultStatus)

İsteğe bağlı. Oturum açma URL'sinin kuruluş için varsayılan olarak kullanılıp kullanılmayacağı. defaultStatus ayarı SIGNIN_DETAIL_IS_DEFAULT olarak belirlenmiş SigninDetail, Google Hesabı kayıt yöntemi için kullanılır. Bir kuruluşun signinDetails öğelerinden yalnızca birinde defaultStatus, SIGNIN_DETAIL_IS_DEFAULT olarak ayarlanabilir. Bir Enterprise öğesinde en az bir signinDetails varsa ve bunların hiçbirinde defaultStatus, SIGNIN_DETAIL_IS_DEFAULT olarak ayarlanmamışsa listedeki ilk öğe seçilir ve defaultStatus, SIGNIN_DETAIL_IS_DEFAULT olarak ayarlanır. Enterprise için signinDetails belirtilmemişse Google Hesabı cihaz kaydı başarısız olur.

_token_tag birleşik alanı.

_token_tag aşağıdakilerden yalnızca biri olabilir:
tokenTag

string

SigninDetail örnekleri arasında ayrım yapmak için EMM tarafından belirtilen meta veriler.

ContactInfo

JSON gösterimi 
{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
Alanlar
contactEmail

string

Yönetilen Google Play ile ilgili önemli duyuruları göndermek için kullanılacak bir iletişim kişisinin e-posta adresi.
dataProtectionOfficerName

string

Veri koruma yetkilisinin adı.
dataProtectionOfficerEmail

string

Veri koruma yetkilisinin e-posta adresi. E-posta doğrulanmış ancak onaylanmamış.
dataProtectionOfficerPhone

string

Veri koruma görevlisinin telefon numarası. Telefon numarası doğrulanır ancak onaylanmaz.
euRepresentativeName

string

AB temsilcisinin adı.
euRepresentativeEmail

string

AB temsilcisinin e-posta adresi. E-posta doğrulanmış ancak onaylanmamış.
euRepresentativePhone

string

AB temsilcisinin telefon numarası. Telefon numarası doğrulandı ancak onaylanmadı.

GoogleAuthenticationSettings

JSON gösterimi 
{
  "googleAuthenticationRequired": enum (GoogleAuthenticationRequired)
}
Alanlar
googleAuthenticationRequired

enum (GoogleAuthenticationRequired)

Yalnızca çıkış. Kullanıcıların kayıt işlemi sırasında Google tarafından kimliklerinin doğrulanması gerekip gerekmediği. BT yöneticisi, bilgi çalışanlarının cihazlarında Google kimlik doğrulamasının etkinleştirilip etkinleştirilmeyeceğini belirleyebilir. Bu değer yalnızca Google Yönetici Konsolu üzerinden ayarlanabilir. Google kimlik doğrulaması signin_url ile birlikte kullanılabilir. Google kimlik doğrulaması gerektiğinde ve signin_url belirtildiğinde Google kimlik doğrulaması signin_url'dan önce başlatılır.

Araç Ek Açıklamaları

Yıkıcı İpucu: ❌ | İdempotent İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌