Method: files.listLabels

ファイルのラベルを一覧表示します。

HTTP リクエスト

GET https://www.googleapis.com/drive/v2/files/{fileId}/listLabels

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

パスパラメータ

パラメータ
fileId

string

ファイルの ID。

クエリ パラメータ

パラメータ
maxResults

integer

ページごとに返されるラベルの最大数。設定しない場合、デフォルトの 100 が使用されます。

pageToken

string

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

リクエスト本文

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

レスポンスの本文

ファイルに適用されるラベルのリスト。

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

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

object (Label)

ラベルのリスト。

nextPageToken

string

ラベルの次のページ用のページトークン。リストの最後に達している場合、このフィールドは存在しません。なんらかの理由でトークンが拒否された場合は、トークンを破棄し、ページ分けを結果の最初のページから再開する必要があります。

kind

string

常に drive#labelList です。

認可スコープ

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

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

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