Method: partners.devices.findByOwner

Znajduje urządzenia zarezerwowane dla klientów. Wyniki zawierają tylko urządzenia zarejestrowane u sprzedawcy, które zostały określone za pomocą argumentu partnerId. Urządzenia klienta kupione u innych sprzedawców nie pojawiają się w wynikach wyszukiwania.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
partnerId

string (int64 format)

Wymagane. Identyfikator partnera sprzedawcy.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "pageToken": string,
  "limit": string,
  "sectionType": enum (DeviceProvisioningSectionType),
  "customerId": [
    string
  ],
  "googleWorkspaceCustomerId": [
    string
  ]
}
Pola
pageToken

string

Token określający stronę wyników do zwrócenia.

limit

string (int64 format)

Wymagane. Maksymalna liczba urządzeń wyświetlanych na stronie wyników. Musi mieścić się w przedziale od 1 do 100 włącznie.

sectionType

enum (DeviceProvisioningSectionType)

Wymagane. Typ sekcji rekordu obsługi administracyjnej urządzenia.

customerId[]

string (int64 format)

Lista identyfikatorów klientów do wyszukania.

googleWorkspaceCustomerId[]

string

Lista identyfikatorów kont Google Workspace do wyszukania.

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Odpowiedź zawierająca znalezione urządzenia.

Zapis JSON
{
  "devices": [
    {
      object (Device)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Pola
devices[]

object (Device)

Urządzenia klienta.

nextPageToken

string

Token użyty do uzyskania dostępu do następnej strony wyników. Pomijany, jeśli nie są dostępne żadne dalsze wyniki.

totalSize

integer

Łączna liczba elementów na liście bez względu na podział na strony.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.