Method: labels.disable

게시된 라벨을 사용 중지합니다. 라벨을 사용 중지하면 현재 게시된 버전에 따라 사용 중지된 새 버전이 생성됩니다. 초안 버전이 있는 경우 사용 중지된 새 초안 버전이 최신 초안 버전을 기반으로 생성됩니다. 이전 초안 버전이 삭제됩니다.

사용 중지하면 labels.delete을 사용하여 라벨을 삭제할 수 있습니다.

HTTP 요청

POST https://drivelabels.googleapis.com/v2/{name=labels/*}:disable

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

경로 매개변수

매개변수
name

string

필수 항목입니다. 라벨 리소스 이름입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "updateMask": string,
  "useAdminAccess": boolean,
  "writeControl": {
    object (WriteControl)
  },
  "disabledPolicy": {
    object (DisabledPolicy)
  },
  "languageCode": string
}
입력란
updateMask

string (FieldMask format)

업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 disabledPolicy이(가) 묵시적으로 지정되므로 지정해서는 안 됩니다. 단일 *를 모든 필드 업데이트의 약식으로 사용할 수 있습니다.

useAdminAccess

boolean

사용자의 관리자 인증 정보를 사용하려면 true로 설정합니다. 서버에서는 액세스를 허용하기 전에 사용자가 라벨의 관리자인지 확인합니다.

writeControl

object (WriteControl)

쓰기 요청이 실행되는 방식을 제어합니다. 기본적으로 설정되지 않으므로 마지막 쓰기가 적용됩니다.

disabledPolicy

object (DisabledPolicy)

사용 중지된 정책입니다.

languageCode

string

현지화된 필드 라벨을 평가하는 데 사용할 BCP-47 언어 코드입니다. 지정하지 않으면 구성된 기본 언어의 값이 사용됩니다.

응답 본문

성공한 경우 응답 본문에 Label의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

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