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 |
Wymagany. Identyfikator partnera sprzedawcy. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "deviceIdentifier": { object ( |
Pola | |
---|---|
deviceIdentifier |
Wymagany. Wymagany. Identyfikator urządzenia, na które chcesz zgłosić prawa. |
sectionType |
Wymagany. Typ sekcji rekordu udostępniania urządzenia. |
deviceMetadata |
Opcjonalnie. Metadane do dołączenia do urządzenia. |
preProvisioningToken |
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 |
Identyfikator klienta, do którego zgłoszono prawa do urządzenia. |
googleWorkspaceCustomerId |
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 |
Identyfikator urządzenia, na którym zgłoszono roszczenie. |
deviceName |
Nazwa zasobu urządzenia w formacie |
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.