이 페이지에는 Google Picker API에서 사용할 수 있는 클래스, 메서드, 열거형 유형 목록이 포함되어 있습니다. 이러한 요소는 모두 네임스페이스 google.picker.*에 속합니다. Google 선택 도구를 빌드하고 구성하는 데 사용되는 클래스와 사용자가 항목을 선택한 후 Google 선택 도구에서 반환하는 클래스와 열거형의 두 가지 유형이 있습니다.
구성 클래스 및 유형
다음 클래스와 열거형 유형은 Google 선택 도구를 빌드하고 구성하는 데 사용됩니다.
문서 업로드 보기
DocsUploadView을(를) 사용하여 Google Drive에 문서를 업로드하세요.
DocsUploadView() | 생성자입니다. |
DocsUploadView.setIncludeFolders(boolean) | 사용자가 Google Drive에서 업로드할 폴더를 선택하도록 허용합니다. |
DocsUploadView.setParent(string) | 업로드 대상을 지정된 폴더로 설정합니다. 이는 setIncludeFolders를 false로 재정의합니다. |
Docs 뷰
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 | 사용자가 두 개 이상의 항목을 선택하도록 허용합니다. |
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() | 선택 도구 객체를 삭제합니다. |
선택 도구 빌더
PickerBuilder는 Picker 객체를 만드는 데 사용됩니다. 달리 명시되지 않는 한 아래 메서드의 반환 유형은 PickerBuilder 유형이므로 하나의 호출을 차례로 연결할 수 있습니다. 일반적인 용도는 Google 선택 도구 코드 샘플을 참고하세요.
PickerBuilder() | 생성자입니다. |
PickerBuilder.addView( | 탐색창에 View를 추가합니다. |
PickerBuilder.addViewGroup(ViewGroup) | 최상위 탐색 창에 ViewGroup를 추가합니다. |
PickerBuilder.build() | 선택 도구 객체를 구성합니다. 선택 도구 객체가 반환됩니다. |
PickerBuilder.disableFeature(Feature) | 선택 도구 기능을 사용 중지합니다. |
PickerBuilder.enableFeature(Feature) | 선택 도구 기능을 사용 설정합니다. |
PickerBuilder.getRelayUrl() | Gadgets.rpc에 사용되는 릴레이 URL을 가져옵니다. |
PickerBuilder.getTitle() | 대화상자 제목을 가져옵니다. |
PickerBuilder.hideTitleBar() | 제목 표시줄이 표시되지 않도록 사용 중지합니다. 다시 사용 설정하려면 비어 있지 않거나 제목이 정의되지 않은 setTitle를 호출합니다. |
PickerBuilder.isFeatureEnabled(Feature) | 선택 도구 Feature가 사용 설정되어 있는지 확인합니다. |
PickerBuilder.setAppId(string) | 애플리케이션이 Google Drive API를 통해 사용자 파일에 액세스하도록 허용하는 데 필요한 Google Drive 앱 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, 포토, YouTube입니다. |
PickerBuilder.setOrigin(string) | Google 선택 도구 대화상자의 출처를 설정합니다. 애플리케이션을 iframe에서 실행하는 경우 출처가 최상위 페이지의 window.location.protocol + '//' + window.location.host로 설정되어야 합니다. |
PickerBuilder.setRelayUrl(string) | 가젯.rpc에 사용되는 릴레이 URL을 설정합니다. |
PickerBuilder.setSelectableMimeTypes(string) | 선택 가능한 MIME 유형 목록을 설정합니다. MIME 유형이 두 개 이상인 경우 쉼표를 사용하여 구분합니다. |
PickerBuilder.setSize() | 원하는 대화상자 크기를 설정합니다. 대화상자가 자동으로 가운데 표시됩니다. 최소 크기는 (566,350), 최대 크기는 (1051,650)입니다. |
PickerBuilder.setTitle(string) | 대화상자 제목을 설정합니다. |
PickerBuilder.toUri() | 이 빌더가 생성한 URI를 반환합니다. |
리소스 ID
ResourceId는 Google Documents List API에 적합한 리소스 ID를 생성하는 데 사용되는 정적 클래스입니다.
ResourceId.generate(Document) | 문서 객체를 리소스 ID에 매핑합니다. |
보기
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을 중첩합니다. |
뷰 ID
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 스프레드시트 |
콜백 유형
다음과 같은 열거형은 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 | 동영상 항목입니다. |