אחזור רשימה מעומדת של כל המכשירים הניידים בבעלות המשתמש לחשבון. כדי לאחזר רשימה שכוללת מכשירים בבעלות החברה, צריך להשתמש ב-Cloud Identity Devices API. השיטה הזו מפסיקה לפעול לאחר 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
טיפוסים בני מנייה (enums) | |
---|---|
DEVICE_ID |
המספר הסידורי של מכשיר נייד של Google Sync. למכשירי Android, זהו מזהה ייחודי שנוצר על ידי תוכנה. |
EMAIL |
זוהי כתובת האימייל של בעלי המכשיר. |
LAST_SYNC |
תאריך הסנכרון של הגדרות המדיניות האחרונות של המכשיר. |
MODEL |
הדגם של המכשיר הנייד. |
NAME |
שם המשתמש של הבעלים של המכשיר. |
OS |
מערכת ההפעלה של המכשיר. |
STATUS |
סטטוס המכשיר. |
TYPE |
סוג המכשיר. |
תחזית
טיפוסים בני מנייה (enums) | |
---|---|
BASIC |
כולל רק את שדות המטא-נתונים הבסיסיים (למשל, מזהה מכשיר, דגם, סטטוס, סוג וסטטוס) |
FULL |
כולל את כל שדות המטא-נתונים |
SortOrder
טיפוסים בני מנייה (enums) | |
---|---|
ASCENDING |
סדר עולה. |
DESCENDING |
סדר יורד. |