Method: enterprises.structures.list
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Mencantumkan struktur yang dikelola oleh perusahaan.
Permintaan HTTP
GET https://smartdevicemanagement.googleapis.com/v1/{parent=enterprises/*}/structures
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter |
parent |
string
Perusahaan induk untuk mencantumkan struktur. Mis. "perusahaan/XYZ".
|
Parameter kueri
Parameter |
filter |
string
Filter opsional untuk mencantumkan struktur.
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Pesan respons untuk SmartDeviceManagementService.ListStructures
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
{
"structures": [
{
object (Structure )
}
]
} |
Kolom |
structures[] |
object (Structure )
Daftar struktur.
|
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/sdm.service
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-25 UTC."],[[["\u003cp\u003eLists device access structures managed by an enterprise using the provided endpoint.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering structures via an optional query parameter.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization using the \u003ccode\u003ehttps://www.googleapis.com/auth/sdm.service\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eReturns a list of structures if successful, formatted as outlined in the response body section.\u003c/p\u003e\n"]]],["This document details retrieving a list of enterprise-managed structures. It uses a `GET` request to a specific URL: `https://smartdevicemanagement.googleapis.com/v1/{parent=enterprises/*}/structures`. The `parent` path parameter specifies the enterprise. An optional `filter` query parameter refines the structure list. The request body is empty. The successful response includes a list of `structures` in JSON format. This action requires the `https://www.googleapis.com/auth/sdm.service` authorization scope.\n"],null,["# Method: enterprises.structures.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.ListStructuresResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Examples](#examples)\n\nLists structures managed by the enterprise.\n\n### HTTP request\n\n`GET https://smartdevicemanagement.googleapis.com/v1/{parent=enterprises/*}/structures`\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 structures under. E.g. \"enterprises/XYZ\". |\n\n### Query parameters\n\n| Parameters ||\n|----------|----------------------------------------------|\n| `filter` | `string` Optional filter to list structures. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for SmartDeviceManagementService.ListStructures\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------|\n| ``` { \"structures\": [ { object (/nest/device-access/reference/rest/v1/enterprises.structures#Structure) } ] } ``` |\n\n| Fields ||\n|----------------|--------------------------------------------------------------------------------------------------------------------------|\n| `structures[]` | `object (`[Structure](/nest/device-access/reference/rest/v1/enterprises.structures#Structure)`)` The list of structures. |\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)."]]