1# Application Permission Groups 2 3## Usage Guidelines 4 5- 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. 6 7- 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. 8 9 The following uses the Location and Camera permission groups as an example. 10 11 - 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. 12 - 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. 13 - 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. 14 15- 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). 16 17<!--RP1--> 18 19## Location 20 21- [ohos.permission.LOCATION_IN_BACKGROUND](permissions-for-all-user.md#ohospermissionlocation_in_background) 22 23- [ohos.permission.LOCATION](permissions-for-all-user.md#ohospermissionlocation) 24 25- [ohos.permission.APPROXIMATELY_LOCATION](permissions-for-all-user.md#ohospermissionapproximately_location) 26 27## Camera 28 29- [ohos.permission.CAMERA](permissions-for-all-user.md#ohospermissioncamera) 30 31## Microphone 32 33- [ohos.permission.MICROPHONE](permissions-for-all-user.md#ohospermissionmicrophone) 34 35## Contacts 36 37- [ohos.permission.READ_CONTACTS](permissions-for-system-apps.md#ohospermissionread_contacts) 38 39- [ohos.permission.WRITE_CONTACTS](permissions-for-system-apps.md#ohospermissionwrite_contacts) 40 41## Calendar 42 43- [ohos.permission.READ_CALENDAR](permissions-for-all-user.md#ohospermissionread_calendar) 44 45- [ohos.permission.WRITE_CALENDAR](permissions-for-all-user.md#ohospermissionwrite_calendar) 46 47- [ohos.permission.READ_WHOLE_CALENDAR](permissions-for-system-apps.md#ohospermissionread_whole_calendar) 48 49- [ohos.permission.WRITE_WHOLE_CALENDAR](permissions-for-system-apps.md#ohospermissionwrite_whole_calendar) 50 51## Fitness 52 53- [ohos.permission.ACTIVITY_MOTION](permissions-for-all-user.md#ohospermissionactivity_motion) 54 55## Body Sensors 56 57- [ohos.permission.READ_HEALTH_DATA](permissions-for-all-user.md#ohospermissionread_health_data) 58 59## Images and Videos 60 61- [ohos.permission.WRITE_IMAGEVIDEO](permissions-for-system-apps.md#ohospermissionwrite_imagevideo) 62 63- [ohos.permission.READ_IMAGEVIDEO](permissions-for-system-apps.md#ohospermissionread_imagevideo) 64 65- [ohos.permission.MEDIA_LOCATION](permissions-for-all-user.md#ohospermissionmedia_location) 66 67- [ohos.permission.SHORT_TERM_WRITE_IMAGEVIDEO](permissions-for-system-apps.md#ohospermissionshort_term_write_imagevideo) 68 69## Music and Audio 70 71- [ohos.permission.WRITE_AUDIO](permissions-for-system-apps.md#ohospermissionwrite_audio) 72 73- [ohos.permission.READ_AUDIO](permissions-for-system-apps.md#ohospermissionread_audio) 74 75## Ad Tracking 76 77- [ohos.permission.APP_TRACKING_CONSENT](permissions-for-all-user.md#ohospermissionapp_tracking_consent) 78 79## Installed Bundle List 80 81- [ohos.permission.GET_INSTALLED_BUNDLE_LIST](permissions-for-system-apps.md#ohospermissionget_installed_bundle_list) 82 83## Multi-device Collaboration 84 85- [ohos.permission.DISTRIBUTED_DATASYNC](permissions-for-all-user.md#ohospermissiondistributed_datasync) 86 87## Bluetooth 88 89- [ohos.permission.ACCESS_BLUETOOTH](permissions-for-all-user.md#ohospermissionaccess_bluetooth) 90 91## Phone 92 93- [ohos.permission.ANSWER_CALL](permissions-for-system-apps.md#ohospermissionanswer_call) 94 95- [ohos.permission.MANAGE_VOICEMAIL](permissions-for-system-apps.md#ohospermissionmanage_voicemail) 96 97## Call Logs 98 99- [ohos.permission.READ_CALL_LOG](permissions-for-system-apps.md#ohospermissionread_call_log) 100 101- [ohos.permission.WRITE_CALL_LOG](permissions-for-system-apps.md#ohospermissionwrite_call_log) 102 103## Messaging 104 105- [ohos.permission.READ_CELL_MESSAGES](permissions-for-system-apps.md#ohospermissionread_cell_messages) 106 107- [ohos.permission.READ_MESSAGES](permissions-for-system-apps.md#ohospermissionread_messages) 108 109- [ohos.permission.RECEIVE_MMS](permissions-for-system-apps.md#ohospermissionreceive_mms) 110 111- [ohos.permission.RECEIVE_SMS](permissions-for-system-apps.md#ohospermissionreceive_sms) 112 113- [ohos.permission.RECEIVE_WAP_MESSAGES](permissions-for-system-apps.md#ohospermissionreceive_wap_messages) 114 115- [ohos.permission.SEND_MESSAGES](permissions-for-system-apps.md#ohospermissionsend_messages) 116 117## Pasteboard 118 119- [ohos.permission.READ_PASTEBOARD](permissions-for-system-apps.md#ohospermissionread_pasteboard) 120 121## Directory 122 123- [ohos.permission.READ_WRITE_DOWNLOAD_DIRECTORY](permissions-for-all-user.md#ohospermissionread_write_download_directory) 124 125- [ohos.permission.READ_WRITE_DESKTOP_DIRECTORY](permissions-for-system-apps.md#ohospermissionread_write_desktop_directory) 126 127- [ohos.permission.READ_WRITE_DOCUMENTS_DIRECTORY](permissions-for-all-user.md#ohospermissionread_write_documents_directory) 128 129## NearLink 130 131- [ohos.permission.ACCESS_NEARLINK](permissions-for-all-user.md#ohospermissionaccess_nearlink) 132 133<!--RP1End--> 134 135## Files<sup>(deprecated)</sup> 136 137> **NOTE** 138> This permission group is deprecated since API version 12. 139 140<!--Del--> 141- ohos.permission.READ_DOCUMENT 142 143- ohos.permission.WRITE_DOCUMENT 144<!--DelEnd--> 145- ohos.permission.READ_MEDIA 146 147- ohos.permission.WRITE_MEDIA 148 149**Alternative solution**: 150 151- To read or write images or videos in the media library: 152 153 - (Recommended) Use [Picker](../../media/medialibrary/photoAccessHelper-photoviewpicker.md) to read images and videos in the media library, and use [SaveButton](../../media/medialibrary/photoAccessHelper-savebutton.md#using-savebutton) to save images and videos in the media library. This solution is recommended because the application does not need any permission. 154 - Apply for the <!--RP5-->[ohos.permission.READ_IMAGEVIDEO](permissions-for-system-apps.md#ohospermissionread_imagevideo) or [ohos.permission.WRITE_IMAGEVIDEO](permissions-for-system-apps.md#ohospermissionwrite_imagevideo)<!--RP5End--> permission to read images and videos in the media library. 155 156- To read audio clips in the media library: 157 158 Apply for the restricted permission <!--RP6-->[ohos.permission.READ_AUDIO](permissions-for-system-apps.md#ohospermissionread_audio) or [ohos.permission.WRITE_AUDIO](permissions-for-system-apps.md#ohospermissionwrite_audio)<!--RP6End--> to read or write audio files in the media library. 159 160- To read documents in **Files**: 161 162 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). 163