در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4
خلاصه: روش ها | روش های ارثی

CustomAudienceManager

public class CustomAudienceManager
extends Object

java.lang.object
↳ android.adservices.customaudience.CustomAudienceManager

CustomAudienceManager API هایی را برای برنامه ها و ad-SDK ها برای پیوستن یا ترک مخاطبان سفارشی فراهم می کند.

خلاصه

روش های عمومی

void fetchAndJoinCustomAudience ( FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver < Object , Exception > receiver)

کاربر را به CustomAudience واکشی شده از fetchUri اضافه می کند.

static CustomAudienceManager get ( Context context)

روش کارخانه برای ایجاد یک نمونه از CustomAudienceManager.

TestCustomAudienceManager getTestCustomAudienceManager ()

یک سرویس با API های فعال کننده تست ایجاد کنید

void joinCustomAudience ( JoinCustomAudienceRequest joinCustomAudienceRequest, Executor executor, OutcomeReceiver < Object , Exception > receiver)

کاربر را به CustomAudience داده شده اضافه می کند.

void leaveCustomAudience ( LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver < Object , Exception > receiver)

تلاش برای حذف کاربر از یک مخاطب سفارشی با حذف هر گونه داده CustomAudience موجود، شناسایی شده توسط ownerPackageName ، buyer ، و name .

روش های ارثی

روش های عمومی

fetchAndJoinCustomAudience

