Method: enterprises.policies.modifyPolicyApplications
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعديل التطبيقات أو إنشاؤها في إحدى السياسات
طلب HTTP
POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*/policies/*}:modifyPolicyApplications
يستخدِم عنوان URL بنية تحويل الترميز gRPC.
مَعلمات المسار
المعلمات |
name |
string
مطلوب. اسم Policy الذي يحتوي على عناصر ApplicationPolicy المطلوب تعديلها، بالتنسيق enterprises/{enterpriseId}/policies/{policyId}
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
الحقول |
changes[] |
object (ApplicationPolicyChange )
مطلوب. التغييرات التي سيتم إجراؤها على عناصر ApplicationPolicy. يجب أن تتضمّن السمة قيمة ApplicationPolicyChange واحدة على الأقل.
|
نص الاستجابة
الردّ على طلب تعديل أو إنشاء عناصر ApplicationPolicy في السياسة المحدّدة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
{
"policy": {
object (Policy )
}
} |
الحقول |
policy |
object (Policy )
السياسة المعدَّلة
|
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidmanagement
لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
ApplicationPolicyChange
تغيير سيتم إجراؤه على عنصر ApplicationPolicy واحد.
الحقول |
application |
object (ApplicationPolicy )
إذا كان ApplicationPolicy.packageName يتطابق مع عنصر ApplicationPolicy حالي ضمن Policy الذي يتم تعديله، سيتم تعديل هذا العنصر. بخلاف ذلك، ستتم إضافته إلى نهاية Policy.applications .
|
updateMask |
string (FieldMask format)
قناع الحقل الذي يشير إلى الحقول المطلوب تعديلها. في حال عدم تحديدها، يتم تعديل جميع الحقول القابلة للتعديل. هذه قائمة مفصولة بفواصل تتضمّن الأسماء المؤهَّلة بالكامل للحقول. مثال: "user.displayName,photo"
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Method: enterprises.policies.modifyPolicyApplications\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.ModifyPolicyApplicationsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [ApplicationPolicyChange](#ApplicationPolicyChange)\n - [JSON representation](#ApplicationPolicyChange.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nUpdates or creates applications in a policy.\n\n### HTTP request\n\n`POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*/policies/*}:modifyPolicyApplications`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The name of the [`Policy`](/android/management/reference/rest/v1/enterprises.policies#Policy) containing the [`ApplicationPolicy`](/android/management/reference/rest/v1/enterprises.policies#ApplicationPolicy) objects to be updated, in the form `enterprises/{enterpriseId}/policies/{policyId}`. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"changes\": [ { object (/android/management/reference/rest/v1/enterprises.policies/modifyPolicyApplications#ApplicationPolicyChange) } ] } ``` |\n\n| Fields ||\n|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `changes[]` | `object (`[ApplicationPolicyChange](/android/management/reference/rest/v1/enterprises.policies/modifyPolicyApplications#ApplicationPolicyChange)`)` Required. The changes to be made to the ApplicationPolicy objects. There must be at least one `ApplicationPolicyChange`. |\n\n### Response body\n\nResponse to a request to update or create ApplicationPolicy objects in the given policy.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------|\n| ``` { \"policy\": { object (/android/management/reference/rest/v1/enterprises.policies#Policy) } } ``` |\n\n| Fields ||\n|----------|--------------------------------------------------------------------------------------------------------------|\n| `policy` | `object (`[Policy](/android/management/reference/rest/v1/enterprises.policies#Policy)`)` The updated policy. |\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).\n\nApplicationPolicyChange\n-----------------------\n\nA change to be made to a single ApplicationPolicy object.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"application\": { object (/android/management/reference/rest/v1/enterprises.policies#ApplicationPolicy) }, \"updateMask\": string } ``` |\n\n| Fields ||\n|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `application` | `object (`[ApplicationPolicy](/android/management/reference/rest/v1/enterprises.policies#ApplicationPolicy)`)` If [`ApplicationPolicy.packageName`](/android/management/reference/rest/v1/enterprises.policies#ApplicationPolicy.FIELDS.package_name) matches an existing ApplicationPolicy object within the [`Policy`](/android/management/reference/rest/v1/enterprises.policies#Policy) being modified, then that object will be updated. Otherwise, it will be added to the end of the [`Policy.applications`](/android/management/reference/rest/v1/enterprises.policies#Policy.FIELDS.applications). |\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` The field mask indicating the fields to update. If omitted, all modifiable fields are updated. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |"]]