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, 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<Object, Exception> 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:
- "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:
ownerPackageName
, uygulamanın paket adını çağırmıyor ve/veya- Alıcının API'yi kullanma yetkisi yok.
Bu çağrı, şu durumlarda IllegalArgumentException
ile başarısız olur:
- Sunucudan alınan JSON geçerli değil.
- 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. |