Method: partners.devices.findByOwner

دستگاه های ادعا شده برای مشتریان را پیدا می کند. نتایج فقط شامل دستگاه‌های ثبت‌شده برای فروشنده است که با آرگومان partnerId شناسایی شده‌اند. دستگاه های مشتری خریداری شده از سایر فروشندگان در نتایج ظاهر نمی شوند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
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 مراجعه کنید.