@ohos.account.appAccount (App Account Management)

The appAccount module provides APIs for adding, deleting, modifying, and querying app account information, and supports inter-app authentication and distributed data synchronization.

NOTE

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

import account_appAccount from '@ohos.account.appAccount';

account_appAccount.createAppAccountManager

createAppAccountManager(): AppAccountManager

Creates an AppAccountManager object.

System capability: SystemCapability.Account.AppAccount

Return value

Example

let appAccountManager = account_appAccount.createAppAccountManager();

AppAccountManager

Implements app account management.

createAccount⁹⁺

createAccount(name: string, callback: AsyncCallback<void>): void;

Creates an app account. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
  appAccountManager.createAccount("WangWu", (err) => { 
      console.log("createAccount err: " + JSON.stringify(err));
  });
} catch (err) {
  console.log("createAccount err: " + JSON.stringify(err));
}

createAccount⁹⁺

createAccount(name: string, options: CreateAccountOptions, callback: AsyncCallback<void>): void

Creates an app account with custom data. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

let options = {
  customData: {
    "age": "10"
  }
}
try {
  appAccountManager.createAccount("LiSi", options, (err) => {
    if (err) {
      console.log("createAccount failed, error: " + JSON.stringify(err));
    } else {
      console.log("createAccount successfully");
    }
  });
} catch(err) {
  console.log("createAccount exception: " + JSON.stringify(err));
}

createAccount⁹⁺

createAccount(name: string, options?: CreateAccountOptions): Promise<void>

Creates an app account with custom data. This API uses a promise to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

let options = {
  customData: {
    "age": "10"
  }
}
try {
  appAccountManager.createAccount("LiSi", options).then(() => {
    console.log("createAccount successfully");
  }).catch((err) => {
    console.log("createAccount failed, error: " + JSON.stringify(err));
  });
} catch(err) {
  console.log("createAccount exception: " + JSON.stringify(err));
}

createAccountImplicitly⁹⁺

createAccountImplicitly(owner: string, callback: AuthCallback): void

Creates an app account implicitly based on the specified account owner. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

function onResultCallback(code, result) {
  console.log("resultCode: "  + code);
  console.log("result: "  + JSON.stringify(result));
}

function onRequestRedirectedCallback(request) {
  let wantInfo = {
    deviceId: '',
    bundleName: 'com.example.accountjsdemo',
    action: 'ohos.want.action.viewData',
    entities: ['entity.system.default'],
  }
  this.context.startAbility(wantInfo).then(() => {
    console.log("startAbility successfully");
  }).catch((err) => {
    console.log("startAbility err: " + JSON.stringify(err));
  })
}

try {  
  appAccountManager.createAccountImplicitly("com.example.accountjsdemo", {
    onResult: onResultCallback,
    onRequestRedirected: onRequestRedirectedCallback
  });
} catch (err) {
  console.log("createAccountImplicitly exception: " + JSON.stringify(err));
}

createAccountImplicitly⁹⁺

createAccountImplicitly(owner: string, options: CreateAccountImplicitlyOptions, callback: AuthCallback): void

Creates an app account implicitly based on the specified account owner and options. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

function onResultCallback(code, result) {
  console.log("resultCode: "  + code);
  console.log("result: "  + JSON.stringify(result));
}

function onRequestRedirectedCallback(request) {
  let wantInfo = {
    deviceId: '',
    bundleName: 'com.example.accountjsdemo',
    action: 'ohos.want.action.viewData',
    entities: ['entity.system.default'],
  }
  this.context.startAbility(wantInfo).then(() => {
    console.log("startAbility successfully");
  }).catch((err) => {
    console.log("startAbility err: " + JSON.stringify(err));
  })
}

let options = {
  authType: "getSocialData",
  requiredLabels: [ "student" ]
};
try {
  appAccountManager.createAccountImplicitly("com.example.accountjsdemo", options, {
    onResult: onResultCallback,
    onRequestRedirected: onRequestRedirectedCallback
  });
} catch (err) {
  console.log("createAccountImplicitly exception: " + JSON.stringify(err));
}

removeAccount⁹⁺

removeAccount(name: string, callback: AsyncCallback<void>): void

Removes an app account. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
  appAccountManager.removeAccount("ZhaoLiu", (err) => {
    if (err) {
      console.log("removeAccount failed, error: " + JSON.stringify(err));
    } else {
      console.log("removeAccount successfully");
    }
 });
} catch(err) {
  console.log("removeAccount exception: " + JSON.stringify(err));
}

removeAccount⁹⁺

removeAccount(name: string): Promise<void>

Removes an app account. This API uses a promise to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

try {
  appAccountManager.removeAccount("Lisi").then(() => {
    console.log("removeAccount successfully");
  }).catch((err) => {
    console.log("removeAccount failed, error: " + JSON.stringify(err));
  });
} catch (err) {
  console.log("removeAccount exception: " + JSON.stringify(err));
}

setAppAccess⁹⁺

setAppAccess(name: string, bundleName: string, isAccessible: boolean, callback: AsyncCallback<void>): void

Sets the access to the data of an account for an app. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
  appAccountManager.setAppAccess("ZhangSan", "com.example.accountjsdemo", true, (err) => {
    if (err) {
      console.log("setAppAccess failed: " + JSON.stringify(err));
    } else {
      console.log("setAppAccess successfully");
    }
  });
} catch (err) {
  console.log("setAppAccess exception: " + JSON.stringify(err));
}

setAppAccess⁹⁺

setAppAccess(name: string, bundleName: string, isAccessible: boolean): Promise<void>

Sets the access to the data of an account for an app. This API uses a promise to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

try {
  appAccountManager.setAppAccess("ZhangSan", "com.example.accountjsdemo", true).then(() => {
    console.log("setAppAccess successfully");
  }).catch((err) => {
    console.log("setAppAccess failed: " + JSON.stringify(err));
  });
} catch (err) {
  console.log("setAppAccess exception: " + JSON.stringify(err));
}

checkAppAccess⁹⁺

checkAppAccess(name: string, bundleName: string, callback: AsyncCallback<boolean>): void

Checks whether an app can access the data of an account. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
  appAccountManager.checkAppAccess("ZhangSan", "com.example.accountjsdemo", (err, isAccessible) => {
    if (err) {
      console.log("checkAppAccess failed, error: " + JSON.stringify(err));
    } else {
      console.log("checkAppAccess successfully");
    }
  });
} catch (err) {
  console.log("checkAppAccess exception: " + JSON.stringify(err));
}

checkAppAccess⁹⁺

checkAppAccess(name: string, bundleName: string): Promise<boolean>

Checks whether an app can access the data of an account. This API uses a promise to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

try {
  appAccountManager.checkAppAccess("ZhangSan", "com.example.accountjsdemo").then((isAccessible) => {
    console.log("checkAppAccess successfully, isAccessible: " + isAccessible);
  }).catch((err) => {
    console.log("checkAppAccess failed, error: " + JSON.stringify(err));
  });
} catch (err) {
  console.log("checkAppAccess exception: " + JSON.stringify(err));
}

setDataSyncEnabled⁹⁺

setDataSyncEnabled(name: string, isEnabled: boolean, callback: AsyncCallback<void>): void

Sets data synchronization for an app account. This API uses an asynchronous callback to return the result.

Required permissions: ohos.permission.DISTRIBUTED_DATASYNC

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
    appAccountManager.setDataSyncEnabled("ZhangSan", true, (err) => { 
        console.log("setDataSyncEnabled err: " + JSON.stringify(err));
    });
} catch (err) {
    console.log("setDataSyncEnabled err: " + JSON.stringify(err));
}

setDataSyncEnabled⁹⁺

setDataSyncEnabled(name: string, isEnabled: boolean): Promise<void>

Sets data synchronization for an app account. This API uses a promise to return the result.

Required permissions: ohos.permission.DISTRIBUTED_DATASYNC

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

