Method: revisions.list

ファイルの改訂版を一覧表示します。詳細については、ファイルの改訂版を管理するをご覧ください。

重要: このメソッドから返される改訂版のリストは、頻繁に編集される Google ドキュメント、スプレッドシート、スライドなど、改訂履歴が長いファイルの場合、完全ではない可能性があります。古い改訂版はレスポンスから除外される可能性があるため、返される最初の改訂版が既存の最も古い改訂版ではない場合があります。Workspace エディタのユーザー インターフェースに表示される改訂履歴は、API から返されるリストよりも完全である可能性があります。

HTTP リクエスト

GET https://www.googleapis.com/drive/v3/files/{fileId}/revisions

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
fileId

string

ファイルの ID。

クエリ パラメータ

パラメータ
pageSize

integer

返される改訂版の最大数。サービスから返される数は、この値より少ない場合があります。

指定されていない場合は、最大で 200 件の改訂版が返されます。

最大値は 1,000 です。1,000 を超える値は 1,000 に強制変換されます。
pageToken

string

前のリスト リクエストを次のページで続行するためのトークン。これは、前のレスポンスの 'nextPageToken' の値に設定する必要があります。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

ファイルの改訂版のリスト。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "revisions": [
    {
      object (Revision)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
フィールド
revisions[]

object (Revision)

改訂版のリスト。nextPageToken が入力されている場合、このリストは完全ではない可能性があるため、結果の追加ページを取得する必要があります。
nextPageToken

string

改訂版の次のページのページトークン。改訂版リストの末尾に達すると、この値は存在しません。トークンが何らかの理由で拒否された場合は、破棄して、結果の最初のページからページ分割を再開する必要があります。通常、ページトークンは数時間有効です。ただし、新しいアイテムが追加または削除されると、期待される結果が異なる場合があります。
kind

string

リソースの種類を示します。値は固定文字列 "drive#revisionList" です。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

一部のスコープは制限されており、アプリで使用するにはセキュリティ評価が必要です。詳細については、認可ガイドをご覧ください。