Method: customers.devices.get
Stay organized with collections
Save and categorize content based on your preferences.
Gets the details of a device.
HTTP request
GET https://androiddeviceprovisioning.googleapis.com/v1/{name=customers/*/devices/*}
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
name |
string
Required. The device to get. An API resource name in the format customers/[CUSTOMER_ID]/devices/[DEVICE_ID].
|
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance of Device.
Authorization Scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/androidworkzerotouchemm
For more information, see the OAuth 2.0 Overview.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-08-07 UTC.
[null,null,["Last updated 2024-08-07 UTC."],[[["\u003cp\u003eThis endpoint retrieves detailed information about a specific device using its resource name.\u003c/p\u003e\n"],["\u003cp\u003eThe request is made via a \u003ccode\u003eGET\u003c/code\u003e HTTP request to a URL following gRPC Transcoding syntax, with the device's identifier in the path.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, while a successful response will contain device details as an instance of the \u003ccode\u003eDevice\u003c/code\u003e resource.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ename\u003c/code\u003e path parameter is required and must follow the format \u003ccode\u003ecustomers/[CUSTOMER_ID]/devices/[DEVICE_ID]\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAccessing this endpoint requires OAuth 2.0 authorization with the scope \u003ccode\u003ehttps://www.googleapis.com/auth/androidworkzerotouchemm\u003c/code\u003e.\u003c/p\u003e\n"]]],["A `GET` request to `https://androiddeviceprovisioning.googleapis.com/v1/{name=customers/*/devices/*}` retrieves device details. The `name` path parameter, a string in the format `customers/[CUSTOMER_ID]/devices/[DEVICE_ID]`, is mandatory. The request body must be empty. Upon success, the response body returns a `Device` instance. Authorization requires the `https://www.googleapis.com/auth/androidworkzerotouchemm` OAuth scope. The url uses gRPC Transcoding.\n"],null,["- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n\nGets the details of a device.\n\nHTTP request\n\n`GET https://androiddeviceprovisioning.googleapis.com/v1/{name=customers/*/devices/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\nPath parameters\n\n| Parameters ||\n|--------|-------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The device to get. An API resource name in the format `customers/[CUSTOMER_ID]/devices/[DEVICE_ID]`. |\n\nRequest body\n\nThe request body must be empty.\n\nResponse body\n\nIf successful, the response body contains an instance of [Device](/zero-touch/reference/customer/rest/v1/customers.devices#Device).\n\nAuthorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidworkzerotouchemm`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]