Drive API v2 ガイド

Google Drive API バージョン 2 を使用している場合、Google Drive API ガイド v3 の内容の大部分は v2 にも関連しています。このセクションには、v3 ガイドの特定のページに記載されている情報とは異なる、v2 に固有の情報がすべて含まれています。詳細なコンテキストについては、各サブセクションに、対応するガイドページへのリンクが含まれています。

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

ファイルのリビジョンをダウンロードして公開する

[ファイルのリビジョンのダウンロードと公開] ページでは、次の情報が v2 に固有のものです（v3 で表示されたこれらのセクションを置き換えます）。

個々のリビジョンの一覧表示とダウンロード

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

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 メソッドには、共有ドライブに固有のパラメータがいくつかあります。パラメータの一覧については、共有ドライブの変更を追跡するをご覧ください。

ファイルをアップロードする

[Upload file data] ページを見ると、v2 に固有の情報であることがわかります。

Google ドキュメントの種類にインポート

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

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

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

バージョン 2 の検索クエリの違い

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

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

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