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