try {
    appAccountManager .setDataSyncEnabled("ZhangSan", true).then(() => { 
        console.log('setDataSyncEnabled Success');
    }).catch((err) => {
        console.log("setDataSyncEnabled err: "  + JSON.stringify(err));
    });
} catch (err) {
    console.log("setDataSyncEnabled err: "  + JSON.stringify(err));
}

checkDataSyncEnabled⁹⁺

checkDataSyncEnabled(name: string, callback: AsyncCallback<boolean>): void

Checks whether data synchronization is enabled for an app account. This API uses an asynchronous callback to return the result.

Required permissions: ohos.permission.DISTRIBUTED_DATASYNC

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
  appAccountManager.checkDataSyncEnabled("ZhangSan", (err, isEnabled) => {
    if (err) {
      console.log("checkDataSyncEnabled failed, err: " + JSON.stringify(err));
    } else {
      console.log('checkDataSyncEnabled successfully, isEnabled: ' + isEnabled);
    }
  });
} catch (err) {
  console.log("checkDataSyncEnabled err: " + JSON.stringify(err));
}

checkDataSyncEnabled⁹⁺

checkDataSyncEnabled(name: string): Promise<boolean>

Checks whether data synchronization is enabled for an app account. This API uses a promise to return the result.

Required permissions: ohos.permission.DISTRIBUTED_DATASYNC

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

try {
  appAccountManager.checkDataSyncEnabled("ZhangSan").then((isEnabled) => {
      console.log("checkDataSyncEnabled successfully, isEnabled: " + isEnabled);
  }).catch((err) => {
    console.log("checkDataSyncEnabled failed, err: " + JSON.stringify(err));
  });
} catch (err) {
  console.log("checkDataSyncEnabled err: " + JSON.stringify(err));
}

setCredential⁹⁺

setCredential(name: string, credentialType: string, credential: string,callback: AsyncCallback<void>): void

Sets a credential for an app account. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
  appAccountManager.setCredential("ZhangSan", "PIN_SIX", "xxxxxx", (err) => {
    if (err) {
      console.log("setCredential failed, error: " + JSON.stringify(err));
    } else {
      console.log("setCredential successfully");
    }
  });
} catch (err) {
  console.log("setCredential exception: " + JSON.stringify(err));
}

setCredential⁹⁺

setCredential(name: string, credentialType: string, credential: string): Promise<void>

Sets a credential for an app account. This API uses a promise to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

try {
  appAccountManager.setCredential("ZhangSan", "PIN_SIX", "xxxxxx").then(() => {
    console.log("setCredential successfully");
  }).catch((err) => {
    console.log("setCredential failed, error: " + JSON.stringify(err));
  });
} catch (err) {
  console.log("setCredential exception: " + JSON.stringify(err));
}

getCredential⁹⁺

getCredential(name: string, credentialType: string, callback: AsyncCallback<string>): void

Obtains the credential of an app account. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
    appAccountManager.getCredential("ZhangSan", "PIN_SIX", (err, result) => { 
      if (err) {
        console.log("getCredential failed, error: " + JSON.stringify(err));
      } else {
        console.log('getCredential successfully, result: ' + result);
      }
    });
} catch (err) {
    console.log("getCredential err: " + JSON.stringify(err));
}

getCredential⁹⁺

getCredential(name: string, credentialType: string): Promise<string>

Obtains the credential of an app account. This API uses a promise to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

try {
  appAccountManager.getCredential("ZhangSan", "PIN_SIX").then((credential) => {
      console.log("getCredential successfully, credential: " + credential);
  }).catch((err) => {
      console.log("getCredential failed, error: " + JSON.stringify(err));
  });
} catch (err) {
  console.log("getCredential exception: "  + JSON.stringify(err));
}

setCustomData⁹⁺

setCustomData(name: string, key: string, value: string, callback: AsyncCallback<void>): void

Sets custom data for an app account. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
  appAccountManager.setCustomData("ZhangSan", "age", "12", (err) => {
    if (err) {
      console.log("setCustomData failed, error: " + JSON.stringify(err));
    } else {
      console.log("setCustomData successfully");
    }
  });
} catch (err) {
  console.log("setCustomData exception: " + JSON.stringify(err));
}

setCustomData⁹⁺

setCustomData(name: string, key: string, value: string): Promise<void>

Sets custom data for an app account. This API uses a promise to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

try {
  appAccountManager.setCustomData("ZhangSan", "age", "12").then(() => {
    console.log("setCustomData successfully");
  }).catch((err) => {
    console.log("setCustomData failed, error: " + JSON.stringify(err));
  });
} catch (err) {
  console.log("setCustomData exception: " + JSON.stringify(err));
}

getCustomData⁹⁺

getCustomData(name: string, key: string, callback: AsyncCallback<string>): void

Obtains the custom data of an app account based on the specified key. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
  appAccountManager.getCustomData("ZhangSan", "age", (err, data) => {
    if (err) {
      console.log('getCustomData failed, error: ' + err);
    } else {
      console.log("getCustomData successfully, data: " + data);
    }
  });
} catch (err) {
  console.log("getCustomData exception: " + JSON.stringify(err));
}

getCustomData⁹⁺

getCustomData(name: string, key: string): Promise<string>

Obtains the custom data of an app account based on the specified key. This API uses a promise to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

try {
  appAccountManager.getCustomData("ZhangSan", "age").then((data) => {
    console.log("getCustomData successfully, data: " + data);
  }).catch((err) => {
    console.log("getCustomData failed, error: " + JSON.stringify(err));
  });
} catch (err) {
  console.log("getCustomData exception: " + JSON.stringify(err));
}

getCustomDataSync⁹⁺

getCustomDataSync(name: string, key: string): string;

Obtains the custom data of an app account based on the specified key. The API returns the result synchronously.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

try {
    let value = appAccountManager.getCustomDataSync("ZhangSan", "age");
    console.info("getCustomDataSync successfully, vaue:" + value);
} catch (err) {
  console.error("getCustomDataSync failed, error: " + JSON.stringify(err));
}

getAllAccounts⁹⁺

getAllAccounts(callback: AsyncCallback<Array<AppAccountInfo>>): void

Obtains information about all accessible app accounts. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
  appAccountManager.getAllAccounts((err, data) => {
    if (err) {
      console.debug("getAllAccounts failed, error:" + JSON.stringify(err));
    } else {
      console.debug("getAllAccounts successfully");
    }
  });
} catch (err) {
    console.debug("getAllAccounts exception: " + JSON.stringify(err));
}

getAllAccounts⁹⁺

getAllAccounts(): Promise<Array<AppAccountInfo>>

Obtains information about all accessible app accounts. This API uses a promise to return the result.

System capability: SystemCapability.Account.AppAccount

Return value

Error codes

Example

try {
  appAccountManager.getAllAccounts().then((data) => {
    console.debug("getAllAccounts successfully");
  }).catch((err) => {
    console.debug("getAllAccounts failed, error:" + JSON.stringify(err));
  });
} catch (err) {
  console.debug("getAllAccounts exception: " + JSON.stringify(err));
}

getAccountsByOwner⁹⁺

getAccountsByOwner(owner: string, callback: AsyncCallback<Array<AppAccountInfo>>): void

Obtains the app accounts that can be accessed by the invoker based on the app account owner. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
  appAccountManager.getAccountsByOwner("com.example.accountjsdemo2", (err, data) => {
    if (err) {
      console.debug("getAccountsByOwner failed, error:" + JSON.stringify(err));
    } else {
      console.debug("getAccountsByOwner successfully, data:" + JSON.stringify(data));
    }
  });
} catch (err) {
  console.debug("getAccountsByOwner exception:" + JSON.stringify(err));
}

getAccountsByOwner⁹⁺

getAccountsByOwner(owner: string): Promise<Array<AppAccountInfo>>

Obtains the app accounts that can be accessed by the invoker based on the app account owner. This API uses a promise to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

