ÖzelKitle Yöneticisi

public class CustomAudienceManager
extends Object

java.lang.Object
→ Yönergeler	android.adservices.customaudience.CustomAudienceManager

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

Özet

Herkese açık yöntemler
`void`	`fetchAndJoinCustomAudience(FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)` Kullanıcıyı bir `fetchUri` öğesinden getirilen `CustomAudience` öğesine ekler.
`static CustomAudienceManager`	`get(Context context)` CustomAudienceManager örneği oluşturmak için fabrika yöntemi.
`TestCustomAudienceManager`	`getTestCustomAudienceManager()` Testi etkinleştiren API'lerle hizmet oluşturma
`void`	`joinCustomAudience(JoinCustomAudienceRequest joinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)` Kullanıcıyı belirtilen `CustomAudience` öğesine ekler.
`void`	`leaveCustomAudience(LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)` `ownerPackageName`, `buyer` ve `name` ile tanımlanan mevcut `CustomAudience` verilerini silerek kullanıcıyı özel bir kitleden kaldırmaya çalışır.

Devralınan yöntemler


        
          java.lang.Object

sınıfından

`Object`	`clone()` Bu nesnenin bir kopyasını oluşturur ve döndürür.
`boolean`	`equals(Object obj)` Başka bir nesnenin buna "eşit" olup olmadığını gösterir.
`void`	`finalize()` Atık toplama, nesneye başka referans olmadığını belirlediğinde bir nesnede çöp toplayıcı tarafından çağrılır.
`final Class<?>`	`getClass()` Bu `Object` öğesinin çalışma zamanı sınıfını döndürür.
`int`	`hashCode()` Nesne için bir karma kod değeri döndürür.
`final void`	`notify()` Bu nesnenin monitörünü bekleyen tek bir iş parçacığını uyandırır.
`final void`	`notifyAll()` Bu nesnenin monitörünü bekleyen tüm ileti dizilerini uyandırır.
`String`	`toString()` Nesnenin dize temsilini döndürür.
`final void`	`wait(long timeoutMillis, int nanos)` Mevcut iş parçacığının, uyanana kadar (genellikle bildirimde bulunarak veya kesilerek ya da belirli bir süre geçene kadar) beklemesine neden olur.
`final void`	`wait(long timeoutMillis)` Mevcut iş parçacığının, uyanana kadar (genellikle bildirimde bulunarak veya kesilerek ya da belirli bir süre geçene kadar) beklemesine neden olur.
`final void`	`wait()` Geçerli iş parçacığının, genellikle bilgilendirilerek veya kesilerek uyandırılana kadar beklemesine neden olur.

Herkese açık yöntemler

getirmeAndKatılÖzelKitle

Android UpsideDownCakePrivacySandbox'a eklendi

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

Kullanıcıyı bir fetchUri öğesinden getirilen CustomAudience öğesine ekler.

Kullanıcıyı aynı ownerPackageName, buyer ve name kombinasyonuyla özel bir kitleye kaydetme girişimi, reklam verileri listesi de dahil olmak üzere mevcut özel kitle bilgilerinin üzerine yazılmasına neden olur.

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

Bu çağrı, aşağıdaki durumda bir SecurityException ile başarısız olur

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

Bu çağrı, aşağıdaki durumda bir IllegalArgumentException ile başarısız olur

çağrı yapan uygulama depolama alanı sınırını aşmış ve/veya
Belirtilen CustomAudience içindeki URI parametrelerinin kimliği CustomAudience alıcısıyla doğrulanmaz.

Çağrı paketi izin verilen hız sınırlarını aşarsa ve kısıtlanırsa bu çağrı LimitExceededException ile başarısız olur.

Dahili hizmet hatasıyla karşılaşılırsa bu çağrı IllegalStateException hatasıyla başarısız olur.
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, hangi iş parçacığının kullanıldığını kontrol etmek için kolay bir yol sağlayan bu `Executor` aracılığıyla gönderilir. Etkinlikleri uygulamanızın ana iş parçacığı üzerinden göndermek için `Context.getMainExecutor()` kullanabilirsiniz. Aksi takdirde, uygun iş parçacığına gönderim yapan bir `Executor` sağlayın.
`receiver`	`OutcomeReceiver`: Bu değer `null` olamaz.

get

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 6'ya da eklendi

public static CustomAudienceManager get (Context context)

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

Parametreler
`context`	`Context`: Kullanılacak `Context` değeri, `null` olamaz.

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

getTestÖzelKitle Yöneticisi

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 4'e de eklendi

public TestCustomAudienceManager getTestCustomAudienceManager ()

Testi etkinleştiren API'lerle hizmet oluşturma

İlerlemeler
`TestCustomAudienceManager`	Bu değer `null` olamaz.

katılÖzelKitle

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 4'e de eklendi

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

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

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

Bu çağrı, aşağıdaki durumda bir SecurityException ile başarısız olur

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

Bu çağrı, aşağıdaki durumda bir IllegalArgumentException ile başarısız olur

çağrı yapan uygulama depolama alanı sınırını aşmış ve/veya
Belirtilen CustomAudience içindeki URI parametrelerinin kimliği CustomAudience alıcısıyla doğrulanmaz.

Çağrı paketi izin verilen hız sınırlarını aşarsa ve kısıtlanırsa bu çağrı LimitExceededException ile başarısız olur.

Dahili hizmet hatasıyla karşılaşılırsa bu çağrı IllegalStateException hatasıyla başarısız olur.
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, hangi iş parçacığının kullanıldığını kontrol etmek için kolay bir yol sağlayan bu `Executor` aracılığıyla gönderilir. Etkinlikleri uygulamanızın ana iş parçacığı üzerinden göndermek için `Context.getMainExecutor()` kullanabilirsiniz. Aksi takdirde, uygun iş parçacığına gönderim yapan bir `Executor` sağlayın.
`receiver`	`OutcomeReceiver`: Bu değer `null` olamaz.

ayrılÖzelKitle

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 4'e de eklendi

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

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

Bu çağrı, aşağıdaki durumda bir SecurityException ile başarısız olur

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

Çağrı paketi izin verilen hız sınırlarını aşarsa ve kısıtlanırsa bu çağrı LimitExceededException ile başarısız olur.

Bu çağrı, arayana belirtilen özel kitlenin cihaz üzerindeki depolama alanında mevcut olup olmadığını bildirmez. Diğer bir deyişle, alıcı henüz katılmamış bir özel kitleden ayrılmaya çalıştığında bu işlem sessizce başarısız olur.
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, hangi iş parçacığının kullanıldığını kontrol etmek için kolay bir yol sağlayan bu `Executor` aracılığıyla gönderilir. Etkinlikleri uygulamanızın ana iş parçacığı üzerinden göndermek için `Context.getMainExecutor()` kullanabilirsiniz. Aksi takdirde, uygun iş parçacığına gönderim yapan bir `Executor` sağlayın.
`receiver`	`OutcomeReceiver`: Bu değer `null` olamaz.