이 페이지에는 Google Picker API에서 사용할 수 있는 클래스, 메서드, 열거형 목록이 포함되어 있습니다. 이러한 요소는 모두 네임스페이스 google.picker.*
에 속합니다.
두 가지 유형의 클래스와 열거형이 있습니다. Google 선택 도구를 빌드하고 구성하는 데 사용되는 클래스와 사용자가 항목을 선택한 후 Google 선택 도구에서 반환하는 클래스입니다.
구성 클래스 및 유형
Google 선택 도구를 빌드하고 구성하는 데 다음 클래스와 열거형이 사용됩니다.
DocsUploadView
DocsUploadView
을(를) 사용하여 Google Drive에 문서를 업로드하세요.
DocsUploadView() | 생성자입니다. |
DocsUploadView.setIncludeFolders(boolean) | 사용자가 Google Drive에서 업로드할 폴더를 선택하도록 허용합니다. |
DocsUploadView.setParent(string) | 업로드 대상을 지정된 폴더로 설정합니다. 그러면 setIncludeFolders 가 false로 재정의됩니다. |
DocsView
DocsView
는 Google Drive 뷰에 사용할 수 있는 View
의 서브클래스입니다.
DocsView(ViewId | undefined) | 생성자입니다. ViewId 은(는) Google Drive 뷰 중 하나여야 합니다. 기본값은 ViewId.DOCS 입니다. |
DocsView.setEnableDrives(boolean) | 공유 드라이브 및 공유 드라이브에 포함된 파일을 표시합니다. 사용 설정하기 전에 공유 드라이브 사용 설정에 대한 Google Drive API 문서를 참고하세요. |
DocsView.setIncludeFolders(boolean) | 뷰 항목에 폴더를 표시합니다. setOwnedByMe 와 결합하지 마세요. setIncludeFolders(true) 가 설정되면 setOwnedByMe 가 무시됩니다. |
DocsView.setSelectFolderEnabled(boolean) | 사용자가 Google Drive의 폴더를 선택하도록 허용합니다. |
DocsView.setMode(DocsViewMode) | 뷰가 문서를 표시하는 데 사용하는 모드를 선택합니다. |
DocsView.setOwnedByMe(boolean | undefined) | 문서가 사용자 소유인지 또는 사용자와 공유되었는지에 따라 문서를 필터링합니다. 이 설정을 setIncludeFolders 과(와) 함께 사용하지 마세요. setIncludeFolders(true) 가 설정되면 setOwnedByMe 가 무시됩니다. |
DocsView.setParent(string) | 표시할 초기 상위 폴더를 설정합니다. |
DocsView.setStarred(boolean) | 사용자가 별표표시했는지 여부에 따라 문서를 필터링합니다. |
DocsViewMode
DocsViewMode
는 DocsView 내에 데이터를 표시하기 위한 열거형 유형입니다. 이러한 값은 DocsView.setMode
호출에 사용합니다.
DocsViewMode.GRID | 미리보기 이미지 그리드로 문서를 표시합니다. |
DocsViewMode.LIST | 문서를 세부 목록에 표시합니다. |
특성
Feature
는 다양한 뷰의 기능을 사용 설정/사용 중지하는 열거형 유형입니다. 이러한 값은 PickerBuilder.enableFeature
및 PickerBuilder.disableFeature
호출에 사용합니다.
Feature.MINE_ONLY | Google Drive의 항목을 표시할 때 사용자가 소유한 문서만 표시합니다. |
Feature.MULTISELECT_ENABLED | 사용자가 2개 이상의 항목을 선택할 수 있도록 허용합니다. |
Feature.NAV_HIDDEN | 탐색창을 숨깁니다. 탐색창을 숨기면 사용자는 선택한 첫 번째 보기에서만 선택할 수 있습니다. |
Feature.SIMPLE_UPLOAD_ENABLED | 사진 업로드의 경우 사진별로 선택 (앨범별이 아님)을 사용하도록 설정할지 제어합니다. |
Feature.SUPPORT_DRIVES |
지원 중단됨: 이제 공유 드라이브 항목이 기본적으로 포함됩니다. 공유 드라이브 항목이 결과에 포함되는지 여부입니다. |
선택 도구
Picker
는 사용자와의 UI 작업을 나타내는 최상위 객체입니다. 이러한 객체는 직접 생성되지 않고 대신 PickerBuilder
객체를 사용합니다.
Picker.isVisible() | 현재 선택 도구 공개 상태를 나타내는 불리언을 가져옵니다. |
Picker.setCallback(function(object)) | 사용자가 항목을 선택하거나 취소할 때마다 호출되는 콜백 메서드를 지정합니다. |
Picker.setRelayUrl(string) | 교차 도메인 문제를 우회하려면 릴레이 URL을 지정하세요. |
Picker.setVisible(boolean) | 선택 도구 객체의 공개 상태를 제어합니다. |
Picker.dispose() | Picker 객체를 삭제합니다. |
PickerBuilder
PickerBuilder
는 Picker
객체를 만드는 데 사용됩니다. 달리 명시되지 않는 한 아래 메서드의 반환 유형은 PickerBuilder
유형이므로 호출을 차례로 연결할 수 있습니다. 일반적인 사용 방법은 Google 선택도구 코드 샘플을 참고하세요.
PickerBuilder() | 생성자입니다. |
PickerBuilder.addView( | 탐색창에 View 를 추가합니다. |
PickerBuilder.addViewGroup(ViewGroup) | 최상위 탐색창에 ViewGroup 를 추가합니다. |
PickerBuilder.build() | Picker 객체를 구성합니다. Picker 객체가 반환됩니다. |
PickerBuilder.disableFeature(Feature) | 선택 도구 기능을 사용 중지합니다. |
PickerBuilder.enableFeature(Feature) | 선택 도구 기능을 사용 설정합니다. |
PickerBuilder.getRelayUrl() | Dialogflows.RPC에 사용되는 릴레이 URL을 가져옵니다. |
PickerBuilder.getTitle() | 대화상자 제목을 가져옵니다. |
PickerBuilder.hideTitleBar() | 제목 표시줄을 표시하지 않도록 설정합니다. 다시 사용 설정하려면 제목이 비어 있지 않거나 정의되지 않은 상태로 setTitle 를 호출하세요. |
PickerBuilder.isFeatureEnabled(Feature) | 선택 도구 Feature 가 사용 설정되어 있는지 확인합니다. |
PickerBuilder.setAppId(string) | 애플리케이션이 Google Drive API를 통해 사용자의 파일에 액세스하는 데 필요한 Google Drive App ID를 설정합니다. |
PickerBuilder.setCallback(method) | 콜백 메서드를 설정합니다. 이 메서드는 사용자가 항목을 선택하거나 취소할 때 호출됩니다. 콜백 메서드는 단일 콜백 객체를 수신합니다. 콜백 객체의 구조는 JSON 가이드에 설명되어 있습니다. |
PickerBuilder.setDeveloperKey(string) | Google API 콘솔에서 가져온 브라우저 API 키를 설정합니다. 브라우저 API 키를 얻는 방법에 대한 자세한 내용은 개발자 가이드를 참고하세요. |
PickerBuilder.setDocument(document) | 문서를 설정합니다. |
PickerBuilder.setLocale(string) | ISO 639 언어 코드입니다. 지원되지 않는 언어인 경우 en-US가 사용됩니다. 이 메서드는 google.load() 시간에 언어를 설정하는 대신 사용할 수 있습니다. 지원되는 언어 목록은 개발자 가이드를 참고하세요. |
PickerBuilder.setMaxItems(number) | 사용자가 선택할 수 있는 최대 항목 수를 설정합니다. |
PickerBuilder.setOAuthToken(string) | 현재 사용자를 인증하는 데 사용할 OAuth 토큰을 설정합니다. 토큰의 범위에 따라 특정 뷰만 데이터를 표시합니다. 유효한 범위는 Google Docs 및 Drive입니다. |
PickerBuilder.setOrigin(string) | Google 선택도구 대화상자의 출처를 설정합니다. 애플리케이션이 iframe에서 실행 중인 경우 원점은 맨 위 페이지의 window.location.protocol + '//' + window.location.host 로 설정해야 합니다. |
PickerBuilder.setRelayUrl(string) | toolss.RPC에 사용되는 릴레이 URL을 설정합니다. |
PickerBuilder.setSelectableMimeTypes(string) | 선택 가능한 MIME 유형 목록을 설정합니다. MIME 유형이 두 개 이상 필요한 경우 쉼표를 사용하여 구분하세요. |
PickerBuilder.setSize() | 원하는 대화상자 크기를 설정합니다. 대화상자는 가운데에 자동으로 배치됩니다. 최소 크기는 (566,350), 최대 크기는 (1051,650)입니다. |
PickerBuilder.setTitle(string) | 대화상자 제목을 설정합니다. |
PickerBuilder.toUri() | 이 빌더에서 생성한 URI를 반환합니다. |
ResourceId
ResourceId
는 Google Documents List API에 적합한 리소스 ID를 생성하는 데 사용되는 정적 클래스입니다.
ResourceId.generate(Document) | 문서 객체를 리소스 ID에 매핑합니다. |
보기
View
는 다양한 View 클래스의 추상 기본 클래스입니다(예: DocsView
).
View(ViewId) | 생성자입니다. |
View.getId() | 이 뷰의 ViewId를 반환합니다. |
View.setMimeTypes(string) | 뷰에 포함된 MIME 유형을 설정합니다. MIME 유형이 두 개 이상 필요한 경우 쉼표를 사용하여 구분하세요. MIME 유형을 설정하지 않으면 모든 MIME 유형의 파일이 뷰에 표시됩니다. |
View.setQuery(string) | 검색이 포함된 보기의 경우 이러한 검색어로 검색어를 미리 채웁니다. |
ViewGroup
ViewGroup
는 뷰의 시각적 그룹입니다. ViewGroup 자체의 루트 항목은 View
여야 합니다.
ViewGroup(View | ViewId) | ViewGroup 는 탐색창에 있는 뷰를 시각적으로 그룹화한 것입니다. ViewGroup 자체의 루트 항목은 View 여야 합니다. |
ViewGroup.addLabel(string) | 이 ViewGroup 에 라벨을 추가합니다. |
ViewGroup.addView(ViewId | View) | ViewGroup 에 뷰를 추가합니다. View 는 view 에서 파생된 객체로 표시되거나 단순히 ViewId로 표시될 수 있습니다. |
ViewGroup.addViewGroup(ViewGroup) | 현재 ViewGroup 내에 ViewGroup 를 중첩합니다. |
ViewId
ViewId
는 View
및 ViewGroup
객체를 구성하는 데 사용되는 열거형입니다.
ViewId.DOCS | 모든 Google Drive 문서 유형 |
ViewId.DOCS_IMAGES | Google Drive 사진 |
ViewId.DOCS_IMAGES_AND_VIDEOS | Google Drive 사진 및 동영상 |
ViewId.DOCS_VIDEOS | Google Drive 동영상 |
ViewId.DOCUMENTS | Google Drive 문서. |
ViewId.DRAWINGS | Google Drive 드로잉 |
ViewId.FOLDERS | Google Drive 폴더. |
ViewId.FORMS | Google Drive Forms |
ViewId.PDFS | Google Drive에 저장된 PDF 파일 |
ViewId.PRESENTATIONS | Google Drive 프레젠테이션. |
ViewId.SPREADSHEETS | Google Drive Sheets로 이동합니다. |
콜백 유형
Google Picker API에서 반환한 콜백 데이터에는 다음과 같은 열거형이 있습니다.
작업
Action
는 사용자가 대화상자를 닫기 위해 실행한 작업을 나타내는 열거형 유형입니다. 이 값은 콜백 데이터의 Response.ACTION
필드에 있습니다.
Action.CANCEL | 사용자가 Google 선택도구 대화상자를 취소했습니다. |
Action.PICKED | 사용자가 한 개 이상의 항목을 선택했습니다. |
문서
Document
는 선택된 특정 항목에 관한 정보를 전달하는 데 사용되는 열거형입니다. 선택한 항목과 관련된 필드만 반환됩니다. 이 값은 콜백 데이터의 Response.DOCUMENTS
필드에 있습니다.
Document.DESCRIPTION | 선택한 항목에 대한 사용자 제작 설명입니다. |
Document.DURATION | 선택한 동영상의 길이입니다. |
Document.EMBEDDABLE_URL | 웹페이지에 삽입하기에 적합한 이 항목의 URL입니다. |
Document.ICON_URL | 이 항목에 대한 아이콘의 URL입니다. |
Document.ID | 선택한 항목의 ID입니다. |
Document.IS_NEW | 선택한 항목이 방금 업로드된 경우 true를 반환합니다. |
Document.LAST_EDITED_UTC | 이 항목이 마지막으로 수정된 시간을 설명하는 타임스탬프입니다. |
Document.MIME_TYPE | 이 항목의 MIME 유형입니다. |
Document.NAME | 이 항목의 이름입니다. |
Document.NUM_CHILDREN | 이 항목에 포함된 하위 항목의 수입니다. 예를 들어 선택한 폴더의 파일 수입니다. |
Document.PARENT_ID | 이 항목의 상위 ID입니다. 예를 들어 이 파일이 포함된 폴더입니다. |
Document.SERVICE_ID | 이 항목이 선택된 서비스를 설명하는 ServiceId 입니다. |
Document.THUMBNAILS | 사진 또는 동영상의 속성을 설명하는 Thumbnail 의 배열입니다. 선택한 항목이 Google Drive에 속한 경우 썸네일이 반환되지 않습니다. |
Document.TYPE | 선택한 항목의 Type 입니다. |
Document.URL | 이 항목에 대한 URL입니다. |
응답
Response
는 사용자가 선택한 항목에 관한 정보를 전달하는 데 사용되는 열거형입니다.
Response.ACTION | Action 유형은 사용자가 대화상자를 닫기 위해 실행한 작업을 나타냅니다. |
Response.DOCUMENTS | 사용자가 선택한 Document 의 배열입니다. |
Response.PARENTS | 선택한 항목에 대한 상위 폴더의 ID입니다. (예: 파일이 선택된 상위 폴더의 ID) |
Response.VIEW | 사용자가 이러한 항목을 선택한 View 입니다. |
서비스 ID
ServiceId
는 항목이 선택된 서비스를 설명하는 데 사용되는 열거형입니다. 이 값은 선택한 Document
의 Document.SERVICE_ID
필드에 있습니다.
ServiceId.DOCS | Google 드라이브. |
썸네일
Thumbnail
는 선택한 사진 또는 동영상에 관한 정보를 전달하는 데 사용되는 열거형입니다. 이 값은 선택한 Document
의 Document.THUMBNAILS
필드에서 찾을 수 있습니다.
Thumbnail.HEIGHT | 사진 또는 동영상의 높이입니다(단위: 픽셀). |
Thumbnail.WIDTH | 사진 또는 동영상의 너비입니다(단위: 픽셀). |
Thumbnail.URL | 선택한 사진 또는 동영상의 URL입니다. |
유형
Type
는 선택한 항목을 분류하는 데 사용되는 열거형입니다. 이 값은 선택한 Document
의 Document.TYPE
필드에서 찾을 수 있습니다.
Type.DOCUMENT | 항목이 문서입니다. |
Type.PHOTO | 항목이 사진입니다. |
Type.VIDEO | 항목이 동영상입니다. |