Method: customers.policies.networks.defineNetwork
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
طلب HTTP
POST https://chromepolicy.googleapis.com/v1/{customer=customers/*}/policies/networks:defineNetwork
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
customer |
string
مطلوب. العميل الذي سيمتلك هذه الشبكة الجديدة.
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| تمثيل JSON |
{
"targetResource": string,
"name": string,
"settings": [
{
object (NetworkSetting)
}
]
} |
| الحقول |
targetResource |
string
مطلوب. المورد المستهدف الذي سيتم تحديد هذه الشبكة الجديدة عليه. الموارد التالية متاحة: * الوحدة التنظيمية ("orgunits/{orgunit_id}")
|
name |
string
يجب ملء الحقل. لاسم الشبكة الجديدة التي تم إنشاؤها.
|
settings[] |
object (NetworkSetting)
مطلوب. إعدادات الشبكة التفصيلية.
|
نص الاستجابة
كائن الاستجابة لإنشاء شبكة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"networkId": string,
"targetResource": string,
"settings": [
{
object (NetworkSetting)
}
]
} |
| الحقول |
networkId |
string
رقم تعريف الشبكة للشبكة الجديدة التي تم إنشاؤها.
|
targetResource |
string
المورد المستهدف الذي سيتم تحديد هذه الشبكة الجديدة عليه. الموارد التالية متاحة: * الوحدة التنظيمية ("orgunits/{orgunit_id}")
|
settings[] |
object (NetworkSetting)
إعدادات الشبكة التفصيلية للشبكة الجديدة التي تم إنشاؤها
|
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/chrome.management.policy
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eDefine a new network with specific settings for a target resource, such as an organizational unit.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires the target resource, network name, and detailed network settings.\u003c/p\u003e\n"],["\u003cp\u003eThe response body provides the network ID, target resource, and network settings of the newly created network.\u003c/p\u003e\n"],["\u003cp\u003eThis functionality requires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/chrome.management.policy\u003c/code\u003e scope.\u003c/p\u003e\n"]]],[],null,["# Method: customers.policies.networks.defineNetwork\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.DefineNetworkResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nDefine a new network.\n\n### HTTP request\n\n`POST https://chromepolicy.googleapis.com/v1/{customer=customers/*}/policies/networks:defineNetwork`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|----------------------------------------------------------------|\n| `customer` | `string` Required. The customer who will own this new network. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"targetResource\": string, \"name\": string, \"settings\": [ { object (/chrome/policy/reference/rest/v1/NetworkSetting) } ] } ``` |\n\n| Fields ||\n|------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `targetResource` | `string` Required. The target resource on which this new network will be defined. The following resources are supported: \\* Organizational Unit (\"orgunits/{orgunit_id}\") |\n| `name` | `string` Required. name of the new created network. |\n| `settings[]` | `object (`[NetworkSetting](/chrome/policy/reference/rest/v1/NetworkSetting)`)` Required. Detailed network settings. |\n\n### Response body\n\nResponse object for creating a network.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"networkId\": string, \"targetResource\": string, \"settings\": [ { object (/chrome/policy/reference/rest/v1/NetworkSetting) } ] } ``` |\n\n| Fields ||\n|------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `networkId` | `string` Network ID of the new created network. |\n| `targetResource` | `string` The target resource on which this new network will be defined. The following resources are supported: \\* Organizational Unit (\"orgunits/{orgunit_id}\") |\n| `settings[]` | `object (`[NetworkSetting](/chrome/policy/reference/rest/v1/NetworkSetting)`)` Detailed network settings of the new created network |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/chrome.management.policy`"]]
