Method: partners.devices.findByOwner

  • This API endpoint finds devices claimed by customers, specifically those registered to the reseller identified by the partnerId.

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

  • The request body requires parameters such as limit, and sectionType, and includes optional fields for filtering by customerId and googleWorkspaceCustomerId.

  • The response body returns a list of devices, and information about pagination through nextPageToken, along with the totalSize.

  • Authorization for this API requires the https://www.googleapis.com/auth/androidworkprovisioning OAuth scope.

Finds devices claimed for customers. The results only contain devices registered to the reseller that's identified by the partnerId argument. The customer's devices purchased from other resellers don't appear in the results.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
partnerId

string (int64 format)

Required. The ID of the reseller partner.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "pageToken": string,
  "limit": string,
  "sectionType": enum (DeviceProvisioningSectionType),
  "customerId": [
    string
  ],
  "googleWorkspaceCustomerId": [
    string
  ]
}
Fields
pageToken

string

A token specifying which result page to return.
limit

string (int64 format)

Required. The maximum number of devices to show in a page of results. Must be between 1 and 100 inclusive.
sectionType

enum (DeviceProvisioningSectionType)

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

string (int64 format)

The list of customer IDs to search for.
googleWorkspaceCustomerId[]

string

The list of IDs of Google Workspace accounts to search for.

Response body

If successful, the response body contains data with the following structure:

Response containing found devices.

JSON representation 
{
  "devices": [
    {
      object (Device)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Fields
devices[]

object (Device)

The customer's devices.
nextPageToken

string

A token used to access the next page of results. Omitted if no further results are available.
totalSize

integer

The total count of items in the list irrespective of pagination.

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.