Method: partners.devices.findByIdentifier

    • This API endpoint allows searching for devices by hardware identifiers like IMEI using a POST request.

    • The request URL follows gRPC Transcoding syntax and requires the partnerId as a path parameter.

    • The request body must include pageToken , limit , and deviceIdentifier to specify the search criteria and results page size.

    • The response body includes a list of devices , along with nextPageToken for pagination and totalSize for the total device count.

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

    Finds devices by hardware identifiers, such as IMEI.

    HTTP request

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

    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 
 , 
 "deviceIdentifier" 
 : 
 { 
 object (  DeviceIdentifier 
 
) 
 } 
 }
    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.
    deviceIdentifier

    object ( DeviceIdentifier )

    Required. Required. The device identifier 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 )

    Found 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 .
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: