ProtectedSignalsManager

public class ProtectedSignalsManager
extends Object

java.lang.Object
↳	android.adservices.signals.ProtectedSignalsManager

ProtectedSignalsManager, korumalı sinyallerini yönetmek için uygulamalar ve reklam SDK'ları için API'ler sağlar.

Özet

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

Devralınan yöntemler

Kaynak:


        
          java.lang.Object

`Object`	`clone()` Bu nesnenin bir kopyasını oluşturur ve döndürür.
`boolean`	`equals(Object obj)` Başka bir nesnenin bu nesneye "eşit" olup olmadığını belirtir.
`void`	`finalize()` Atık toplama, nesneye başka referans olmadığını belirlediğinde bir nesne üzerinde çö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 izleyicisinde bekleyen tek bir iş parçacığı uyandırır.
`final void`	`notifyAll()` Bu nesnenin monitöründe bekleyen tüm iş parçacıklarını 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, genellikle bildirim veya kesinti almasıyla ya da belirli bir gerçek zaman geçmesi sonucunda uyandırılana kadar beklemesine neden olur.
`final void`	`wait(long timeoutMillis)` Mevcut iş parçacığının, genellikle bildirim veya kesinti almasıyla ya da belirli bir gerçek zaman geçmesi sonucunda uyandırılana kadar beklemesine neden olur.
`final void`	`wait()` Mevcut iş parçacığının, genellikle bildirim veya kesinti almasıyla 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şturmaya yönelik fabrika yöntemi.

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

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

updateSignals

Android UpsideDownCakePrivacySandbox'a eklendi

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

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

JSON'un üst düzey anahtarları 5 komuttan birine karşılık gelmelidir:

"put": Aynı anahtara sahip mevcut sinyallerin üzerine yazarak yeni bir sinyal ekler. Bunun değeri, anahtarların yerleştirilecek anahtara karşılık gelen base64 dizeleri ve değerlerin yerleştirilecek değere karşılık gelen base64 dizeleri olduğu bir JSON nesnesi olacaktır.

"Ekle": Bir zaman serisine yeni bir sinyal/sinyal ekler. Seri boyutu, belirtilen maksimum değeri aşarsa yenilerine yer açmak için en eski sinyaller kaldırılır. Bu parametrenin değeri, anahtarların eklenecek anahtara karşılık gelen base64 dizelerinin ve değerlerin "values" ve "maxSignals" olmak üzere iki alana sahip nesnelerin bulunduğu bir JSON nesnesi şeklindedir. "values", zaman serisine eklenecek sinyal değerlerine karşılık gelen Base64 dizelerinin listesidir. "maxSignals", bu zaman serisinde izin verilen maksimum değer sayısıdır. Anahtarla ilişkili mevcut sinyal sayısı maxSignals'ı aşarsa en eski sinyaller kaldırılır. put ile eklenen bir anahtara ekleme yapabileceğinizi unutmayın. Ancak maksimum değer sayısından fazla değer eklemek hataya neden olmaz.

"put_if_not_present": Yalnızca aynı anahtara sahip mevcut sinyal yoksa yeni bir sinyal ekler. Bunun değeri, anahtarların yerleştirilecek anahtara karşılık gelen base64 dizeleri ve değerlerin yerleştirilecek değere karşılık gelen base64 dizeleri olduğu bir JSON nesnesi olmalıdır.

"remove": Bir anahtarın sinyalini kaldırır. Bu değerin değeri, silinmesi gereken sinyallerin anahtarlarına karşılık gelen base64 dizelerinin listesidir.

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

"REGISTER" : İlk kez sağlanırsa kodlayıcı uç noktasını kaydeder veya yeni sağlanan uç noktayı mevcut uç noktanın üzerine yazar. "REGISTER" işlemi için "uç nokta" sağlanmalıdır.

Kodlayıcı uç noktası sağlamanın alt anahtarı "endpoint", değer ise uç noktanın URI dizesidir.

Anahtar üzerinde JSON başına yalnızca bir komut çalıştırılabilir. İki komut aynı anahtarda işlem yapmaya çalışırsa bu yöntem bir IllegalArgumentException

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

ownerPackageName, uygulamanın paket adını çağırmıyor ve/veya
Alıcı, API'yi kullanma yetkisine sahip değilse.

Aşağıdaki durumlarda bu çağrı IllegalArgumentException hatasıyla başarısız olur:

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

Arama paketi izin verilen hız sınırlarını aşıyorsa ve hız sınırlandırılıyorsa bu arama LimitExceededException hatasıyla başarısız olur.

Dahili bir hizmet hatasıyla karşılaşılırsa bu çağrı IllegalStateException ile 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 arama ve dinleyici etkinlikleri bu `Executor` üzerinden dağıtılır. Böylece, hangi iş parçacığının kullanılacağını kolayca kontrol edebilirsiniz. Etkinlikleri uygulamanızın ana iş akışı üzerinden dağıtmak için `Context.getMainExecutor()` kullanabilirsiniz. Aksi takdirde, uygun bir ileti dizisine yönlendiren bir `Executor` sağlayın.
`receiver`	`OutcomeReceiver`: Bu değer `null` olamaz.