アプリ メタデータ バンドルのスキーマ

Android 14 以降では、Android パッケージ インストーラで、 データ セーフティの方針などの、Android プラットフォーム機能 位置情報の利用許可に関する新しいプロンプトが表示されます。

このメタデータを指定する方法は 2 つあります。

  • システム イメージにプリロードされたアプリの場合、デバイス メーカーは以下を行うことができます。 XML ファイルをシステム イメージに追加して、アプリに関するメタデータを提供する 以下で説明する永続可能なバンドルを使用します。

  • インストールまたは更新中のアプリの場合、このメタデータを指定するには、アプリ インストーラは PersistableBundle オブジェクトを setAppMetadata() メソッドを使用します。

で確認できます。

トップレベルの永続型バンドルは、次の Key-Value ペアで構成されています。特に指定のない限り、各キーは省略可能です。

version（必須）
アプリのメタデータ形式のバージョン番号。このトレーニングの値として 2 を使用します。 タイプとして long を指定します。想定されるキーまたはコンテンツ タイプが AppMetadata を変更すると、Android によってバージョン番号が変更されます。
safety_labels
アプリの安全ラベルを指定する PersistableBundle オブジェクト。
system_app_safety_label
アプリの ID を指定する PersistableBundle オブジェクト system-app-safety-label。システム サービスとして機能するアプリの場合、 safety_labels バンドルの代わりに system_app_safety_label バンドルが使用されます。
transparency_info
アプリの透明度を指定する PersistableBundle オブジェクト。 をご覧ください。

セーフティ ラベルの形式

safety_labels バンドルには、次の Key-Value ペアが含まれています。

version（必須）
セーフティ ラベル形式のバージョン番号。このトレーニングの値として 1 を使用します。 現在のバージョンとタイプとして long を指定します。
data_labels
アプリが収集するデータを指定する PersistableBundle オブジェクト 共有します。
security_labels
アプリのデータの削除と削除を指定する PersistableBundle オブジェクト 暗号化のプラクティスを確認します。
third_party_verification
アプリのデータ セーフティを指定する方法を指定する PersistableBundle オブジェクト 第三者によって検証されている。

収集および共有されるデータ

data_labels バンドルには、次の Key-Value ペアが含まれています。

data_collected
アプリが処理するデータの種類を指定する PersistableBundle オブジェクト 収集します。
data_shared
アプリが共有するデータタイプを指定する PersistableBundle オブジェクト。

データのカテゴリ

data_collected キーと data_shared キーはどちらも data_category バンドル形式を使用します。この形式には、次のリストに示す Key-Value ペアが含まれています。各キーは、特定のカテゴリのデータタイプを指定する PersistableBundle オブジェクトにマッピングされます。

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

データ型

data_category バンドル内の各キーは、data_type 形式を使用する異なるバンドルにマッピングされます。data_type 形式で指定するキーは、data_category に対して選択したキーによって異なります。

data_type の考えられる Key-Value ペアを次のリストに示します。「 各キーの値は PersistableBundle オブジェクトで、 その特定のデータタイプに対するアプリのデータ使用方針。一部のデータ型は、キーを 1 つだけ使用します。

個人情報

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

金融情報

  • card_bank_account
  • purchase_history
  • credit_score
  • other

位置情報

  • approx_location
  • precise_location

メールとテキスト メッセージ

  • emails
  • text_messages
  • other

写真と動画

  • photos
  • videos

音声

  • sound_recordings
  • music_files
  • other

ストレージ

files_docs

健康、フィットネス

  • health
  • fitness

連絡先

contacts

カレンダー

calendar

ID

other

アプリのパフォーマンス

  • crash_logs
  • performance_diagnostics
  • other

アプリでのアクション

  • user_interaction
  • in_app_search_history
  • installed_apps
  • user_generated_content
  • other

検索とブラウジング

web_browsing_history

データ使用

data_usage バンドルには、次の Key-Value ペアが含まれています。

purposes（必須）

イベントを収集またはする特定の理由を表す整数の配列 データの共有と PersistableBundle の使用 <ph type="x-smartling-placeholder"></ph> putIntArray メソッドを呼び出します。それぞれに、以下に定義する目的のうち少なくとも 1 つが必要です。 あります。

  • 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

ブール値。ユーザーが以下をオプトインまたはオプトアウトできるかどうかを指定します 説明します。

注: この値は、データ収集を表す data_category バンドルにのみ設定します。データ共有には設定しないでください。

ephemeral

ブール値。アプリがデータを処理するかどうかを指定します ディスクではなくメモリでのみサーバーサイドにデータを保管し、データが保持すること 特定のデータ処理サービスを実行するために必要な リクエストできます。

注: この値は、 データ収集を表す data_category バンドル設定しない データ共有に使用できます。

データの削除と暗号化の方針

security_labels バンドルには、アプリのデータ削除と暗号化の方針を表す Key-Value ペアが含まれています。

is_data_deletable
ブール値。ユーザーがアプリでユーザーデータの削除をリクエストできるようにするかどうかを指定します。
is_data_encrypted
ブール値。アプリが収集するすべてのユーザーデータを、 暗号化されます。

サードパーティによる検証

third_party_verification バンドルは、単一のキー url で構成されています。この URL は、 文字列値として、サービス アカウントに使用するサードパーティの アプリのデータ セーフティ情報を確認する。

