Method: enterprises.devices.list
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Liste les appareils gérés par l'entreprise.
Requête HTTP
GET https://smartdevicemanagement.googleapis.com/v1/{parent=enterprises/*}/devices
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
parent |
string
Entreprise parente sous laquelle répertorier les appareils. Exemple : "entreprises/XYZ".
|
Paramètres de requête
| Paramètres |
filter |
string
Filtre facultatif permettant de lister les appareils. Les filtres peuvent être effectués sur: Nom personnalisé de l'appareil (correspondance de sous-chaîne) : 'customName=wing'
|
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Message de réponse pour SmartDeviceManagementService.ListDevices
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
| Représentation JSON |
{
"devices": [
{
object (Device)
}
]
} |
| Champs |
devices[] |
object (Device)
Liste des appareils.
|
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/sdm.service
Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[[["\u003cp\u003eLists all devices managed by a given enterprise, allowing for filtering by device custom name.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/sdm.service\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eUses a \u003ccode\u003eGET\u003c/code\u003e request to the specified endpoint with the enterprise ID as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides a list of devices in JSON format, including details for each device.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should be empty, while query parameters can be used to specify filters.\u003c/p\u003e\n"]]],[],null,["# Method: enterprises.devices.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListDevicesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Examples](#examples)\n\nLists devices managed by the enterprise.\n\n### HTTP request\n\n`GET https://smartdevicemanagement.googleapis.com/v1/{parent=enterprises/*}/devices`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------|\n| `parent` | `string` The parent enterprise to list devices under. E.g. \"enterprises/XYZ\". |\n\n### Query parameters\n\n| Parameters ||\n|----------|---------------------------------------------------------------------------------------------------------------------------|\n| `filter` | `string` Optional filter to list devices. Filters can be done on: Device custom name (substring match): 'customName=wing' |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for SmartDeviceManagementService.ListDevices\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------|\n| ``` { \"devices\": [ { object (/nest/device-access/reference/rest/v1/enterprises.devices#Device) } ] } ``` |\n\n| Fields ||\n|-------------|--------------------------------------------------------------------------------------------------------------|\n| `devices[]` | `object (`[Device](/nest/device-access/reference/rest/v1/enterprises.devices#Device)`)` The list of devices. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/sdm.service`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
