xref: /aosp_15_r20/prebuilts/sdk/35/system/api/framework-adservices.txt (revision 344a7f5ef16c479e7a7f54ee6567a9d112f9e72b)
1*344a7f5eSAndroid Build Coastguard Worker// Signature format: 2.0
2*344a7f5eSAndroid Build Coastguard Workerpackage android.adservices.adid {
3*344a7f5eSAndroid Build Coastguard Worker
4*344a7f5eSAndroid Build Coastguard Worker  public abstract class AdIdProviderService extends android.app.Service {
5*344a7f5eSAndroid Build Coastguard Worker    ctor public AdIdProviderService();
6*344a7f5eSAndroid Build Coastguard Worker    method @Nullable public final android.os.IBinder onBind(@Nullable android.content.Intent);
7*344a7f5eSAndroid Build Coastguard Worker    method @NonNull public abstract android.adservices.adid.AdId onGetAdId(int, @NonNull String) throws java.io.IOException;
8*344a7f5eSAndroid Build Coastguard Worker    field public static final String SERVICE_INTERFACE = "android.adservices.adid.AdIdProviderService";
9*344a7f5eSAndroid Build Coastguard Worker  }
10*344a7f5eSAndroid Build Coastguard Worker
11*344a7f5eSAndroid Build Coastguard Worker}
12*344a7f5eSAndroid Build Coastguard Worker
13*344a7f5eSAndroid Build Coastguard Workerpackage android.adservices.appsetid {
14*344a7f5eSAndroid Build Coastguard Worker
15*344a7f5eSAndroid Build Coastguard Worker  public abstract class AppSetIdProviderService extends android.app.Service {
16*344a7f5eSAndroid Build Coastguard Worker    ctor public AppSetIdProviderService();
17*344a7f5eSAndroid Build Coastguard Worker    method @Nullable public final android.os.IBinder onBind(@Nullable android.content.Intent);
18*344a7f5eSAndroid Build Coastguard Worker    method @NonNull public abstract android.adservices.appsetid.AppSetId onGetAppSetId(int, @NonNull String) throws java.io.IOException;
19*344a7f5eSAndroid Build Coastguard Worker    field public static final String SERVICE_INTERFACE = "android.adservices.appsetid.AppSetIdProviderService";
20*344a7f5eSAndroid Build Coastguard Worker  }
21*344a7f5eSAndroid Build Coastguard Worker
22*344a7f5eSAndroid Build Coastguard Worker}
23*344a7f5eSAndroid Build Coastguard Worker
24*344a7f5eSAndroid Build Coastguard Workerpackage android.adservices.cobalt {
25*344a7f5eSAndroid Build Coastguard Worker
26*344a7f5eSAndroid Build Coastguard Worker  public abstract class AdServicesCobaltUploadService extends android.app.Service {
27*344a7f5eSAndroid Build Coastguard Worker    ctor public AdServicesCobaltUploadService();
28*344a7f5eSAndroid Build Coastguard Worker    method @Nullable public final android.os.IBinder onBind(@Nullable android.content.Intent);
29*344a7f5eSAndroid Build Coastguard Worker    method public abstract void onUploadEncryptedCobaltEnvelope(@NonNull android.adservices.cobalt.EncryptedCobaltEnvelopeParams);
30*344a7f5eSAndroid Build Coastguard Worker    field public static final String SERVICE_INTERFACE = "android.adservices.cobalt.AdServicesCobaltUploadService";
31*344a7f5eSAndroid Build Coastguard Worker  }
32*344a7f5eSAndroid Build Coastguard Worker
33*344a7f5eSAndroid Build Coastguard Worker  public final class EncryptedCobaltEnvelopeParams implements android.os.Parcelable {
34*344a7f5eSAndroid Build Coastguard Worker    ctor public EncryptedCobaltEnvelopeParams(int, @NonNull int, @NonNull byte[]);
35*344a7f5eSAndroid Build Coastguard Worker    method public int describeContents();
36*344a7f5eSAndroid Build Coastguard Worker    method @NonNull public byte[] getCipherText();
37*344a7f5eSAndroid Build Coastguard Worker    method @NonNull public int getEnvironment();
38*344a7f5eSAndroid Build Coastguard Worker    method @NonNull public int getKeyIndex();
39*344a7f5eSAndroid Build Coastguard Worker    method public void writeToParcel(@NonNull android.os.Parcel, int);
40*344a7f5eSAndroid Build Coastguard Worker    field @NonNull public static final android.os.Parcelable.Creator<android.adservices.cobalt.EncryptedCobaltEnvelopeParams> CREATOR;
41*344a7f5eSAndroid Build Coastguard Worker    field public static final int ENVIRONMENT_DEV = 1; // 0x1
42*344a7f5eSAndroid Build Coastguard Worker    field public static final int ENVIRONMENT_PROD = 0; // 0x0
43*344a7f5eSAndroid Build Coastguard Worker  }
44*344a7f5eSAndroid Build Coastguard Worker
45*344a7f5eSAndroid Build Coastguard Worker}
46*344a7f5eSAndroid Build Coastguard Worker
47*344a7f5eSAndroid Build Coastguard Workerpackage android.adservices.common {
48*344a7f5eSAndroid Build Coastguard Worker
49*344a7f5eSAndroid Build Coastguard Worker  public class AdServicesCommonManager {
50*344a7f5eSAndroid Build Coastguard Worker    method @RequiresPermission(anyOf={android.adservices.common.AdServicesPermissions.MODIFY_ADSERVICES_STATE, android.adservices.common.AdServicesPermissions.MODIFY_ADSERVICES_STATE_COMPAT}) public void enableAdServices(@NonNull android.adservices.common.AdServicesStates, @NonNull java.util.concurrent.Executor, @NonNull android.os.OutcomeReceiver<java.lang.Boolean,java.lang.Exception>);
51*344a7f5eSAndroid Build Coastguard Worker    method @RequiresPermission(anyOf={android.adservices.common.AdServicesPermissions.MODIFY_ADSERVICES_STATE, android.adservices.common.AdServicesPermissions.MODIFY_ADSERVICES_STATE_COMPAT}) public void enableAdServices(@NonNull android.adservices.common.AdServicesStates, @NonNull java.util.concurrent.Executor, @NonNull android.adservices.common.AdServicesOutcomeReceiver<java.lang.Boolean,java.lang.Exception>);
52*344a7f5eSAndroid Build Coastguard Worker    method @NonNull public static android.adservices.common.AdServicesCommonManager get(@NonNull android.content.Context);
53*344a7f5eSAndroid Build Coastguard Worker    method @RequiresPermission(anyOf={android.adservices.common.AdServicesPermissions.ACCESS_ADSERVICES_STATE, android.adservices.common.AdServicesPermissions.ACCESS_ADSERVICES_STATE_COMPAT}) public void isAdServicesEnabled(@NonNull java.util.concurrent.Executor, @NonNull android.os.OutcomeReceiver<java.lang.Boolean,java.lang.Exception>);
54*344a7f5eSAndroid Build Coastguard Worker    method @RequiresPermission(anyOf={android.adservices.common.AdServicesPermissions.ACCESS_ADSERVICES_STATE, android.adservices.common.AdServicesPermissions.ACCESS_ADSERVICES_STATE_COMPAT}) public void isAdServicesEnabled(@NonNull java.util.concurrent.Executor, @NonNull android.adservices.common.AdServicesOutcomeReceiver<java.lang.Boolean,java.lang.Exception>);
55*344a7f5eSAndroid Build Coastguard Worker    method @RequiresPermission(anyOf={android.adservices.common.AdServicesPermissions.MODIFY_ADSERVICES_STATE, android.adservices.common.AdServicesPermissions.MODIFY_ADSERVICES_STATE_COMPAT}) public void setAdServicesEnabled(boolean, boolean);
56*344a7f5eSAndroid Build Coastguard Worker    method @RequiresPermission(anyOf={android.adservices.common.AdServicesPermissions.UPDATE_PRIVILEGED_AD_ID, android.adservices.common.AdServicesPermissions.UPDATE_PRIVILEGED_AD_ID_COMPAT}) public void updateAdId(@NonNull android.adservices.common.UpdateAdIdRequest, @NonNull java.util.concurrent.Executor, @NonNull android.adservices.common.AdServicesOutcomeReceiver<java.lang.Boolean,java.lang.Exception>);
57*344a7f5eSAndroid Build Coastguard Worker    method @RequiresPermission(anyOf={android.adservices.common.AdServicesPermissions.UPDATE_PRIVILEGED_AD_ID, android.adservices.common.AdServicesPermissions.UPDATE_PRIVILEGED_AD_ID_COMPAT}) public void updateAdId(@NonNull android.adservices.common.UpdateAdIdRequest, @NonNull java.util.concurrent.Executor, @NonNull android.os.OutcomeReceiver<java.lang.Boolean,java.lang.Exception>);
58*344a7f5eSAndroid Build Coastguard Worker  }
59*344a7f5eSAndroid Build Coastguard Worker
60*344a7f5eSAndroid Build Coastguard Worker  public class AdServicesPermissions {
61*344a7f5eSAndroid Build Coastguard Worker    field public static final String ACCESS_ADSERVICES_STATE = "android.permission.ACCESS_ADSERVICES_STATE";
62*344a7f5eSAndroid Build Coastguard Worker    field public static final String ACCESS_ADSERVICES_STATE_COMPAT = "android.permission.ACCESS_ADSERVICES_STATE_COMPAT";
63*344a7f5eSAndroid Build Coastguard Worker    field public static final String ACCESS_PRIVILEGED_ADSERVICES_COBALT_UPLOAD = "android.permission.ACCESS_PRIVILEGED_AD_SERVICES_COBALT_UPLOAD";
64*344a7f5eSAndroid Build Coastguard Worker    field public static final String ACCESS_PRIVILEGED_AD_ID = "android.permission.ACCESS_PRIVILEGED_AD_ID";
65*344a7f5eSAndroid Build Coastguard Worker    field public static final String ACCESS_PRIVILEGED_APP_SET_ID = "android.permission.ACCESS_PRIVILEGED_APP_SET_ID";
66*344a7f5eSAndroid Build Coastguard Worker    field public static final String MODIFY_ADSERVICES_STATE = "android.permission.MODIFY_ADSERVICES_STATE";
67*344a7f5eSAndroid Build Coastguard Worker    field public static final String MODIFY_ADSERVICES_STATE_COMPAT = "android.permission.MODIFY_ADSERVICES_STATE_COMPAT";
68*344a7f5eSAndroid Build Coastguard Worker    field public static final String UPDATE_PRIVILEGED_AD_ID = "android.permission.UPDATE_PRIVILEGED_AD_ID";
69*344a7f5eSAndroid Build Coastguard Worker    field public static final String UPDATE_PRIVILEGED_AD_ID_COMPAT = "android.permission.UPDATE_PRIVILEGED_AD_ID_COMPAT";
70*344a7f5eSAndroid Build Coastguard Worker  }
71*344a7f5eSAndroid Build Coastguard Worker
72*344a7f5eSAndroid Build Coastguard Worker  public final class AdServicesStates implements android.os.Parcelable {
73*344a7f5eSAndroid Build Coastguard Worker    method public int describeContents();
74*344a7f5eSAndroid Build Coastguard Worker    method @NonNull public boolean isAdIdEnabled();
75*344a7f5eSAndroid Build Coastguard Worker    method @NonNull public boolean isAdultAccount();
76*344a7f5eSAndroid Build Coastguard Worker    method @NonNull public boolean isPrivacySandboxUiEnabled();
77*344a7f5eSAndroid Build Coastguard Worker    method @NonNull public boolean isPrivacySandboxUiRequest();
78*344a7f5eSAndroid Build Coastguard Worker    method @NonNull public boolean isU18Account();
79*344a7f5eSAndroid Build Coastguard Worker    method public void writeToParcel(@NonNull android.os.Parcel, int);
80*344a7f5eSAndroid Build Coastguard Worker    field @NonNull public static final android.os.Parcelable.Creator<android.adservices.common.AdServicesStates> CREATOR;
81*344a7f5eSAndroid Build Coastguard Worker  }
82*344a7f5eSAndroid Build Coastguard Worker
83*344a7f5eSAndroid Build Coastguard Worker  public static final class AdServicesStates.Builder {
84*344a7f5eSAndroid Build Coastguard Worker    ctor public AdServicesStates.Builder();
85*344a7f5eSAndroid Build Coastguard Worker    method @NonNull public android.adservices.common.AdServicesStates build();
86*344a7f5eSAndroid Build Coastguard Worker    method @NonNull public android.adservices.common.AdServicesStates.Builder setAdIdEnabled(boolean);
87*344a7f5eSAndroid Build Coastguard Worker    method @NonNull public android.adservices.common.AdServicesStates.Builder setAdultAccount(boolean);
88*344a7f5eSAndroid Build Coastguard Worker    method @NonNull public android.adservices.common.AdServicesStates.Builder setPrivacySandboxUiEnabled(boolean);
89*344a7f5eSAndroid Build Coastguard Worker    method @NonNull public android.adservices.common.AdServicesStates.Builder setPrivacySandboxUiRequest(boolean);
90*344a7f5eSAndroid Build Coastguard Worker    method @NonNull public android.adservices.common.AdServicesStates.Builder setU18Account(boolean);
91*344a7f5eSAndroid Build Coastguard Worker  }
92*344a7f5eSAndroid Build Coastguard Worker
93*344a7f5eSAndroid Build Coastguard Worker  public final class EnableAdServicesResponse implements android.os.Parcelable {
94*344a7f5eSAndroid Build Coastguard Worker    method public int describeContents();
95*344a7f5eSAndroid Build Coastguard Worker    method public boolean isApiEnabled();
96*344a7f5eSAndroid Build Coastguard Worker    method public boolean isSuccess();
97*344a7f5eSAndroid Build Coastguard Worker    method public void writeToParcel(@NonNull android.os.Parcel, int);
98*344a7f5eSAndroid Build Coastguard Worker    field @NonNull public static final android.os.Parcelable.Creator<android.adservices.common.EnableAdServicesResponse> CREATOR;
99*344a7f5eSAndroid Build Coastguard Worker  }
100*344a7f5eSAndroid Build Coastguard Worker
101*344a7f5eSAndroid Build Coastguard Worker  public final class UpdateAdIdRequest implements android.os.Parcelable {
102*344a7f5eSAndroid Build Coastguard Worker    method public int describeContents();
103*344a7f5eSAndroid Build Coastguard Worker    method @NonNull public String getAdId();
104*344a7f5eSAndroid Build Coastguard Worker    method public boolean isLimitAdTrackingEnabled();
105*344a7f5eSAndroid Build Coastguard Worker    method public void writeToParcel(@NonNull android.os.Parcel, int);
106*344a7f5eSAndroid Build Coastguard Worker    field @NonNull public static final android.os.Parcelable.Creator<android.adservices.common.UpdateAdIdRequest> CREATOR;
107*344a7f5eSAndroid Build Coastguard Worker  }
108*344a7f5eSAndroid Build Coastguard Worker
109*344a7f5eSAndroid Build Coastguard Worker  public static final class UpdateAdIdRequest.Builder {
110*344a7f5eSAndroid Build Coastguard Worker    ctor public UpdateAdIdRequest.Builder(@NonNull String);
111*344a7f5eSAndroid Build Coastguard Worker    method @NonNull public android.adservices.common.UpdateAdIdRequest build();
112*344a7f5eSAndroid Build Coastguard Worker    method @NonNull public android.adservices.common.UpdateAdIdRequest.Builder setLimitAdTrackingEnabled(boolean);
113*344a7f5eSAndroid Build Coastguard Worker  }
114*344a7f5eSAndroid Build Coastguard Worker
115*344a7f5eSAndroid Build Coastguard Worker}
116*344a7f5eSAndroid Build Coastguard Worker
117*344a7f5eSAndroid Build Coastguard Workerpackage android.adservices.extdata {
118*344a7f5eSAndroid Build Coastguard Worker
119*344a7f5eSAndroid Build Coastguard Worker  public final class AdServicesExtDataParams implements android.os.Parcelable {
120*344a7f5eSAndroid Build Coastguard Worker    ctor public AdServicesExtDataParams(int, int, int, int, int, long);
121*344a7f5eSAndroid Build Coastguard Worker    method public int describeContents();
122*344a7f5eSAndroid Build Coastguard Worker    method public int getIsAdultAccount();
123*344a7f5eSAndroid Build Coastguard Worker    method public int getIsMeasurementConsented();
124*344a7f5eSAndroid Build Coastguard Worker    method public int getIsNotificationDisplayed();
125*344a7f5eSAndroid Build Coastguard Worker    method public int getIsU18Account();
126*344a7f5eSAndroid Build Coastguard Worker    method public int getManualInteractionWithConsentStatus();
127*344a7f5eSAndroid Build Coastguard Worker    method public long getMeasurementRollbackApexVersion();
128*344a7f5eSAndroid Build Coastguard Worker    method public void writeToParcel(@NonNull android.os.Parcel, int);
129*344a7f5eSAndroid Build Coastguard Worker    field @NonNull public static final android.os.Parcelable.Creator<android.adservices.extdata.AdServicesExtDataParams> CREATOR;
130*344a7f5eSAndroid Build Coastguard Worker  }
131*344a7f5eSAndroid Build Coastguard Worker
132*344a7f5eSAndroid Build Coastguard Worker  public abstract class AdServicesExtDataStorageService extends android.app.Service {
133*344a7f5eSAndroid Build Coastguard Worker    ctor public AdServicesExtDataStorageService();
134*344a7f5eSAndroid Build Coastguard Worker    method @Nullable public final android.os.IBinder onBind(@Nullable android.content.Intent);
135*344a7f5eSAndroid Build Coastguard Worker    method @NonNull public abstract android.adservices.extdata.AdServicesExtDataParams onGetAdServicesExtData();
136*344a7f5eSAndroid Build Coastguard Worker    method public abstract void onPutAdServicesExtData(@NonNull android.adservices.extdata.AdServicesExtDataParams, @NonNull int[]);
137*344a7f5eSAndroid Build Coastguard Worker    field public static final int FIELD_IS_ADULT_ACCOUNT = 3; // 0x3
138*344a7f5eSAndroid Build Coastguard Worker    field public static final int FIELD_IS_MEASUREMENT_CONSENTED = 1; // 0x1
139*344a7f5eSAndroid Build Coastguard Worker    field public static final int FIELD_IS_NOTIFICATION_DISPLAYED = 0; // 0x0
140*344a7f5eSAndroid Build Coastguard Worker    field public static final int FIELD_IS_U18_ACCOUNT = 2; // 0x2
141*344a7f5eSAndroid Build Coastguard Worker    field public static final int FIELD_MANUAL_INTERACTION_WITH_CONSENT_STATUS = 4; // 0x4
142*344a7f5eSAndroid Build Coastguard Worker    field public static final int FIELD_MEASUREMENT_ROLLBACK_APEX_VERSION = 5; // 0x5
143*344a7f5eSAndroid Build Coastguard Worker    field public static final String SERVICE_INTERFACE = "android.adservices.extdata.AdServicesExtDataStorageService";
144*344a7f5eSAndroid Build Coastguard Worker  }
145*344a7f5eSAndroid Build Coastguard Worker
146*344a7f5eSAndroid Build Coastguard Worker}
147*344a7f5eSAndroid Build Coastguard Worker
148