@ohos.identifier.oaid (广告标识服务)

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

说明： 本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 使用获取开放匿名设备标识符接口，需申请相关权限：ohos.permission.APP_TRACKING_CONSENT

导入模块

import identifier from '@ohos.identifier.oaid';

identifier.getOAID

getOAID(): Promise<string>

获取开放匿名设备标识符（Open Anonymous Device Identifier, OAID），使用Promise异步返回。

需要权限： ohos.permission.APP_TRACKING_CONSENT

系统能力： SystemCapability.Advertising.OAID

返回值：

错误码：

以下错误码的详细介绍请参见广告标识服务错误码参考。

示例：

import identifier from '@ohos.identifier.oaid';
import hilog from '@ohos.hilog'; 
import { BusinessError } from '@ohos.base';
 
try {  
  identifier.getOAID().then((data) => {
    const oaid: string = data;
    hilog.info(0x0000, 'testTag', '%{public}s', `get oaid by promise success, oaid: ${oaid}`);
  }).catch((err: BusinessError) => {
    hilog.info(0x0000, 'testTag', '%{public}s', `get oaid by promise failed, code: ${err.code}, message: ${err.message}`);
  })
} catch (err) {
  hilog.error(0x0000, 'testTag', '%{public}s', `get oaid by promise catch error: ${err.code} ${err.message}`);
}

identifier.getOAID

getOAID(callback: AsyncCallback<string>): void

获取开放匿名设备标识符（Open Anonymous Device Identifier, OAID），使用callback异步回调。

需要权限： ohos.permission.APP_TRACKING_CONSENT

系统能力： SystemCapability.Advertising.OAID

参数：

错误码：

以下错误码的详细介绍请参见广告标识服务错误码参考。

示例：

import identifier from '@ohos.identifier.oaid';
import hilog from '@ohos.hilog'; 
import { BusinessError } from '@ohos.base';
 
try {
  identifier.getOAID((err: BusinessError, data: string) => {
    if (err.code) {
      hilog.error(0x0000, 'testTag', '%{public}s', `get oaid by callback failed, error: ${err.code} ${err.message}`);
    } else {
      const oaid: string = data;
      hilog.info(0x0000, 'testTag', '%{public}s', 'get oaid by callback success');
    }
   });
} catch (err) {
  hilog.error(0x0000, 'testTag', '%{public}s', `get oaid by callback catch error: ${err.code} ${err.message}`);
}

identifier.resetOAID

resetOAID(): void

重置开放匿名设备标识符（Open Anonymous Device Identifier, OAID）。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Advertising.OAID

错误码：

以下错误码的详细介绍请参见广告标识服务错误码参考。

示例：

import identifier from '@ohos.identifier.oaid';
import hilog from '@ohos.hilog'; 

try {
  identifier.resetOAID();
} catch (err) {
  hilog.error(0x0000, 'testTag', '%{public}s', `reset oaid catch error: ${err.code} ${err.message}`);
}