このページは Cloud Translation API によって翻訳されました。

chrome.privacy

説明

chrome.privacy API を使用すると、ユーザーのプライバシーに影響する可能性がある Chrome の機能の使用を管理できます。この API は、Chrome の設定を取得して設定するために、タイプ API の ChromeSetting プロトタイプを使用します。

権限

privacy

API を使用するには、拡張機能のマニフェストで「プライバシー」権限を申告する必要があります。次に例を示します。

{
  "name": "My extension",
  ...
  "permissions": [
    "privacy"
  ],
  ...
}

コンセプトと使用方法

Chrome の設定の現在の値は簡単に確認できます。まず目的のプロパティを見つけてから、そのオブジェクトの get() を呼び出して、現在の値と拡張機能の制御レベルを取得します。たとえば、Chrome のクレジットカードの自動入力機能が有効になっているかどうかを確認するには、次のように記述します。

chrome.privacy.services.autofillCreditCardEnabled.get({}, function(details) {
  if (details.value) {
    console.log('Autofill is on!');
  } else {
    console.log('Autofill is off!');
  }
});

まず、拡張機能が設定を制御できることを確認する必要があるため、設定の値の変更は少し複雑になります。エンタープライズポリシーによって特定の値にロックされている設定（levelOfControl が「not_controllable」に設定）または別の拡張機能で値が制御されている場合（levelOfControl が「controlled_by_other_extensions」に設定）を拡張機能が切り替えた場合、ユーザーには設定は変更されません。set() の呼び出しは成功しますが、設定はすぐにオーバーライドされます。混乱を招く可能性があるため、ユーザーが選択した設定が実際に適用されない場合は、ユーザーに警告することをおすすめします。

注: 拡張機能が ChromeSetting を制御する機能について詳しくは、chrome.types.ChromeSetting をご覧ください。

つまり、get() メソッドを使用してアクセスレベルを確認し、拡張機能が設定を制御できる場合にのみ set() を呼び出す必要があります（実際、拡張機能が設定を制御できない場合は、ユーザーの混乱を軽減するために、視覚的に機能を無効にすることをおすすめします）。

chrome.privacy.services.autofillCreditCardEnabled.get({}, function(details) {
  if (details.levelOfControl === 'controllable_by_this_extension') {
    chrome.privacy.services.autofillCreditCardEnabled.set({ value: true }, function() {
      if (chrome.runtime.lastError === undefined) {
        console.log("Hooray, it worked!");
      } else {
        console.log("Sadness!", chrome.runtime.lastError);
      }
    });
  }
});

設定値の変更に興味がある場合は、その onChange イベントにリスナーを追加します。たとえば、最近インストールした拡張機能が設定の制御を取得した場合や、企業ポリシーによって制御がオーバーライドされた場合に、ユーザーに警告できます。たとえば、クレジットカードの自動入力ステータスの変更をリッスンするには、次のコードで十分です。

chrome.privacy.services.autofillCreditCardEnabled.onChange.addListener(
  function (details) {
    // The new value is stored in `details.value`, the new level of control
    // in `details.levelOfControl`, and `details.incognitoSpecific` will be
    // `true` if the value is specific to Incognito mode.
  }
);

例

この API を試すには、chrome-extension-samples リポジトリからプライバシー API の例をインストールしてください。

型

IPHandlingPolicy

Chrome 48 以降

WebRTC の IP 取り扱いポリシー。

列挙型

"default"

"default_public_and_private_interfaces"

"default_public_interface_only"

"disable_non_proxied_udp"

プロパティ

network

Chrome によるネットワーク接続全般の処理に影響する設定です。

タイプ

オブジェクト

プロパティ

networkPredictionEnabled

types.ChromeSetting<boolean>

有効にすると、Chrome は DNS エントリを事前に解決し、サーバーへの TCP 接続と SSL 接続を予防的に開けることで、ウェブブラウジングの高速化を試みます。この設定は、Chrome の内部予測サービスで実行される操作にのみ影響します。ウェブページから開始された事前接続や事前接続には影響しません。この設定の値はブール値で、デフォルトは true です。
webRTCIPHandlingPolicy

types.ChromeSetting<IPHandlingPolicy>

Chrome 48 以降

WebRTC トラフィックのルーティング方法やローカルアドレス情報の公開量に影響を与えるメディアのパフォーマンスとプライバシーのトレードオフをユーザーが指定できるようにします。この設定の値は IPHandlingPolicy 型で、デフォルトは default です。

services

Google とデフォルトの検索プロバイダが提供するサードパーティのネットワークサービスを必要とする機能を有効または無効にする設定です。

タイプ

オブジェクト

プロパティ

alternateErrorPagesEnabled

types.ChromeSetting<boolean>

有効にすると、Chrome はウェブサービスを使用してナビゲーションエラーを解決します。この設定の値はブール値で、デフォルトは true です。
autofillAddressEnabled

types.ChromeSetting<boolean>

