אחזור רשימה מחולקת של כל המכשירים הניידים בבעלות משתמש עבור חשבון. כדי לאחזר רשימה שכוללת מכשירים בבעלות החברה, צריך להשתמש במקום זאת ב-Devices API של Cloud Identity. בשיטה הזו הזמן הקצוב לתפוגה מסתיים אחרי 60 דקות. מידע נוסף זמין במאמר פתרון בעיות בקודי שגיאה.
בקשת HTTP
GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/mobile
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
customerId |
המזהה הייחודי של חשבון Google Workspace של הלקוח. כמנהל חשבון, יש לך אפשרות להשתמש בכינוי |
פרמטרים של שאילתה
פרמטרים | |
---|---|
maxResults |
מספר התוצאות המקסימלי שיש להחזיר. הערך המקסימלי המותר הוא 100. |
orderBy |
מאפיין המכשיר שמשמש למיון התוצאות. |
pageToken |
אסימון לציון הדף הבא ברשימה |
projection |
הגבלת המידע המוחזר לקבוצת שדות שנבחרו. |
query |
מחרוזת חיפוש בפורמט שמצוין בכתובת https://developers.google.com/admin-sdk/directory/v1/search-operators. |
sortOrder |
האם להחזיר תוצאות בסדר עולה או יורד. יש להשתמש בו עם הפרמטר |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"kind": string,
"etag": string,
"mobiledevices": [
{
object ( |
שדות | |
---|---|
kind |
זה סוג המשאב. |
etag |
ה-ETag של המשאב. |
mobiledevices[] |
רשימה של אובייקטים במכשיר נייד. |
nextPageToken |
האסימון שמשמש לגישה לדף הבא בתוצאה הזו. |
היקפי ההרשאות
נדרש אחד מהיקפי ההרשאות הבאים של 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
טיפוסים בני מנייה (enum) | |
---|---|
DEVICE_ID |
המספר הסידורי של מכשיר נייד של Google Sync. במכשירי Android, זהו מזהה ייחודי שנוצר על ידי תוכנה. |
EMAIL |
כתובת האימייל של בעלי המכשיר. |
LAST_SYNC |
הגדרות המדיניות האחרונות מסתנכרנות עם התאריך והשעה של המכשיר. |
MODEL |
הדגם של המכשיר הנייד. |
NAME |
שם המשתמש של בעלי המכשיר. |
OS |
מערכת ההפעלה שמותקנת במכשיר. |
STATUS |
סטטוס המכשיר. |
TYPE |
סוג המכשיר. |
היטל
טיפוסים בני מנייה (enum) | |
---|---|
BASIC |
כולל רק את שדות המטא-נתונים הבסיסיים (למשל, deviceId, דגם, סטטוס, סוג וסטטוס) |
FULL |
כולל את כל שדות המטא-נתונים |
SortOrder
טיפוסים בני מנייה (enum) | |
---|---|
ASCENDING |
סדר עולה. |
DESCENDING |
סדר יורד. |