MCP Tools Reference: Android Device Management MCP Server

টুল: list_enterprises

কলকারীর কাছে অ্যাক্সেসযোগ্য এন্টারপ্রাইজগুলির তালিকা তৈরি করে।

নিচের নমুনাটি 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-পরিচালিত উদ্যোগগুলির তালিকা তৈরির অনুরোধ।

তালিকা উদ্যোগ অনুরোধ

JSON উপস্থাপনা 
{
  "projectId": string,
  "pageSize": integer,
  "pageToken": string,
  "view": enum (EnterpriseView)
}
ক্ষেত্র
projectId

string

প্রয়োজনীয়। এন্টারপ্রাইজ পরিচালনাকারী EMM-এর ক্লাউড প্রকল্প আইডি।

pageSize

integer

অনুরোধকৃত পৃষ্ঠার আকার। প্রকৃত পৃষ্ঠার আকার সর্বনিম্ন বা সর্বোচ্চ মান নির্ধারণ করা যেতে পারে।

pageToken

string

সার্ভার কর্তৃক প্রদত্ত ফলাফলের একটি পৃষ্ঠা চিহ্নিতকারী একটি টোকেন।

view

enum ( EnterpriseView )

কোন এন্টারপ্রাইজ ফিল্ডগুলি ফেরত দিতে হবে তা নির্দিষ্ট করে। এই পদ্ধতিটি শুধুমাত্র BASIC সমর্থন করে।

আউটপুট স্কিমা

উদ্যোগ তালিকাভুক্ত করার অনুরোধের প্রতিক্রিয়া।

তালিকা উদ্যোগ প্রতিক্রিয়া

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 ফর্ম্যাটে একটি রঙ যা ডিভাইস ম্যানেজমেন্ট অ্যাপ 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

ব্যবহারকারীদের কাছে প্রদর্শিত এন্টারপ্রাইজের নাম। এই ক্ষেত্রের সর্বোচ্চ দৈর্ঘ্য ১০০টি অক্ষর।

termsAndConditions[]

object ( TermsAndConditions )

এই এন্টারপ্রাইজের জন্য একটি ডিভাইস সরবরাহ করার সময় যে শর্তাবলী মেনে নিতে হবে। এই তালিকার প্রতিটি মানের জন্য শর্তাবলীর একটি পৃষ্ঠা তৈরি করা হয়েছে।

appAutoApprovalEnabled
(deprecated)

boolean

অবচিত এবং অব্যবহৃত।

signinDetails[]

object ( SigninDetail )

এন্টারপ্রাইজের সাইন-ইন বিশদ।

contactInfo

object ( ContactInfo )

একটি EMM-পরিচালিত এন্টারপ্রাইজের এন্টারপ্রাইজ যোগাযোগের তথ্য।

googleAuthenticationSettings

object ( GoogleAuthenticationSettings )

গুগল-প্রদত্ত ব্যবহারকারী প্রমাণীকরণের সেটিংস।

enterpriseType

enum ( EnterpriseType )

শুধুমাত্র আউটপুট। এন্টারপ্রাইজের ধরণ।

managedGooglePlayAccountsEnterpriseType

enum ( ManagedGooglePlayAccountsEnterpriseType )

শুধুমাত্র আউটপুট। একটি পরিচালিত Google Play অ্যাকাউন্ট এন্টারপ্রাইজের ধরণ।

managedGoogleDomainType

enum ( ManagedGoogleDomainType )

শুধুমাত্র আউটপুট। পরিচালিত Google ডোমেনের ধরণ।

Int32Value সম্পর্কে

JSON উপস্থাপনা 
{
  "value": integer
}
ক্ষেত্র
value

integer

int32 মান।

বাহ্যিক তথ্য

JSON উপস্থাপনা 
{
  "url": string,
  "sha256Hash": string
}
ক্ষেত্র
url

string

ডেটার পরম URL, যা অবশ্যই http অথবা https স্কিম ব্যবহার করবে। Android ডিভাইস নীতি GET অনুরোধে কোনও শংসাপত্র প্রদান করে না, তাই URLটি সর্বজনীনভাবে অ্যাক্সেসযোগ্য হতে হবে। আক্রমণকারীদের URLটি আবিষ্কার করা থেকে বিরত রাখতে URL-এ একটি দীর্ঘ, এলোমেলো উপাদান অন্তর্ভুক্ত করা ব্যবহার করা যেতে পারে।

sha256Hash

string

url-এ হোস্ট করা কন্টেন্টের বেস-64 এনকোডেড SHA-256 হ্যাশ। যদি কন্টেন্টটি এই হ্যাশের সাথে না মেলে, তাহলে Android ডিভাইস নীতি ডেটা ব্যবহার করবে না।

শর্তাবলীএবংশর্তাবলী

JSON উপস্থাপনা 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
ক্ষেত্র
header

object ( UserFacingMessage )

HTML কন্টেন্টের উপরে প্রদর্শিত একটি ছোট হেডার।

content

object ( UserFacingMessage )

একটি ভালোভাবে ফর্ম্যাট করা HTML স্ট্রিং। এটি android.text.Html#fromHtml দিয়ে ক্লায়েন্টে পার্স করা হবে।

ব্যবহারকারীর মুখোমুখি বার্তা

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

যদি কোনও স্থানীয় বার্তা নির্দিষ্ট না করা থাকে অথবা ব্যবহারকারীর স্থানীয় বার্তার সাথে কোনও স্থানীয় বার্তার মিল না থাকে, তাহলে ডিফল্ট বার্তাটি প্রদর্শিত হবে। যদি কোনও স্থানীয় বার্তা প্রদান করা হয় তবে একটি ডিফল্ট বার্তা প্রদান করতে হবে।

