Uygulama meta veri paketleri için şema

Android 14'ten itibaren Android paket yükleyici, güncellenmiş Konum izni istemi gibi Android platform özelliklerinde kullanmak üzere bir uygulamayla ilgili meta verileri (ör. veri güvenliği uygulamaları) alabilir.

Bu meta verileri iki şekilde sağlayabilirsiniz:

  • Cihaz üreticileri, sistem görüntüsüne önceden yüklenmiş bir uygulama için sistem görüntüsüne aşağıda açıklanan kalıcı paketi içeren bir XML dosyası ekleyerek uygulamayla ilgili meta veriler sağlayabilir.

  • Yüklenen veya güncellenen uygulamalarda bu meta veriyi belirtmek için uygulama yükleyiciler, setAppMetadata() yöntemine bir PersistableBundle nesnesi iletmelidir.

Üst düzey kalıcı paket, aşağıdaki anahtar/değer çiftlerinden oluşur. Aksi belirtilmedikçe her anahtar isteğe bağlıdır.

version (zorunlu)
Uygulama meta veri biçiminin sürüm numarası. Bu geçerli sürüm için değer olarak 2, tür olarak da long kullanın. AppMetadata işlevinin kullanılması beklenen anahtarlar veya içerik türleri değişirse Android sürüm numarasını değiştirir.
safety_labels
Uygulamanın güvenlik etiketlerini belirten bir PersistableBundle nesnesi.
system_app_safety_label
Uygulamanın system-app-safety-label'ını belirten bir PersistableBundle nesnesi. Sistem hizmeti işlevi gören uygulamalarda safety_labels paketinin yerine system_app_safety_label paketi kullanılır.
transparency_info
Uygulamanın şeffaflık bilgilerini belirten bir PersistableBundle nesnesi.

Güvenlik etiketleri biçimi

safety_labels paketi aşağıdaki anahtar/değer çiftlerini içerir:

version (zorunlu)
Güvenlik etiketleri biçiminin sürüm numarası. Bu geçerli sürüm için değer olarak 1, tür olarak da long kullanın.
data_labels
Uygulamanın topladığı ve paylaştığı verileri belirten bir PersistableBundle nesnesi.
security_labels
Uygulamanın veri silme ve şifreleme uygulamalarını belirten bir PersistableBundle nesnesi.
third_party_verification
Uygulamanın veri güvenliği uygulamalarının bir üçüncü taraf tarafından nasıl doğrulandığını belirten bir PersistableBundle nesnesi.

Toplanan ve paylaşılan veriler

data_labels paketi aşağıdaki anahtar/değer çiftlerini içerir:

data_collected
Uygulamanın topladığı veri türlerini belirten bir PersistableBundle nesnesi.
data_shared
Uygulamanın paylaştığı veri türlerini belirten bir PersistableBundle nesnesi.

Veri kategorileri

Hem data_collected hem de data_shared anahtarları, aşağıdaki listede gösterilen anahtar/değer çiftlerini içeren data_category paket biçimini kullanır. Her anahtar, belirli bir kategori için veri türlerini belirten bir PersistableBundle nesnesiyle eşlenir.

  • personal
  • financial
  • location
  • email_text_message
  • photo_video
  • audio
  • storage
  • health_fitness
  • contacts
  • calendar
  • identifiers
  • app_performance
  • actions_in_app
  • search_and_browsing

Veri türleri

data_category paketindeki her anahtar, data_type biçimini kullanan farklı bir paketle eşlenir. data_type biçiminde belirttiğiniz anahtarlar, data_category için ne seçtiğinize bağlıdır.

Olası data_type anahtar/değer çiftleri aşağıdaki listelerde yer alıyor. Bu anahtarların her birinin değeri, uygulamanın söz konusu veri türü için veri kullanımı uygulamalarını açıklayan bir PersistableBundle nesnesidir. Bazı veri türleri yalnızca bir anahtar kullanır.

Kişisel

  • name
  • email_address
  • physical_address
  • phone_number
  • race_ethnicity
  • political_or_religious_beliefs
  • sexual_orientation_or_gender_identity
  • personal_identifiers
  • other

Finansal

  • card_bank_account
  • purchase_history
  • credit_score
  • other

Konum

  • approx_location
  • precise_location

E-posta ve kısa mesajlar

  • emails
  • text_messages
  • other

Fotoğraflar ve videolar

  • photos
  • videos

Ses

  • sound_recordings
  • music_files
  • other

Depolama

files_docs

Sağlık fitness

  • health
  • fitness

