Method: enterprises.structures.get
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الحصول على بنية تديرها المؤسسة.
طلب HTTP
GET https://smartdevicemanagement.googleapis.com/v1/{name=enterprises/*/structures/*}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات |
name |
string
اسم البنية المطلوبة. على سبيل المثال: "enterprises/XYZ/structures/ABC".
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Structure
.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/sdm.service
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRetrieves a specific structure within a given enterprise using its unique name.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003esdm.service\u003c/code\u003e scope for accessing the Smart Device Management API.\u003c/p\u003e\n"],["\u003cp\u003eUses a \u003ccode\u003eGET\u003c/code\u003e request with the structure's name as a path parameter and an empty request body.\u003c/p\u003e\n"],["\u003cp\u003eReturns a \u003ccode\u003eStructure\u003c/code\u003e object containing information about the requested structure upon successful execution.\u003c/p\u003e\n"]]],["This document details retrieving a managed structure via an HTTP GET request. The request URL, using gRPC Transcoding, specifies the structure's name via the `name` path parameter (e.g., \"enterprises/XYZ/structures/ABC\"). The request body must be empty. A successful request returns a `Structure` instance in the response body. The operation requires the `https://www.googleapis.com/auth/sdm.service` OAuth scope for authorization. Examples are available within the document.\n"],null,["# Method: enterprises.structures.get\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- [Authorization scopes](#body.aspect)\n- [Examples](#examples)\n\nGets a structure managed by the enterprise.\n\n### HTTP request\n\n`GET https://smartdevicemanagement.googleapis.com/v1/{name=enterprises/*/structures/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|----------------------------------------------------------------------------------------------|\n| `name` | `string` The name of the structure requested. For example: \"enterprises/XYZ/structures/ABC\". |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [Structure](/nest/device-access/reference/rest/v1/enterprises.structures#Structure).\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)."]]