স্থানীয় বার্তাপ্রবেশ

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। সাইন-ইন এন্ডপয়েন্টটি https://enterprise.google.com/android/enroll?et= আকারে একটি URL দিয়ে প্রমাণীকরণ প্রবাহ শেষ করবে। সফল লগইনের জন্য, অথবা ব্যর্থ লগইনের জন্য https://enterprise.google.com/android/enroll/invalid ।

signinEnrollmentToken

string

কাস্টম সাইন-ইন প্রবাহ ট্রিগার করতে ব্যবহৃত একটি এন্টারপ্রাইজ ব্যাপী তালিকাভুক্তি টোকেন। এটি সার্ভার দ্বারা তৈরি একটি কেবল-পঠনযোগ্য ক্ষেত্র।

qrCode

string

একটি JSON স্ট্রিং যার UTF-8 উপস্থাপনা এই তালিকাভুক্তি টোকেন সহ একটি ডিভাইস নথিভুক্ত করার জন্য একটি QR কোড তৈরি করতে ব্যবহার করা যেতে পারে। NFC ব্যবহার করে একটি ডিভাইস নথিভুক্ত করার জন্য, NFC রেকর্ডে JSON-এর বৈশিষ্ট্যগুলির একটি সিরিয়ালাইজড java.util.Properties উপস্থাপনা থাকতে হবে। এটি সার্ভার দ্বারা তৈরি একটি পঠনযোগ্য ক্ষেত্র।

allowPersonalUsage

enum ( AllowPersonalUsage )

এই তালিকাভুক্তি টোকেনের সাথে সরবরাহ করা কোনও ডিভাইসে ব্যক্তিগত ব্যবহারের অনুমতি আছে কিনা তা নিয়ন্ত্রণ করে।

কোম্পানির মালিকানাধীন ডিভাইসের জন্য:

  • ব্যক্তিগত ব্যবহার সক্ষম করলে ব্যবহারকারী ডিভাইসে একটি কাজের প্রোফাইল সেট আপ করতে পারবেন।
  • ব্যক্তিগত ব্যবহার অক্ষম করার জন্য ব্যবহারকারীকে ডিভাইসটিকে সম্পূর্ণরূপে পরিচালিত ডিভাইস হিসেবে সরবরাহ করতে হবে।

ব্যক্তিগত মালিকানাধীন ডিভাইসের জন্য:

  • ব্যক্তিগত ব্যবহার সক্ষম করলে ব্যবহারকারী ডিভাইসে একটি কাজের প্রোফাইল সেট আপ করতে পারবেন।
  • ব্যক্তিগত ব্যবহার অক্ষম করলে ডিভাইসটি প্রভিশনিং থেকে বিরত থাকবে। ব্যক্তিগত মালিকানাধীন ডিভাইসে ব্যক্তিগত ব্যবহার অক্ষম করা যাবে না।
defaultStatus

enum ( SigninDetailDefaultStatus )

ঐচ্ছিক। এন্টারপ্রাইজের জন্য সাইন-ইন URL ডিফল্টরূপে ব্যবহার করা উচিত কিনা। Google অ্যাকাউন্ট নথিভুক্তকরণ পদ্ধতির জন্য SIGNIN_DETAIL_IS_DEFAULT তে সেট করা defaultStatus সহ SigninDetail ব্যবহার করা হয়। একটি এন্টারপ্রাইজের signinDetails এর মধ্যে শুধুমাত্র একটিতে defaultStatus SIGNIN_DETAIL_IS_DEFAULT তে সেট করা থাকতে পারে। যদি একটি Enterprise কমপক্ষে একটি signinDetails থাকে এবং তাদের কোনওটিতেই defaultStatus SIGNIN_DETAIL_IS_DEFAULT তে সেট করা না থাকে, তাহলে তালিকা থেকে প্রথমটি নির্বাচন করা হয় এবং defaultStatus SIGNIN_DETAIL_IS_DEFAULT তে সেট করা থাকে। যদি Enterprise এর জন্য কোনও signinDetails নির্দিষ্ট না থাকে, তাহলে Google অ্যাকাউন্ট ডিভাইস নথিভুক্তি ব্যর্থ হবে।

ইউনিয়ন ক্ষেত্র _token_tag ।

_token_tag নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

tokenTag

string

SigninDetail এর উদাহরণগুলির মধ্যে পার্থক্য করার জন্য একটি EMM-নির্দিষ্ট মেটাডেটা।

যোগাযোগের তথ্য

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 )

শুধুমাত্র আউটপুট। নথিভুক্তিকরণ প্রক্রিয়ার সময় ব্যবহারকারীদের Google দ্বারা প্রমাণীকরণের প্রয়োজন কিনা। নলেজ ওয়ার্কার ডিভাইসের জন্য এন্টারপ্রাইজের জন্য Google প্রমাণীকরণ সক্ষম কিনা তা IT অ্যাডমিন নির্দিষ্ট করতে পারেন। এই মানটি শুধুমাত্র Google অ্যাডমিন কনসোলের মাধ্যমে সেট করা যেতে পারে। signin_url এর মাধ্যমে Google প্রমাণীকরণ ব্যবহার করা যেতে পারে যেখানে Google প্রমাণীকরণ প্রয়োজন এবং একটি signin_url নির্দিষ্ট করা থাকে, সেখানে signin_url আগে Google প্রমাণীকরণ চালু করা হবে।

টুল টীকা

ধ্বংসাত্মক ইঙ্গিত: ❌ | অদক্ষ ইঙ্গিত: ✅ | কেবল পঠনযোগ্য ইঙ্গিত: ✅ | উন্মুক্ত বিশ্ব ইঙ্গিত: ❌