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 リソースを使用してアクセスします。

これは、ファイルの Drive ファイルのデータベース 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 です。詳細については、検索クエリの用語と 演算子をご覧ください。