Method: partners.devices.claimAsync
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Rivendica un gruppo di dispositivi per un cliente in modo asincrono. Aggiunge i dispositivi alla registrazione zero-touch. Per saperne di più, vedi Operazioni batch a lunga esecuzione.
Richiesta HTTP
POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claimAsync
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
partnerId |
string (int64 format)
Obbligatorio. L'ID del partner rivenditore.
|
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"claims": [
{
object (PartnerClaim)
}
]
} |
| Campi |
claims[] |
object (PartnerClaim)
Obbligatorio. Un elenco di rivendicazioni relative ai dispositivi.
|
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/androidworkprovisioning
Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
PartnerClaim
Identifica una richiesta di rivendicazione.
| Rappresentazione 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.
} |
| Campi |
deviceIdentifier |
object (DeviceIdentifier)
Obbligatorio. Obbligatorio. Identificatore del dispositivo.
|
sectionType |
enum (DeviceProvisioningSectionType)
Obbligatorio. Il tipo di sezione del record di provisioning del dispositivo.
|
deviceMetadata |
object (DeviceMetadata)
Obbligatorio. I metadati da allegare al dispositivo oggetto della rivendicazione.
|
preProvisioningToken |
string
(Facoltativo) Deve essere e può essere impostato solo per i dispositivi ChromeOS.
|
Campo unione customer. Obbligatorio. Il cliente per il quale il dispositivo viene rivendicato. customer può essere solo uno dei seguenti: |
customerId |
string (int64 format)
L'ID del cliente per il quale il dispositivo viene rivendicato.
|
googleWorkspaceCustomerId |
string
L'ID cliente di Google Workspace.
|
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[[["\u003cp\u003eThis endpoint \u003ccode\u003ePOST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claimAsync\u003c/code\u003e enables partners to asynchronously claim a batch of devices for a customer, adding them to zero-touch enrollment.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires a \u003ccode\u003epartnerId\u003c/code\u003e path parameter, which is the reseller partner's ID, and a request body with a list of device claims within the \u003ccode\u003eclaims\u003c/code\u003e field.\u003c/p\u003e\n"],["\u003cp\u003eEach device claim is identified by a \u003ccode\u003ePartnerClaim\u003c/code\u003e object, which contains the \u003ccode\u003edeviceIdentifier\u003c/code\u003e, \u003ccode\u003esectionType\u003c/code\u003e, \u003ccode\u003edeviceMetadata\u003c/code\u003e, and a customer identifier in the form of \u003ccode\u003ecustomerId\u003c/code\u003e or \u003ccode\u003egoogleWorkspaceCustomerId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ePartnerClaim\u003c/code\u003e object optionally includes a \u003ccode\u003epreProvisioningToken\u003c/code\u003e and is required to complete the request.\u003c/p\u003e\n"],["\u003cp\u003eA successful request returns an \u003ccode\u003eOperation\u003c/code\u003e object, indicating that the long-running operation has been initiated.\u003c/p\u003e\n"]]],["This outlines how to claim devices for a customer asynchronously via the Android zero-touch enrollment API. Use a `POST` request to `https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claimAsync`, providing the required `partnerId`. The request body, structured in JSON, includes a list of device `claims` with each claim containing the `deviceIdentifier`, `sectionType`, `deviceMetadata`, and the required customer's ID (`customerId` or `googleWorkspaceCustomerId`). The `preProvisioningToken` field is required only for ChromeOS devices. The response body contains an `Operation`.\n"],null,["# Method: partners.devices.claimAsync\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n- [PartnerClaim](#PartnerClaim)\n - [JSON representation](#PartnerClaim.SCHEMA_REPRESENTATION)\n\nClaims a batch of devices for a customer asynchronously. Adds the devices to zero-touch enrollment. To learn more, read [Long‑running batch operations](/zero-touch/guides/how-it-works#operations).\n\n### HTTP request\n\n`POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claimAsync`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------------|\n| `partnerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the reseller partner. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"claims\": [ { object (/zero-touch/reference/reseller/rest/v1/partners.devices/claimAsync#PartnerClaim) } ] } ``` |\n\n| Fields ||\n|------------|-------------------------------------------------------------------------------------------------------------------------------------------------|\n| `claims[]` | `object (`[PartnerClaim](/zero-touch/reference/reseller/rest/v1/partners.devices/claimAsync#PartnerClaim)`)` Required. A list of device claims. |\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/zero-touch/reference/reseller/rest/v1/operations#Operation).\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidworkprovisioning`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).\n\nPartnerClaim\n------------\n\nIdentifies one claim request.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"deviceIdentifier\": { object (/zero-touch/reference/reseller/rest/v1/partners.devices#DeviceIdentifier) }, \"sectionType\": enum (/zero-touch/reference/reseller/rest/v1/partners.devices#DeviceProvisioningSectionType), \"deviceMetadata\": { object (/zero-touch/reference/reseller/rest/v1/partners.devices#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`. } ``` |\n\n| Fields ||\n|-----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `deviceIdentifier` | `object (`[DeviceIdentifier](/zero-touch/reference/reseller/rest/v1/partners.devices#DeviceIdentifier)`)` Required. Required. Device identifier of the device. |\n| `sectionType` | `enum (`[DeviceProvisioningSectionType](/zero-touch/reference/reseller/rest/v1/partners.devices#DeviceProvisioningSectionType)`)` Required. The section type of the device's provisioning record. |\n| `deviceMetadata` | `object (`[DeviceMetadata](/zero-touch/reference/reseller/rest/v1/partners.devices#DeviceMetadata)`)` Required. The metadata to attach to the device at claim. |\n| `preProvisioningToken` | `string` Optional. Must and can only be set for Chrome OS devices. |\n| Union field `customer`. Required. The customer for whom the device is being claimed. `customer` can be only one of the following: ||\n| `customerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the customer for whom the device is being claimed. |\n| `googleWorkspaceCustomerId` | `string` The Google Workspace customer ID. |"]]
