# Drive {% code fullWidth="true" %} ``` 名前: singularity storage update drive - Google Drive 使用法: singularity storage update drive [コマンドオプション] <名前|ID> 説明: --client-id GoogleのアプリケーションクライアントID 自分自身のものを設定することをおすすめします。 自分自身で作成する方法については、https://rclone.org/drive/#making-your-own-client-idを参照してください。 空白のままにすると、パフォーマンスが低下する内部キーが使用されます。 --client-secret OAuthクライアントシークレット。 通常は空白のままにしておきます。 --token OAuthアクセストークン（JSON形式）。 --auth-url 認証サーバーのURL。 プロバイダのデフォルトを使用するには空白のままにしておきます。 --token-url トークンサーバーのURL。 プロバイダのデフォルトを使用するには空白のままにしておきます。 --scope ドライブへのアクセス時にrcloneが使用するスコープ。 例: | drive | 全ファイルへの完全アクセス（アプリケーションデータフォルダを除く）。 | drive.readonly | ファイルのメタデータとファイルの内容への読み取り専用アクセス。 | drive.file | rcloneによって作成されたファイルへのアクセスのみ。 | | これらはドライブのウェブサイトで表示されます。 | | ファイルの承認はユーザーがアプリを承認解除すると取り消されます。 | drive.appfolder | Application Dataフォルダへの読み取りと書き込みのアクセスを許可。 | | これはドライブのウェブサイトで表示されません。 | drive.metadata.readonly | ファイルのメタデータへの読み取り専用アクセスですが、 | | ファイルの内容を読み取ることやダウンロードすることはできません。 --root-folder-id ルートフォルダのID。 通常は空白のままにしておきます。 ドキュメントを参照）またはrcloneが使用する非ルートフォルダを 開始点として使用するために入力します。 --service-account-file サービスアカウントの認証情報のJSONファイルパス。 通常は空白のままにしておきます。 インタラクティブログインの代わりにSAを使用する場合にのみ必要です。 先頭の`~`はファイル名の中で展開されます。 `${RCLONE_CONFIG_DIR}`などの環境変数も同様です。 --service-account-credentials サービスアカウント認証情報のJSON blob。 通常は空白のままにしておきます。 インタラクティブログインの代わりにSAを使用する場合にのみ必要です。 --team-drive 共有ドライブ（チームドライブ）のID。 --auth-owner-only 認証されたユーザーによって所有されているファイルのみを考慮する。 --use-trash ファイルを完全に削除する代わりにゴミ箱に送信。 既定では、ファイルはゴミ箱に送信されます。 ファイルを完全に削除する場合は「--drive-use-trash=false」とします。 --copy-shortcut-content ショートカットの代わりにサーバーサイドでショートカットの内容をコピーする。 サーバーサイドコピーを実行すると、通常rcloneはショートカットをショートカットのままコピーします。 このフラグを使用すると、サーバーサイドコピーを実行する際に、rcloneはショートカットの内容をコピーします。 --skip-gdocs すべてのリストでGoogleドキュメントをスキップする。 与えられた場合、gdocsはrcloneにとってほとんど見えなくなります。 --skip-checksum-gphotos GoogleフォトおよびビデオのMD5チェックサムをスキップする。 Googleフォトやビデオの転送時にチェックサムエラーが発生する場合に使用します。 このフラグを設定すると、Googleフォトおよびビデオは空のMD5チェックサムを返します。 なお、Googleフォトは「photos」スペースにあることで識別されます。 破損したチェックサムは、Googleがイメージ/ビデオを変更したが チェックサムを更新しなかったために発生します。 --shared-with-me 共有されたファイルのみを表示する。 rcloneが「Shared with me」フォルダで操作するように指示します（ ここではGoogleドライブを介して他のユーザーが共有したファイルとフォルダにアクセスできます）。 これは「list」（lsd、lslなど）および「copy」（copy、syncなど）コマンドだけでなく、 他のすべてのコマンドでも機能します。 --trashed-only ゴミ箱にあるファイルのみを表示する。 これにより、元のディレクトリ構造のまま、ゴミ箱の中のファイルが表示されます。 --starred-only スターがついているファイルのみを表示する。 --formats 廃止予定: export_formatsを参照してください。 --export-formats Googleドキュメントをダウンロードする際の優先フォーマットのカンマ区切りリスト。 --import-formats Googleドキュメントをアップロードする際の優先フォーマットのカンマ区切りリスト。 --allow-import-name-change Googleドキュメントをアップロードする際にファイルタイプの変更を許可する。 たとえば、file.docからfile.docxに変わります。 これにより、同期が混乱し、毎回再アップロードされます。 --use-created-date 更新日ではなく作成日を使用する。 データのダウンロード時に作成日を計算したい場合に便利です。 **警告**：このフラグにはいくつかの予期しない影響がある場合があります。 ドライブにアップロードすると、**すべてのファイルが上書き**されます （作成以降に変更されていない場合を除く）。 ダウンロード時にはその逆が起こります。 この副作用を回避するには、「--checksum」フラグを使用します。 この機能は、Googleフォトによって記録された写真の撮影日を維持するために実装されました。 Googleドライブの設定で「Google Photosフォルダを作成する」オプションをチェックする必要があります。 その後、写真をローカルにコピーまたは移動し、 イメージの撮影日（作成日）を変更日として設定できます。 --use-shared-date 共有された日付（作成日）の代わりに更新日を使用する。 注：「--drive-use-created-date」と同様に、このフラグには アップロード/ダウンロード時のファイルに予期しない影響がある場合があります。 このフラグと「--drive-use-created-date」の両方が設定されている場合、作成日が使用されます。 --list-chunk リストのチャンクサイズ 100-1000、0で無効。 --impersonate サービスアカウントを使用する場合に、このユーザーをなりすます。 --alternate-export 廃止予定: もはや必要ありません。 --upload-cutoff チャンクアップロードに切り替えるための閾値。 --chunk-size アップロードチャンクのサイズ。 2のn乗であり、256k以上である必要があります。 これを大きくするとパフォーマンスが向上しますが、 各チャンクは転送ごとにメモリに1つずつバッファリングされます。 これを減らすとメモリ使用量が減少しますが、パフォーマンスが低下します。 --acknowledge-abuse "cannotDownloadAbusiveFile"エラーコードで「このファイルは悪意のあるコンテンツまたはスパムとして識別され、ダウンロードできません」というエラーメッセージが返されるファイルをダウンロードできるように設定する。 ファイルのダウンロード時に「cannotDownloadAbusiveFile」というエラーコードが返される場合、このフラグをrcloneに指定して、 ダウンロードするファイルのリスクを承知したことを示します。 rcloneはそれでもファイルをダウンロードします。 なお、サービス アカウントを使用している場合、このフラグが機能するためには Manager 権限（Content Manager ではありません）が必要です。 SAに適切な権限がない場合、Googleはこのフラグを無視します。 --keep-revision-forever 各ファイルの新しいヘッドリビジョンを永久に保持する。 --size-as-quota サイズをストレージとしての使用クオータ表示する。 ファイルのサイズを使用したストレージクオータとして表示します。 これは現行バージョンと、永久に保持するように設定された古いバージョンを合算します。 **警告**：このフラグにはいくつかの予期しない影響がある場合があります。 構成ファイルでこのフラグを設定することはお勧めしません。 推奨されるのは、rclone ls/lsl/lsf/lsjsonなどを実行する際に--drive-size-as-quotaフラグを使用することです。 同期にこのフラグを使用する場合は --ignore size も使用する必要があります。 --v2-download-min-size オブジェクトがこれよりも大きい場合は、v2 APIを使用してダウンロードします。 --pacer-min-sleep API呼び出し間の最小スリープ時間。 --pacer-burst スリープせずに許可されるAPI呼び出しの数。 --server-side-across-configs 異なるドライブ構成間でサーバーサイドの操作（例：コピー）を実行することを許可する。 これは、2つの異なるGoogleドライブ間でサーバーサイドのコピーを行いたい場合に便利です。 すべての構成の間で動作するかどうかは簡単に判断できないため、デフォルトでは無効になっています。 --disable-http2 Driveがhttp2を使用しないように設定する。 現在、GoogleドライブバックエンドとHTTP/2の間に解決できない問題があります。 ドライブバックエンドではHTTP/2はデフォルトで無効になっていますが、ここで再度有効にできます。 この問題が解決されると、このフラグは削除されます。 参照: https://github.com/rclone/rclone/issues/3631 --stop-on-upload-limit アップロード制限エラーを致命的にする。 現時点では、Googleドライブに1日あたり750 GiBのデータをアップロードすることが可能です（これは非公開の制限です）。 この制限に達すると、Googleドライブはわずかに異なるエラーメッセージを生成します。 このフラグが設定されていると、これらのエラーは致命的となります。 これにより、進行中の同期が中止されます。 Googleが文書化していないエラーメッセージ文字列に依存しているため、この検出は将来的には壊れる可能性があります。 参照: https://github.com/rclone/rclone/issues/3857 --stop-on-download-limit ダウンロード制限エラーを致命的にする。 現時点では、Googleドライブから1日あたり10 TiBのデータをダウンロードすることが可能です（これは非公開の制限です）。 この制限に達すると、Googleドライブはわずかに異なるエラーメッセージを生成します。 このフラグが設定されていると、これらのエラーは致命的となります。 これにより、進行中の同期が中止されます。 Googleが文書化していないエラーメッセージ文字列に依存しているため、この検出は将来的には壊れる可能性があります。 --skip-shortcuts ショートカットファイルをスキップする場合は、設定する。 通常、rcloneではショートカットファイルを参照先のオリジナルファイルとして処理します（ショートカットについては、[ショートカットセクション](#shortcuts)を参照）。 このフラグが設定されている場合、rcloneはショートカットファイルを完全に無視します。 --skip-dangling-shortcuts ダングリングショートカットファイルをスキップする場合は、設定する。 このフラグが設定されている場合、rcloneはリストにダングリングショートカットを表示しません。 --resource-key リンク共有されたファイルにアクセスするためのリソースキー。 次のようなリンクで共有されたファイルにアクセスする必要がある場合は、 https://drive.google.com/drive/folders/XXX?resourcekey=YYY&usp=sharing "XXX"を"root_folder_id"、"YYY"を"resource_key"として使用する必要があります。 そうしないと、ディレクトリにアクセスしようとすると、404 not found エラーが表示されます。 参照: https://developers.google.com/drive/api/guides/resource-keys このリソースキーの要件は、一部の古いファイルにのみ適用されます。 また、（利用したいユーザーでrcloneが認証されている場合）、 1回ウェブインターフェースでフォルダを開くだけで、リソースキーを必要としないようです。 --encoding バックエンドのエンコーディング。 詳細については[概要のエンコーディングセクション](/overview/#encoding)を参照してください。 オプション: --alternate-export 廃止予定: もはや必要ありません。(default: false) [$ALTERNATE_EXPORT] --client-id value GoogleのアプリケーションクライアントID [$CLIENT_ID] --client-secret value OAuthクライアントシークレット [$CLIENT_SECRET] --help, -h ヘルプを表示する --scope value ドライブへのアクセス時にrcloneが使用するスコープ [$SCOPE] --service-account-file value サービスアカウントの認証情報のJSONファイルパス [$SERVICE_ACCOUNT_FILE] 高度なオプション --acknowledge-abuse "cannotDownloadAbusiveFile"エラーコードで「このファイルは悪意のあるコンテンツまたはスパムとして識別され、ダウンロードできません」というエラーメッセージが返されるファイルをダウンロードできるように設定する。(default: false) [$ACKNOWLEDGE_ABUSE] --allow-import-name-change Googleドキュメントをアップロードする際にファイルタイプの変更を許可する。(default: false) [$ALLOW_IMPORT_NAME_CHANGE] --auth-owner-only 認証されたユーザーによって所有されているファイルのみを考慮する。(default: false) [$AUTH_OWNER_ONLY] --auth-url value 認証サーバーのURL [$AUTH_URL] --chunk-size value アップロードチャンクのサイズ。(default: "8Mi") [$CHUNK_SIZE] --copy-shortcut-content ショートカットの代わりにサーバーサイドでショートカットの内容をコピーする。(default: false) [$COPY_SHORTCUT_CONTENT] --disable-http2 Driveがhttp2を使用しないように設定する。(default: true) [$DISABLE_HTTP2] --encoding value バックエンドのエンコーディング。(default: "InvalidUtf8") [$ENCODING] --export-formats value Googleドキュメントをダウンロードする優先フォーマットのカンマ区切りリスト。(default: "docx,xlsx,pptx,svg") [$EXPORT_FORMATS] --formats value 廃止予定: export_formatsを参照してください。 [$FORMATS] --impersonate value サービスアカウントを使用する場合に、このユーザーをなりすます。 [$IMPERSONATE] --import-formats value Googleドキュメントをアップロードする優先フォーマットのカンマ区切りリスト。 [$IMPORT_FORMATS] --keep-revision-forever 各ファイルの新しいヘッドリビジョンを永久に保持する。(default: false) [$KEEP_REVISION_FOREVER] --list-chunk value リストのチャンクサイズ 100-1000、0で無効。 (default: 1000) [$LIST_CHUNK] --pacer-burst value スリープせずに許可されるAPI呼び出しの数。 (default: 100) [$PACER_BURST] --pacer-min-sleep value API呼び出し間の最小スリープ時間。 (default: "100ms") [$PACER_MIN_SLEEP] --resource-key value リンク共有されたファイルにアクセスするためのリソースキー。 [$RESOURCE_KEY] --root-folder-id value ルートフォルダのID。 [$ROOT_FOLDER_ID] --server-side-across-configs 異なるドライブ構成間でサーバーサイドの操作（例：コピー）を実行することを許可する。(default: false) [$SERVER_SIDE_ACROSS_CONFIGS] --service-account-credentials value サービスアカウント認証情報のJSON blob。 [$SERVICE_ACCOUNT_CREDENTIALS] --shared-with-me 共有されたファイルのみを表示する。(default: false) [$SHARED_WITH_ME] --size-as-quota サイズをストレージとしての使用クオータ表示する。(default: false) [$SIZE_AS_QUOTA] --skip-checksum-gphotos GoogleフォトおよびビデオのMD5チェックサムをスキップする。(default: false) [$SKIP_CHECKSUM_GPHOTOS] --skip-dangling-shortcuts ダングリングショートカットファイルをスキップする場合は、設定する。(default: false) [$SKIP_DANGLING_SHORTCUTS] --skip-gdocs すべてのリストでGoogleドキュメントをスキップする。(default: false) [$SKIP_GDOCS] --skip-shortcuts ショートカットファイルをスキップする場合は、設定する。(default: false) [$SKIP_SHORTCUTS] --starred-only スターがついているファイルのみを表示する。(default: false) [$STARRED_ONLY] --stop-on-download-limit ダウンロード制限エラーを致命的にする。(default: false) [$STOP_ON_DOWNLOAD_LIMIT] --stop-on-upload-limit アップロード制限エラーを致命的にする。(default: false) [$STOP_ON_UPLOAD_LIMIT] --team-drive value 共有ドライブ（チームドライブ）のID。 [$TEAM_DRIVE] --token value OAuthアクセストークン（JSON形式）。 [$TOKEN] --token-url value トークンサーバーのURL。 [$TOKEN_URL] --trashed-only ゴミ箱にあるファイルのみを表示する。(default: false) [$TRASHED_ONLY] --upload-cutoff value チャンクアップロードに切り替えるための閾値。(default: "8Mi") [$UPLOAD_CUTOFF] --use-created-date 更新日ではなく作成日を使用する。(default: false) [$USE_CREATED_DATE] --use-shared-date 共有された日付（作成日）の代わりに更新日を使用する。(default: false) [$USE_SHARED_DATE] --use-trash ファイルを完全に削除する代わりにゴミ箱に送信する。(default: true) [$USE_TRASH] --v2-download-min-size value オブジェクトがこれよりも大きい場合は、v2 APIを使用してダウンロードします。(default: "off") [$V2_DOWNLOAD_MIN_SIZE] ``` {% endcode %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://data-programs.gitbook.io/singularity/jp/cli-reference/storage/update/drive.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.