本模块提供开放匿名设备标识符（Open Anonymous Device Identifier, OAID，以下简称OAID）的获取和重置能力。

说明

本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

使用获取开放匿名设备标识符接口，需[向用户申请授权](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/request-user-authorization)（默认开启权限）：ohos.permission.APP\_TRACKING\_CONSENT。

## 导入模块

PhonePC/2in1TabletTV



```
1. import { identifier } from '@kit.AdsKit';
```

## identifier.getOAID

PhonePC/2in1TabletTV

getOAID(): Promise<string>

获取开放匿名设备标识符（OAID）。使用Promise异步回调。

**需要权限：** ohos.permission.APP\_TRACKING\_CONSENT

**系统能力：** SystemCapability.Advertising.OAID

**返回值：**

展开

| 类型 | 说明 |
| --- | --- |
| Promise<string> | Promise对象，返回开放匿名设备标识符（OAID）。  1.如应用已配置ohos.permission.APP\_TRACKING\_CONSENT权限，且“跨应用关联访问权限”为“允许”，则返回OAID。  2.如应用已配置ohos.permission.APP\_TRACKING\_CONSENT权限，且“跨应用关联访问权限”为“禁止”，则返回00000000-0000-0000-0000-000000000000。  3.如应用未配置ohos.permission.APP\_TRACKING\_CONSENT权限，则返回00000000-0000-0000-0000-000000000000。 |

说明

设置项“跨应用关联访问权限”在HarmonyOS NEXT Developer Beta5及更早版本名称为“应用跟踪访问权限”。

**错误码：**

以下错误码的详细介绍请参见[开放匿名设备标识服务错误码参考](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-oaid)。

展开

| 错误码ID | 错误信息 |
| --- | --- |
| 17300001 | System internal error. |

**示例：**



```
1. import { identifier } from '@kit.AdsKit';
2. import { BusinessError } from '@kit.BasicServicesKit';
3. import { hilog } from '@kit.PerformanceAnalysisKit';

5. void identifier.getOAID().then((data: string) => {
6. const oaid: string = data;
7. }).catch((error: BusinessError) => {
8. hilog.error(0x0000, 'testTag', `Failed to get oaid. Code is ${error.code}, message is ${error.message}`);
9. });
```

## identifier.getOAID

PhonePC/2in1TabletTV

getOAID(callback: AsyncCallback<string>): void

获取开放匿名设备标识符（OAID）。使用callback异步回调。

**需要权限：** ohos.permission.APP\_TRACKING\_CONSENT

**系统能力：** SystemCapability.Advertising.OAID

**参数：**

展开

| **参数**名 | **类型** | 必填 | 说明 |
| --- | --- | --- | --- |
| callback | AsyncCallback<string> | 是 | 回调函数，返回开放匿名设备标识符（OAID）。  1.如应用已配置ohos.permission.APP\_TRACKING\_CONSENT权限，且“跨应用关联访问权限”为“允许”，则返回OAID。  2.如应用已配置ohos.permission.APP\_TRACKING\_CONSENT权限，且“跨应用关联访问权限”为“禁止”，则返回00000000-0000-0000-0000-000000000000。  3.如应用未配置ohos.permission.APP\_TRACKING\_CONSENT权限，则返回00000000-0000-0000-0000-000000000000。 |

说明

设置项“跨应用关联访问权限”在HarmonyOS NEXT Developer Beta5及更早版本名称为“应用跟踪访问权限”。

**错误码：**

以下错误码的详细介绍请参见[开放匿名设备标识服务错误码参考](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-oaid)。

展开

| 错误码ID | 错误信息 |
| --- | --- |
| 17300001 | System internal error. |

**示例：**



```
1. import { identifier } from '@kit.AdsKit';
2. import { BusinessError } from '@kit.BasicServicesKit';

4. identifier.getOAID((err: BusinessError, data: string) => {
5. if (err.code) {
6. return;
7. }
8. const oaid: string = data;
9. });
```