Kişiler

contacts

Takvim

calendar

Tanımlayıcılar

other

Uygulama performansı

  • crash_logs
  • performance_diagnostics
  • other

Uygulama içi işlemler

  • user_interaction
  • in_app_search_history
  • installed_apps
  • user_generated_content
  • other

Arama ve göz atma

web_browsing_history

Veri kullanımı

data_usage paketi aşağıdaki anahtar/değer çiftlerini içerir:

purposes(zorunlu)

Verilerin toplanmasına veya paylaşılmasına ilişkin özel nedenleri temsil eden ve PersistableBundle putIntArray yöntemini kullanan bir tam sayı dizisi. Her paket için aşağıda tanımlanan amaçlardan en az biri gereklidir.

  • 1: PURPOSE_APP_FUNCTIONALITY
  • 2: PURPOSE_ANALYTICS
  • 3: PURPOSE_DEVELOPER_COMMUNICATIONS
  • 4: PURPOSE_FRAUD_PREVENTION_SECURITY
  • 5: PURPOSE_ADVERTISING
  • 6: PURPOSE_PERSONALIZATION
  • 7: PURPOSE_ACCOUNT_MANAGEMENT
is_collection_optional

Boole değeri. Kullanıcıların veri toplamayı etkinleştirip devre dışı bırakabileceğini belirtir.

Not: Bu değeri yalnızca veri toplamayı temsil eden data_category paketleri için ayarlayın. Veri paylaşımı için ayarlamayın.

ephemeral

Boole değeri. Uygulamanın, verileri sunucu tarafında yalnızca bellekte işleyip işlemediğini ve uygulamanın, verileri belirli bir veri işleme isteğini yerine getirmek için gereken süre boyunca sakladığını belirtir.

Not: Bu değeri yalnızca veri toplamayı temsil eden data_category paketleri için ayarlayın. Veri paylaşımı için ayarlamayın.

Veri silme ve şifreleme uygulamaları

security_labels paketi, uygulamanın veri silme ve şifreleme yöntemlerini temsil eden anahtar/değer çiftleri içerir:

is_data_deletable
Boole değeri. Uygulamanın, kullanıcının kendi verilerini silmesini istemesine izin verip vermediğini belirtir.
is_data_encrypted
Boole değeri. Uygulama tarafından toplanan tüm kullanıcı verilerinin aktarım sırasında şifrelenip şifrelenmediğini belirtir.

Üçüncü taraf doğrulama

third_party_verification paketi tek bir anahtardan (url) oluşur. Dize değeri olarak gösterilen bu URL, uygulamanın veri güvenliği bilgilerini doğrulamak için kullanılan üçüncü taraf web sitesini belirtir.

Sistem hizmet güvenliği etiketleri biçimi

Sistem hizmeti işlevi gören uygulamalarda safety_labels paketinin yerine system_app_safety_label paketi kullanılır ve aşağıdaki anahtar/değer çiftlerini içerir:

url (zorunlu)

  • Sistem hizmeti olarak işlev gören uygulamanın güvenlik bilgilerinin bulunduğu bir sayfaya yönlendiren URL.
  • Tür olarak string kullanın.
  • Bu sağlanmamışsa yedek olarak gizlilik politikası URL'si kullanılmalıdır.
  • Not: Google Play Store, privacy_policy yedeğini kullanır.

Şeffaflık bilgisi biçimi

transparency_info paketi aşağıdaki anahtar/değer çiftlerini içerir:

developer_info
Uygulama geliştiriciyle ilgili bilgileri belirten bir PersistableBundle nesnesi.
app_info
Uygulamayla ilgili bilgileri belirten bir PersistableBundle nesnesi.

Geliştirici bilgileri

developer_info paketi aşağıdaki anahtar/değer çiftlerini içerir:

developer_#
Geliştiriciyi tanımlayan bir PersistableBundle nesnesi. developer_info bir veya daha fazla developer_# içerir. Burada #, bir tam sayıdır. Örneğin developer_0, developer_1, developer_2 vb.

Geliştirici

developer_# paketi aşağıdaki anahtar/değer çiftlerini içerir:

name (zorunlu)
Geliştiricinin adını belirten bir dize.
email (zorunlu)
Geliştiricinin e-posta adresini belirten bir dize.
address (zorunlu)
Geliştiricinin posta adresini belirten bir dize.
country_region (zorunlu)
Geliştiricinin ülkesini veya bölgesini belirten bir dize.
website
Geliştiricinin web sitesini belirten bir dize.

