Method: approvals.list

ファイルの承認を一覧表示します。詳しくは、承認を管理するをご覧ください。

デフォルトでは、このメソッドは最小限のレスポンスを返します。このレスポンスには items 配列が含まれない場合があります。承認の詳細を取得するには、fields クエリ パラメータを使用して、必要なフィールドを明示的に指定する必要があります。必要なフィールドのみを返す方法については、特定のフィールドを返すをご覧ください。

HTTP リクエスト

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

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

パスパラメータ

パラメータ
fileId

string

必須。承認の対象となるファイルの ID。

クエリ パラメータ

パラメータ
pageSize

integer

返す承認の最大数。設定しない場合、最大 100 件の承認が返されます。
pageToken

string

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

リクエストの本文

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

レスポンスの本文

承認リスト リクエストのレスポンス。

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

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

string

常に drive#approvalList です。
items[]

object (Approval)

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

string

承認の次のページのページトークン。承認リストの末尾に達すると、この項目は表示されません。トークンが何らかの理由で拒否された場合は、破棄して、結果の最初のページからページ分割を再開する必要があります。

認可スコープ

次の 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.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

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