Method: enterprises.devices.patch
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
طلب HTTP
PATCH https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات |
name |
string
اسم الجهاز بالتنسيق enterprises/{enterpriseId}/devices/{deviceId}
|
مَعلمات طلب البحث
المعلمات |
updateMask |
string (FieldMask format)
قناع الحقل الذي يشير إلى الحقول المطلوب تعديلها في حال عدم ضبطه، سيتم تعديل جميع الحقول القابلة للتعديل. هذه قائمة مفصولة بفواصل تتضمّن أسماء حقول مؤهَّلة بالكامل. مثال: "user.displayName,photo"
|
نص الطلب
يحتوي نص الطلب على مثال Device
.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Device
.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidmanagement
لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eUpdates a device using an HTTP PATCH request to a specific URL with required path and optional query parameters.\u003c/p\u003e\n"],["\u003cp\u003eRequires \u003ccode\u003ehttps://www.googleapis.com/auth/androidmanagement\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"],["\u003cp\u003eRequest and response bodies utilize the \u003ccode\u003eDevice\u003c/code\u003e object for data transfer.\u003c/p\u003e\n"],["\u003cp\u003ePath parameters specify the enterprise and device, while query parameters allow for selective field updates using a field mask.\u003c/p\u003e\n"],["\u003cp\u003eYou can find more details about the \u003ccode\u003eDevice\u003c/code\u003e object and authorization in the provided links.\u003c/p\u003e\n"]]],["This document details how to update a device using a PATCH request. The request URL structure is `https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}`, using gRPC Transcoding. The `name` path parameter specifies the device. The `updateMask` query parameter indicates which fields to modify. The request and response bodies use the `Device` object. Authorization requires the `https://www.googleapis.com/auth/androidmanagement` OAuth scope. The user can use the `Try it!` option to test the update.\n"],null,["# Method: enterprises.devices.patch\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- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates a device.\n\n### HTTP request\n\n`PATCH https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}`\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 device in the form `enterprises/{enterpriseId}/devices/{deviceId}`. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` The field mask indicating the fields to update. If not set, all modifiable fields will be modified. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n\n### Request body\n\nThe request body contains an instance of [Device](/android/management/reference/rest/v1/enterprises.devices#Device).\n\n### Response body\n\nIf successful, the response body contains an instance of [Device](/android/management/reference/rest/v1/enterprises.devices#Device).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidmanagement`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]