ডিরেক্টরি API: Chrome ডিভাইস

একটি অ্যাকাউন্টের জন্য সমস্ত Chrome ডিভাইস পুনরুদ্ধার করুন৷

একটি অ্যাকাউন্টে বরাদ্দ করা সমস্ত Chrome ডিভাইসের একটি তালিকা ফেরত দিতে, নিম্নলিখিত GET অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। পঠনযোগ্যতার জন্য, এই কোড নমুনা লাইন রিটার্ন আছে:

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/
devices/chromeos?projection={BASIC|FULL}&query=query
&orderBy=orderBy category&sortOrder={ASCENDING|DESCENDING}
&pageToken=token for next results page, if applicable
&maxResults=max number of results per page

  • customerId হল গ্রাহকের Google অ্যাকাউন্টের একটি অনন্য শনাক্তকারী।
  • একজন অ্যাকাউন্ট প্রশাসক হিসাবে, আপনি my_customer স্ট্রিংটিও ব্যবহার করতে পারেন যা আপনার অ্যাকাউন্টের customerId প্রতিনিধিত্ব করে। customerId মান পাওয়ার আরেকটি উপায় হল ব্যবহারকারীর অপারেশন পুনরুদ্ধার করা । অপারেশনের userKey পাথ প্যারামিটারে আপনার প্রশাসকের ইমেল ঠিকানা বা আপনার প্রশাসকের অনন্য ব্যবহারকারী id মান ব্যবহার করুন৷

ক্যোয়ারী স্ট্রিং, অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, API রেফারেন্স দেখুন।

উদাহরণ: ব্যবহারকারী দ্বারা ডিভাইস ফিল্টার

এই উদাহরণটি query=user:help desk ব্যবহার করে একটি নির্দিষ্ট ব্যবহারকারীর জন্য অনুসন্ধান করে। প্রতিক্রিয়াটিতে একটি একক chromeosdevice রিসোর্স রয়েছে, যেখানে annotatedUser হল help desk :

JSON অনুরোধ

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
chromeos?projection=FULL&query=user:help desk&orderBy=status
&sortOrder=ASCENDING&maxResults=100

JSON প্রতিক্রিয়া

{
  "kind": "directory#chromeosdevices",
  "chromeosdevices": [
     {
       "kind": "directory#chromeosdevice",
       "etag": "1234567890"
       "deviceId": "def456",
       "serialNumber": "234567",
       "status": "ACTIVE",
       "lastSync": "2013-03-05T17:30:04.325Z",
       "supportEndDate": "2014-04-05T17:30:04.325Z",
       "annotatedUser": "help desk",
       "annotatedLocation": "Mountain View help desk Chromebook",
       "annotatedAssetId": "1234567890",
       "notes": "Loaned from support",
       "orderNumber": "1234",
       "willAutoRenew": true,
       "osVersion": "Browser Version 18.0",
       "platformVersion": "Platform Version 1415.2.0",
       "firmwareVersion": "Firmware Version 1.2.3.4",
       "bootMode": "validated",
       "lastEnrollmentTime": "2012-04-05T17:30:04.325Z",
       "orgUnitPath": "corp/engineering",
       "recentUsers": [
         {
           "type": "USER_TYPE_MANAGED",
           "email": "user@customer.com"
         }
       ],
       "activeTimeRanges": [
         {
           "date": "2012-04-05",
           "activeTime": "3600000"
         }
       ],
     }
  ],
  "nextPageToken": "abcdefghijkl123"
}

উদাহরণ: সিরিয়াল নম্বর দ্বারা ডিভাইসগুলি ফিল্টার করুন

এই উদাহরণটি query=id: 123456 ব্যবহার করে একটি নির্দিষ্ট সিরিয়াল নম্বর অনুসন্ধান করে, যেখানে 123456 হল ডিভাইসের সিরিয়াল নম্বর। নীচে দেখানো প্রতিক্রিয়াটিতে একটি একক মিলে যাওয়া উত্তর রয়েছে, যেখানে serialNumber বৈশিষ্ট্য অনুসন্ধান মানের সাথে মেলে।

JSON অনুরোধ

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
chromeos?projection=FULL&query=id:123456&orderBy=status
&sortOrder=ASCENDING&maxResults=100

JSON প্রতিক্রিয়া

{
  "kind": "directory#chromeosdevices",
  "chromeosdevices": [
     {
       "kind": "directory#chromeosdevice",
       "deviceId": "abc123",
       "serialNumber": "123456",
       "status": "SHIPPED",
       "supportEndDate": "1404457200000",
       "model": "model_value",
       "meid": "meid_value",
       "macAddress": "mac_address_value",
       "orderNumber": "1234",
       "willAutoRenew": true
     }
  ],
  "nextPageToken": "abcdefghijkl123"
}

এই প্রতিক্রিয়া উদাহরণ model , meid , এবং macAddress বৈশিষ্ট্য অন্তর্ভুক্ত। যদি কোনও ডিভাইসে এই বৈশিষ্ট্যগুলি না থাকে তবে সেগুলি প্রতিক্রিয়াতে অন্তর্ভুক্ত করা হয় না। সম্পূর্ণ বিশদ বিবরণের জন্য, Chromeosdevices সম্পদ উপস্থাপনা দেখুন।

একটি MEID তালিকা রপ্তানি করুন

একটি Chrome ডিভাইসে 3G মোবাইল কার্ডের জন্য meid হল মোবাইল ইকুইপমেন্ট আইডেন্টিফায়ার (MEID)৷ একটি MEID সাধারণত একটি বেতার ক্যারিয়ারের পোস্ট-পে পরিষেবা পরিকল্পনায় একটি ডিভাইস যোগ করার সময় ব্যবহৃত হয়। MEID তালিকা রপ্তানি করতে, MEID-এর সম্পূর্ণ তালিকা পুনরুদ্ধার করতে নিম্নলিখিত GET অনুরোধ এবং nextPageToken মানগুলি ব্যবহার করুন৷ পঠনযোগ্যতার জন্য, এই কোড নমুনা লাইন রিটার্ন আছে:

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/
devices/chromeos?fields=nextPageToken,chromeosdevices(meid)

একটি Chrome ডিভাইস পুনরুদ্ধার করুন

একটি Chrome ডিভাইসের বৈশিষ্ট্য পুনরুদ্ধার করতে, নিম্নলিখিত GET অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। পঠনযোগ্যতার জন্য, এই কোড নমুনা লাইন রিটার্ন আছে:

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/
devices/chromeos/deviceId?projection={FULL|BASIC}
  • customerId হল গ্রাহকের Google অ্যাকাউন্টের একটি অনন্য শনাক্তকারী।
  • একজন অ্যাকাউন্ট প্রশাসক হিসাবে, আপনি my_customer স্ট্রিংটিও ব্যবহার করতে পারেন যা আপনার অ্যাকাউন্টের customerId প্রতিনিধিত্ব করে। customerId মান পাওয়ার আরেকটি উপায় হল ব্যবহারকারীর অপারেশন পুনরুদ্ধার করা । অপারেশনের userKey পাথ প্যারামিটারে আপনার প্রশাসকের ইমেল ঠিকানা বা আপনার প্রশাসকের অনন্য ব্যবহারকারী id মান ব্যবহার করুন৷
  • deviceId একটি ডিভাইসের জন্য একটি অনন্য শনাক্তকারী এবং এটি সমস্ত Chrome ডিভাইস পুনরুদ্ধার অপারেশনের প্রতিক্রিয়াতে পাওয়া যায়।

ক্যোয়ারী স্ট্রিং, অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, API রেফারেন্স দেখুন।

JSON অনুরোধ

একটি উদাহরণ অনুরোধ। পঠনযোগ্যতার জন্য, এই কোড নমুনায় লাইন রিটার্ন রয়েছে:
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
chromeos/deviceId?projection=full

