Method: partners.devices.findByOwner

חיפוש מכשירים שלקוחות תבעו עליהם בעלות. התוצאות מכילות רק מכשירים הרשומים למפיץ וזוהו על ידי הארגומנט partnerId. המכשירים של הלקוח שנרכשו ממפיצים אחרים לא יופיעו בתוצאות.

בקשת HTTP

POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:findByOwner

כתובת ה-URL משתמשת בתחביר gRPC קידוד מחדש.

פרמטרים של נתיב

פרמטרים
partnerId

string (int64 format)

חובה. המזהה של שותף המפיץ.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON
{
  "pageToken": string,
  "limit": string,
  "sectionType": enum (DeviceProvisioningSectionType),
  "customerId": [
    string
  ],
  "googleWorkspaceCustomerId": [
    string
  ]
}
שדות
pageToken

string

אסימון שמציין איזה דף תוצאה להחזיר.

limit

string (int64 format)

חובה. המספר המקסימלי של מכשירים שיוצגו בדף תוצאות. חייב להיות בין 1 ל-100, כולל.

sectionType

enum (DeviceProvisioningSectionType)

חובה. סוג הקטע ברשומת ניהול התצורה של המכשיר.

customerId[]

string (int64 format)

רשימת מספרי הלקוח שיש לחפש.

googleWorkspaceCustomerId[]

string

רשימת המזהים של חשבונות Google Workspace שברצונך לחפש.

גוף התשובה

אם התגובה הצליחה, גוף התגובה מכיל נתונים במבנה הבא:

תגובה שמכילה מכשירים שנמצאו.

ייצוג JSON
{
  "devices": [
    {
      object (Device)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
שדות
devices[]

object (Device)

המכשירים של הלקוח.

nextPageToken

string

אסימון המשמש לגישה לדף התוצאות הבא. הושמט אם אין תוצאות נוספות זמינות.

totalSize

integer

המספר הכולל של הפריטים ברשימה, ללא קשר לעימוד.

היקפי הרשאה

ההגדרה הזו מחייבת את היקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/androidworkprovisioning

למידע נוסף, עיינו בסקירה כללית על OAuth 2.0.