이 문서에는 Drive Labels API별 승인 및 인증 정보가 포함되어 있습니다. 이 문서를 읽기 전에 인증 및 승인 알아보기에서 Google Workspace의 일반적인 인증 및 승인 정보를 읽어보세요.
승인을 위해 OAuth 2.0 구성
OAuth 동의 화면 구성 및 범위 선택을 통해 사용자와 앱 검토자에게 표시할 정보를 정의하고 나중에 게시할 수 있도록 앱을 등록합니다.
Google Drive Labels API 범위
앱에 부여된 액세스 수준을 정의하려면 승인 범위를 식별하고 선언해야 합니다. 승인 범위는 Google Workspace 앱 이름, 액세스하는 데이터 유형, 액세스 수준이 포함된 OAuth 2.0 URI 문자열입니다. 범위는 사용자의 Google 계정 데이터를 비롯한 Google Workspace 데이터를 사용하기 위한 앱의 요청입니다.
앱이 설치되면 사용자에게 앱에서 사용하는 범위를 확인해 달라는 메시지가 표시됩니다. 일반적으로 최대한 좁은 범위의 범위를 선택하고 앱에 필요하지 않은 범위를 요청하지 않는 것이 좋습니다. 사용자는 명확하게 설명된 제한된 범위에 더 쉽게 액세스 권한을 부여합니다.
가능하면 민감하지 않은 범위를 사용하는 것이 좋습니다. 민감하지 않은 범위는 파일별 액세스 범위를 부여하고 앱에 필요한 특정 기능에 대한 액세스를 좁힙니다.
다음 OAuth 2.0 범위를 사용하여 Drive 항목에 적용된 라벨 메타데이터를 읽고, 검색하고, 수정할 수 있습니다.
| 범위 | 의미 |
|---|---|
|
Drive 항목에 적용된 라벨 메타데이터를 읽고, 검색하고, 수정합니다. |
|
애플리케이션에 승인된 Drive 항목에 적용된 라벨 메타데이터를 읽고 검색합니다. |
자세한 내용은 Drive API OAuth 2.0 범위 및 Drive API별 승인을 참고하세요.
라벨 범위
다음 OAuth 범위를 사용하여 라벨을 보고 관리할 수 있습니다.
| 범위 | 의미 |
|---|---|
https://www.googleapis.com/auth/drive.labels
|
Drive 라벨을 보고, 사용하고, 관리합니다.
|
https://www.googleapis.com/auth/drive.labels.readonly
|
Drive 라벨을 확인하고 사용합니다.
|
https://www.googleapis.com/auth/drive.admin.labels
|
조직의 모든 Drive 라벨을 확인, 수정, 생성, 삭제하고 조직의 라벨 관련 관리자 정책을 확인할 수 있습니다.
|
https://www.googleapis.com/auth/drive.admin.labels.readonly
|
조직의 모든 Drive 라벨 및 라벨 관련 관리자 정책을 확인합니다.
|
관리자 액세스
ADMIN 라벨을 관리하려면 다음을 지정해야 합니다.
useAdminAccess는 사용자의 관리자 사용자 인증 정보를 사용하는true입니다.- 라벨 관리 권한이 있는 계정 관리자
useAdminAccess
관리자는 useAdminAccess 매개변수를 설정하여 관리자 권한을 호출해야 합니다. useAdminAccess를 설정하면 고객이 소유한 모든 라벨을 보고 수정할 수 있습니다. 여기에는 ADMIN 및 SHARED 라벨이 모두 포함됩니다.
useAdminAccess가 설정되지 않은 경우 쓰기 요청은 SHARED label type가 모두 있는 라벨과 이 라벨에 적절한 EDITOR 역할을 가진 사용자에게만 허용됩니다.
자세한 내용은 액세스 사용자 인증 정보 만들기를 참고하세요.