1# Application Permission Groups 2 3<!--Kit: Ability Kit--> 4<!--Subsystem: Security--> 5<!--Owner: @xia-bubai--> 6<!--SE: @linshuqing; @hehehe-li--> 7<!--TSE: @leiyuqian--> 8 9## Usage Guidelines 10 11- It will be helpful if you understand [permission groups and permissions](app-permission-mgmt-overview.md#permission-groups-and-permissions) before requesting permission groups for your application. 12 13- A permission group is a logical grouping of related permissions. When a permission is requested, the members of the group are presented together in the user interface, making it easier for the user to manage permissions. If the user grants the permission, all the permissions in the permission group will be granted in a unified manner. For security purposes, the Location, Contacts, Call Logs, Phone, Messaging, and Calendar permission groups do not support unified authorization. 14 15 The following uses the Location and Camera permission groups as an example. 16 17 - When an application requests only the ohos.permission.APPROXIMATELY_LOCATION permission (belong to the Location permission group), a dialog box containing only the requested permission will be displayed to request user authorization. 18 - When an application requests the ohos.permission.APPROXIMATELY_LOCATION and ohos.permission.LOCATION permissions (belonging to the Location permission group), a dialog box containing only the requested permissions will be displayed to request user authorization. 19 - When an application requests ohos.permission.APPROXIMATELY_LOCATION (belonging to the Location permission group) and ohos.permission.CAMERA (belonging to the Camera permission group), two dialog boxes will be displayed to request the location and camera permissions, respectively. 20 21- The following lists the permission groups supported by the system. For details about the permissions, see [Open user_grant Permissions](permissions-for-all-user.md). 22 23## Location <!--Del-->Information<!--DelEnd--> 24 25- [ohos.permission.LOCATION_IN_BACKGROUND](permissions-for-all-user.md#ohospermissionlocation_in_background) 26 27- [ohos.permission.LOCATION](permissions-for-all-user.md#ohospermissionlocation) 28 29- [ohos.permission.APPROXIMATELY_LOCATION](permissions-for-all-user.md#ohospermissionapproximately_location) 30 31## Camera 32 33- [ohos.permission.CAMERA](permissions-for-all-user.md#ohospermissioncamera) 34 35## Microphone 36 37- [ohos.permission.MICROPHONE](permissions-for-all-user.md#ohospermissionmicrophone) 38 39## Contacts 40 41- [ohos.permission.READ_CONTACTS](restricted-permissions.md#ohospermissionread_contacts) 42 43- [ohos.permission.WRITE_CONTACTS](restricted-permissions.md#ohospermissionwrite_contacts) 44 45## Calendar 46 47- [ohos.permission.READ_CALENDAR](permissions-for-all-user.md#ohospermissionread_calendar) 48 49- [ohos.permission.WRITE_CALENDAR](permissions-for-all-user.md#ohospermissionwrite_calendar) 50 51<!--Del--> 52- [ohos.permission.READ_WHOLE_CALENDAR](permissions-for-system-apps-user.md#ohospermissionread_whole_calendar) 53 54- [ohos.permission.WRITE_WHOLE_CALENDAR](permissions-for-system-apps-user.md#ohospermissionwrite_whole_calendar) 55<!--DelEnd--> 56 57<!--RP1--> 58## Fitness 59 60- [ohos.permission.ACTIVITY_MOTION](permissions-for-all-user.md#ohospermissionactivity_motion) 61 62## Body Sensors 63 64- [ohos.permission.READ_HEALTH_DATA](permissions-for-all-user.md#ohospermissionread_health_data) 65<!--RP1End--> 66 67## Images and Videos 68 69- [ohos.permission.WRITE_IMAGEVIDEO](restricted-permissions.md#ohospermissionwrite_imagevideo) 70 71- [ohos.permission.READ_IMAGEVIDEO](restricted-permissions.md#ohospermissionread_imagevideo) 72 73- [ohos.permission.MEDIA_LOCATION](permissions-for-all-user.md#ohospermissionmedia_location) 74 75- [ohos.permission.SHORT_TERM_WRITE_IMAGEVIDEO](restricted-permissions.md#ohospermissionshort_term_write_imagevideo) 76 77## Music and Audio 78 79- [ohos.permission.WRITE_AUDIO](restricted-permissions.md#ohospermissionwrite_audio) 80 81- [ohos.permission.READ_AUDIO](restricted-permissions.md#ohospermissionread_audio) 82 83<!--RP2--> 84## Ad Tracking 85 86- [ohos.permission.APP_TRACKING_CONSENT](permissions-for-all-user.md#ohospermissionapp_tracking_consent) 87<!--RP2End--> 88 89<!--Del--> 90## Installed Bundle List 91 92- [ohos.permission.GET_INSTALLED_BUNDLE_LIST](permissions-for-system-apps-user.md#ohospermissionget_installed_bundle_list) 93<!--DelEnd--> 94 95<!--RP3--> 96## Multi-device Collaboration 97 98- [ohos.permission.DISTRIBUTED_DATASYNC](permissions-for-all-user.md#ohospermissiondistributed_datasync) 99 100## Bluetooth 101 102- [ohos.permission.ACCESS_BLUETOOTH](permissions-for-all-user.md#ohospermissionaccess_bluetooth) 103 104## NearLink 105 106- [ohos.permission.ACCESS_NEARLINK](permissions-for-all-user.md#ohospermissionaccess_nearlink) 107<!--RP3End--> 108 109<!--Del--> 110## Phone 111 112- [ohos.permission.ANSWER_CALL](permissions-for-system-apps-user.md#ohospermissionanswer_call) 113 114- [ohos.permission.MANAGE_VOICEMAIL](permissions-for-system-apps-user.md#ohospermissionmanage_voicemail) 115 116## Call Logs 117 118- [ohos.permission.READ_CALL_LOG](permissions-for-system-apps-user.md#ohospermissionread_call_log) 119 120- [ohos.permission.WRITE_CALL_LOG](permissions-for-system-apps-user.md#ohospermissionwrite_call_log) 121 122## Messaging 123 124- [ohos.permission.READ_CELL_MESSAGES](permissions-for-system-apps-user.md#ohospermissionread_cell_messages) 125 126- [ohos.permission.READ_MESSAGES](permissions-for-system-apps-user.md#ohospermissionread_messages) 127 128- [ohos.permission.RECEIVE_MMS](permissions-for-system-apps-user.md#ohospermissionreceive_mms) 129 130- [ohos.permission.RECEIVE_SMS](permissions-for-system-apps-user.md#ohospermissionreceive_sms) 131 132- [ohos.permission.RECEIVE_WAP_MESSAGES](permissions-for-system-apps-user.md#ohospermissionreceive_wap_messages) 133 134- [ohos.permission.SEND_MESSAGES](permissions-for-system-apps-user.md#ohospermissionsend_messages) 135<!--DelEnd--> 136 137## Pasteboard 138 139- [ohos.permission.READ_PASTEBOARD](restricted-permissions.md#ohospermissionread_pasteboard) 140 141## Screenshots 142 143- [ohos.permission.CUSTOM_SCREEN_CAPTURE](permissions-for-all-user.md#ohospermissioncustom_screen_capture) 144 145## Directory 146 147> **NOTE** 148> <br>The permissions are available only to 2-in-1 device applications. 149 150- [ohos.permission.READ_WRITE_DOWNLOAD_DIRECTORY](permissions-for-all-user.md#ohospermissionread_write_download_directory) 151 152- [ohos.permission.READ_WRITE_DESKTOP_DIRECTORY](restricted-permissions.md#ohospermissionread_write_desktop_directory) 153- [ohos.permission.READ_WRITE_DOCUMENTS_DIRECTORY](permissions-for-all-user.md#ohospermissionread_write_documents_directory) 154 155## Files<sup>(deprecated)</sup> 156 157> **NOTE** 158> This permission group is deprecated since API version 12. 159 160<!--Del--> 161- ohos.permission.READ_DOCUMENT 162 163- ohos.permission.WRITE_DOCUMENT 164<!--DelEnd--> 165- ohos.permission.READ_MEDIA 166 167- ohos.permission.WRITE_MEDIA 168 169**Alternative solution**: 170 171- To read or write images or videos in the media library: 172 173 - (Recommended) Use [Picker](../../media/medialibrary/photoAccessHelper-photoviewpicker.md) to read images and videos in the media library, and use the [SaveButton/authorization pop-up window](../../media/medialibrary/photoAccessHelper-savebutton.md) to save images and videos in the media library. This solution is recommended because the application does not need any permission. 174 - Request the restricted permission [ohos.permission.READ_IMAGEVIDEO](restricted-permissions.md#ohospermissionread_imagevideo) or [ohos.permission.WRITE_IMAGEVIDEO](restricted-permissions.md#ohospermissionwrite_imagevideo). 175 176- To read audio clips in the media library: 177 178 Request the restricted permission [ohos.permission.READ_AUDIO](restricted-permissions.md#ohospermissionread_audio) or [ohos.permission.WRITE_AUDIO](restricted-permissions.md#ohospermissionwrite_audio). 179 180- To read documents in **Files**: 181 182 Use the file Picker to read documents in **Files**. For details, see [Selecting Documents](../../file-management/select-user-file.md#selecting-documents) and [Saving Documents](../../file-management/save-user-file.md#saving-documents). 183