ProtectedSignalsManager

public class ProtectedSignalsManager
extends Object

java.lang.Object
→ Yönergeler	android.adservices.signals.ProtectedSignalsManager

ProtectedSignalsManager, uygulamaların korumalı sinyallerini yönetmesi için ad-SDK'lar ve uygulamalar için API'ler sağlar.

Özet

Herkese açık yöntemler
`static ProtectedSignalsManager`	`get(Context context)` ProtectedSignalsManager örneği oluşturma için fabrika yöntemi.
`void`	`updateSignals(UpdateSignalsRequest updateSignalsRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)` UpdateSignals API, hangi sinyallerin ekleneceğini veya kaldırılacağını açıklayan URI'den bir JSON 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

get

Android UpsideDownCakePrivacySandbox'a eklendi

public static ProtectedSignalsManager get (Context context)

ProtectedSignalsManager örneği oluşturma için fabrika yöntemi.

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

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

güncellemeSinyalleri

Android UpsideDownCakePrivacySandbox'a eklendi

public void updateSignals (UpdateSignalsRequest updateSignalsRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

UpdateSignals API, hangi sinyallerin ekleneceğini veya kaldırılacağını açıklayan URI'den bir JSON alır. Bu API, kodlayıcı uç noktasının kaydedilmesini de sağlar. Uç nokta, sinyallerin kodlanmasını sağlayan bir kodlama mantığı indirmek için kullanılır.

JSON öğesinin üst düzey anahtarları şu 5 komuttan birine karşılık gelmelidir:

"put": Aynı anahtara sahip tüm mevcut sinyallerin üzerine yazarak yeni bir sinyal ekler. Bunun değeri, anahtarların konacak anahtara karşılık gelen 64 tabanlı dizeler, değerlerin ise konacak değere karşılık gelen 64 tabanlı dizeler olduğu bir JSON nesnesidir.

"ekle": Bir zaman serisine yeni sinyal/sinyal ekler. Serinin boyutu belirtilen maksimum değeri aşarsa yenilerine yer açmak için en eski sinyalleri kaldırır. Bunun değeri, anahtarların eklenecek anahtara karşılık gelen 64 tabanlı dizeler ve değerlerin şu iki alanı olan nesneler olduğu bir JSON nesnesidir: "values" ve "maxSignals" . "values", zaman serisine eklenecek sinyal değerlerine karşılık gelen 64 tabanlı dizelerin listesidir. "maxSignals" bu zaman serisinde izin verilen maksimum değer sayısıdır. Anahtarla ilişkilendirilmiş mevcut sinyal sayısı maxSignals'ı aşarsa en eski sinyaller kaldırılır. Anahtara ekleme işlemi uygulayabileceğinizi unutmayın. Maksimum değer sayısından daha fazla değer eklemek hataya neden olmaz.

"put_if_not_present" - Yalnızca aynı anahtara sahip mevcut sinyal yoksa yeni sinyal ekler. Bunun değeri, anahtarların yerleştirilecek anahtara karşılık gelen 64 tabanlı dizeler, değerlerin ise konacak değere karşılık gelen 64 tabanlı dize olduğu bir JSON nesnesidir.

"remove" - Bir anahtarın sinyalini kaldırır. Bunun değeri, silinmesi gereken sinyal anahtarlarına karşılık gelen 64 tabanlı dizelerin bir listesidir.

"update_encoder" - Uç noktayı güncellemek için bir işlem ve kodlama mantığı almak için kullanılabilecek bir URI sağlar. Güncelleme işlemi sağlamanın alt anahtarı "action"dır. Şu anda desteklenen değerler şunlardır:

"REGISTER" : İlk kez sağlanmışsa kodlayıcı uç noktasını kaydeder veya yeni sağlanan uç noktayla mevcut olanın üzerine yazar. "REGISTER" işlemi için "uç nokta" sağlanması gereklidir.

Kodlayıcı uç noktası sağlamanın alt anahtarı "uç nokta"dır. Değer, uç noktanın URI dizesidir.

Anahtar, JSON başına yalnızca bir komutla çalıştırılabilir. İki komut aynı anahtar üzerinde çalışmaya çalışırsa bu yöntem bir IllegalArgumentException

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

Sunucudan alınan JSON geçerli değil.
Sağlanan URI geçersiz.

Ç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
`updateSignalsRequest`	`UpdateSignalsRequest`: 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.