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] フィールドで、ユーザー、グループ、ドメインに対して有効なロールを指定します。v2 では、特定のアイテムに対してユーザー、グループ、またはドメインに付与されている有効なロールを反映する権限の role フィールドと additionalRoles フィールドの両方が必要です。

バージョン 2 での検索語句の違い

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

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

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