Chrome 70 以降

有効にすると、住所やその他のフォームデータを自動入力できるようになります。この設定の値はブール値で、デフォルトは true です。
autofillCreditCardEnabled

types.ChromeSetting<boolean>

Chrome 70 以降

有効にすると、Chrome でクレジットカードフォームに自動入力できます。この設定の値はブール値で、デフォルトは true です。
autofillEnabled

types.ChromeSetting<boolean>

Chrome 70 以降でサポートが終了

privacy.services.autofillAddressEnabled と privacy.services.autofillCreditCardEnabled を使用してください。これは、このリリースでの下位互換性を確保するために残されており、将来削除される予定です。
有効にすると、Chrome でフォームに自動入力できるようになります。この設定の値はブール値で、デフォルトは true です。
passwordSavingEnabled

types.ChromeSetting<boolean>

有効にすると、パスワードを保存するかどうかを尋ねるメッセージがパスワードマネージャーに表示されます。この設定の値はブール値で、デフォルトは true です。
safeBrowsingEnabled

types.ChromeSetting<boolean>

有効にすると、Chrome はフィッシングやマルウェアからユーザーを保護するために最善を尽くします。この設定の値はブール値で、デフォルトは true です。
safeBrowsingExtendedReportingEnabled

types.ChromeSetting<boolean>

有効にすると、セーフブラウジングでページがブロックされたときに、ブロックされたページのコンテンツなど、追加情報が Chrome から Google に送信されます。この設定の値はブール値で、デフォルトは false です。
searchSuggestEnabled

types.ChromeSetting<boolean>

有効にすると、Chrome ではアドレスバーに入力したテキストがデフォルトの検索エンジンに送信されます。検索エンジンでは、これまでに入力した内容に一致するウェブサイトや検索キーワードの候補が表示されます。この設定の値はブール値で、デフォルトは true です。
spellingServiceEnabled

types.ChromeSetting<boolean>

有効にすると、Chrome はウェブサービスを使用してスペルミスを修正します。この設定の値はブール値で、デフォルトは false です。
translationServiceEnabled

types.ChromeSetting<boolean>

有効にすると、母国語以外のページの翻訳が表示されます。この設定の値はブール値で、デフォルトは true です。

websites

Chrome でウェブサイトで利用できる情報を指定する設定です。

タイプ

オブジェクト

プロパティ

adMeasurementEnabled

types.ChromeSetting<boolean>

Chrome 111 以降

無効にすると、Attribution Reporting API と Private Aggregation API が無効になります。この設定の値はブール値型で、デフォルト値は true です。拡張機能は、値を false に設定することでのみ、これらの API を無効にできます。これらの API を true に設定しようとすると、エラーがスローされます。
doNotTrackEnabled

types.ChromeSetting<boolean>

Chrome 65 以降

有効にすると、Chrome はリクエストとともに「トラッキング拒否」（DNT: 1）ヘッダーを送信します。この設定の値はブール値型で、デフォルト値は false です。
fledgeEnabled

types.ChromeSetting<boolean>

Chrome 111 以降

無効にすると、Fledge API は無効になります。この設定の値はブール値型で、デフォルト値は true です。拡張機能でこの API を無効にするには、値を false に設定します。この API を true に設定しようとすると、エラーがスローされます。
hyperlinkAuditingEnabled

types.ChromeSetting<boolean>

有効にすると、ウェブサイト（<a ping>）からリクエストされたときに監査 ping が送信されます。この設定の値はブール値型で、デフォルト値は true です。
protectedContentEnabled

types.ChromeSetting<boolean>

Windows と ChromeOS でのみ利用可能: 有効にすると、保護されたコンテンツを実行するために、Chrome でプラグインに一意の ID が割り当てられます。この設定の値はブール値型で、デフォルト値は true です。
referrersEnabled

types.ChromeSetting<boolean>

有効にすると、Chrome はリクエストとともに referer ヘッダーを送信します。はい。この設定の名前は、スペルミスのヘッダーと一致しません。いいえ、変更しません。この設定の値はブール値型で、デフォルト値は true です。
relatedWebsiteSetsEnabled

types.ChromeSetting<boolean>

Chrome 121 以降

無効にすると、関連ウェブサイトセットは無効になります。この設定の値はブール値型で、デフォルト値は true です。拡張機能でこの API を無効にするには、値を false に設定します。この API を true に設定しようとすると、エラーがスローされます。
thirdPartyCookiesAllowed

types.ChromeSetting<boolean>

無効にすると、サードパーティサイトは Cookie を設定できなくなります。この設定の値はブール値型で、デフォルト値は true です。
topicsEnabled

types.ChromeSetting<boolean>

Chrome 111 以降

無効にすると、Topics API が無効になります。この設定の値はブール値型で、デフォルト値は true です。拡張機能でこの API を無効にするには、値を false に設定します。この API を true に設定しようとすると、エラーがスローされます。