public void fetchAndJoinCustomAudience (FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

کاربر را به CustomAudience واکشی شده از fetchUri اضافه می کند.

تلاش برای ثبت نام کاربر برای یک مخاطب سفارشی با همان ترکیب ownerPackageName ، buyer ، و name باعث می‌شود اطلاعات مخاطبان سفارشی موجود، از جمله فهرست داده‌های تبلیغات، بازنویسی شود.

توجه داشته باشید که لیست تبلیغات را می توان به طور کامل توسط کار واکشی پس زمینه روزانه بازنویسی کرد.

این تماس با یک SecurityException اگر

  1. ownerPackageName با نام بسته برنامه و/یا تماس نمی‌گیرد
  2. خریدار مجاز به استفاده از API نیست.

این فراخوانی با یک IllegalArgumentException اگر

  1. برنامه تماس و/یا از محدودیت فضای ذخیره سازی فراتر رفته است
  2. هیچ یک از پارامترهای URI در CustomAudience ارائه شده با خریدار CustomAudience احراز هویت نمی شود.

این تماس با LimitExceededException ناموفق است اگر بسته تماس از حد مجاز نرخ مجاز فراتر رود و throttle شود.

اگر با خطای سرویس داخلی مواجه شود، این تماس با یک IllegalStateException ناموفق است.
به AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE نیاز دارد.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

پارامترها
fetchAndJoinCustomAudienceRequest FetchAndJoinCustomAudienceRequest : این مقدار نمی تواند null باشد.

executor Executor : این مقدار نمی تواند null باشد. رویدادهای پاسخ به تماس و شنونده از طریق این Executor ارسال می‌شوند و راهی آسان برای کنترل رشته مورد استفاده ارائه می‌دهند. برای ارسال رویدادها از طریق رشته اصلی برنامه خود، می توانید از Context.getMainExecutor() استفاده کنید. در غیر این صورت، یک Executor ارائه دهید که به یک موضوع مناسب ارسال می کند.

receiver OutcomeReceiver : این مقدار نمی تواند null باشد.

دریافت کنید

در سطح API 34 اضافه شد
همچنین در برنامه های افزودنی Ad Services 6 
public static CustomAudienceManager get (Context context)

روش کارخانه برای ایجاد یک نمونه از CustomAudienceManager.

پارامترها
context Context : Context استفاده این مقدار نمی تواند null باشد.

برمی گرداند
CustomAudienceManager یک نمونه CustomAudienceManager این مقدار نمی تواند null باشد.

getTestCustomAudienceManager

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4 
public TestCustomAudienceManager getTestCustomAudienceManager ()

یک سرویس با API های فعال کننده تست ایجاد کنید

برمی گرداند
TestCustomAudienceManager این مقدار نمی تواند null باشد.

به CustomAudience بپیوندید

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4 
public void joinCustomAudience (JoinCustomAudienceRequest joinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

کاربر را به CustomAudience داده شده اضافه می کند.

تلاش برای ثبت نام کاربر برای یک مخاطب سفارشی با همان ترکیب ownerPackageName ، buyer ، و name باعث می‌شود اطلاعات مخاطبان سفارشی موجود، از جمله فهرست داده‌های تبلیغات، بازنویسی شود.

توجه داشته باشید که لیست تبلیغات را می توان به طور کامل توسط کار واکشی پس زمینه روزانه بازنویسی کرد.

این تماس با یک SecurityException اگر

  1. ownerPackageName با نام بسته برنامه و/یا تماس نمی‌گیرد
  2. خریدار مجاز به استفاده از API نیست.

این فراخوانی با یک IllegalArgumentException اگر

  1. برنامه تماس و/یا از محدودیت فضای ذخیره سازی فراتر رفته است
  2. هیچ یک از پارامترهای URI در CustomAudience ارائه شده با خریدار CustomAudience احراز هویت نمی شود.

این تماس با LimitExceededException ناموفق است اگر بسته تماس از حد مجاز نرخ مجاز فراتر رود و throttle شود.

اگر با خطای سرویس داخلی مواجه شود، این تماس با یک IllegalStateException ناموفق است.
به AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE نیاز دارد.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

پارامترها
joinCustomAudienceRequest JoinCustomAudienceRequest : این مقدار نمی تواند null باشد.

executor Executor : این مقدار نمی تواند null باشد. رویدادهای پاسخ به تماس و شنونده از طریق این Executor ارسال می‌شوند و راهی آسان برای کنترل رشته مورد استفاده ارائه می‌دهند. برای ارسال رویدادها از طریق رشته اصلی برنامه خود، می توانید از Context.getMainExecutor() استفاده کنید. در غیر این صورت، یک Executor ارائه دهید که به یک موضوع مناسب ارسال می کند.

receiver OutcomeReceiver : این مقدار نمی تواند null باشد.

ترک CustomAudience

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4 
public void leaveCustomAudience (LeaveCustomAudienceRequest leaveCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

تلاش برای حذف کاربر از یک مخاطب سفارشی با حذف هر گونه داده CustomAudience موجود، شناسایی شده توسط ownerPackageName ، buyer ، و name .

این تماس با یک SecurityException اگر

  1. ownerPackageName با نام بسته برنامه تماس نمی گیرد. و/یا
  2. خریدار مجاز به استفاده از API نیست.

این تماس با LimitExceededException ناموفق است اگر بسته تماس از حد مجاز نرخ مجاز فراتر رود و throttle شود.

این تماس به تماس‌گیرنده اطلاع نمی‌دهد که آیا مخاطب سفارشی مشخص‌شده در فضای ذخیره‌سازی دستگاه وجود داشته است یا خیر. به عبارت دیگر، زمانی که خریدار سعی می کند مخاطب سفارشی را ترک کند که به آن ملحق نشده است، بی سر و صدا شکست خواهد خورد.
به AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE نیاز دارد.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

پارامترها
leaveCustomAudienceRequest LeaveCustomAudienceRequest : این مقدار نمی تواند null باشد.

executor Executor : این مقدار نمی تواند null باشد. رویدادهای پاسخ به تماس و شنونده از طریق این Executor ارسال می‌شوند و راهی آسان برای کنترل رشته مورد استفاده ارائه می‌دهند. برای ارسال رویدادها از طریق رشته اصلی برنامه خود، می توانید از Context.getMainExecutor() استفاده کنید. در غیر این صورت، یک Executor ارائه دهید که به یک موضوع مناسب ارسال می کند.

receiver OutcomeReceiver : این مقدار نمی تواند null باشد.