Device Run API (devicerun:v1)

2026-10-29

10 new methods | New API

Additions

    Methods
  • ▼ ▲ devicerun.projects.locations.list

      HTTP Method : GET

      Flat Path : v1/projects/{projectsId}/locations

      Parameters :

        pageSize

          Format : int32

          Description : The maximum number of results to return. If not set, the service selects a default.

          Type : integer

          Location : query

        name

          Type : string

          Required : Yes

          Description : The resource that owns the locations collection, if applicable.

          Location : path

          Pattern : ^projects/[^/]+$

        extraLocationTypes

          Location : query

          Repeated : Yes

          Description : Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage.

          Type : string

        filter

          Type : string

          Location : query

          Description : A filter to narrow down results to a preferred subset. The filtering language accepts strings like `"displayName=tokyo"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).

        pageToken

          Description : A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.

          Type : string

          Location : query

      Parameter Order : name

      Description : Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Path : v1/{+name}/locations

  • ▼ ▲ devicerun.projects.locations.get

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}

      HTTP Method : GET

      Parameter Order : name

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Parameters :

        name

          Type : string

          Location : path

          Required : Yes

          Pattern : ^projects/[^/]+/locations/[^/]+$

          Description : Resource name for the location.

      Description : Gets information about a location.

      Path : v1/{+name}

  • ▼ ▲ devicerun.projects.locations.operations.delete

      Parameters :

        name

          Location : path

          Required : Yes

          Pattern : ^projects/[^/]+/locations/[^/]+/operations/[^/]+$

          Type : string

          Description : The name of the operation resource to be deleted.

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}

      Description : Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.

      Parameter Order : name

      Path : v1/{+name}

      Scopes : https://www.googleapis.com/auth/cloud-platform

      HTTP Method : DELETE

  • ▼ ▲ devicerun.projects.locations.operations.cancel

      Scopes : https://www.googleapis.com/auth/cloud-platform

      HTTP Method : POST

      Parameters :

        name

          Type : string

          Location : path

          Pattern : ^projects/[^/]+/locations/[^/]+/operations/[^/]+$

          Description : The name of the operation resource to be cancelled.

          Required : Yes

      Parameter Order : name

      Path : v1/{+name}:cancel

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel

      Description : Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.

  • ▼ ▲ devicerun.projects.locations.operations.list

      Path : v1/{+name}/operations

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/operations

      Parameters :

        name

          Location : path

          Description : The name of the operation's parent resource.

          Type : string

          Required : Yes

          Pattern : ^projects/[^/]+/locations/[^/]+$

        pageToken

          Type : string

          Description : The standard list page token.

          Location : query

        filter

          Type : string

          Location : query

          Description : The standard list filter.

        pageSize

          Format : int32

          Type : integer

          Location : query

          Description : The standard list page size.

        returnPartialSuccess

          Description : When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `"projects/example/locations/-"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.

          Location : query

          Type : boolean

      Parameter Order : name

      HTTP Method : GET

      Description : Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

  • ▼ ▲ devicerun.projects.locations.operations.get

      Path : v1/{+name}

      Scopes : https://www.googleapis.com/auth/cloud-platform

      HTTP Method : GET

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}

      Parameters :

        name

          Description : The name of the operation resource.

          Pattern : ^projects/[^/]+/locations/[^/]+/operations/[^/]+$

          Required : Yes

          Type : string

          Location : path

      Description : Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.

      Parameter Order : name

  • ▼ ▲ devicerun.projects.locations.softwareVersions.list

      Parameters :

        filter

          Location : query

          Description : Optional. An AIP-160 (https://google.aip.dev/160) filter expression restricting which software versions are returned. An empty filter returns all software versions. Filtering is supported over the `SoftwareVersion` fields, including nested fields via dot-path. Enum and string values must be double-quoted. Examples: * `software_type = "ANDROIDX_TEST_ORCHESTRATOR"` * `software_type = "ANDROIDX_TEST_ORCHESTRATOR" AND is_default = true` * `lifecycle.state = "ACTIVE"` * `version = "1.4.1"`

          Type : string

        pageToken

          Description : Optional. A page token, received from a previous `ListSoftwareVersions` call. Provide this to receive the subsequent page. When paginating, all other parameters provided to `ListSoftwareVersions` must match the call that provided the page token.

          Location : query

          Type : string

        pageSize

          Location : query

          Description : Optional. The maximum number of software versions to return. The server may return fewer items than this value.

          Format : int32

          Type : integer

        parent

          Required : Yes

          Type : string

          Location : path

          Pattern : ^projects/[^/]+/locations/[^/]+$

          Description : Required. The parent of the collection of software versions. Format: `projects/{project}/locations/global`.

      Path : v1/{+parent}/softwareVersions

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Parameter Order : parent

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/softwareVersions

      Description : Lists all software versions.

      HTTP Method : GET

  • ▼ ▲ devicerun.projects.locations.softwareVersions.get

      Description : Returns information about a specific software version.

      HTTP Method : GET

      Path : v1/{+name}

      Parameters :

        name

          Required : Yes

          Pattern : ^projects/[^/]+/locations/[^/]+/softwareVersions/[^/]+$

          Location : path

          Description : Required. The name of the software version. Format: `projects/{project}/locations/global/softwareVersions/{software_version}`.

          Type : string

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/softwareVersions/{softwareVersionsId}

      Parameter Order : name

  • ▼ ▲ devicerun.projects.locations.devices.get

      Parameter Order : name

      Path : v1/{+name}

      Description : Returns information about a specific device.

      Parameters :

        name

          Pattern : ^projects/[^/]+/locations/[^/]+/devices/[^/]+$

          Required : Yes

          Description : Required. The name of the device. Format: `projects/{project}/locations/global/devices/{device}`.

          Location : path

          Type : string

      HTTP Method : GET

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/devices/{devicesId}

      Scopes : https://www.googleapis.com/auth/cloud-platform

  • ▼ ▲ devicerun.projects.locations.devices.list

      Path : v1/{+parent}/devices

      Parameters :

        parent

          Type : string

          Pattern : ^projects/[^/]+/locations/[^/]+$

          Required : Yes

          Location : path

          Description : Required. The parent of the collection of devices. Format: `projects/{project}/locations/global`.

        pageToken

          Description : Optional. A page token, received from a previous `ListDevices` call. Provide this to receive the subsequent page. When paginating, all other parameters provided to `ListDevices` must match the call that provided the page token.

          Location : query

          Type : string

        pageSize

          Type : integer

          Description : Optional. The maximum number of devices to return. The server may return fewer items than this value.

          Location : query

          Format : int32

        filter

          Location : query

          Type : string

          Description : Optional. An AIP-160 (https://google.aip.dev/160) filter expression restricting which devices are returned. An empty filter returns all devices. Filtering is supported over the `Device` fields, including nested fields via dot-path. Enum and string values must be double-quoted. Examples: * `platform = "ANDROID"` * `platform = "ANDROID" AND os_version = "34"` * `hardware_type = "PHYSICAL" AND form_factor = "PHONE"` * `android_details.build_type = "userdebug"` * `availability.capacity = "HIGH"`

      Parameter Order : parent

      HTTP Method : GET

      Description : Lists all devices.

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/devices

      Scopes : https://www.googleapis.com/auth/cloud-platform