JSON প্রতিক্রিয়া

একটি সফল অনুরোধ একটি HTTP 200 স্ট্যাটাস কোড প্রদান করে। স্ট্যাটাস কোডের সাথে, প্রতিক্রিয়াটি Chrome ডিভাইসের বৈশিষ্ট্যগুলি প্রদান করে:

{
  "kind": "directory#chromeosdevice",
  "deviceId": "device_id_value",
  "serialNumber": "device_serial_number",
  "status": "ACTIVE",
  "lastSync": "2012-04-05T17:30:04.325Z",
  "supportEndDate": "2014-04-05T17:30:04.325Z",
  "annotatedUser": "help desk",
  "annotatedLocation": "Mountain View help desk Chromebook",
  "annotatedAssetId": "12345667890",
  "notes": "Loaned from support",
  "orderNumber": "123456",
  "willAutoRenew": true,
  "osVersion": "Browser Version 18.0",
  "platformVersion": "Platform Version 1415.2.0",
  "firmwareVersion": "Firmware Version 1.2.3.4",
  "bootMode": "validated"
  "lastEnrollmentTime": "2012-04-05T17:30:04.325Z",
  "orgUnitPath": "corp/engineering"
}

একটি Chrome ডিভাইস আপডেট করুন

একটি Chrome ডিভাইস আপডেট করতে, নিম্নলিখিত PUT অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। পঠনযোগ্যতার জন্য, এই কোড নমুনা লাইন রিটার্ন আছে:

PUT https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/
devices/chromeos/deviceId?projection={FULL|BASIC}
  • customerId হল গ্রাহকের Google অ্যাকাউন্টের একটি অনন্য শনাক্তকারী।
  • একজন অ্যাকাউন্ট প্রশাসক হিসাবে, আপনি my_customer স্ট্রিংটিও ব্যবহার করতে পারেন যা আপনার অ্যাকাউন্টের customerId প্রতিনিধিত্ব করে। customerId মান পাওয়ার আরেকটি উপায় হল ব্যবহারকারীর অপারেশন পুনরুদ্ধার করা । অপারেশনের userKey পাথ প্যারামিটারে আপনার প্রশাসকের ইমেল ঠিকানা বা আপনার প্রশাসকের অনন্য ব্যবহারকারী id মান ব্যবহার করুন৷
  • deviceId একটি ডিভাইসের জন্য একটি অনন্য শনাক্তকারী এবং এটি সমস্ত Chrome ডিভাইস পুনরুদ্ধার অপারেশনের প্রতিক্রিয়াতে পাওয়া যায়।

ক্যোয়ারী স্ট্রিং, অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, API রেফারেন্স দেখুন।

JSON অনুরোধ

নিম্নলিখিত উদাহরণ JSON অনুরোধ একটি Chrome ডিভাইসের annotatedUser , annotatedLocation , annotatedAssetId , notes , এবং orgUnitPath বৈশিষ্ট্য আপডেট করে৷ পঠনযোগ্যতার জন্য, এই কোড নমুনা লাইন রিটার্ন আছে:

PUT https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos/deviceId?projection=full
অনুরোধের মূল অংশের উদাহরণ:
{
  "deviceId": "device_id_value",
  "annotatedUser": "help desk",
  "annotatedLocation": "Mountain View help desk Chromebook",
  "annotatedAssetId": "1234567890",
  "notes": "Loaned from support",
  "orgUnitPath": "/corp/sales"
}

একটি আপডেটের অনুরোধের জন্য, শুধুমাত্র আপনার অনুরোধে আপডেট করা মান সহ বৈশিষ্ট্যগুলি অন্তর্ভুক্ত করুন৷

একটি সফল অনুরোধ একটি HTTP 200 স্ট্যাটাস কোড প্রদান করে। স্ট্যাটাস কোডের সাথে, প্রতিক্রিয়া আপডেট করা Chrome ডিভাইসের জন্য বৈশিষ্ট্য প্রদান করে।

