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.