try {
  appAccountManager.getAccountsByOwner("com.example.accountjsdemo2").then((data) => {
    console.debug("getAccountsByOwner successfully, data:" + JSON.stringify(data));
  }).catch((err) => {
    console.debug("getAccountsByOwner failed, error:" + JSON.stringify(err));
  });
} catch (err) {
  console.debug("getAccountsByOwner exception:" + JSON.stringify(err));
}

on('accountChange')⁹⁺

on(type: 'accountChange', owners: Array<string>, callback: Callback<Array<AppAccountInfo>>): void

Subscribes to account information changes of apps.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

function changeOnCallback(data){
	console.log("receive change data:" + JSON.stringify(data));
}
try{
	appAccountManager.on("accountChange", ["com.example.actsaccounttest"], changeOnCallback);
} catch(err) {
	console.error("on accountChange failed, error:" + JSON.stringify(err));
}

off('accountChange')⁹⁺

off(type: 'accountChange', callback?: Callback<Array<AppAccountInfo>>): void

Unsubscribes from account information changes.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

function changeOnCallback(data){
	console.log("receive change data:" + JSON.stringify(data));
}
try{
	appAccountManager.on("accountChange", ["com.example.actsaccounttest"], changeOnCallback);
} catch(err) {
	console.error("on accountChange failed, error:" + JSON.stringify(err));
}
try{
	appAccountManager.off('accountChange', changeOnCallback);
}
catch(err){
	console.error("off accountChange failed, error:" + JSON.stringify(err));
}

auth⁹⁺

auth(name: string, owner: string, authType: string, callback: AuthCallback): void

Authenticates an app account. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

function onResultCallback(code, authResult) {
  console.log("resultCode: "  + code);
  console.log("authResult: "  + JSON.stringify(authResult));
}

function onRequestRedirectedCallback(request) {
  let wantInfo = {
    deviceId: '',
    bundleName: 'com.example.accountjsdemo',
    action: 'ohos.want.action.viewData',
    entities: ['entity.system.default'],
  }
  this.context.startAbility(wantInfo).then(() => {
    console.log("startAbility successfully");
  }).catch((err) => {
    console.log("startAbility err: " + JSON.stringify(err));
  })
}

try {
  appAccountManager.auth("LiSi", "com.example.accountjsdemo", "getSocialData", {
      onResult: onResultCallback,
      onRequestRedirected: onRequestRedirectedCallback
  });
} catch (err) {
  console.log("auth exception: "  + JSON.stringify(err));
}

auth⁹⁺

auth(name: string, owner: string, authType: string, options: {[key: string]: Object}, callback: AuthCallback): void

Authenticates an app account with customized options. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

function onResultCallback(code, authResult) {
  console.log("resultCode: "  + code);
  console.log("authResult: "  + JSON.stringify(authResult));
}

function onRequestRedirectedCallback(request) {
  let wantInfo = {
    deviceId: '',
    bundleName: 'com.example.accountjsdemo',
    action: 'ohos.want.action.viewData',
    entities: ['entity.system.default'],
  }
  this.context.startAbility(wantInfo).then(() => {
    console.log("startAbility successfully");
  }).catch((err) => {
    console.log("startAbility err: " + JSON.stringify(err));
  })
}

let options = {
  "password": "xxxx",
};
try {
  appAccountManager.auth("LiSi", "com.example.accountjsdemo", "getSocialData", options, {
      onResult: onResultCallback,
      onRequestRedirected: onRequestRedirectedCallback
  });
} catch (err) {
  console.log("auth exception: "  + JSON.stringify(err));
}

getAuthToken⁹⁺

getAuthToken(name: string, owner: string, authType: string, callback: AsyncCallback<string>): void

Obtains the authorization token of the specified authentication type for an app account. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
  appAccountManager.getAuthToken("LiSi", "com.example.accountjsdemo", "getSocialData", (err, token) => {
    if (err) {
      console.log("getAuthToken failed, error: " + JSON.stringify(err));
    } else {
      console.log("getAuthToken successfully, token: " + token);
    }
  });
} catch (err) {
    console.log("getAuthToken exception: " + JSON.stringify(err));
}

getAuthToken⁹⁺

getAuthToken(name: string, owner: string, authType: string): Promise<string>

Obtains the authorization token of the specified authentication type for an app account. This API uses a promise to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

try {
  appAccountManager.getAuthToken("LiSi", "com.example.accountjsdemo", "getSocialData").then((token) => {
    console.log("getAuthToken successfully, token: " + token);
  }).catch((err) => {
    console.log("getAuthToken failed, error: " + JSON.stringify(err));
  });
} catch (err) {
    console.log("getAuthToken exception: " + JSON.stringify(err));
}

setAuthToken⁹⁺

setAuthToken(name: string, authType: string, token: string, callback: AsyncCallback<void>): void

Sets an authorization token of the specific authentication type for an app account. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
  appAccountManager.setAuthToken("LiSi", "getSocialData", "xxxx", (err) => {
    if (err) {
      console.log("setAuthToken failed, error: " + JSON.stringify(err));
    } else {
      console.log("setAuthToken successfully");
    }
  });
} catch (err) {
    console.log('setAuthToken exception: ' + JSON.stringify(err));
}

setAuthToken⁹⁺

setAuthToken(name: string, authType: string, token: string): Promise<void>

Sets an authorization token of the specific authentication type for an app account. This API uses a promise to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

try {
  appAccountManager.setAuthToken("LiSi", "getSocialData", "xxxx").then(() => {
      console.log("setAuthToken successfully");
  }).catch((err) => {
      console.log("setAuthToken failed, error: " + JSON.stringify(err));
  });
} catch (err) {
  console.log("setAuthToken exception: " + JSON.stringify(err));
}

deleteAuthToken⁹⁺

deleteAuthToken(name: string, owner: string, authType: string, token: string, callback: AsyncCallback<void>): void

Deletes the authorization token of the specified authentication type for an app account. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
    appAccountManager.deleteAuthToken("LiSi", "com.example.accountjsdemo", "getSocialData", "xxxxx", (err) => {
      if (err) {
        console.log('deleteAuthToken failed, error: ' + JSON.stringify(err));
      } else {
        console.log("deleteAuthToken successfully");
      }
    });
} catch (err) {
    console.log('deleteAuthToken exception: ' + JSON.stringify(err));
}

deleteAuthToken⁹⁺

deleteAuthToken(name: string, owner: string, authType: string, token: string): Promise<void>

Deletes the authorization token of the specified authentication type for an app account. This API uses a promise to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

try {
  appAccountManager.deleteAuthToken("LiSi", "com.example.accountjsdemo", "getSocialData", "xxxxx").then(() => {
    console.log("deleteAuthToken successfully");
  }).catch((err) => {
    console.log('deleteAuthToken failed, error: ' + JSON.stringify(err));
  });
} catch (err) {
  console.log('deleteAuthToken exception: ' + JSON.stringify(err));
}

setAuthTokenVisibility⁹⁺

setAuthTokenVisibility(name: string, authType: string, bundleName: string, isVisible: boolean, callback: AsyncCallback<void>): void

Sets the visibility of an authorization token to an app. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
    appAccountManager.setAuthTokenVisibility("LiSi", "getSocialData", "com.example.accountjsdemo", true, (err) => {
      if (err) {
        console.log("setAuthTokenVisibility failed, error: " + JSON.stringify(err));
      } else {
        console.log("setAuthTokenVisibility successfully");
      }
    });
} catch (err) {
    console.log("setAuthTokenVisibility exception: " + JSON.stringify(err));
}

setAuthTokenVisibility⁹⁺

setAuthTokenVisibility(name: string, authType: string, bundleName: string, isVisible: boolean): Promise<void>

Sets the visibility of an authorization token to an app. This API uses a promise to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

