חיפוש מכשירים שלקוחות תבעו עליהם בעלות. התוצאות מכילות רק מכשירים הרשומים למפיץ וזוהו על ידי הארגומנט partnerId
. המכשירים של הלקוח שנרכשו ממפיצים אחרים לא יופיעו בתוצאות.
בקשת HTTP
POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:findByOwner
כתובת ה-URL משתמשת בתחביר gRPC קידוד מחדש.
פרמטרים של נתיב
פרמטרים | |
---|---|
partnerId |
חובה. המזהה של שותף המפיץ. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"pageToken": string,
"limit": string,
"sectionType": enum ( |
שדות | |
---|---|
pageToken |
אסימון שמציין איזה דף תוצאה להחזיר. |
limit |
חובה. המספר המקסימלי של מכשירים שיוצגו בדף תוצאות. חייב להיות בין 1 ל-100, כולל. |
sectionType |
חובה. סוג הקטע ברשומת ניהול התצורה של המכשיר. |
customerId[] |
רשימת מספרי הלקוח שיש לחפש. |
googleWorkspaceCustomerId[] |
רשימת המזהים של חשבונות Google Workspace שברצונך לחפש. |
גוף התשובה
אם התגובה הצליחה, גוף התגובה מכיל נתונים במבנה הבא:
תגובה שמכילה מכשירים שנמצאו.
ייצוג JSON |
---|
{
"devices": [
{
object ( |
שדות | |
---|---|
devices[] |
המכשירים של הלקוח. |
nextPageToken |
אסימון המשמש לגישה לדף התוצאות הבא. הושמט אם אין תוצאות נוספות זמינות. |
totalSize |
המספר הכולל של הפריטים ברשימה, ללא קשר לעימוד. |
היקפי הרשאה
ההגדרה הזו מחייבת את היקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/androidworkprovisioning
למידע נוסף, עיינו בסקירה כללית על OAuth 2.0.