Drive API v2 ガイド

Google Drive API バージョン 2 を使用している場合、Google Drive API ガイド v3 のコンテンツのほとんどは v2 にも当てはまります。このセクションには、v2 固有の情報がすべて含まれています。これは、v3 ガイドの特定のページに表示される情報とは異なります。各サブセクションには、対応するガイドページへのリンクが含まれています。

相違点の全一覧については、Drive API v2 と v3 の機能比較リファレンスをご覧ください。

ファイルの改訂版をダウンロードして公開する

[ファイルの改訂版をダウンロードして公開] ページでは、次の情報は v2 に固有のもので、v3 で表示されるこれらのセクションに代わるものです。

個々のリビジョンを一覧表示してダウンロードする

ファイルのリビジョンのリストを取得したら、承認済みの GET リクエストをその []downloadUrl](/workspace/drive/api/reference/rest/v2/revisions) プロパティに送信して、任意のリビジョンのコンテンツをダウンロードできます。この有効期間の短い URL は、リビジョンをリクエストすると Google ドライブによって生成されます。後で使用するために、これに依存しないでください。

exportLinks プロパティをオンにすると、サポートされている形式のいずれかでリビジョンをエクスポートすることもできます。

カスタム ファイルのプロパティ

カスタム ファイル プロパティを追加するページの情報に加えて、次の情報は v2 に固有のものです。

プロパティには、properties リソースを使用してアクセスします。

これは、ファイルにドライブ ファイルのデータベース ID を保存するために使用される一般的なプロパティの構造です。

{
  'key':        'additionalID',
  'value':      'ID',
  'visibility': 'PRIVATE'
}

上限の詳細については、リファレンス ドキュメントの properties をご覧ください。

共有ドライブのサポートを有効にする

共有ドライブのサポートを実装するページの情報のほか、v2 の場合はこの追加フィールド trashedDate を置き換えます。

共有ドライブのサポートを実装するでは、共有ドライブのコンテンツを操作する際に、次のメソッドで supportsAllDrives=true が必要になります。

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

changes.get メソッドと changes.list メソッドには、共有ドライブに固有のパラメータがいくつかあります。パラメータのリストについては、共有ドライブの変更履歴を確認するセクションをご覧ください。

ファイルをアップロード

[ファイルデータをアップロードする] ページで、次の情報が v2 に固有のものであることを確認します。

Google ドキュメントにインポートできるファイル形式

Google ドライブでファイルを作成する際に、一部の種類のファイルを Google ドキュメント、Google スプレッドシート、Google スライドのドキュメントに変換できます。files.insert convert クエリ パラメータを含め、ファイルの（workspace_name）mimeType プロパティを設定します。詳細については、ファイルデータをアップロードするをご覧ください。

ファイル、フォルダ、ドライブを共有する

ファイル、フォルダ、ドライブを共有するページの注意書きにあるように、v3 では 1 つのフィールド role のみで、ユーザー、グループ、ドメインの有効なロールを指定します。v2 では、権限の role フィールドと additionalRoles フィールドの両方に、ユーザー、グループ、ドメインが特定のアイテムに対して持つ有効なロールが反映されている必要があります。

v2 の検索クエリの違い

v2 の title フィールドは、v3 では name です。例については、ファイルとフォルダを検索するをご覧ください。

v2 の createdDate フィールドは、v3 では createdTime です。例については、共有ドライブを検索するをご覧ください。

v2 の modifiedDate フィールドは、v3 では modifiedTime です。v2 の lastViewedByMeDate フィールドは、v3 では viewedByMeTime です。詳しくは、検索クエリの用語と演算子をご覧ください。