Google Picker API 참조

이 페이지에는 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.enableFeaturePickerBuilder.disableFeature 호출에 사용합니다.

Feature.MINE_ONLYGoogle 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

PickerBuilderPicker 객체를 만드는 데 사용됩니다. 달리 명시되지 않는 한 아래 메서드의 반환 유형은 PickerBuilder 유형이므로 호출을 차례로 연결할 수 있습니다. 일반적인 사용 방법은 Google 선택도구 코드 샘플을 참고하세요.

PickerBuilder()생성자입니다.
PickerBuilder.addView(View | ViewId)탐색창에 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에 뷰를 추가합니다. Viewview에서 파생된 객체로 표시되거나 단순히 ViewId로 표시될 수 있습니다.
ViewGroup.addViewGroup(ViewGroup)현재 ViewGroup 내에 ViewGroup를 중첩합니다.

ViewId

ViewIdViewViewGroup 객체를 구성하는 데 사용되는 열거형입니다.

ViewId.DOCS모든 Google Drive 문서 유형
ViewId.DOCS_IMAGESGoogle Drive 사진
ViewId.DOCS_IMAGES_AND_VIDEOSGoogle Drive 사진 및 동영상
ViewId.DOCS_VIDEOSGoogle Drive 동영상
ViewId.DOCUMENTSGoogle Drive 문서.
ViewId.DRAWINGSGoogle Drive 드로잉
ViewId.FOLDERSGoogle Drive 폴더.
ViewId.FORMSGoogle Drive Forms
ViewId.PDFSGoogle Drive에 저장된 PDF 파일
ViewId.PRESENTATIONSGoogle Drive 프레젠테이션.
ViewId.SPREADSHEETSGoogle 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.ACTIONAction 유형은 사용자가 대화상자를 닫기 위해 실행한 작업을 나타냅니다.
Response.DOCUMENTS사용자가 선택한 Document의 배열입니다.
Response.PARENTS선택한 항목에 대한 상위 폴더의 ID입니다. (예: 파일이 선택된 상위 폴더의 ID)
Response.VIEW사용자가 이러한 항목을 선택한 View입니다.

서비스 ID

ServiceId는 항목이 선택된 서비스를 설명하는 데 사용되는 열거형입니다. 이 값은 선택한 DocumentDocument.SERVICE_ID 필드에 있습니다.

ServiceId.DOCSGoogle 드라이브.

썸네일

Thumbnail는 선택한 사진 또는 동영상에 관한 정보를 전달하는 데 사용되는 열거형입니다. 이 값은 선택한 DocumentDocument.THUMBNAILS 필드에서 찾을 수 있습니다.

Thumbnail.HEIGHT사진 또는 동영상의 높이입니다(단위: 픽셀).
Thumbnail.WIDTH사진 또는 동영상의 너비입니다(단위: 픽셀).
Thumbnail.URL선택한 사진 또는 동영상의 URL입니다.

유형

Type는 선택한 항목을 분류하는 데 사용되는 열거형입니다. 이 값은 선택한 DocumentDocument.TYPE 필드에서 찾을 수 있습니다.

Type.DOCUMENT항목이 문서입니다.
Type.PHOTO항목이 사진입니다.
Type.VIDEO항목이 동영상입니다.