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