Directory API: ChromeOS ডিভাইস

কোনও অ্যাকাউন্টের জন্য সব ChromeOS ডিভাইস ফিরিয়ে আনুন

কোনও অ্যাকাউন্টে অ্যাসাইন করা সব ChromeOS ডিভাইসের তালিকা পেতে, নিম্নলিখিত 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 তালিকা এক্সপোর্ট করা

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

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

ChromeOS ডিভাইস ফিরিয়ে আনা

ChromeOS ডিভাইসের প্রপার্টি ফিরিয়ে আনতে, নিম্নলিখিত 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 হল ডিভাইসের জন্য একটি অনন্য শনাক্তকারী এবং এটি সব ChromeOS ডিভাইস ফিরিয়ে আনুন অপারেশনের উত্তরে পাওয়া যায়।

কোয়েরি স্ট্রিং, অনুরোধ ও উত্তর সংক্রান্ত প্রপার্টির জন্য, API রেফারেন্স দেখুন।

JSON অনুরোধ

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

JSON রেসপন্স

অনুরোধ সফল হলে HTTP 200 স্ট্যাটাস কোড রিটার্ন করে। স্ট্যাটাস কোডের পাশাপাশি, রেসপন্স ChromeOS ডিভাইসের প্রপার্টি ফিরিয়ে দেয়: 

{
  "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"
}

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

ChromeOS ডিভাইস আপডেট করতে, নিম্নলিখিত 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 হল ডিভাইসের জন্য একটি অনন্য শনাক্তকারী এবং এটি সব ChromeOS ডিভাইস ফিরিয়ে আনুন অপারেশনের উত্তরে পাওয়া যায়।

কোয়েরি স্ট্রিং, অনুরোধ ও উত্তর সংক্রান্ত প্রপার্টির জন্য API রেফারেন্স দেখুন।

JSON অনুরোধ

নিম্নলিখিত JSON অনুরোধের উদাহরণ ChromeOS ডিভাইসের 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 স্ট্যাটাস কোড রিটার্ন করে। স্ট্যাটাস কোডের পাশাপাশি, রেসপন্স আপডেট করা ChromeOS ডিভাইসের প্রপার্টি ফিরিয়ে দেয়।

ChromeOS ডিভাইস ডিপ্রোভিশন বা বন্ধ করা

ChromeOS ডিভাইস ডিপ্রোভিশন বা বন্ধ করতে, নিম্নলিখিত 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 অনুরোধটি ChromeOS ডিভাইস ডিপ্রোভিশন এবং বন্ধ করার জন্য একটি নমুনা অনুরোধ দেখায়: 

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 স্ট্যাটাস কোড রিটার্ন করে।

ChromeOS ডিভাইসকে প্রাতিষ্ঠানিক ইউনিটে সরান

সর্বাধিক ৫০টি ChromeOS ডিভাইস কোনও একটি প্রতিষ্ঠান ইউনিটে সরাতে, নিম্নলিখিত 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 নামের একটি সাংগঠনিক ইউনিটে ৩টি ChromeOS ডিভাইস সরানোর জন্য একটি নমুনা অনুরোধ দেখায়: 

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 স্ট্যাটাস কোড দেখায়।