try {
  appAccountManager.setAuthTokenVisibility("LiSi", "getSocialData", "com.example.accountjsdemo", true).then(() => {
    console.log("setAuthTokenVisibility successfully");
  }).catch((err) => {
    console.log("setAuthTokenVisibility failed, error: " + JSON.stringify(err));
  });
} catch (err) {
  console.log("setAuthTokenVisibility exception: " + JSON.stringify(err));
}

checkAuthTokenVisibility⁹⁺

checkAuthTokenVisibility(name: string, authType: string, bundleName: string, callback: AsyncCallback<boolean>): void

Checks the visibility of an authorization token of the specified authentication type to an app. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
  appAccountManager.checkAuthTokenVisibility("LiSi", "getSocialData", "com.example.accountjsdemo", (err, isVisible) => {
    if (err) {
      console.log("checkAuthTokenVisibility failed, error: " + JSON.stringify(err));
    } else {
      console.log("checkAuthTokenVisibility successfully, isVisible: " + isVisible);
    }
  });
} catch (err) {
  console.log("checkAuthTokenVisibility exception: " + JSON.stringify(err));
}

checkAuthTokenVisibility⁹⁺

checkAuthTokenVisibility(name: string, authType: string, bundleName: string): Promise<boolean>

Checks the visibility of an authorization token of the specified authentication type to an app. This API uses a promise to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

try {
  appAccountManager.checkAuthTokenVisibility("LiSi", "getSocialData", "com.example.accountjsdemo").then((isVisible) => {
    console.log("checkAuthTokenVisibility successfully, isVisible: " + isVisible);
  }).catch((err) => {
    console.log("checkAuthTokenVisibility failed, error: " + JSON.stringify(err));
  });
} catch (err) {
  console.log("checkAuthTokenVisibility exception: " + JSON.stringify(err));
}

getAllAuthTokens⁹⁺

getAllAuthTokens(name: string, owner: string, callback: AsyncCallback<Array<AuthTokenInfo>>): void

Obtains all tokens visible to the invoker for an app account. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
  appAccountManager.getAllAuthTokens("LiSi", "com.example.accountjsdemo", (err, tokenArr) => {
    if (err) {
      console.log("getAllAuthTokens failed, error: "  + JSON.stringify(err));
    } else {
      console.log('getAllAuthTokens successfully, tokenArr: ' + tokenArr);
    }
  });
} catch (err) {
  console.log("getAllAuthTokens exception: "  + JSON.stringify(err));
}

getAllAuthTokens⁹⁺

getAllAuthTokens(name: string, owner: string): Promise<Array<AuthTokenInfo>>

Obtains all tokens visible to the invoker for an app account. This API uses a promise to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

try {
  appAccountManager.getAllAuthTokens("LiSi", "com.example.accountjsdemo").then((tokenArr) => {
      console.log('getAllAuthTokens successfully, tokenArr: ' + JSON.stringify(tokenArr));
  }).catch((err) => {
      console.log("getAllAuthTokens failed, error: "  + JSON.stringify(err));
  });
} catch (err) {
  console.log("getAllAuthTokens exception: "  + JSON.stringify(err));
}

getAuthList⁹⁺

getAuthList(name: string, authType: string, callback: AsyncCallback<Array<string>>): void

Obtains the authorization list of the specified authentication type for an app account. The authorization list contains all authorized bundles. The token authorization list is set by setAuthTokenVisibility. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
  appAccountManager.getAuthList("com.example.accountjsdemo", "getSocialData", (err, authList) => {
    if (err) {
      console.log("getAuthList failed, error: " + JSON.stringify(err));
    } else {
      console.log("getAuthList successfully, authList: " + authList);
    }
  });
} catch (err) {
  console.log('getAuthList exception: ' + JSON.stringify(err));
}

getAuthList⁹⁺

getAuthList(name: string, authType: string): Promise<Array<string>>

Obtains the authorization list of the specified authentication type for an app account. The authorization list contains all authorized bundles. The token authorization list is set by setAuthTokenVisibility. This API uses a promise to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

try {
  appAccountManager.getAuthList("com.example.accountjsdemo", "getSocialData").then((authList) => {
      console.log("getAuthList successfully, authList: " + authList);
  }).catch((err) => {
      console.log("getAuthList failed, error: "  + JSON.stringify(err));
  });
} catch (err) {
  console.log("getAuthList exception: "  + JSON.stringify(err));
}

getAuthCallback⁹⁺

getAuthCallback(sessionId: string, callback: AsyncCallback<AuthCallback>): void

Obtains the authenticator callback for the authentication session. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

import UIAbility from '@ohos.app.ability.UIAbility';

export default class EntryAbility extends UIAbility {
  onCreate(want, param) {
    var sessionId = want.parameters[account_appAccount.Constants.KEY_SESSION_ID];
    try {
      appAccountManager.getAuthCallback(sessionId, (err, callback) => {
        if (err != null) {
            console.log("getAuthCallback err: "  + JSON.stringify(err));
            return;
        }
        var result = {
          accountInfo: {
            name: "Lisi",
            owner: "com.example.accountjsdemo",
          },
          tokenInfo: {
            token: "xxxxxx",
            authType: "getSocialData"
          }
        };
        callback.onResult(0, result);
      });
    } catch (err) {
        console.log("getAuthCallback exception: "  + JSON.stringify(err));
    }
  }
}

getAuthCallback⁹⁺

getAuthCallback(sessionId: string): Promise<AuthCallback>

Obtains the authenticator callback for the authentication session. This API uses a promise to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

import UIAbility from '@ohos.app.ability.UIAbility';

export default class EntryAbility extends UIAbility {
  onCreate(want, param) {
    var sessionId = want.parameters[account_appAccount.Constants.KEY_SESSION_ID];
    try {
      appAccountManager.getAuthCallback(sessionId).then((callback) => {
      var result = {
        accountInfo: {
          name: "Lisi",
          owner: "com.example.accountjsdemo",
        },
        tokenInfo: {
          token: "xxxxxx",
          authType: "getSocialData"
        }
      };
      callback.onResult(0, result);
      }).catch((err) => {
        console.log("getAuthCallback err: "  + JSON.stringify(err));
      });
    } catch (err) {
      console.log("getAuthCallback exception: "  + JSON.stringify(err));
    }
  }
}

queryAuthenticatorInfo⁹⁺

queryAuthenticatorInfo(owner: string, callback: AsyncCallback<AuthenticatorInfo>): void

Obtains the authenticator information of an app. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
  appAccountManager.queryAuthenticatorInfo("com.example.accountjsdemo", (err, info) => {
    if (err) {
      console.log("queryAuthenticatorInfo failed, error: "  + JSON.stringify(err));
    } else {
      console.log('queryAuthenticatorInfo successfully, info: ' + JSON.stringify(info));
    }
  });
} catch (err) {
  console.log("queryAuthenticatorInfo exception: "  + JSON.stringify(err));
}

queryAuthenticatorInfo⁹⁺

queryAuthenticatorInfo(owner: string): Promise<AuthenticatorInfo>

Obtains the authenticator information of an app. This API uses a promise to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

try {
  appAccountManager.queryAuthenticatorInfo("com.example.accountjsdemo").then((info) => { 
      console.log("queryAuthenticatorInfo successfully, info: " + JSON.stringify(info));
  }).catch((err) => {
      console.log("queryAuthenticatorInfo failed, error: "  + JSON.stringify(err));
  });
} catch (err) {
  console.log("queryAuthenticatorInfo exception: "  + JSON.stringify(err));
}

checkAccountLabels⁹⁺

checkAccountLabels(name: string, owner: string, labels: Array<string>, callback: AsyncCallback<boolean>): void;

Checks whether an app account has specific labels. This API uses an asynchronous callback to return the result. The labels are checked by the authenticator of the target app.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

let labels = ["student"];
try {
  appAccountManager.checkAccountLabels("zhangsan", "com.example.accountjsdemo", labels, (err, hasAllLabels) => {
    if (err) {
      console.log("checkAccountLabels failed, error: "  + JSON.stringify(err));
    } else {
      console.log("checkAccountLabels successfully, hasAllLabels: " + hasAllLabels);
    }
  });
} catch (err) {
  console.log("checkAccountLabels exception: "  + JSON.stringify(err));
}

