Method: labels.list

라벨 나열

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

쿼리 매개변수

매개변수
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

자세한 내용은 승인 가이드를 참조하세요.