このトピックでは、Drive および Photo Service におけるファイルのアップロードに関するよくある質問に回答します。対象には、インスタントアップロード、再開可能なアップロード、ストレージ使用量の更新遅延、およびアップロード失敗のトラブルシューティングが含まれます。
インスタントアップロードと事前チェックの違い
インスタントアップロードは、ファイル全体の SHA-1 ハッシュに基づいています。ファイルを作成すると、サーバーがその完全な SHA-1 ハッシュを計算します。このハッシュが既存のレコードと一致する場合、アップロードは即座に完了します。
インスタントアップロードの事前チェックは、大容量ファイル向けの最適化です。大容量ファイルの完全な SHA-1 ハッシュを計算するのは時間がかかる場合があります。事前チェックプロセスでは、まずファイルの先頭 1 KB を読み取り、そのハッシュを計算します。この 1 KB ハッシュに一致するレコードが存在しない場合、そのファイルはインスタントアップロードの対象外となり、不要な完全ハッシュ計算を回避するためにプロセスは早期に終了します。1 KB ハッシュに一致するレコードが見つかった場合は、サーバーがファイル全体の SHA-1 ハッシュを計算し、インスタントアップロードが可能かどうかを確認します。
ドライブストレージの更新遅延
PDS はドライブのストレージ使用量を非同期で更新します。アップロードが完了した後、ストレージ使用量のデータは通常、2～3 秒以内にリフレッシュされます。
インスタントアップロードの粒度
インスタントアップロードはファイルレベルで動作します。ファイルをアップロードすると、サーバーがその SHA-1 ハッシュを計算して保存します。同じハッシュを持つファイルをその後アップロードする場合、インスタントアップロードがトリガーされます。
再開可能なアップロード
はい。再開可能なアップロードは、ファイルを複数のパートに分割し、それぞれを独立してアップロードすることで機能します。再開可能な最小単位は 1 つのパートです。パートの途中からアップロードを再開することはできません。
アップロード失敗の主な原因
ホスティングモードを使用している場合、アップロード失敗の原因は、Cross-Origin Resource Sharing (CORS) ルールの設定ミスであることが多いです。ご利用の OSS バケットの CORS ルールを確認し、オリジン、リクエストメソッド、リクエストヘッダーがすべて許可リストに含まれていることをご確認ください。
ドライブのストレージクォータを使い切った場合も、アップロードが失敗することがあります。この場合、API は
QuotaExhaustedエラーコードを返します。