checkAccountLabels⁹⁺

checkAccountLabels(name: string, owner: string, labels: Array<string>): Promise<boolean>

Checks whether an app account has specific labels. This API uses a promise to return the result. The labels are checked by the authenticator of the target app.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

let labels = ["student"];
try {
  appAccountManager.checkAccountLabels("zhangsan", "com.example.accountjsdemo", labels).then((hasAllLabels) => {
    console.log('checkAccountLabels successfully: ' + hasAllLabels);
  }).catch((err) => {
    console.log("checkAccountLabels failed, error: "  + JSON.stringify(err));
  });
} catch (err) {
  console.log("checkAccountLabels exception: "  + JSON.stringify(err));
}

deleteCredential⁹⁺

deleteCredential(name: string, credentialType: string, callback: AsyncCallback<void>): void

Deletes the credential of the specified type from an app account. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
  appAccountManager.deleteCredential("zhangsan", "PIN_SIX", (err) => {
    if (err) {
      console.log("deleteCredential failed, error: "  + JSON.stringify(err));
    } else {
      console.log("deleteCredential successfully");
    }
  });
} catch (err) {
  console.log("deleteCredential exception: "  + JSON.stringify(err));
}

deleteCredential⁹⁺

deleteCredential(name: string, credentialType: string): Promise<void>

Deletes the credential of the specified type from an app account. This API uses a promise to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

try {
  appAccountManager.deleteCredential("zhangsan", "PIN_SIX").then(() => {
    console.log("deleteCredential successfully");
  }).catch((err) => {
    console.log("deleteCredential failed, error: " + JSON.stringify(err));
  });
} catch (err) {
  console.log("deleteCredential exception: "  + JSON.stringify(err));
}

selectAccountsByOptions⁹⁺

selectAccountsByOptions(options: SelectAccountsOptions, callback: AsyncCallback<Array<AppAccountInfo>>): void

Selects the accounts that can be accessed by the invoker based on the options. This API uses an asynchronous callback to return the result. If the options contain label constraints, the authenticator of the target app provides the capability of checking the labels.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

let options = {
  allowedOwners: [ "com.example.accountjsdemo" ],
  requiredLabels: [ "student" ]
};
try {
  appAccountManager.selectAccountsByOptions(options, (err, accountArr) => {
    if (err) {
      console.log("selectAccountsByOptions failed, error: "  + JSON.stringify(err));
    } else {
      console.log("selectAccountsByOptions successfully, accountArr: " + JSON.stringify(accountArr));
    }
  });
} catch (err) {
  console.log("selectAccountsByOptions exception: "  + JSON.stringify(err));
}

selectAccountsByOptions⁹⁺

selectAccountsByOptions(options: SelectAccountsOptions): Promise<Array<AppAccountInfo>>

Selects the accounts that can be accessed by the invoker based on the options. This API uses a promise to return the result. If the options contain label constraints, the authenticator of the target app provides the capability of checking the labels.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Error codes

Example

let options = {
  allowedOwners: ["com.example.accountjsdemo"]
};
try {
  appAccountManager.selectAccountsByOptions(options).then((accountArr) => {
    console.log("selectAccountsByOptions successfully, accountArr: " + JSON.stringify(accountArr));
  }).catch((err) => {
    console.log("selectAccountsByOptions failed, error: "  + JSON.stringify(err));
  });
} catch (err) {
  console.log("selectAccountsByOptions exception: "  + JSON.stringify(err));
}

verifyCredential⁹⁺

verifyCredential(name: string, owner: string, callback: AuthCallback): void;

Verifies the credential of an app account. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
    appAccountManager.verifyCredential("zhangsan", "com.example.accountjsdemo", {
        onResult: (resultCode, result) => {
            console.log("verifyCredential onResult, resultCode:" + JSON.stringify(resultCode));
            console.log("verifyCredential onResult, result:" + JSON.stringify(result));
        },
        onRequestRedirected: (request) => {
            console.log("verifyCredential onRequestRedirected, request:" + JSON.stringify(request));
        }
    });
} catch (err) {
    console.log("verifyCredential err: "  + JSON.stringify(err));
}

verifyCredential⁹⁺

verifyCredential(name: string, owner: string, options: VerifyCredentialOptions, callback: AuthCallback): void;

Verifies the user credential. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

let options = {
  credentialType: "pin",
  credential: "123456"
};
try {
  appAccountManager.verifyCredential("zhangsan", "com.example.accountjsdemo", options, {
    onResult: (resultCode, result) => {
      console.log("verifyCredential onResult, resultCode:" + JSON.stringify(resultCode));
      console.log("verifyCredential onResult, result:" + JSON.stringify(result));
    },
    onRequestRedirected: (request) => {
      console.log("verifyCredential onRequestRedirected, request:" + JSON.stringify(request));
    }
  });
} catch (err) {
  console.log("verifyCredential err: "  + JSON.stringify(err));
}

setAuthenticatorProperties⁹⁺

setAuthenticatorProperties(owner: string, callback: AuthCallback): void;

Sets the authenticator attributes of an app. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

try {
  appAccountManager.setAuthenticatorProperties("com.example.accountjsdemo", {
    onResult: (resultCode, result) => {
      console.log("setAuthenticatorProperties onResult, resultCode:" + JSON.stringify(resultCode));
      console.log("setAuthenticatorProperties onResult, result:" + JSON.stringify(result));
    },
    onRequestRedirected: (request) => {
      console.log("setAuthenticatorProperties onRequestRedirected, request:" + JSON.stringify(request));
    }
  });
} catch (err) {
  console.log("setAuthenticatorProperties err: "  + JSON.stringify(err));
}

setAuthenticatorProperties⁹⁺

setAuthenticatorProperties(owner: string, options: SetPropertiesOptions, callback: AuthCallback): void;

Set authenticator properties. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Account.AppAccount

Parameters

Error codes

Example

let options = {
  properties: {"prop1": "value1"}
};
try {
  appAccountManager.setAuthenticatorProperties("com.example.accountjsdemo", options, {
    onResult: (resultCode, result) => {
      console.log("setAuthenticatorProperties onResult, resultCode:" + JSON.stringify(resultCode));
      console.log("setAuthenticatorProperties onResult, result:" + JSON.stringify(result));
    },
    onRequestRedirected: (request) => {
      console.log("setAuthenticatorProperties onRequestRedirected, request:" + JSON.stringify(request));
    }
  });
} catch (err) {
  console.log("setAuthenticatorProperties err: "  + JSON.stringify(err));
} 

addAccount^(deprecated)

addAccount(name: string, callback: AsyncCallback<void>): void

Adds an app account. 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 createAccount.

System capability: SystemCapability.Account.AppAccount

Parameters

Example

appAccountManager.addAccount("WangWu", (err) => { 
    console.log("addAccount err: " + JSON.stringify(err));
});

addAccount^(deprecated)

addAccount(name: string, extraInfo: string, callback: AsyncCallback<void>): void

Adds an app account name and additional 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 createAccount.

System capability: SystemCapability.Account.AppAccount

Parameters

Example

appAccountManager.addAccount("LiSi", "token101", (err) => { 
  console.log("addAccount err: " + JSON.stringify(err));
});

addAccount^(deprecated)

addAccount(name: string, extraInfo?: string): Promise<void>

Adds an app account name and additional information. This API uses an asynchronous callback to return the result. 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 createAccount.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Example

appAccountManager.addAccount("LiSi", "token101").then(()=> { 
  console.log('addAccount Success');
}).catch((err) => {
  console.log("addAccount err: "  + JSON.stringify(err));
});

addAccountImplicitly^(deprecated)