システム サービス セーフティ ラベルの形式

システム サービスとして機能するアプリの場合: system_app_safety_label バンドル safety_labels バンドルの代わりに使用され、次のものが含まれます。 Key-Value ペア:

url（必須）

  • システム サービスとして機能するアプリの安全性に関する情報が記載されたページを指す URL。
  • タイプとして string を使用します。
  • プライバシー ポリシーの URL を指定していない場合は、URL を 使用します。
  • 注: Google Play ストアでは、privacy_policy がフォールバックとして使用されます。

透明性情報の形式

transparency_info バンドルには、次の Key-Value ペアが含まれています。

developer_info
アプリに関する情報を指定する PersistableBundle オブジェクト。 デベロッパーです。
app_info
アプリに関する情報を指定する PersistableBundle オブジェクト。

デベロッパー情報

developer_info バンドルには、次の Key-Value ペアが含まれています。

developer_#
デベロッパーを識別する PersistableBundle オブジェクト。「 developer_info には 1 つ以上の developer_# が含まれます。 ここで、# は整数です。例: developer_0 developer_1、developer_2 など。

デベロッパー

developer_# バンドルには、次の Key-Value が含まれます。 ペア:

name（必須）
デベロッパーの名前を示す文字列。
email（必須）
デベロッパーのメールアドレスを示す文字列。
address（必須）
デベロッパーの送付先住所を示す文字列。
country_region（必須）
デベロッパーの国または地域を示す文字列。
website
デベロッパーのウェブサイトを示す文字列。

app_registry

  • デベロッパーのストアまたはレジストリを示す文字列。
  • デベロッパーがストアまたは別のレジストリにも登録されている場合、この値にはそのストアの Android パッケージ名、またはレジストリの URL を設定します。
  • 複数のストアの複数のエントリが許されます。
  • Google Play の場合は、com.android.vending を使用します。
  • デベロッパーが Google Play SDK Index に掲載されている SDK である場合は、この項目を省略してください。 属性です。
  • デベロッパーがアプリストアやレジストリに登録していない場合は、これを省略します。 属性です。

app_registry_id

  • 指定された app_registry のデベロッパーの ID を示す文字列。
  • デベロッパーがストアやその他のレジストリにも登録されている場合、 ストアまたはレジストリの ID である必要があります
  • 複数のストアの複数のエントリが許されます。
  • Google Play に登録されているデベロッパーの場合、この値には URL を指定する必要があります デベロッパー ページの https://play.google.com/store/apps/dev?id=5700313618786177705 は デベロッパーの URL（Google LLC））。
  • デベロッパーが、Google Play SDK Index に掲載されている SDK デベロッパーである場合は、SDK の Google Play SDK Index URL を使用します（例: https://play.google.com/sdks/details/com-google-android-gms-play-services-ads は Google Mobile Ads（GMA）SDK の Google Play SDK Index URL）。
  • デベロッパーが別のストアやレジストリに登録している場合は、アプリストア URL または他の識別子を指定できます。
  • デベロッパーがどのアプリストアにも登録されていない場合は、この属性を 省略されます。

アプリ情報

app_info バンドルには、次の Key-Value ペアが含まれています。

title（必須）
アプリのタイトルを示す文字列。
description（必須）
人間が読める形式のテキスト blob でアプリの目的を記述する文字列 表示されます。
contains_ads（必須）
アプリに広告を表示するかどうかを宣言するブール値。

privacy_policy（必須）

  • プライバシー ポリシーにリンクする URL 属性を含む文字列 ユーザーデータの取り扱いについて詳細に説明します。
  • ユーザーデータを送信するアプリに必須です。
  • アプリにこのリンクが含まれていない場合は、含まれていないものとみなされます。 使用する必要があります。
category（必須）

アプリの主な目的を最もよく表す、次のアプリカテゴリのいずれかを含む文字列。

  • Android（AOSP コンポーネントのみ）*
  • アート＆デザイン
  • 自動車＆乗り物
  • 美容
  • 書籍＆参考書
  • お店やサービス
  • コミック
  • 通信
  • 出会い
  • 教育
  • エンターテイメント
  • イベント
  • 金融
  • 食べ物と飲み物
  • ゲーム
  • 健康＆フィットネス
  • 住まい＆インテリア
  • インストーラ（アプリストアまたは他のインストーラのみ）*
  • ライブラリ＆デモ
  • ライフスタイル
  • 地図とナビ
  • 医療
  • 音楽とオーディオ
  • ニュース＆雑誌
  • 子育て、育児
  • パーソナライズ
  • 写真処理技術
  • 仕事効率化
  • セキュリティ*
  • ショッピング
  • ソーシャル
  • スポーツ
  • ツール
  • 旅行＆地域
  • アップデータ（デバイスのデフォルトの無線（OTA）アップデート アプリのみ）*
  • 動画プレーヤー、エディタ
  • 天気情報
で確認できます。
contact_info
連絡先情報の連絡先情報を含む PersistableBundle オブジェクト。 （下を参照）。

連絡先情報

contact_info バンドルには、次の Key-Value ペアが含まれています。

email（必須）
アプリのメールアドレスを指定する文字列。
website
アプリのウェブサイトを示す文字列。