GOgoogle
partners

POST /v1/partners/{partnersId}/devices:claim

Claims a device for a customer and adds it to zero-touch enrollment. If the device is already claimed by another customer, the call returns an error.

Request

  • Base URL
    https://androiddeviceprovisioning.googleapis.com
  • URL
    https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnersId}/devices:claim
  • Auth
    none declared

Path parameters

partnersIdstring required

Request body

configurationIdstring int64

Optional. The ID of the configuration applied to the device section.

customerIdstring int64

The ID of the customer for whom the device is being claimed.

googleWorkspaceCustomerIdstring

The Google Workspace customer ID.

preProvisioningTokenstring

Optional. Must and can only be set for Chrome OS devices.

sectionType'SECTION_TYPE_UNSPECIFIED' | 'SECTION_TYPE_SIM_LOCK' | 'SECTION_TYPE_ZERO_TOUCH'

Required. The section type of the device's provisioning record.

simlockProfileIdstring int64

Optional. Must and can only be set when DeviceProvisioningSectionType is SECTION_TYPE_SIM_LOCK. The unique identifier of the SimLock profile.

Response

Successful response

deviceIdstring int64

The device ID of the claimed device.

deviceNamestring

The resource name of the device in the format partners/[PARTNER_ID]/devices/[DEVICE_ID].

Changes

No recorded changes to this operation across all 4 revisions of this API.