addAccountImplicitly(owner: string, authType: string, options: {[key: string]: any}, callback: AuthenticatorCallback): void

Adds an app account implicitly based on the specified owner. This API uses an asynchronous callback to return the result.

NOTE

This API is supported since API version 8 and deprecated since API version 9. You are advised to use createAccountImplicitly.

System capability: SystemCapability.Account.AppAccount

Parameters

Example

function onResultCallback(code, result) {
  console.log("resultCode: "  + code);
  console.log("result: "  + JSON.stringify(result));
}

function onRequestRedirectedCallback(request) {
  let wantInfo = {
    deviceId: '',
    bundleName: 'com.example.accountjsdemo',
    action: 'ohos.want.action.viewData',
    entities: ['entity.system.default'],
  }
  this.context.startAbility(wantInfo).then(() => {
    console.log("startAbility successfully");
  }).catch((err) => {
    console.log("startAbility err: " + JSON.stringify(err));
  })
}

appAccountManager.addAccountImplicitly("com.example.accountjsdemo", "getSocialData", {}, {
  onResult: onResultCallback,
  onRequestRedirected: onRequestRedirectedCallback
});

deleteAccount^(deprecated)

deleteAccount(name: string, callback: AsyncCallback<void>): void

Deletes an app account. 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 removeAccount.

System capability: SystemCapability.Account.AppAccount

Parameters

Example

appAccountManager.deleteAccount("ZhaoLiu", (err) => { 
    console.log("deleteAccount err: " + JSON.stringify(err));
 });

deleteAccount^(deprecated)

deleteAccount(name: string): Promise<void>

Deletes an app account. 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 removeAccount.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Example

appAccountManager.deleteAccount("ZhaoLiu").then(() => { 
      console.log('deleteAccount Success');
 }).catch((err) => {
    console.log("deleteAccount err: "  + JSON.stringify(err));
});

disableAppAccess^(deprecated)

disableAppAccess(name: string, bundleName: string, callback: AsyncCallback<void>): void

Disables an app account from accessing an app. 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 setAppAccess.

System capability: SystemCapability.Account.AppAccount

Parameters

Example

appAccountManager.disableAppAccess("ZhangSan", "com.example.accountjsdemo", (err) => { 
    console.log("disableAppAccess err: " + JSON.stringify(err));
});

disableAppAccess^(deprecated)

disableAppAccess(name: string, bundleName: string): Promise<void>

Disables an app account from accessing an app. 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 setAppAccess.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Example

appAccountManager.disableAppAccess("ZhangSan", "com.example.accountjsdemo").then(() => { 
    console.log('disableAppAccess Success');
}).catch((err) => {
    console.log("disableAppAccess err: "  + JSON.stringify(err));
});

enableAppAccess^(deprecated)

enableAppAccess(name: string, bundleName: string, callback: AsyncCallback<void>): void

Enables an app account to access an app. 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 setAppAccess.

System capability: SystemCapability.Account.AppAccount

Parameters

Example

appAccountManager.enableAppAccess("ZhangSan", "com.example.accountjsdemo", (err) => { 
    console.log("enableAppAccess: " + JSON.stringify(err));
 });

enableAppAccess^(deprecated)

enableAppAccess(name: string, bundleName: string): Promise<void>

Enables an app account to access an app. 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 setAppAccess.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Example

appAccountManager.enableAppAccess("ZhangSan", "com.example.accountjsdemo").then(() => { 
     console.log('enableAppAccess Success');
}).catch((err) => {
    console.log("enableAppAccess err: "  + JSON.stringify(err));
});

checkAppAccountSyncEnable^(deprecated)

checkAppAccountSyncEnable(name: string, callback: AsyncCallback<boolean>): void

Checks whether data synchronization is enabled for an app account. 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 checkDataSyncEnabled.

Required permissions: ohos.permission.DISTRIBUTED_DATASYNC

System capability: SystemCapability.Account.AppAccount

Parameters

Example

appAccountManager.checkAppAccountSyncEnable("ZhangSan", (err, result) => { 
    console.log("checkAppAccountSyncEnable err: " + JSON.stringify(err));
    console.log('checkAppAccountSyncEnable result: ' + result);
});

checkAppAccountSyncEnable^(deprecated)

checkAppAccountSyncEnable(name: string): Promise<boolean>

Checks whether data synchronization is enabled for an app account. 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 checkDataSyncEnabled.

Required permissions: ohos.permission.DISTRIBUTED_DATASYNC

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Example

appAccountManager.checkAppAccountSyncEnable("ZhangSan").then((data) => { 
    console.log('checkAppAccountSyncEnable, result: ' + data);
}).catch((err) => {
    console.log("checkAppAccountSyncEnable err: "  + JSON.stringify(err));
});

setAccountCredential^(deprecated)

setAccountCredential(name: string, credentialType: string, credential: string,callback: AsyncCallback<void>): void

Set credentials for an app account. 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 setCredential.

System capability: SystemCapability.Account.AppAccount

Parameters

Example

appAccountManager.setAccountCredential("ZhangSan", "credentialType001", "credential001", (err) => { 
    console.log("setAccountCredential err: " + JSON.stringify(err));
});

setAccountCredential^(deprecated)

setAccountCredential(name: string, credentialType: string, credential: string): Promise<void>

Set credentials for an app account. 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 setCredential.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Example

appAccountManager.setAccountCredential("ZhangSan", "credentialType001", "credential001").then(() => { 
    console.log('setAccountCredential Success');
}).catch((err) => {
    console.log("setAccountCredential err: "  + JSON.stringify(err));
});

setAccountExtraInfo^(deprecated)

setAccountExtraInfo(name: string, extraInfo: string, callback: AsyncCallback<void>): void

Sets additional information for an app account. 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 setCustomData.

System capability: SystemCapability.Account.AppAccount

Parameters

Example

appAccountManager.setAccountExtraInfo("ZhangSan", "Tk002", (err) => { 
    console.log("setAccountExtraInfo err: " + JSON.stringify(err));
});

setAccountExtraInfo^(deprecated)

setAccountExtraInfo(name: string, extraInfo: string): Promise<void>

Sets additional information for an app account. 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 setCustomData.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Example

appAccountManager.setAccountExtraInfo("ZhangSan", "Tk002").then(() => { 
    console.log('setAccountExtraInfo Success');
}).catch((err) => {
    console.log("setAccountExtraInfo err: "  + JSON.stringify(err));
});

setAppAccountSyncEnable^(deprecated)

setAppAccountSyncEnable(name: string, isEnable: boolean, callback: AsyncCallback<void>): void

Sets data synchronization for an app account. 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 setDataSyncEnabled.

Required permissions: ohos.permission.DISTRIBUTED_DATASYNC

System capability: SystemCapability.Account.AppAccount

Parameters

Example

appAccountManager.setAppAccountSyncEnable("ZhangSan", true, (err) => { 
    console.log("setAppAccountSyncEnable err: " + JSON.stringify(err));
});

setAppAccountSyncEnable^(deprecated)

setAppAccountSyncEnable(name: string, isEnable: boolean): Promise<void>

Sets data synchronization for an app account. 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 setDataSyncEnabled.

Required permissions: ohos.permission.DISTRIBUTED_DATASYNC

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Example

appAccountManager .setAppAccountSyncEnable("ZhangSan", true).then(() => { 
    console.log('setAppAccountSyncEnable Success');
}).catch((err) => {
    console.log("setAppAccountSyncEnable err: "  + JSON.stringify(err));
});

setAssociatedData^(deprecated)

setAssociatedData(name: string, key: string, value: string, callback: AsyncCallback<void>): void

Sets data to be associated with an app account. 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 setCustomData.

System capability: SystemCapability.Account.AppAccount

Parameters

Example

appAccountManager.setAssociatedData("ZhangSan", "k001", "v001", (err) => { 
    console.log("setAssociatedData err: " + JSON.stringify(err));
});

setAssociatedData^(deprecated)

