Method: enterprises.structures.rooms.list
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Répertorie les salles gérées par l'entreprise.
Requête HTTP
GET https://smartdevicemanagement.googleapis.com/v1/{parent=enterprises/*/structures/*}/rooms
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
parent |
string
Nom de la ressource parente des salles demandées. Par exemple : "entreprise/XYZ/structures/ABC".
|
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.ListRooms
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
| Représentation JSON |
{
"rooms": [
{
object (Room)
}
]
} |
| Champs |
rooms[] |
object (Room)
Liste des salles.
|
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 rooms managed by an enterprise within a specific structure.\u003c/p\u003e\n"],["\u003cp\u003eRequires an HTTP GET request to a structured URL containing the enterprise and structure IDs.\u003c/p\u003e\n"],["\u003cp\u003eAn empty request body is necessary, while the response provides a list of rooms in JSON format.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required using the \u003ccode\u003ehttps://www.googleapis.com/auth/sdm.service\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This document outlines the process for listing rooms within an enterprise using the Smart Device Management API. A `GET` request is sent to a specific URL containing the enterprise and structure identifiers in the `parent` path parameter. The request body must be empty. Successful requests return a JSON response containing a list of `rooms`, each detailed as an object. This action requires the `https://www.googleapis.com/auth/sdm.service` OAuth scope for authorization.\n"],null,["# Method: enterprises.structures.rooms.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListRoomsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Examples](#examples)\n\nLists rooms managed by the enterprise.\n\n### HTTP request\n\n`GET https://smartdevicemanagement.googleapis.com/v1/{parent=enterprises/*/structures/*}/rooms`\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 resource name of the rooms requested. For example: \"enterprises/XYZ/structures/ABC\". |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for SmartDeviceManagementService.ListRooms\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------|\n| ``` { \"rooms\": [ { object (/nest/device-access/reference/rest/v1/enterprises.structures.rooms#Room) } ] } ``` |\n\n| Fields ||\n|-----------|-----------------------------------------------------------------------------------------------------------------|\n| `rooms[]` | `object (`[Room](/nest/device-access/reference/rest/v1/enterprises.structures.rooms#Room)`)` The list of rooms. |\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)."]]
