Method: partners.devices.claim

Rezerwuje urządzenie dla klienta i dodaje je do rejestracji typu zero-touch. Jeśli inny klient już zgłosił prawo do danego urządzenia, 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)

Wymagane. 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)

Wymagane. Wymagane. Identyfikator urządzenia, do którego chcesz zgłosić prawa.
sectionType

enum (DeviceProvisioningSectionType)

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

object (DeviceMetadata)

Opcjonalnie: Metadane, które mają zostać dołączone do urządzenia.
preProvisioningToken

string

Opcjonalnie: Musi być i można go ustawić tylko dla urządzeń z Chrome OS.
Pole sumy customer. Wymagane. Klient, w imieniu którego zgłoszono roszczenie dotyczące urządzenia. customer może mieć tylko jedną z tych wartości:
customerId

string (int64 format)

Identyfikator klienta, w imieniu którego zgłaszane jest własność urządzenia.
googleWorkspaceCustomerId

string

Identyfikator klienta Google Workspace.

Treść odpowiedzi

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

Komunikat z odpowiedzią zawierający identyfikator urządzenia dla roszczenia.

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

string (int64 format)

Identyfikator urządzenia objętego roszczeniem.
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 artykule Omówienie protokołu OAuth 2.0.