setAssociatedData(name: string, key: string, value: string): Promise<void>

Sets data to be associated with an app account. 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 setCustomData.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Example

appAccountManager.setAssociatedData("ZhangSan", "k001", "v001").then(() => { 
    console.log('setAssociatedData Success');
}).catch((err) => {
    console.log("setAssociatedData err: "  + JSON.stringify(err));
});

getAllAccessibleAccounts^(deprecated)

getAllAccessibleAccounts(callback: AsyncCallback<Array<AppAccountInfo>>): void

Obtains information about all accessible app accounts. 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 getAllAccounts.

Required permissions: ohos.permission.GET_ALL_APP_ACCOUNTS

System capability: SystemCapability.Account.AppAccount

Parameters

Example

appAccountManager.getAllAccessibleAccounts((err, data)=>{
	console.debug("getAllAccessibleAccounts err:" + JSON.stringify(err));
	console.debug("getAllAccessibleAccounts data:" + JSON.stringify(data));
});

getAllAccessibleAccounts^(deprecated)

getAllAccessibleAccounts(): Promise<Array<AppAccountInfo>>

Obtains information about all accessible app accounts. 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 getAllAccounts.

Required permissions: ohos.permission.GET_ALL_APP_ACCOUNTS

System capability: SystemCapability.Account.AppAccount

Return value

Example

appAccountManager.getAllAccessibleAccounts().then((data) => { 
     console.log('getAllAccessibleAccounts: ' + data);
}).catch((err) => {
    console.log("getAllAccessibleAccounts err: "  + JSON.stringify(err));
});

getAllAccounts^(deprecated)

getAllAccounts(owner: string, callback: AsyncCallback<Array<AppAccountInfo>>): void

Obtains the app accounts that can be accessed by the invoker based on the app account owner. 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 getAccountsByOwner.

Required permissions: ohos.permission.GET_ALL_APP_ACCOUNTS

System capability: SystemCapability.Account.AppAccount

Parameters

Example

const selfBundle = "com.example.actsgetallaaccounts";
appAccountManager.getAllAccounts(selfBundle, (err, data)=>{
	console.debug("getAllAccounts err:" + JSON.stringify(err));
	console.debug("getAllAccounts data:" + JSON.stringify(data));
});

getAllAccounts^(deprecated)

getAllAccounts(owner: string): Promise<Array<AppAccountInfo>>

Obtains the app accounts that can be accessed by the invoker based on the app account owner. 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 getAccountsByOwner.

Required permissions: ohos.permission.GET_ALL_APP_ACCOUNTS (available only to system applications)

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Example

const selfBundle = "com.example.actsgetallaaccounts";
appAccountManager.getAllAccounts(selfBundle).then((data) => { 
     console.log('getAllAccounts: ' + data);
}).catch((err) => {
    console.log("getAllAccounts err: "  + JSON.stringify(err));
});

getAccountCredential^(deprecated)

getAccountCredential(name: string, credentialType: string, callback: AsyncCallback<string>): void

Obtains the credential of an app account. 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 getCredential.

System capability: SystemCapability.Account.AppAccount

Parameters

Example

appAccountManager.getAccountCredential("ZhangSan", "credentialType001", (err, result) => { 
    console.log("getAccountCredential err: " + JSON.stringify(err));
    console.log('getAccountCredential result: ' + result);
});

getAccountCredential^(deprecated)

getAccountCredential(name: string, credentialType: string): Promise<string>

Obtains the credential of an app account. 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 getCredential.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Example

appAccountManager.getAccountCredential("ZhangSan", "credentialType001").then((data) => { 
    console.log('getAccountCredential, result: ' + data);
}).catch((err) => {
    console.log("getAccountCredential err: "  + JSON.stringify(err));
});

getAccountExtraInfo^(deprecated)

getAccountExtraInfo(name: string, callback: AsyncCallback<string>): void

Obtains additional information of an app account. Additional information refers to other information that can be converted to the string type. It cannot contain sensitive information, such as the app account password and token. 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 getCustomData.

System capability: SystemCapability.Account.AppAccount

Parameters

Example

appAccountManager.getAccountExtraInfo("ZhangSan", (err, result) => { 
    console.log("getAccountExtraInfo err: " + JSON.stringify(err));
    console.log('getAccountExtraInfo result: ' + result);
});

getAccountExtraInfo^(deprecated)

getAccountExtraInfo(name: string): Promise<string>

Obtains additional information of an app account. Additional information refers to other information that can be converted to the string type. It cannot contain sensitive information, such as the app account password and token. 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 getCustomData.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Example

appAccountManager.getAccountExtraInfo("ZhangSan").then((data) => { 
    console.log('getAccountExtraInfo, result: ' + data);
}).catch((err) => {
    console.log("getAccountExtraInfo err: "  + JSON.stringify(err));
});

getAssociatedData^(deprecated)

getAssociatedData(name: string, key: string, callback: AsyncCallback<string>): void

Obtains data associated with an app account. 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 getCustomData.

System capability: SystemCapability.Account.AppAccount

Parameters

Example

appAccountManager.getAssociatedData("ZhangSan", "k001", (err, result) => { 
    console.log("getAssociatedData err: " + JSON.stringify(err));
    console.log('getAssociatedData result: ' + result);
});

getAssociatedData^(deprecated)

getAssociatedData(name: string, key: string): Promise<string>

Obtains data associated with an app account. 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 getCustomData.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Example

appAccountManager.getAssociatedData("ZhangSan", "k001").then((data) => { 
     console.log('getAssociatedData: ' + data);
}).catch((err) => {
    console.log("getAssociatedData err: "  + JSON.stringify(err));
});

on('change')^(deprecated)

on(type: 'change', owners: Array<string>, callback: Callback<Array<AppAccountInfo>>): void

Subscribes to account information changes of apps.

NOTE

This API is supported since API version 7 and deprecated since API version 9. You are advised to use on('accountChange').

System capability: SystemCapability.Account.AppAccount

Parameters

Example

function changeOnCallback(data){
	console.debug("receive change data:" + JSON.stringify(data));
}
try{
	appAccountManager.on('change', ["com.example.actsaccounttest"], changeOnCallback);
}
catch(err){
	console.error("on accountOnOffDemo err:" + JSON.stringify(err));
}

off('change')^(deprecated)

off(type: 'change', callback?: Callback<Array<AppAccountInfo>>): void

Unsubscribes from account information changes.

NOTE

This API is supported since API version 7 and deprecated since API version 9. You are advised to use off('accountChange').

System capability: SystemCapability.Account.AppAccount

Parameters

Example

function changeOnCallback(data){
	console.debug("receive change data:" + JSON.stringify(data));
	appAccountManager.off('change', function(){
		console.debug("off finish");
	})
}
try{
	appAccountManager.on('change', ["com.example.actsaccounttest"], changeOnCallback);
}
catch(err){
	console.error("on accountOnOffDemo err:" + JSON.stringify(err));
}

authenticate^(deprecated)

authenticate(name: string, owner: string, authType: string, options: {[key: string]: any}, callback: AuthenticatorCallback): void

Authenticates an app account with customized options. This API uses an asynchronous callback to return the result.

NOTE

This API is supported since API version 8 and deprecated since API version 9. You are advised to use auth.

System capability: SystemCapability.Account.AppAccount

Parameters

Example

function onResultCallback(code, result) {
    console.log("resultCode: "  + code);
    console.log("result: "  + JSON.stringify(result));
}

function onRequestRedirectedCallback(request) {
  let wantInfo = {
    deviceId: '',
    bundleName: 'com.example.accountjsdemo',
    action: 'ohos.want.action.viewData',
    entities: ['entity.system.default'],
  }
  this.context.startAbility(wantInfo).then(() => {
    console.log("startAbility successfully");
  }).catch((err) => {
    console.log("startAbility err: " + JSON.stringify(err));
  })
}

