Method: partners.devices.claim

Rezerwowanie urządzenia dla klienta i dodawanie go do rejestracji typu zero-touch. Jeśli urządzenie zostało już zajęte przez innego klienta, wywołanie zwróci błąd.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
partnerId

string (int64 format)

Wymagany. Identyfikator partnera sprzedawcy.

Treść żądania

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

Zapis JSON 
{
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "sectionType": enum (DeviceProvisioningSectionType),
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "preProvisioningToken": string,
  // Union field customer can be only one of the following:
  "customerId": string,
  "googleWorkspaceCustomerId": string
  // End of list of possible types for union field customer.
}
Pola
deviceIdentifier

object (DeviceIdentifier)

Wymagany. Wymagany. Identyfikator urządzenia, na które chcesz zgłosić prawa.
sectionType

enum (DeviceProvisioningSectionType)

Wymagany. Typ sekcji rekordu udostępniania urządzenia.
deviceMetadata

object (DeviceMetadata)

Opcjonalnie. Metadane do dołączenia do urządzenia.
preProvisioningToken

string

Opcjonalnie. Tę funkcję można skonfigurować tylko na urządzeniach z Chrome OS.
Pole sumy: customer. Wymagany. Klient, do którego zgłoszono prawa do urządzenia. customer może mieć tylko jedną z tych wartości:
customerId

string (int64 format)

Identyfikator klienta, do którego zgłoszono prawa do urządzenia.
googleWorkspaceCustomerId

string

Identyfikator klienta Google Workspace.

Treść odpowiedzi

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

Odpowiedź zawierająca identyfikator urządzenia roszczenia.

Zapis JSON 
{
  "deviceId": string,
  "deviceName": string
}
Pola
deviceId

string (int64 format)

Identyfikator urządzenia, na którym zgłoszono roszczenie.
deviceName

string

Nazwa zasobu urządzenia w formacie partners/[PARTNER_ID]/devices/[DEVICE_ID].

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.