Drive API v2 ガイド

Google Drive API バージョン 2 を使用している場合、Google Drive API ガイド v3 のコンテンツのほとんどは v2 にも関連しています。このセクションには、v3 ガイドの特定のページに記載されているものとは異なる、v2 固有のすべての情報が記載されています。各サブセクションには、完全なコンテキストを得るための、対応するガイドページへのリンクが含まれています。

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

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

[ファイルのリビジョンをダウンロードして公開する] ページの次の情報は v2 に固有のものであり、v3 に表示される次のセクションに置き換わります。

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

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

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

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

[カスタム ファイル プロパティを追加する] ページの情報に加え、v2 に固有の次の情報を確認してください。

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

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

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

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

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

[共有ドライブのサポートを実装する] ページの情報に加えて、この追加フィールド trashedDate を v2 に置き換えます。

共有ドライブのサポートを実装するで説明した次のメソッドでは、共有ドライブのコンテンツを操作するときに 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 では role フィールドのみがユーザー、グループ、ドメインの有効なロールを指定します。v2 では、権限の role フィールドと additionalRoles フィールドの両方で、ユーザー、グループ、またはドメインが特定のアイテムに対して持つ有効なロールを反映する必要があります。

v2 の検索クエリの違い

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

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

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