app_registry

  • Geliştiricinin mağazasını veya kayıt otoritesini belirten bir dize.
  • Geliştirici bir mağazada veya başka bir kayıt otoritesinde de kayıtlıysa değer, mağazanın Android paket adı veya kayıt otoritesinin URL'si olmalıdır.
  • Birden fazla mağaza için birden çok girişe izin verilir.
  • Google Play için com.android.vending kullanın.
  • Geliştirici, Google Play SDK Index'te listelenen bir SDK ise bu özelliği çıkarın.
  • Geliştirici herhangi bir uygulama mağazası veya kayıt defterinde kayıtlı değilse bu özelliği çıkarın.

app_registry_id

  • Belirtilen app_registry için geliştiricinin kimliğini belirten bir dize.
  • Geliştirici aynı zamanda bir mağazada veya başka bir kayıt otoritesinde de kayıtlıysa değer, mağaza veya kayıt otoritesi kimliği olmalıdır.
  • Birden fazla mağaza için birden çok girişe izin verilir.
  • Google Play'e kayıtlı geliştiriciler için bu değer, geliştirici sayfasının URL'si olmalıdır (örneğin, https://play.google.com/store/apps/dev?id=5700313618786177705, Google LLC geliştiricisinin URL'sidir).
  • Geliştirici, Google Play SDK Index'te listelenen bir SDK geliştiricisiyse SDK'nın Google Play SDK Index URL'sini kullanın (ör. https://play.google.com/sdks/details/com-google-android-gms-play-services-ads, Google Mobile Ads (GMA) SDK'sının Google Play SDK Index URL'sidir).
  • Geliştirici başka bir mağaza veya kayıt defterinde kayıtlıysa bir uygulama mağazası URL'si ya da başka bir tanımlayıcı sağlanabilir.
  • Bir geliştirici herhangi bir uygulama mağazasına kayıtlı değilse bu özellik atlanabilir.

Uygulama bilgisi

app_info paketi aşağıdaki anahtar/değer çiftlerini içerir:

title (zorunlu)
Uygulamanın başlığını belirten bir dize.
description (zorunlu)
Uygulamanın amacını, İngilizce dilinde kullanıcıların okuyabileceği bir metin blobunda belirten bir dize.
contains_ads (zorunlu)
Uygulamanın reklam gösterip göstermediğini belirten boole değeridir.

privacy_policy (zorunlu)

  • Kullanıcı verilerinin nasıl işlendiğini ayrıntılı şekilde açıklayan gizlilik politikasına bağlantı veren bir URL özelliği içeren dize.
  • Kullanıcı verisi ileten uygulamalar için gereklidir.
  • Uygulama bu bağlantıyı içermiyorsa uygulamanın kullanıcı verilerini işlemediği varsayılır.
category (zorunlu)

Uygulamanın birincil amacını en iyi açıklayan aşağıdaki uygulama kategorilerinden birini içeren bir dize:

  • Android (yalnızca bir AOSP bileşeni için)*
  • Sanat ve tasarım
  • Arabalar ve araçlar
  • Güzellik
  • Kitaplar ve referans
  • İş
  • Çizgi Romanlar
  • İletişim
  • Flört
  • Eğitim
  • Eğlence
  • Etkinlikler
  • Finans
  • Gıda ve içecek
  • Oyun
  • Sağlık ve fitness
  • Ev ve dekorasyon
  • Yükleyici (yalnızca bir uygulama mağazası veya başka bir yükleyici için)*
  • Kitaplıklar ve kısa demolar
  • Yaşam tarzı
  • Haritalar ve rota izleme
  • Tıp
  • Müzik ve ses
  • Haberler ve dergiler
  • Ebeveynlik
  • Kişiselleştirme
  • Fotoğrafçılık
  • Üretkenlik
  • Güvenlik*
  • Alışveriş
  • Sosyal
  • Spor
  • Araçlar
  • Seyahat ve yerel bilgiler
  • Güncelleyici (yalnızca cihazın varsayılan kablosuz (OTA) güncelleme uygulaması için)*
  • Video oynatıcılar ve düzenleyiciler
  • Hava durumu
contact_info
Uygulamanın iletişim bilgilerini içeren bir PersistableBundle nesnesi (aşağıda).

İletişim bilgileri

contact_info paketi aşağıdaki anahtar/değer çiftlerini içerir:

email (zorunlu)
Uygulamanın e-posta adresini belirten bir dize.
website
Uygulamanın web sitesini belirten bir dize.