xref: /docs/en/application-dev/reference/apis-ads-kit/js-apis-oaid-sys.md (revision e41f4b71)

# @ohos.identifier.oaid (OAID) (System API)


The **OAID** module provides APIs for obtaining and resetting Open Anonymous Device Identifiers (OAIDs).


> **NOTE**
>
> The initial APIs of this module are supported since API version 10. Newly added APIs will be marked with a superscript to indicate their earliest API version.
>
> To use the APIs for obtaining OAIDs, you must [request the ohos.permission.APP_TRACKING_CONSENT permission](../../security/AccessToken/request-user-authorization.md).
> This topic describes only system APIs provided by the module. For details about its public APIs, see [@ohos.identifier.oaid (OAID)](js-apis-oaid.md).


## Modules to Import

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

## identifier.resetOAID

resetOAID(): void

Resets an OAID.

**System API**: This is a system API.

**System capability**: SystemCapability.Advertising.OAID

**Error codes**

For details about the following error codes, see [OAID Error Codes](errorcode-oaid.md).

| ID | Error Message | 
| -------- | -------- |
| 202      | Permission verification failed. A non-system application calls a system API. |
| 17300001 | System internal error. |
| 17300002 | Not in the trust list. | 

**Example**
```
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}`);
}
```