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

詳しくは、承認ガイドをご覧ください。