appAccountManager.authenticate("LiSi", "com.example.accountjsdemo", "getSocialData", {}, {
  onResult: onResultCallback,
  onRequestRedirected: onRequestRedirectedCallback
});

getOAuthToken^(deprecated)

getOAuthToken(name: string, owner: string, authType: string, callback: AsyncCallback<string>): void

Obtains the authorization token of the specified authentication type for an app account. This API uses an asynchronous callback to return the result.

NOTE

This API is supported since API version 8 and deprecated since API version 9. You are advised to use getAuthToken.

System capability: SystemCapability.Account.AppAccount

Parameters

Example

appAccountManager.getOAuthToken("LiSi", "com.example.accountjsdemo", "getSocialData", (err, data) => {
     console.log('getOAuthToken err: ' + JSON.stringify(err));
     console.log('getOAuthToken token: ' + data);
});

getOAuthToken^(deprecated)

getOAuthToken(name: string, owner: string, authType: string): Promise<string>

Obtains the authorization token of the specified authentication type for an app account. This API uses a promise to return the result.

NOTE

This API is supported since API version 8 and deprecated since API version 9. You are advised to use getAuthToken.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Example

appAccountManager.getOAuthToken("LiSi", "com.example.accountjsdemo", "getSocialData").then((data) => {
     console.log('getOAuthToken token: ' + data);
}).catch((err) => {
    console.log("getOAuthToken err: "  + JSON.stringify(err));
});

setOAuthToken^(deprecated)

setOAuthToken(name: string, authType: string, token: string, callback: AsyncCallback<void>): void

Sets an authorization token of the specific authentication type for an app account. This API uses an asynchronous callback to return the result.

NOTE

This API is supported since API version 8 and deprecated since API version 9. You are advised to use setAuthToken.

System capability: SystemCapability.Account.AppAccount

Parameters

Example

appAccountManager.setOAuthToken("LiSi", "getSocialData", "xxxx", (err) => {
    console.log('setOAuthToken err: ' + JSON.stringify(err));
});

setOAuthToken^(deprecated)

setOAuthToken(name: string, authType: string, token: string): Promise<void>

Sets an authorization token of the specific authentication type for an app account. This API uses a promise to return the result.

NOTE

This API is supported since API version 8 and deprecated since API version 9. You are advised to use setAuthToken.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Example

appAccountManager.setOAuthToken("LiSi", "getSocialData", "xxxx").then(() => {
    console.log('setOAuthToken successfully');
}).catch((err) => {
    console.log('setOAuthToken err: ' + JSON.stringify(err));
});

deleteOAuthToken^(deprecated)

deleteOAuthToken(name: string, owner: string, authType: string, token: string, callback: AsyncCallback<void>): void

Deletes the authorization token of the specified authentication type for an app account. This API uses an asynchronous callback to return the result.

NOTE

This API is supported since API version 8 and deprecated since API version 9. You are advised to use deleteAuthToken.

System capability: SystemCapability.Account.AppAccount

Parameters

Example

appAccountManager.deleteOAuthToken("LiSi", "com.example.accountjsdemo", "getSocialData", "xxxxx", (err) => {
     console.log('deleteOAuthToken err: ' + JSON.stringify(err));
});

deleteOAuthToken^(deprecated)

deleteOAuthToken(name: string, owner: string, authType: string, token: string): Promise<void>

Deletes the authorization token of the specified authentication type for an app account. This API uses a promise to return the result.

NOTE

This API is supported since API version 8 and deprecated since API version 9. You are advised to use deleteAuthToken.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Example

appAccountManager.deleteOAuthToken("LiSi", "com.example.accountjsdemo", "getSocialData", "xxxxx").then(() => {
     console.log('deleteOAuthToken successfully');
}).catch((err) => {
    console.log("deleteOAuthToken err: "  + JSON.stringify(err));
});

setOAuthTokenVisibility^(deprecated)

setOAuthTokenVisibility(name: string, authType: string, bundleName: string, isVisible: boolean, callback: AsyncCallback<void>): void

Sets the visibility of an authorization token to an app. This API uses an asynchronous callback to return the result.

NOTE

This API is supported since API version 8 and deprecated since API version 9. You are advised to use setAuthTokenVisibility.

System capability: SystemCapability.Account.AppAccount

Parameters

Example

appAccountManager.setOAuthTokenVisibility("LiSi", "getSocialData", "com.example.accountjsdemo", true, (err) => {
     console.log('setOAuthTokenVisibility err: ' + JSON.stringify(err));
});

setOAuthTokenVisibility^(deprecated)

setOAuthTokenVisibility(name: string, authType: string, bundleName: string, isVisible: boolean): Promise<void>

Sets the visibility of an authorization token to an app. This API uses a promise to return the result.

NOTE

This API is supported since API version 8 and deprecated since API version 9. You are advised to use setAuthTokenVisibility.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Example

appAccountManager.setOAuthTokenVisibility("LiSi", "getSocialData", "com.example.accountjsdemo", true).then(() => {
    console.log('setOAuthTokenVisibility successfully');
}).catch((err) => {
    console.log('setOAuthTokenVisibility err: ' + JSON.stringify(err));
});

checkOAuthTokenVisibility^(deprecated)

checkOAuthTokenVisibility(name: string, authType: string, bundleName: string, callback: AsyncCallback<boolean>): void

Checks the visibility of an authorization token of the specified authentication type to an app. This API uses an asynchronous callback to return the result.

NOTE

This API is supported since API version 8 and deprecated since API version 9. You are advised to use checkAuthTokenVisibility.

System capability: SystemCapability.Account.AppAccount

Parameters

Example

appAccountManager.checkOAuthTokenVisibility("LiSi", "getSocialData", "com.example.accountjsdemo", (err, data) => {
    console.log('checkOAuthTokenVisibility err: ' + JSON.stringify(err));
    console.log('checkOAuthTokenVisibility isVisible: ' + data);
});

checkOAuthTokenVisibility^(deprecated)

checkOAuthTokenVisibility(name: string, authType: string, bundleName: string): Promise<boolean>

Checks the visibility of an authorization token of the specified authentication type to an app. This API uses a promise to return the result.

NOTE

This API is supported since API version 8 and deprecated since API version 9. You are advised to use checkAuthTokenVisibility.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Example

appAccountManager.checkOAuthTokenVisibility("LiSi", "getSocialData", "com.example.accountjsdemo").then((data) => {
    console.log('checkOAuthTokenVisibility isVisible: ' + data);
}).catch((err) => {
    console.log('checkOAuthTokenVisibility err: ' + JSON.stringify(err));
});

getAllOAuthTokens^(deprecated)

getAllOAuthTokens(name: string, owner: string, callback: AsyncCallback<Array<OAuthTokenInfo>>): void

Obtains all tokens visible to the invoker for an app account. This API uses an asynchronous callback to return the result.

NOTE

This API is supported since API version 8 and deprecated since API version 9. You are advised to use getAllAuthTokens.

System capability: SystemCapability.Account.AppAccount

Parameters

Example

appAccountManager.getAllOAuthTokens("LiSi", "com.example.accountjsdemo", (err, data) => {
    console.log("getAllOAuthTokens err: "  + JSON.stringify(err));
    console.log('getAllOAuthTokens data: ' + JSON.stringify(data));
});

getAllOAuthTokens^(deprecated)

getAllOAuthTokens(name: string, owner: string): Promise<Array<OAuthTokenInfo>>

Obtains all tokens visible to the invoker for an app account. This API uses a promise to return the result.

NOTE

This API is supported since API version 8 and deprecated since API version 9. You are advised to use getAllAuthTokens.

System capability: SystemCapability.Account.AppAccount

Parameters

Return value

Example

appAccountManager.getAllOAuthTokens("LiSi", "com.example.accountjsdemo").then((data) => {
    console.log('getAllOAuthTokens data: ' + JSON.stringify(data));
}).catch((err) => {
    console.log("getAllOAuthTokens err: "  + JSON.stringify(err));
});