Method: labels.publish

모든 초안 변경사항을 라벨에 게시합니다. 게시된 라벨은 초안 상태로 되돌릴 수 없습니다. 자세한 내용은 google.apps.drive.labels.v2.Lifecycle를 참고하세요.

라벨을 게시하면 새 버전이 게시됩니다. 이전의 모든 초안 버전이 삭제됩니다. 이전에 게시된 버전은 유지되지만 필요에 따라 자동으로 삭제될 수 있습니다.

게시된 일부 변경사항은 더 이상 허용되지 않습니다. 일반적으로 라벨과 관련된 기존 메타데이터를 무효화하거나 새로운 제한을 야기하는 변경사항은 거부됩니다. 예를 들어 라벨에 대한 다음과 같은 변경사항은 라벨이 게시된 후에 거부됩니다. * 라벨은 직접 삭제할 수 없습니다. 먼저 사용 중지한 다음 삭제해야 합니다. * Field.FieldType은 변경할 수 없습니다. * 필드 유효성 검사 옵션을 변경하면 이전에 수락된 항목을 거부할 수 없습니다. * 최대 항목 줄이기

HTTP 요청

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

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

경로 매개변수

매개변수
name

string

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

요청 본문

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

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

boolean

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

writeControl

object (WriteControl)

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

languageCode

string

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

응답 본문

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

승인 범위

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

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

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