• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.identifier.oaid (广告标识服务)(系统接口)
2
3本模块提供开放匿名设备标识符（Open Anonymous Device Identifier, OAID，以下简称OAID）的获取和重置能力。
4
5> **说明：**<br/>
6> 本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。<br/>
7> 使用获取开放匿名设备标识符接口，需[向用户申请授权](../../security/AccessToken/request-user-authorization.md)：ohos.permission.APP_TRACKING_CONSENT。<br/>
8> 当前页面仅包含本模块的系统接口，其他公开接口参见[@ohos.identifier.oaid (广告标识服务)](js-apis-oaid.md)。
9
10## 导入模块
11
12```ts
13import { identifier } from '@kit.AdsKit';
14```
15
16## identifier.resetOAID
17
18resetOAID(): void
19
20重置开放匿名设备标识符（Open Anonymous Device Identifier, OAID）。
21
22**系统接口：** 此接口为系统接口。
23
24**系统能力：** SystemCapability.Advertising.OAID
25
26**错误码：**
27
28以下错误码的详细介绍请参见[广告标识服务错误码参考](errorcode-oaid.md)。
29
30| 错误码ID | 错误信息                                                                     |
31|----------|------------------------------------------------------------------------------|
32| 202      | Permission verification failed. A non-system application calls a system API. |
33| 17300001 | System internal error.                                                       |
34| 17300002 | Not in the trust list.                                                       |
35
36**示例：**
37
38```ts
39import { identifier } from '@kit.AdsKit';
40import { hilog } from '@kit.PerformanceAnalysisKit';
41
42try {
43  identifier.resetOAID();
44} catch (err) {
45  hilog.error(0x0000, 'testTag', `Fail to reset OAID. Code is ${err.code}, message is ${err.message}`);
46}
47```