Method: partners.devices.unclaimAsync

  • This endpoint facilitates the asynchronous unclaiming of a batch of devices for a customer, effectively removing them from zero-touch enrollment.

  • The HTTP request to unclaim devices is a POST request to https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:unclaimAsync, utilizing gRPC Transcoding syntax.

  • The request requires a partnerId path parameter, representing the reseller partner ID, and the request body contains a list of unclaims, each specifying a device to be unclaimed.

  • The PartnerUnclaim object uses a union field device that accepts either a deviceIdentifier or a deviceId to specify which device should be unclaimed, along with the sectionType of the device.

  • The endpoint requires the https://www.googleapis.com/auth/androidworkprovisioning OAuth scope and returns an instance of Operation upon successful completion.

Unclaims a batch of devices for a customer asynchronously. Removes the devices from zero-touch enrollment. To learn more, read Long‑running batch operations.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
partnerId

string (int64 format)

Required. The reseller partner ID.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "unclaims": [
    {
      object (PartnerUnclaim)
    }
  ]
}
Fields
unclaims[]

object (PartnerUnclaim)

Required. The list of devices to unclaim.

Response body

If successful, the response body contains an instance of Operation.

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.

PartnerUnclaim

Identifies one unclaim request.

JSON representation 
{
  "sectionType": enum (DeviceProvisioningSectionType),

  // Union field device can be only one of the following:
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "deviceId": string
  // End of list of possible types for union field device.
}
Fields
sectionType

enum (DeviceProvisioningSectionType)

Required. The section type of the device's provisioning record.
Union field device. The device to unclaim. device can be only one of the following:
deviceIdentifier

object (DeviceIdentifier)

Required. Device identifier of the device.
deviceId

string (int64 format)

Required. Device ID of the device.