Method: labels.list

ラベルを一覧表示します。

HTTP リクエスト

GET https://drivelabels.googleapis.com/v2/labels

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

クエリ パラメータ

パラメータ
publishedOnly

boolean

公開済みのラベルのみを結果に含めるかどうか。

  • true の場合、現在の公開済みラベルのリビジョンのみが返されます。無効になっているラベルも含まれます。返されるラベルのリソース名は、公開されたリビジョン（labels/{id}/{revisionId}）を参照します。
  • false の場合、現在のラベルのリビジョンが返されますが、これは公開されていない可能性があります。返されたラベルリソース名は、特定のリビジョン（labels/{id}）を参照しません。
customer

string

このリスト リクエストの対象範囲の顧客。例: 「customers/abcd1234」。未設定のままにすると、現在の顧客のすべてのラベルが返されます。
languageCode

string

ローカライズされたフィールド ラベルの評価に使用する BCP-47 言語コード。指定しない場合、デフォルトで設定されている言語の値が使用されます。
pageSize

integer

ページごとに返すラベルの最大数。デフォルト: 50。最大: 200
pageToken

string

返されるページのトークンです。
view

enum (LabelView)

指定すると、指定されたビューに属する特定のフィールドのみが返されます。

ユニオン パラメータ access。

access は次のいずれかになります。
useAdminAccess

boolean

ユーザーの管理者認証情報を使用するには、true に設定します。顧客のすべてのラベルが返されます。
minimumRole

enum (LabelRole)

返されたラベルに対してユーザーが必要とするアクセスレベルを指定します。ユーザーがラベルに対して付与する必要がある最小限のロール。デフォルトは READER です。

リクエスト本文

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

レスポンスの本文

成功すると、レスポンスの本文に次の構造のデータが含まれます。

ラベルの一覧表示に対するレスポンス。

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

object (Label)

ラベル、
nextPageToken

string

レスポンスの次のページのトークン。

認可スコープ

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

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.labels.readonly
  • https://www.googleapis.com/auth/drive.admin.labels
  • https://www.googleapis.com/auth/drive.admin.labels.readonly

詳細については、承認ガイドをご覧ください。