이 문서에는 Google Docs API별 승인 및 인증 정보가 포함되어 있습니다. 이 문서를 읽기 전에 인증 및 승인 알아보기에서 Google Workspace의 일반적인 인증 및 승인 정보를 읽어보세요.
승인을 위해 OAuth 2.0 구성
OAuth 동의 화면 구성 및 범위 선택을 통해 사용자와 앱 검토자에게 표시할 정보를 정의하고 나중에 게시할 수 있도록 앱을 등록합니다.
Docs API 범위
앱에 부여된 액세스 수준을 정의하려면 승인 범위를 식별하고 선언해야 합니다. 승인 범위는 Google Workspace 앱 이름, 액세스하는 데이터 유형, 액세스 수준이 포함된 OAuth 2.0 URI 문자열입니다. 범위는 사용자의 Google 계정 데이터를 포함한 Google Workspace 데이터를 사용하기 위한 앱의 요청입니다.
앱이 설치되면 사용자에게 앱에서 사용하는 범위를 확인해 달라는 메시지가 표시됩니다. 일반적으로 최대한 좁은 범위의 범위를 선택하고 앱에 필요하지 않은 범위를 요청하지 않는 것이 좋습니다. 사용자는 명확하게 설명된 제한된 범위에 더 쉽게 액세스 권한을 부여합니다.
가능하면 민감하지 않은 범위를 사용하는 것이 좋습니다. 민감하지 않은 범위는 파일별 액세스 범위를 부여하고 앱에 필요한 특정 기능에 대한 액세스 범위를 좁히기 때문입니다.
Docs API는 다음 범위를 지원합니다.
| 범위 코드 | 설명 | 사용 |
|---|---|---|
https://www.googleapis.com/auth/documents |
모든 Google Docs 문서를 확인, 수정, 생성, 삭제할 수 있습니다. | 민감한 콘텐츠 |
https://www.googleapis.com/auth/documents.readonly |
모든 Google Docs 문서를 확인합니다. | 민감한 콘텐츠 |
https://www.googleapis.com/auth/drive.file |
이 앱에서 사용하는 특정 Google Drive 파일만 보고, 수정하고, 만들고, 삭제합니다. | 권장 민감하지 않음 |
https://www.googleapis.com/auth/drive |
모든 Google Drive 파일을 확인, 수정, 생성, 삭제할 수 있습니다. | 제한됨 |
https://www.googleapis.com/auth/drive.readonly |
Google Drive 파일 보기 및 다운로드 | 제한됨 |
표의 사용량 열은 다음 정의에 따라 각 범위의 민감도를 나타냅니다.
비민감한 정보: 이러한 범위는 승인 액세스의 가장 작은 범위를 제공하며 기본 앱 인증만 필요합니다. 이 요구사항에 관한 자세한 내용은 인증을 위해 앱 제출을 참고하세요.
민감한 정보: 이러한 범위는 사용자가 앱에 대해 승인한 특정 Google 사용자 데이터에 대한 액세스 권한을 제공합니다. 추가 앱 인증을 거쳐야 합니다. 이 요구사항에 관한 자세한 내용은 민감한 정보 및 제한된 범위 요구사항을 참고하세요.
제한됨: 이러한 범위는 Google 사용자 데이터에 대한 광범위한 액세스 권한을 제공하며 제한된 범위 확인 절차를 거쳐야 합니다. 이 요구사항에 관한 자세한 내용은 Google API 서비스 사용자 데이터 정책 및 특정 API 범위의 추가 요구사항을 참고하세요. 제한된 범위의 데이터를 서버에 저장하거나 전송하는 경우 보안 평가를 거쳐야 합니다.
앱에 다른 Google API에 대한 액세스 권한이 필요한 경우 해당 범위도 추가할 수 있습니다. Google API 범위에 관한 자세한 내용은 OAuth 2.0을 사용하여 Google API에 액세스를 참고하세요.
특정 OAuth 2.0 범위에 대한 자세한 내용은 Google API의 OAuth 2.0 범위를 참조하세요.