!12279 [翻译完成】#I5Y6VM

Merge pull request !12279 from Annie_wang/PR11104

en/application-dev/reference/apis/js-apis-distributed-account.md

 # Distributed Account Management
 
-The distributedAccount module provides basic functions for managing distributed accounts, including querying and updating account login status.
+The **distributedAccount** module provides APIs for managing distributed accounts, including querying and updating account login status.
 
 > **NOTE**<br>
+> 
 > The initial APIs of this module are supported since API version 7. Newly added APIs will be marked with a superscript to indicate their earliest API version.
 
-
 ## Modules to Import
 
 ```js
 import account_distributedAccount from '@ohos.account.distributedAccount';
 ```
 
-
 ## account_distributedAccount.getDistributedAccountAbility
 
 getDistributedAccountAbility(): DistributedAccountAbility
@@ -25,7 +24,7 @@ Obtains a **DistributedAccountAbility** instance.
 
   | Type| Description|
   | -------- | -------- |
-  | [DistributedAccountAbility](#distributedaccountability) | **DistributedAccountAbility** instance obtained. This instance provides methods for querying and updating the login state of a distributed account.|
+  | [DistributedAccountAbility](#distributedaccountability) | **DistributedAccountAbility** instance obtained. This instance provides APIs for querying and updating the login state of a distributed account.|
 
 **Example**
   ```js
@@ -34,13 +33,88 @@ Obtains a **DistributedAccountAbility** instance.
 
 ## DistributedAccountAbility
 
-Provides methods for querying and updating the login state of a distributed account. You must obtain a **DistributedAccountAbility** instance first.
+Provides APIs for querying and updating the login state of a distributed account. You must obtain a **DistributedAccountAbility** instance first.
+
+### getOsAccountDistributedInfo<sup>9+</sup>
+
+getOsAccountDistributedInfo(callback: AsyncCallback&lt;DistributedInfo&gt;): void
+
+Obtains distributed account information. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.Account.OsAccount
+
+**Required permissions**: ohos.permission.MANAGE_DISTRIBUTED_ACCOUNTS, ohos.permission.GET_DISTRIBUTED_ACCOUNTS, or ohos.permission.DISTRIBUTED_DATASYNC
+
+**Parameters**
+
+  | Name| Type| Mandatory| Description|
+  | -------- | -------- | -------- | -------- |
+  | callback | AsyncCallback&lt;[DistributedInfo](#distributedinfo)&gt; | Yes| Callback invoked to return the result. If the operation is successful, **err** is **undefined** and data is the distributed account information obtained. Otherwise, **err** is an error object.|
+
+**Error codes**
+
+| ID| Error Message|
+| -------- | ------------------- |
+| 12300001 | System service exception. |
+
+**Example**
+  ```js
+  const accountAbility = account_distributedAccount.getDistributedAccountAbility();
+  try {
+    accountAbility.getOsAccountDistributedInfo((err, data) => {
+      console.log("getOsAccountDistributedInfo err: " + JSON.stringify(err));
+      console.log('Query account info name: ' + data.name);
+      console.log('Query account info id: ' + data.id);
+    });
+  } catch (e) {
+    console.log("getOsAccountDistributedInfo exception: " + JSON.stringify(e));
+  }
+  ```
 
-### queryOsAccountDistributedInfo
+### getOsAccountDistributedInfo<sup>9+</sup>
+
+getOsAccountDistributedInfo(): Promise&lt;DistributedInfo&gt;
+
+Obtains distributed account information. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.Account.OsAccount
+
+**Required permissions**: ohos.permission.MANAGE_DISTRIBUTED_ACCOUNTS, ohos.permission.GET_DISTRIBUTED_ACCOUNTS, or ohos.permission.DISTRIBUTED_DATASYNC
+
+**Return value**
+
+  | Type| Description|
+  | -------- | -------- |
+  | Promise&lt;[DistributedInfo](#distributedinfo)&gt; | Promise used to return the distributed account information obtained.|
+
+**Error codes**
+
+| ID| Error Message|
+| -------- | ------------------- |
+| 12300001 | System service exception. |
+
+**Example**
+  ```js
+  const accountAbility = account_distributedAccount.getDistributedAccountAbility();
+  try {
+    accountAbility.getOsAccountDistributedInfo().then((data) => {
+        console.log('Query account info name: ' + data.name);
+        console.log('Query account info id: ' + data.id);
+    }).catch((err) => {
+        console.log("getOsAccountDistributedInfo err: "  + JSON.stringify(err));
+    });
+  } catch (e) {
+    console.log("getOsAccountDistributedInfo exception: " + JSON.stringify(e));
+  }
+  ```
+### queryOsAccountDistributedInfo<sup>(deprecated)</sup>
 
 queryOsAccountDistributedInfo(callback: AsyncCallback&lt;DistributedInfo&gt;): void
 
 Obtains distributed account information. This API uses an asynchronous callback to return the result.
+> **NOTE**
+>
+> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [getOsAccountDistributedInfo](#getosaccountdistributedinfo9).
 
 **System capability**: SystemCapability.Account.OsAccount
 
@@ -50,24 +124,28 @@ Obtains distributed account information. This API uses an asynchronous callback
 
   | Name| Type| Mandatory| Description|
   | -------- | -------- | -------- | -------- |
-  | callback | AsyncCallback&lt;[DistributedInfo](#distributedinfo)&gt; | Yes| Callback invoked to return the distributed account information obtained.|
+  | callback | AsyncCallback&lt;[DistributedInfo](#distributedinfo)&gt; | Yes| Callback invoked to return the result. If the operation is successful, **err** is **undefined** and data is the distributed account information obtained. Otherwise, **err** is an error object.|
 
 **Example**
   ```js
   const accountAbility = account_distributedAccount.getDistributedAccountAbility();
-  accountAbility.queryOsAccountDistributedInfo((err, data) => { 
+  accountAbility.queryOsAccountDistributedInfo((err, data) => {
       console.log("queryOsAccountDistributedInfo err: " + JSON.stringify(err));
       console.log('Query account info name: ' + data.name);
       console.log('Query account info id: ' + data.id);
   });
   ```
 
-### queryOsAccountDistributedInfo
+### queryOsAccountDistributedInfo<sup>(deprecated)</sup>
 
 queryOsAccountDistributedInfo(): Promise&lt;DistributedInfo&gt;
 
 Obtains distributed account information. This API uses a promise to return the result.
 
+> **NOTE**
+>
+> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [getOsAccountDistributedInfo](#getosaccountdistributedinfo9-1).
+
 **System capability**: SystemCapability.Account.OsAccount
 
 **Required permissions**: ohos.permission.MANAGE_LOCAL_ACCOUNTS or ohos.permission.DISTRIBUTED_DATASYNC
@@ -81,7 +159,7 @@ Obtains distributed account information. This API uses a promise to return the r
 **Example**
   ```js
   const accountAbility = account_distributedAccount.getDistributedAccountAbility();
-  accountAbility.queryOsAccountDistributedInfo().then((data) => { 
+  accountAbility.queryOsAccountDistributedInfo().then((data) => {
       console.log('Query account info name: ' + data.name);
       console.log('Query account info id: ' + data.id);
   }).catch((err) => {
@@ -89,12 +167,97 @@ Obtains distributed account information. This API uses a promise to return the r
   });
   ```
 
-### updateOsAccountDistributedInfo
+### setOsAccountDistributedInfo<sup>9+</sup>
+
+setOsAccountDistributedInfo(accountInfo: DistributedInfo, callback: AsyncCallback&lt;void&gt;): void
+
+Sets the distributed account information. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.Account.OsAccount
+
+**Required permissions**: ohos.permission.MANAGE_DISTRIBUTED_ACCOUNTS
+
+**Parameters**
+
+  | Name| Type| Mandatory| Description|
+  | -------- | -------- | -------- | -------- |
+  | accountInfo | [DistributedInfo](#distributedinfo) | Yes| New distributed account information.|
+  | callback | AsyncCallback&lt;void&gt; | Yes| Callback invoked to return the result. If the distributed account information is set successfully, **err** is **undefined**. Otherwise, **err** is an error object.|
+
+**Error codes**
+
+| ID| Error Message|
+| -------- | ------------------- |
+| 12300001 | System service exception. |
+| 12300002 | Invalid accountInfo. |
+| 12300003 | Account not found. |
+
+**Example**
+  ```js
+  const accountAbility = account_distributedAccount.getDistributedAccountAbility();
+  let accountInfo = {id: '12345', name: 'ZhangSan', event: 'Ohos.account.event.LOGIN'};
+  try {
+    accountAbility.setOsAccountDistributedInfo(accountInfo, (err) => {
+        console.log("setOsAccountDistributedInfo err: " + JSON.stringify(err));
+    });
+  } catch (e) {
+    console.log("setOsAccountDistributedInfo exception: " + JSON.stringify(e));
+  }
+  ```
+
+### setOsAccountDistributedInfo<sup>9+</sup>
+
+setOsAccountDistributedInfo(accountInfo: DistributedInfo): Promise&lt;void&gt;
+
+Sets the distributed account information. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.Account.OsAccount
+
+**Required permissions**: ohos.permission.MANAGE_DISTRIBUTED_ACCOUNTS
+
+**Parameters**
+
+  | Name| Type| Mandatory| Description|
+  | -------- | -------- | -------- | -------- |
+  | accountInfo | [DistributedInfo](#distributedinfo) | Yes| New distributed account information.|
+
+**Return value**
+
+  | Type| Description|
+  | -------- | -------- |
+  | Promise&lt;void&gt; | Promise that returns no value.|
+
+**Error codes**
+
+| ID| Error Message|
+| -------- | ------------------- |
+| 12300001 | System service exception. |
+| 12300002 | invalid accountInfo. |
+
+**Example**
+  ```js
+  const accountAbility = account_distributedAccount.getDistributedAccountAbility();
+  let accountInfo = {id: '12345', name: 'ZhangSan', event: 'Ohos.account.event.LOGIN'};
+  try {
+    accountAbility.setOsAccountDistributedInfo(accountInfo).then(() => {
+        console.log('setOsAccountDistributedInfo Success');
+    }).catch((err) => {
+        console.log("setOsAccountDistributedInfo err: "  + JSON.stringify(err));
+    });
+  } catch (e) {
+    console.log("setOsAccountDistributedInfo exception: " + JSON.stringify(e));
+  }
+  ```
+### updateOsAccountDistributedInfo<sup>(deprecated)</sup>
 
 updateOsAccountDistributedInfo(accountInfo: DistributedInfo, callback: AsyncCallback&lt;void&gt;): void
 
 Updates distributed account information. This API uses an asynchronous callback to return the result.
 
+> **NOTE**
+>
+> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [setOsAccountDistributedInfo](#setosaccountdistributedinfo9).
+
 **System capability**: SystemCapability.Account.OsAccount
 
 **Required permissions**: ohos.permission.MANAGE_LOCAL_ACCOUNTS
@@ -103,24 +266,26 @@ Updates distributed account information. This API uses an asynchronous callback
 
   | Name| Type| Mandatory| Description|
   | -------- | -------- | -------- | -------- |
-  | accountInfo | [DistributedInfo](#distributedinfo) | Yes| Distributed account information.|
-  | callback | AsyncCallback&lt;void&gt; | Yes| Callback invoked when the distributed account information is updated.|
+  | accountInfo | [DistributedInfo](#distributedinfo) | Yes| New distributed account information.|
+  | callback | AsyncCallback&lt;void&gt; | Yes| Callback invoked to return the result. If the distributed account information is set successfully, **err** is **undefined**. Otherwise, **err** is an error object.|
 
 **Example**
   ```js
   const accountAbility = account_distributedAccount.getDistributedAccountAbility();
   let accountInfo = {id: '12345', name: 'ZhangSan', event: 'Ohos.account.event.LOGIN'};
-  accountAbility.updateOsAccountDistributedInfo(accountInfo, (err) => { 
+  accountAbility.updateOsAccountDistributedInfo(accountInfo, (err) => {
       console.log("queryOsAccountDistributedInfo err: " + JSON.stringify(err));
   });
   ```
 
-### updateOsAccountDistributedInfo
+### updateOsAccountDistributedInfo<sup>(deprecated)</sup>
 
 updateOsAccountDistributedInfo(accountInfo: DistributedInfo): Promise&lt;void&gt;
 
-Updates distributed account information. This API uses a promise to return the result.
-
+Updates the distributed account information. This API uses a promise to return the result.
+> **NOTE**
+>
+> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [setOsAccountDistributedInfo](#setosaccountdistributedinfo9-1).
 **System capability**: SystemCapability.Account.OsAccount
 
 **Required permissions**: ohos.permission.MANAGE_LOCAL_ACCOUNTS
@@ -129,13 +294,13 @@ Updates distributed account information. This API uses a promise to return the r
 
   | Name| Type| Mandatory| Description|
   | -------- | -------- | -------- | -------- |
-  | accountInfo | [DistributedInfo](#distributedinfo) | Yes| Distributed account information.|
+  | accountInfo | [DistributedInfo](#distributedinfo) | Yes| New distributed account information.|
 
 **Return value**
 
   | Type| Description|
   | -------- | -------- |
-  | Promise&lt;void&gt; | Promise used to return the result.|
+  | Promise&lt;void&gt; | Promise that returns no value.|
 
 **Example**
   ```js
@@ -147,8 +312,6 @@ Updates distributed account information. This API uses a promise to return the r
       console.log("updateOsAccountDistributedInfo err: "  + JSON.stringify(err));
   });
   ```
-
-
 ## DistributedInfo
 
 Defines distributed OS account information.
@@ -157,7 +320,9 @@ Defines distributed OS account information.
 
 | Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
-| name | string | Yes| Name of a distributed account. It must be a non-null string.|
-| id | string | Yes| UID of a distributed account. It must be a non-null string.|
+| name | string | Yes| Name of the distributed account. It must be a non-null string.|
+| id | string | Yes| UID of the distributed account. It must be a non-null string.|
 | event | string | Yes| Login state of a distributed account. The state can be login, logout, token invalid, or logoff, which correspond to the following strings respectively:<br>-&nbsp;Ohos.account.event.LOGIN<br>-&nbsp;Ohos.account.event.LOGOUT<br>-&nbsp;Ohos.account.event.TOKEN_INVALID<br>-&nbsp;Ohos.account.event.LOGOFF |
-| scalableData | object | No| Extended information about a distributed account. Customized information is passed in key-value pairs.<br>Note: This parameter is reserved and not used in query and update methods.|
+| nickname<sup>9+</sup> | string | No| Nickname of the distributed account. It must be a non-null string.|
+| avatar<sup>9+</sup> | string | No| Avatar of the distributed account. It must be a non-null string.|
+| scalableData | object | No| Extended information about the distributed account, passed in key-value (KV) pairs.<br>**NOTE**<br>This parameter is reserved and not used in query and update methods.|