chrome.syncFileSystem

説明

chrome.syncFileSystem API を使用して、Google ドライブにデータを保存し、同期します。この API は、Google ドライブに保存されている任意のユーザー ドキュメントにアクセスするためのものではありません。オフラインとキャッシュ保存の使用のためにアプリ固有の同期可能なストレージを提供し、同じデータをさまざまなクライアントで利用できるようにします。この API の使用方法については、データを管理するをご覧ください。

権限

syncFileSystem

型

ConflictResolutionPolicy

列挙型

"last_write_win"

"manual"

FileInfo

プロパティ

  • アクション

    SyncAction 省略可

    onFileStatusChanged イベントを発生させるために実行された同期アクション。アクション値は、'added'、'updated'、'deleted' のいずれかです。ステータスが 'synced' の場合にのみ適用されます。

  • direction

    SyncDirection 省略可

    onFileStatusChanged イベントの同期方向。同期方向の値は 'local_to_remote' または 'remote_to_local' です。ステータスが 'synced' の場合にのみ適用されます。

  • fileEntry

    エントリ

    ステータスが変更されたターゲット ファイルの fileEntry。同期されたファイルの名前とパスの情報が含まれます。ファイルを削除しても、fileEntry 情報は引き続き利用できますが、ファイルは存在しなくなります。

  • ステータス

    FileStatus

    onFileStatusChanged イベント後のファイル ステータス。ステータス値は 'synced'、'pending'、'conflicting' のいずれかになります。

FileStatus

列挙型

「同期済み」
競合がなく、ローカルの変更が保留されていない。

「pending」
同期されていない保留中のローカル変更が 1 つ以上あります。

「conflicting」
ファイルがリモート バージョンと競合しているため、手動で解決する必要があります。

FileStatusInfo

プロパティ

  • エラー

    文字列 省略可

    指定されたファイルの FileStatus の取得中に問題が発生した場合にのみ返されるオプションのエラー。

  • fileEntry

    エントリ

    getFileStatuses に最初に指定された Entry のいずれか。

  • ステータス

    FileStatus

    ステータス値は 'synced'、'pending'、'conflicting' のいずれかになります。

ServiceInfo

プロパティ

ServiceStatus

列挙型

「初期化中」
同期サービスが初期化されています（データベースからのデータの復元、接続の確認、サービスへの認証など）。

「running」
同期サービスが稼働しています。

"authentication_required"
続行するにはリモート サービスをユーザーが認証する必要があるため、同期サービスがファイルを同期していません。

「temporary_unavailable」
リモート サービスが（一時的に）利用できないため、同期サービスはファイルを同期していません。これは、ネットワークがオフラインである、リモート サービスがダウンしている、リモート サービスにアクセスできないなど、復元可能なエラーが原因です。詳細については、OnServiceInfoUpdated の description パラメータで確認してください（サービス固有の詳細が含まれている可能性があります）。

「disabled」
同期サービスが無効になっており、コンテンツは同期されません。（たとえば、ユーザーがリモート サービスにアカウントを持っていない場合や、同期サービスで回復不能なエラーが発生した場合に、このエラーが発生することがあります）。

StorageInfo

プロパティ

  • quotaBytes

    数値

  • usageBytes

    数値

SyncAction

列挙型

"added"

"updated"

"deleted"

SyncDirection

列挙型

"local_to_remote"

"remote_to_local"

メソッド

getConflictResolutionPolicy()

Promise 
chrome.syncFileSystem.getConflictResolutionPolicy(
  callback?: function,
): Promise<ConflictResolutionPolicy>

現在の競合解決ポリシーを取得します。

パラメータ

戻り値

  • Chrome 117 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

getFileStatus()

Promise 
chrome.syncFileSystem.getFileStatus(
  fileEntry: Entry,
  callback?: function,
): Promise<FileStatus>

指定された fileEntry の FileStatus を返します。ステータス値は 'synced'、'pending'、'conflicting' のいずれかになります。'conflicting' 状態は、サービスの競合解決ポリシーが 'manual' に設定されている場合にのみ発生します。

パラメータ

  • fileEntry

    エントリ

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    (