ক্রোম ডিভাইসগুলিকে অব্যবহিত করা বা অক্ষম করা৷

ক্রোম ডিভাইসগুলিকে অপ্রয়োজনীয় বা অক্ষম করতে, নিম্নলিখিত POST অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধগুলিতে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন৷ পঠনযোগ্যতার জন্য, এই কোড নমুনা লাইন রিটার্ন আছে:

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer or customerId/
devices/chromeos:batchChangeStatus

  • customerId হল গ্রাহকের Google অ্যাকাউন্টের একটি অনন্য শনাক্তকারী।
  • একজন অ্যাকাউন্ট প্রশাসক হিসাবে, আপনি my_customer স্ট্রিংটিও ব্যবহার করতে পারেন যা আপনার অ্যাকাউন্টের customerId প্রতিনিধিত্ব করে। customerId মান পাওয়ার আরেকটি উপায় হল ব্যবহারকারীর অপারেশন পুনরুদ্ধার করা । অপারেশনের userKey পাথ প্যারামিটারে আপনার প্রশাসকের ইমেল ঠিকানা বা আপনার প্রশাসকের অনন্য ব্যবহারকারী id মান ব্যবহার করুন৷

অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, API রেফারেন্স দেখুন।

JSON অনুরোধ

নিম্নলিখিত JSON অনুরোধটি Chrome ডিভাইসগুলিকে অব্যবহিত এবং অক্ষম করার জন্য একটি নমুনা অনুরোধ দেখায়:

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos:batchChangeStatus
স্যাম্পল ডিপ্রোভিশনের রিকোয়েস্ট বডি হল:
{
  "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"],
  "changeChromeOsDeviceStatusAction": "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION",
  "deprovisionReason": "DEPROVISION_REASON_RETIRING_DEVICE"
}
ডিজেবল করার রিকোয়েস্ট বডি হল:
  {
    "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"],
    "changeChromeOsDeviceStatusAction": "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE",
  }

একটি সফল অনুরোধ একটি HTTP 200 স্ট্যাটাস কোড প্রদান করে।

Chrome ডিভাইসগুলিকে অর্গানাইজেশন ইউনিটে সরান৷

একটি অর্গানাইজেশন ইউনিটে 50টি পর্যন্ত Chrome ডিভাইস সরাতে, নিম্নলিখিত POST অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। পঠনযোগ্যতার জন্য, এই কোড নমুনা লাইন রিটার্ন আছে:

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos/moveDevicesToOu?orgUnitPath=/SomeOuName
  • customerId হল গ্রাহকের Google অ্যাকাউন্টের একটি অনন্য শনাক্তকারী।
  • একজন অ্যাকাউন্ট প্রশাসক হিসাবে, আপনি my_customer স্ট্রিংটিও ব্যবহার করতে পারেন যা আপনার অ্যাকাউন্টের customerId প্রতিনিধিত্ব করে। customerId মান পাওয়ার আরেকটি উপায় হল ব্যবহারকারীর অপারেশন পুনরুদ্ধার করা । অপারেশনের userKey পাথ প্যারামিটারে আপনার প্রশাসকের ইমেল ঠিকানা বা আপনার প্রশাসকের অনন্য ব্যবহারকারী id মান ব্যবহার করুন৷

অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, API রেফারেন্স দেখুন।

JSON অনুরোধ

নিম্নলিখিত JSON অনুরোধটি /Marketing নামে একটি প্রতিষ্ঠান ইউনিটে 3টি Chrome ডিভাইস সরানোর জন্য একটি নমুনা অনুরোধ দেখায়:

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos/chromeos/moveDevicesToOu?orgUnitPath=/Marketing

ডিভাইস সরানোর জন্য অনুরোধের অংশ হল:

{
  "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"]
}

একটি সফল অনুরোধ একটি HTTP 200 স্ট্যাটাস কোড প্রদান করে।