Method: mobiledevices.list

किसी खाते के लिए, उपयोगकर्ता के मालिकाना हक वाले सभी मोबाइल डिवाइसों की पेज की गई सूची दिखाता है. कंपनी के मालिकाना हक वाले डिवाइसों की सूची पाने के लिए, Cloud Identity Devices API का इस्तेमाल करें. इस तरीके के लिए 60 मिनट का समय तय है. ज़्यादा जानकारी के लिए, गड़बड़ी के कोड से जुड़ी समस्या हल करना लेख पढ़ें.

एचटीटीपी अनुरोध

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/mobile

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.

पाथ पैरामीटर

पैरामीटर
customerId

string

ग्राहक के Google Workspace खाते का यूनीक आईडी. खाते के एडमिन के तौर पर, अपने खाते के customerId को दिखाने के लिए, my_customer के उपनाम का भी इस्तेमाल किया जा सकता है. customerId को उपयोगकर्ता संसाधन के हिस्से के तौर पर भी दिखाया जाता है.

क्वेरी पैरामीटर

पैरामीटर
maxResults

integer

कितने नतीजे दिखाने हैं. ज़्यादा से ज़्यादा वैल्यू 100 हो सकती है.
orderBy

enum (OrderBy)

नतीजों को क्रम से लगाने के लिए इस्तेमाल की जाने वाली डिवाइस प्रॉपर्टी.
pageToken

string

सूची में अगले पेज की जानकारी देने वाला टोकन
projection

enum (Projection)

चुने गए फ़ील्ड के सेट में दिखाई गई जानकारी पर पाबंदी लगाएं.
query

string

https://developers.google.com/workspace/admin/directory/v1/search-operators पर दिए गए फ़ॉर्मैट में खोज स्ट्रिंग
sortOrder

enum (SortOrder)

नतीजों को बढ़ते या घटते क्रम में दिखाना है या नहीं. इसका इस्तेमाल orderBy पैरामीटर के साथ करना ज़रूरी है.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "kind": string,
  "etag": string,
  "mobiledevices": [
    {
      object (MobileDevice)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
kind

string

यह किस तरह का संसाधन है.
etag

string

संसाधन का ETag.
mobiledevices[]

object (MobileDevice)

मोबाइल डिवाइस ऑब्जेक्ट की सूची.
nextPageToken

string

इस नतीजे के अगले पेज को ऐक्सेस करने के लिए इस्तेमाल किया जाने वाला टोकन.

अनुमति के दायरे

इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/admin.directory.device.mobile
  • https://www.googleapis.com/auth/admin.directory.device.mobile.action
  • https://www.googleapis.com/auth/admin.directory.device.mobile.readonly

ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.

OrderBy

Enums
DEVICE_ID Google Sync के साथ काम करने वाले मोबाइल डिवाइस का सीरियल नंबर. Android डिवाइसों के लिए, यह सॉफ़्टवेयर से जनरेट किया गया यूनीक आइडेंटिफ़ायर होता है.
EMAIL डिवाइस के मालिक का ईमेल पता.
LAST_SYNC डिवाइस की नीति सेटिंग को आखिरी बार सिंक करने की तारीख और समय.
MODEL मोबाइल डिवाइस का मॉडल.
NAME डिवाइस के मालिक का उपयोगकर्ता नाम.
OS डिवाइस का ऑपरेटिंग सिस्टम.
STATUS डिवाइस की स्थिति.
TYPE डिवाइस का टाइप.

अनुमान

Enums
BASIC इसमें सिर्फ़ बुनियादी मेटाडेटा फ़ील्ड शामिल होते हैं. जैसे, deviceId, मॉडल, स्थिति, टाइप, और स्थिति
FULL इसमें सभी मेटाडेटा फ़ील्ड शामिल होते हैं

SortOrder

Enums
ASCENDING बढ़ते क्रम में.
DESCENDING घटते क्रम में.