Signed-off-by:chennian<chennian1@huawei.com>

Signed-off-by: Nchennian <chennian1@huawei.com>

zh-cn/application-dev/reference/apis/js-apis-privacyManager.md

@@ -2,9 +2,9 @@
 
 该模块主要提供权限使用记录等隐私管理接口。
 
-> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
+> **说明：**
 > 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-
+> 本模块接口为系统接口，三方应用不支持调用。
 
 ## 导入模块
 
@@ -17,11 +17,10 @@ import privacyManager from '@ohos.privacyManager';
 
 addPermissionUsedRecord(tokenID: number, permissionName: string, successCount: number, failCount: number): Promise<number>
 
-增加一条权限使用记录。
-
-此接口为系统接口，三方应用不支持调用。
+受应用权限保护的应用在被其他服务、应用调用时，可以使用该接口增加一条权限使用记录。使用Promise异步回调。
+权限使用记录包括：调用方的应用身份标识、使用的应用权限名称，和其访问本应用成功、失败的次数。
 
-**需要权限：** ohos.permission.PERMISSION_USED_STATS
+**需要权限：** ohos.permission.PERMISSION_USED_STATS，仅系统应用可用。
 
 **系统能力：** SystemCapability.Security.AccessToken
 
@@ -29,8 +28,8 @@ addPermissionUsedRecord(tokenID: number, permissionName: string, successCount: n
 
 | 参数名   | 类型                 | 必填 | 说明                                       |
 | -------- | -------------------  | ---- | ------------------------------------------ |
-| tokenID   |  number   | 是   | 要新增记录的目标应用的身份标识。              |
-| permissionName | string | 是   | 要新增记录的权限名称。 |
+| tokenID   |  number   | 是   | 调用方的应用身份标识。              |
+| permissionName | string | 是   | 应用权限名称。 |
 | successCount | number | 是   | 访问成功的次数。 |
 | failCount | number | 是   | 访问失败的次数。 |
 
@@ -38,7 +37,7 @@ addPermissionUsedRecord(tokenID: number, permissionName: string, successCount: n
 
 | 类型          | 说明                                |
 | :------------ | :---------------------------------- |
-| Promise<number> | Promise实例，用于获取异步返回的操作结果。 |
+| Promise<number> | Promise对象。返回`0`表示成功增加记录，返回`-1`表示失败。 |
 
 **示例：**
 
@@ -53,11 +52,10 @@ privacyManager.addPermissionUsedRecord(tokenID, "ohos.permission.PERMISSION_USED
 
 addPermissionUsedRecord(tokenID: number, permissionName: string, successCount: number, failCount: number, callback: AsyncCallback<number>): void
 
-增加一条权限使用记录。
-
-此接口为系统接口，三方应用不支持调用。
+受应用权限保护的应用在被其他服务、应用调用时，可以使用该接口增加一条权限使用记录。使用callback异步回调。
+权限使用记录包括：调用方的应用身份标识、使用的应用权限名称，和其访问本应用成功、失败的次数。
 
-**需要权限：** ohos.permission.PERMISSION_USED_STATS
+**需要权限：** ohos.permission.PERMISSION_USED_STATS，仅系统应用可用。
 
 **系统能力：** SystemCapability.Security.AccessToken
 
@@ -65,17 +63,19 @@ addPermissionUsedRecord(tokenID: number, permissionName: string, successCount: n
 
 | 参数名   | 类型                 | 必填 | 说明                                       |
 | -------- | -------------------  | ---- | ------------------------------------------ |
-| tokenID   |  number   | 是   | 要新增记录的目标应用的身份标识。              |
-| permissionName | string | 是   | 要新增记录的权限名称。 |
+| tokenID   |  number   | 是   | 调用方的应用身份标识。              |
+| permissionName | string | 是   | 应用权限名称。 |
 | successCount | number | 是   | 访问成功的次数。 |
 | failCount | number | 是   | 访问失败的次数。 |
-| callback | AsyncCallback<number> | 是   | 指定的callback回调方法，用于获取返回值。 |
+| callback | AsyncCallback<number> | 是   | 回调函数。返回`0`表示成功增加记录，返回`-1`表示失败。 |
 
 **示例：**
 
 ```js
-let tokenID = 0;
-privacyManager.privacyManager.addPermissionUsedRecord(tokenID, "ohos.permission.PERMISSION_USED_STATS", 1, 0, data => {
+import bundle from '@ohos.bundle'
+var appInfo = await bundle.getApplicationInfo('bundle_name', 0, 100);
+var tokenID = appInfo.accessTokenId;
+privacyManager.privacyManager.addPermissionUsedRecord(tokenID, "ohos.permission.PERMISSION_USED_STATS", 1, 0, (err, data) => {
     console.log(`callback: data->${JSON.stringify(data)}`);
 });
 ```
@@ -86,9 +86,7 @@ getPermissionUsedRecords(request: PermissionUsedRequest): Promise<PermissionU
 
 获取历史权限使用记录。
 
-此接口为系统接口，三方应用不支持调用。
-
-**需要权限：** ohos.permission.PERMISSION_USED_STATS
+**需要权限：** ohos.permission.PERMISSION_USED_STATS，仅系统应用可用。
 
 **系统能力：** SystemCapability.Security.AccessToken
 
@@ -96,13 +94,13 @@ getPermissionUsedRecords(request: PermissionUsedRequest): Promise<PermissionU
 
 | 参数名   | 类型                 | 必填 | 说明                                       |
 | -------- | -------------------  | ---- | ------------------------------------------ |
-| request   |  PermissionUsedRequest   | 是   | 查询权限使用记录的请求。              |
+| request   |  [PermissionUsedRequest](#permissionusedrequest)   | 是   | 查询权限使用记录的请求。              |
 
 **返回值：**
 
 | 类型          | 说明                                |
 | :------------ | :---------------------------------- |
-| Promise<PermissionUsedResponse> | Promise实例，用于异步返回查询的权限使用记录结果。 |
+| Promise<[PermissionUsedResponse](#permissionusedresponse)> | Promise对象。返回权限使用记录。|
 
 **示例：**
 
@@ -128,9 +126,7 @@ getPermissionUsedRecords(request: PermissionUsedRequest, callback: AsyncCallback
 
 获取历史权限使用记录。
 
-此接口为系统接口，三方应用不支持调用。
-
-**需要权限：** ohos.permission.PERMISSION_USED_STATS
+**需要权限：** ohos.permission.PERMISSION_USED_STATS，仅系统应用可用。
 
 **系统能力：** SystemCapability.Security.AccessToken
 
@@ -138,8 +134,8 @@ getPermissionUsedRecords(request: PermissionUsedRequest, callback: AsyncCallback
 
 | 参数名   | 类型                 | 必填 | 说明                                       |
 | -------- | -------------------  | ---- | ------------------------------------------ |
-| request   |  PermissionUsedRequest   | 是   | 查询权限使用记录的请求。              |
-| callback | AsyncCallback&lt;PermissionUsedResponse&gt; | 是   | 指定的callback回调方法，用于获取权限使用记录。 |
+| request | [PermissionUsedRequest](#permissionusedrequest) | 是 | 查询权限使用记录的请求。 |
+| callback | AsyncCallback<[PermissionUsedResponse](#permissionusedresponse)> | 是 | 回调函数。返回权限使用记录。 |
 
 **示例：**
 
@@ -161,11 +157,11 @@ privacyManager.getPermissionUsedRecords(request, (err, data) => {
 
 ## PermissionUsageFlag
 
-表示使用记录的查询方式的枚举值。
+使用记录的查询方式的枚举。
 
 **系统能力：** SystemCapability.Security.AccessToken
 
-| 名称                    | 默认值 | 描述                   |
+| 名称                    | 值 | 描述                   |
 | ----------------------- | ------ | ---------------------- |
 | FLAG_PERMISSION_USAGE_SUMMARY             | 0    | 表示查询总览数据，默认值。 |
 | FLAG_PERMISSION_USAGE_DETAIL         | 1    | 表示查询详细数据。         |
@@ -178,14 +174,14 @@ privacyManager.getPermissionUsedRecords(request, (err, data) => {
 
 | 名称       | 类型             | 必填   | 说明                                       |
 | -------- | -------------- | ---- | ---------------------------------------- |
-| tokenId  | number         | 否    | 需要查询的目标应用的身份标识。                                 |
-| isRemote | boolean         | 否    | 默认值false，当。 |
-| deviceId  | string         | 否    | 需要查询的目标应用的所在的设备ID。                                 |
-| bundleName | string         | 否    | 要查询的目标应用的包名。 |
+| tokenId  | number         | 否    | 目标应用的身份标识。                                 |
+| isRemote | boolean         | 否    | 默认值false。 |
+| deviceId  | string         | 否    | 目标应用所在设备的ID。                                 |
+| bundleName | string         | 否    | 目标应用的包名。 |
 | permissionNames  | Array&lt;string&gt;         | 否    | 需要查询的权限集合。                                 |
-| beginTime | number         | 否    | 查询的起始时间，默认值0，不设定起始时间。 |
-| endTime | number         | 否    | 查询的终止时间，默认值0，不设定终止时间。 |
-| flag | PermissionUsageFlag         | 是    | 查询方式，默认值FLAG_PERMISSION_USAGE_SUMMARY。 |
+| beginTime | number         | 否    | 查询的起始时间，单位：ms，默认值0，不设定起始时间。 |
+| endTime | number         | 否    | 查询的终止时间，单位：ms，默认值0，不设定终止时间。 |
+| flag | [PermissionUsageFlag](#permissionusageflag)         | 是    | 查询方式，默认值FLAG_PERMISSION_USAGE_SUMMARY。 |
 
 ## PermissionUsedResponse
 
@@ -195,27 +191,27 @@ privacyManager.getPermissionUsedRecords(request, (err, data) => {
 
 | 名称       | 类型             | 必填   | 说明                                       |
 | -------- | -------------- | ---- | ---------------------------------------- |
-| beginTime | number         | 否    | 查询记录的起始时间。 |
-| endTime | number         | 否    | 查询记录的终止时间。 |
-| bundleRecords  | Array&lt;BundleUsedRecord&gt;         | 否    | 应用的权限使用记录集合。                                 |
+| beginTime | number         | 否    | 查询记录的起始时间，单位：ms。 |
+| endTime | number         | 否    | 查询记录的终止时间，单位：ms。 |
+| bundleRecords  | Array&lt;[BundleUsedRecord](#BundleUsedRecord)&gt;         | 否    | 应用的权限使用记录集合。                                 |
 
 ## BundleUsedRecord
 
-每个应用下的权限访问记录。
+某个权限的访问记录。
 
 **系统能力：**  以下各项对应的系统能力均为SystemCapability.Security.AccessToken
 
 | 名称       | 类型             | 必填   | 说明                                       |
 | -------- | -------------- | ---- | ---------------------------------------- |
-| tokenId  | number         | 否    | 需要查询的目标应用的身份标识。                                 |
-| isRemote | boolean         | 否    | 默认值false，当。 |
-| deviceId  | string         | 否    | 需要查询的目标应用的所在的设备ID。                                 |
-| bundleName | string         | 否    | 要查询的目标应用的包名。 |
-| permissionRecords  | Array&lt;PermissionUsedRecord&gt;         | 否    | 每个应用的权限使用记录集合。                                 |
+| tokenId  | number         | 否    | 目标应用的身份标识。                                 |
+| isRemote | boolean         | 否    | 默认值false。 |
+| deviceId  | string         | 否    | 目标应用所在设备的ID。                                 |
+| bundleName | string         | 否    | 目标应用的包名。 |
+| permissionRecords  | Array&lt;[PermissionUsedRecord](#PermissionUsedRecord)&gt;         | 否    | 每个应用的权限使用记录集合。                                 |
 
 ## PermissionUsedRecord
 
-表示每一个权限对应的访问记录。
+某个权限的访问记录。
 
 **系统能力：**  以下各项对应的系统能力均为SystemCapability.Security.AccessToken
 
@@ -227,12 +223,12 @@ privacyManager.getPermissionUsedRecords(request, (err, data) => {
 | lastAccessTime | number         | 否    | 最后一次访问时间，单位：ms。 |
 | lastRejectTime | number         | 否    | 最后一次拒绝时间，单位：ms。 |
 | lastAccessDuration | number         | 否    | 最后一次访问时长，单位：ms。 |
-| accessRecords  | Array&lt;UsedRecordDetail&gt;         | 否    | 访问记录集合，当flag为FLAG_PERMISSION_USAGE_SUMMARY时生效，默认查询10条。                                 |
-| rejectRecords  | Array&lt;UsedRecordDetail&gt;         | 否    | 拒绝记录集合，当flag为FLAG_PERMISSION_USAGE_SUMMARY时生效，默认查询10条。                                 |
+| accessRecords  | Array&lt;[UsedRecordDetail](#usedrecorddetail)&gt;         | 否    | 访问记录集合，当flag为FLAG_PERMISSION_USAGE_SUMMARY时生效，默认查询10条。                                 |
+| rejectRecords  | Array&lt;[UsedRecordDetail](#usedrecorddetail)&gt;         | 否    | 拒绝记录集合，当flag为FLAG_PERMISSION_USAGE_SUMMARY时生效，默认查询10条。                                 |
 
 ## UsedRecordDetail
 
-每一次访问记录的详情。
+单次访问记录详情。
 
 **系统能力：**  以下各项对应的系统能力均为SystemCapability.Security.AccessToken