사용자가 파일을 만들거나 열 때 앱을 Google Drive에 표시하려면 다음과 같이 하세요. 먼저 Drive 사용자 인터페이스 (UI) 통합을 설정해야 합니다. 또한 Google Workspace Marketplace
Drive API 사용 설정
Google API를 사용하려면 먼저 Google Cloud에서 사용 설정해야 합니다. 살펴보겠습니다 단일 Google Cloud에서 하나 이상의 API를 사용 설정할 수 있습니다. 살펴보겠습니다
Google Drive UI와의 통합을 시작하려면 Drive API 이를 통해 API 및 UI 통합에 액세스할 수 있습니다. 기능을 살펴보겠습니다
Google Cloud 콘솔에서 Google Drive API를 사용 설정합니다.
Drive UI 통합 설정
- Google API 콘솔에서 메뉴 > API 및 서비스 > 사용 설정된 API 및 서비스를 참고하세요. 로 이동합니다.
- API 및 서비스 대시보드에서 Google Drive API를 클릭합니다. 이 Google Drive API 구성 페이지가 나타납니다.
- Drive UI 통합 탭을 선택합니다.
- (선택사항) 애플리케이션 이름 필드에 이름을 입력합니다. 애플리케이션 이름이 Drive의 앱 관리 탭에서 사용자에게 표시됩니다. 설정을 변경할 수 있습니다.
- (선택사항) 짧은 설명에 한 줄 길이의 짧은 설명을 입력합니다. 필드를 확인합니다. 간단한 설명은 다음 앱의 앱 관리 탭에서 사용자에게 표시됩니다. Drive 설정을 클릭합니다.
- (선택사항) 자세한 설명 입력란에 자세한 설명을 입력합니다.
사용자의 목록에 표시할 하나 이상의 애플리케이션 아이콘 연결된 드라이브 앱 및 '연결 프로그램' 컨텍스트 메뉴 아이콘은 투명한 배경에 PNG 형식이어야 합니다. 아이콘은 최대 24시간이 걸릴 수 있습니다.
드라이브 UI의 '연결 프로그램' 사용 메뉴 항목이라고 하는 경우 아래의 입력란에 앱 URL을 입력하세요. URL 열기 입력란. 이 URL은 '연결 프로그램' 컨텍스트 메뉴
- 이 URL에는 정규화된 도메인 이름이 포함되어야 합니다.
localhost
에서 실행하지 않음 있습니다 - 이 URL은 애플리케이션의 의도한 사용자가 액세스할 수 있어야 합니다. 여러 애플리케이션 버전(예: 공개용 버전)이 있는 경우 버전 1개 및 일부 사용자를 대상으로 하는 제한된 출시 버전, 각 버전 고유한 URL을 사용해야 합니다. 그런 다음 다른 앱을 만들 수 있습니다. 버전별 구성을 보여줍니다
- 다음을 수행해야 합니다. 이 URL의 소유권을 확인 해야 합니다.
- 기본적으로
state
쿼리 매개변수가 이 URL에 추가되어 앱에 전송할 수 있습니다. 자세한 내용은state
매개변수의 콘텐츠는state
매개변수를 사용하세요.
- 이 URL에는 정규화된 도메인 이름이 포함되어야 합니다.
(선택사항) 기본 MIME 유형 및 파일 확장자를 기본 MIME 유형 및 기본 파일 확장자 필드 기본 MIME 파일 형식 및 파일 확장자는 앱이 고유하게 빌드된 파일을 나타냅니다. 있습니다. 예를 들어 앱에서 레이어링과 이미지 편집입니다. 표준 미디어만 포함 유형 오타와 맞춤법 오류가 없는지 확인합니다 앱이 바로가기 또는 타사 바로가기 파일의 경우 MIME 유형을 비워 둘 수 있습니다.
(선택사항) 보조 MIME 유형 및 보조 파일 확장자 필드 보조 MIME 유형 및 파일 확장자는 앱에서 열 수 있는 파일을 나타내며 구체적이지 않습니다. 해야 합니다. 예를 들어, Android Studio 2010을 여는 이미지 편집 앱일 수 있습니다. PNG 및 JPG 이미지 표준 미디어만 포함 유형 오타와 맞춤법 오류가 없는지 확인합니다 앱이 바로가기 또는 타사 바로가기 파일의 경우 MIME 유형을 비워 둘 수 있습니다.
드라이브 UI의 '새로 만들기' 사용 버튼을 사용하고 사용자에게 앱에서 파일 만들기 체크박스를 선택합니다. 새 URL 및 선택사항 문서 이름 입력란이 표시됩니다.
- 이 URL에는 정규화된 도메인 이름이 포함되어야 합니다.
localhost
에서 실행하지 않음 있습니다 - 의 소유권을 확인해야 합니다. URL 해야 합니다.
- 기본적으로
state
쿼리 매개변수가 이 URL에 추가되어 앱에 전송할 수 있습니다. 자세한 내용은state
매개변수의 콘텐츠는state
매개변수를 사용하세요.
- 이 URL에는 정규화된 도메인 이름이 포함되어야 합니다.
새 URL 입력란에 URL을 입력합니다. 이 URL은 '신규' 버튼 사용자를 애플리케이션으로 리디렉션합니다.
(선택사항) 앱에서 Google Workspace 지원 파일을 열려면 다음 안내를 따르세요. 가져오기 체크박스를 선택합니다.
(선택사항) 앱에서 공유 드라이브의 파일을 관리해야 하는 경우 공유 드라이브 지원 체크박스를 선택합니다. 지원 방법에 대한 자세한 내용은 앱에 있는 공유 드라이브(공유 드라이브 구현 참고) 지원을 참조하세요.
제출을 클릭합니다.
drive.install
범위 요청
'연결 프로그램'에서 앱이 옵션으로 표시되도록 허용 또는 'New' 메뉴,
https://www.googleapis.com/auth/drive.install
범위를 통해 통합하도록 요청
관리할 수 있습니다. 이 범위를 요청하면 사용자는
다음과 비슷한 대화상자가 표시됩니다.
![Google Drive UI의 설치 대화상자](https://developers-dot-devsite-v2-prod.appspot.com/static/drive/images/install-scope.png?authuser=3&hl=ko)
Drive 앱에 요청할 수 있는 범위에 관한 자세한 내용은 요청 방법은 API별 승인 및 인증 페이지를 참조하세요. 참조하세요.
state
매개변수
기본적으로 state
매개변수는 Open URL과 New URL에 모두 추가됩니다.
데이터를 Drive UI에서 앱으로 전달할 수 있습니다. 이 매개변수
에는 템플릿 변수 및
요청을 앱에 보냅니다. 포함된 변수는 사용된 URL의 유형에 따라 다릅니다 (예:
URL 또는 새 URL):
템플릿 변수 | 설명 | URL 적용 |
---|---|---|
{ids} |
열려 있는 파일 ID의 쉼표로 구분된 목록입니다. | URL 열기 |
{exportIds} |
내보내는 파일 ID의 쉼표로 구분된 목록 (참고로만 사용) 기본 제공되는 Google 문서를 열 때). | URL 열기 |
{resourceKeys} |
각 리소스에 매핑된 파일 ID의 JSON 사전 키를 누릅니다. | URL 열기 |
{folderId} |
상위 폴더의 ID입니다. | 새 URL |
{folderResourceKey} |
상위 폴더의 리소스 키입니다. | 새 URL |
{userId} |
사용자를 식별하는 프로필 ID입니다. | URL 열기 및 새 URL |
{action} |
수행 중인 작업입니다. 값은
Open URL 또는 create 를 사용하는 경우 open
(새 URL 사용 시)
|
URL 열기 및 새 URL |
state
매개변수는 URL로 인코딩되므로 앱에서 이스케이프를 처리해야 합니다.
JSON으로 파싱합니다 앱은create
state
매개변수를 사용하여 파일 생성 요청을 확인합니다.
새 URL에 대한 JSON 형식의 상태 정보 예
새 URL의 state
정보는 다음과 같습니다.
{
"action":"create",
"folderId":"FOLDER_ID",
"folderResourceKey":"FOLDER_RESOURCE_KEY",
"userId":"USER_ID"
}
Open URL에 관한 JSON 형식의 상태 정보 예
Open URL의 state
정보는 다음과 같습니다.
{
"ids": ["ID"],
"resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
"action":"open",
"userId":"USER_ID"
}
파일 메타데이터를 가져오고 파일을 다운로드하는 데 ID와 리소스 키가 사용됩니다.
있습니다. 앱에 파일 ID와 액세스 토큰이 있으면
파일 메타데이터를 가져오고, 설명된 대로 파일 콘텐츠를 다운로드할 수 있습니다.
(files.get
메서드에서)
관련 주제
설치된 앱은 다음에서 실행되는 작업을 만들고, 관리하고, 열 수 있어야 합니다. 사용할 수 있습니다. 자세한 내용은 Drive UI 'New' 버튼 또는 Drive UI의 '연결 프로그램'과 통합 컨텍스트 메뉴를 엽니다.