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<ObjectException> receiver)

UpdateSignals API, hangi sinyallerin ekleneceğini açıklayan URI'dan bir JSON alır. veya kaldırın.

Devralınan yöntemler

Herkese açık yöntemler

get

public static ProtectedSignalsManager get (Context context)

ProtectedSignalsManager örneği oluşturmak için kullanılan fabrika yöntemi.

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

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

Güncelleme Sinyalleri

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

UpdateSignals API, hangi sinyallerin ekleneceğini açıklayan URI'dan bir JSON alır. veya kaldırın. Bu API, kodlayıcı uç noktasının kaydedilmesine de olanak tanır. Uç nokta, aşağıdakileri yapmak için kullanılır: sinyalleri kodlamayı sağlayan bir kodlama mantığı indirebilir.

JSON için üst düzey anahtarlar, şu 5 komuttan birine karşılık gelmelidir:

"put" - Aynı anahtarı kullanarak mevcut sinyallerin üzerine yazarak yeni bir sinyal ekler. Değer Bu, anahtarların yerleştirilecek anahtara karşılık gelen 64 temel dize olduğu bir JSON nesnesidir. değeri, eklenecek değere karşılık gelen 64 tabanlı dizedir.

"ekle" - Bir zaman serisine yeni bir sinyal/sinyal ekleyerek en eski sinyal/sinyalleri kaldırır sinyallerine de yer verir. Bunun değeri, anahtarların anahtarı eklenecek ve değerler, şu iki alanı olan nesnelerdir: "values" ve "maxSignals" , "değerler" zamana eklenecek sinyal değerlerine karşılık gelen 64 temel dizeden oluşan bir listedir seri. "maxSignals" (Maksimum Sinyaller) bu zaman serisinde izin verilen maksimum değer sayısıdır. Eğer anahtarla ilişkili mevcut sinyal sayısı, en eski sinyallerin maxSignals değerini aşıyor kaldırılacak. Sırayla eklenen bir anahtara ekleme yapabileceğinizi unutmayın. Şundan fazla değil: maksimum değer sayısı bir hataya neden olur.

"put_if_not_" - Yalnızca aynı tuşa sahiptir. Bunun değeri, anahtarların 64'e dayalı dizeler olduğu bir JSON nesnesidir. değerleri, kullanılacak anahtara karşılık gelen 64 koymanız gereken değeri ifade eder.

"kaldır" - Bir anahtarın sinyalini kaldırır. Bunun değeri, 64 tabanlı bir dize listesidir ilgili sinyallerin anahtarlarına karşılık gelir.

"kodlayıcıyı_güncelleme" - Uç noktayı güncellemek için bir işlem ve kullanılabilecek bir URI sağlar almanın başka yolları da var. Güncelleme işlemi sağlamanın alt anahtarı "işlem"dir. ve şu anda desteklenen değerler şunlardır:

  1. "KAYDOL" : İlk kez sağlanırsa kodlayıcı uç noktasını kaydeder veya yeni sağlanan uç nokta ile mevcut uç noktanın üzerine yazar. "Uç nokta"yı sağlama "REGISTER" için gereklidir eyleme dökülebilir.

Kodlayıcı uç noktası sağlamanın alt anahtarı "uç nokta"dır ve değer URI ile başlar.

Anahtar, JSON başına yalnızca bir komutla kullanılabilir. İki komut bir komutla aynı anahtara sahip değilse bu yöntem bir IllegalArgumentException

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. Sunucudan alınan JSON geçerli değil.
  2. Sağlanan URI geçersiz.

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