ÖzelKitle Yöneticisi

public class CustomAudienceManager
extends Object

java.lang.Object
🎃 android.adservices.customaudience.CustomAudienceManager


CustomAudienceManager, özel kitlelere katılmak veya özel kitlelerden ayrılmak için uygulama ve reklam SDK'ları için API'ler sağlar.

Özet

Herkese açık yöntemler

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

Kullanıcıyı, fetchUri kaynağından getirilen CustomAudience içine ekler.

static CustomAudienceManager get(Context context)

CustomAudienceManager örneği oluşturmak için fabrika yöntemi.

TestCustomAudienceManager getTestCustomAudienceManager()

Test etkinleştiren API'lerle hizmet oluşturma

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

Kullanıcıyı belirtilen CustomAudience öğesine ekler.

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

ownerPackageName, buyer ve name tarafından tanımlanan mevcut CustomAudience verilerini silerek kullanıcıyı özel kitleden kaldırmaya çalışır.

Devralınan yöntemler

Herkese açık yöntemler

getirmeVeyaBirÖzelKitle

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

Kullanıcıyı, fetchUri kaynağından getirilen CustomAudience içine ekler.

Kullanıcının aynı ownerPackageName, buyer ve name kombinasyonuna sahip özel bir kitle için kaydedilmesi girişimi, mevcut özel kitlenin reklam verileri listesi de dahil olmak üzere üzerine yazılacak bilgiler

Günlük arka plan getirme işi, reklam listesinin tamamen üzerine yazılabilir.

Bu çağrı, şu durumlarda SecurityException ile başarısız olur:

  1. ownerPackageName, uygulamanın paket adını çağırmıyor ve/veya
  2. Alıcının API'yi kullanma yetkisi yok.

Bu çağrı, şu durumlarda IllegalArgumentException ile başarısız olur:

  1. çağrı uygulaması tarafından depolama alanı sınırı aşıldığından ve/veya
  2. belirtilen CustomAudience içindeki herhangi bir URI parametrelerinin kimliği CustomAudience alıcı.

Çağrı paketiLimitExceededException hız sınırı uygulanır ve kısıtlanır.

Dahili hizmet hatası varsa bu çağrı, IllegalStateException ile başarısız olur. karşılaşılır.
. AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE gerektirir

Parametreler
fetchAndJoinCustomAudienceRequest FetchAndJoinCustomAudienceRequest: Bu değer null olamaz.

executor Executor: Bu değer null olamaz. Geri çağırma ve işleyici etkinlikleri bu Executor kullanılır. Etkinlikleri oluşturmak için Context.getMainExecutor() Aksi takdirde, uygun bir ileti dizisine yönlendiren bir Executor sağlayın.

receiver OutcomeReceiver: Bu değer null olamaz.

get

API düzeyi 34'e eklendi
Ayrıca Ad Services Extensions 6'da da
public static CustomAudienceManager get (Context context)

CustomAudienceManager örneği oluşturmak için fabrika yöntemi.

Parametreler
context Context: Kullanılacak Context Bu değer null olamaz.

İlerlemeler
CustomAudienceManager CustomAudienceManager örneği Bu değer null olamaz.

getTestCustomAudienceManager

API düzeyi 34'e eklendi
Ayrıca Ad Services Extensions 4'e de eklendi
public TestCustomAudienceManager getTestCustomAudienceManager ()

Test etkinleştiren API'lerle hizmet oluşturma

İlerlemeler
TestCustomAudienceManager Bu değer null olamaz.

ortakÖzelKitle

API düzeyi 34'e eklendi
Ayrıca Ad Services Extensions 4'e de eklendi
public void joinCustomAudience (JoinCustomAudienceRequest joinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

Kullanıcıyı belirtilen CustomAudience öğesine ekler.

Kullanıcının aynı ownerPackageName, buyer ve name kombinasyonuna sahip özel bir kitle için kaydedilmesi girişimi, mevcut özel kitlenin reklam verileri listesi de dahil olmak üzere üzerine yazılacak bilgiler

Günlük arka plan getirme işi, reklam listesinin tamamen üzerine yazılabilir.

Bu çağrı, şu durumlarda SecurityException ile başarısız olur:

  1. ownerPackageName, uygulamanın paket adını çağırmıyor ve/veya
  2. Alıcının API'yi kullanma yetkisi yok.

Bu çağrı, şu durumlarda IllegalArgumentException ile başarısız olur:

  1. çağrı uygulaması tarafından depolama alanı sınırı aşıldığından ve/veya
  2. belirtilen CustomAudience içindeki herhangi bir URI parametrelerinin kimliği CustomAudience alıcı.

Çağrı paketiLimitExceededException hız sınırı uygulanır ve kısıtlanır.

Dahili hizmet hatası varsa bu çağrı, IllegalStateException ile başarısız olur. karşılaşılır.
. AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE gerektirir

Parametreler
joinCustomAudienceRequest JoinCustomAudienceRequest: Bu değer null olamaz.

executor Executor: Bu değer null olamaz. Geri çağırma ve işleyici etkinlikleri bu Executor kullanılır. Etkinlikleri oluşturmak için Context.getMainExecutor() Aksi takdirde, uygun bir ileti dizisine yönlendiren bir Executor sağlayın.

receiver OutcomeReceiver: Bu değer null olamaz.

Özel Kitleden ayrıl

API düzeyi 34'e eklendi
Ayrıca Ad Services Extensions 4'e de eklendi
public void leaveCustomAudience (LeaveCustomAudienceRequest leaveCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

ownerPackageName, buyer ve name tarafından tanımlanan mevcut CustomAudience verilerini silerek kullanıcıyı özel kitleden kaldırmaya çalışır.

Bu çağrı, şu durumlarda SecurityException ile başarısız olur:

  1. ownerPackageName, uygulamanın paket adını çağırmıyor; ve/veya
  2. Alıcının API'yi kullanma yetkisi yok.

Çağrı paketiLimitExceededException hız sınırı uygulanır ve kısıtlanır.

Bu çağrı, arayana belirtilen özel kitlenin burada bulunup bulunmadığını bildirmez cihaz üzerinde depolama. Diğer bir deyişle, bir alıcı bir web sitesinden özel kitle.
. AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE gerektirir

Parametreler
leaveCustomAudienceRequest LeaveCustomAudienceRequest: Bu değer null olamaz.

executor Executor: Bu değer null olamaz. Geri çağırma ve işleyici etkinlikleri bu Executor kullanılır. Etkinlikleri oluşturmak için Context.getMainExecutor() Aksi takdirde, uygun bir ileti dizisine yönlendiren bir Executor sağlayın.

receiver OutcomeReceiver: Bu değer null olamaz.