Referencia de la API de selector de Google

Esta página contiene una lista de clases, métodos y tipos enumerados en la API de selector de Google. Todos estos elementos pertenecen al espacio de nombres google.picker.*. Hay 2 tipos de clases y tipos enumerados: las que se usan para compilar y configurar el selector de Google y las que muestra el selector de Google una vez que el usuario selecciona un elemento.

Tipos y clases de configuración

Las siguientes clases y los tipos enumerados se usan para compilar y configurar el selector de Google.

DocsUploadView

Usa DocsUploadView para subir documentos a Google Drive.

DocsUploadView()Constructor.
DocsUploadView.setIncludeFolders(boolean)Permite que el usuario seleccione una carpeta de Google Drive para realizar cargas.
DocsUploadView.setParent(string)Establece el destino de carga en la carpeta especificada. Esto anula setIncludeFolders como falso.

DocsView

DocsView es una subclase de View que se puede usar para las vistas de Google Drive.

DocsView(ViewId | undefined)Constructor. El elemento ViewId debe ser una de las vistas de Google Drive. El valor predeterminado es ViewId.DOCS.
DocsView.setEnableDrives(boolean)Muestra las unidades compartidas y los archivos que contienen. Antes de habilitarla, consulta la documentación de la API de Google Drive para habilitar unidades compartidas.
DocsView.setIncludeFolders(boolean)Mostrar carpetas en los elementos de la vista No se combine con setOwnedByMe. Cuando se configura setIncludeFolders(true), se ignora setOwnedByMe.
DocsView.setSelectFolderEnabled(boolean)Permite al usuario seleccionar una carpeta en Google Drive.
DocsView.setMode(DocsViewMode)Selecciona el modo que usará la vista para mostrar los documentos.
DocsView.setOwnedByMe(boolean | undefined)Filtra los documentos según si son propiedad del usuario o si se comparten con este. No combines esta configuración con setIncludeFolders. Cuando se configura setIncludeFolders(true), se ignora setOwnedByMe.
DocsView.setParent(string)Configura la carpeta superior inicial que se mostrará.
DocsView.setStarred(boolean)Filtra los documentos en función de si el usuario los destaca o no.

DocsViewMode

DocsViewMode es un tipo enumerado para mostrar datos dentro de una DocsView. Usa estos valores en las llamadas a DocsView.setMode.

DocsViewMode.GRIDMuestra los documentos en una cuadrícula de miniaturas.
DocsViewMode.LISTMuestra documentos en una lista detallada.

Función

Feature es un tipo enumerado para activar o desactivar componentes para varias vistas. Usa estos valores en las llamadas a PickerBuilder.enableFeature y PickerBuilder.disableFeature.

Feature.MINE_ONLYMostrar solo documentos que sean propiedad del usuario al mostrar elementos de Google Drive
Feature.MULTISELECT_ENABLEDPermitir que el usuario elija más de un elemento
Feature.NAV_HIDDENOculta el panel de navegación. Si el panel de navegación está oculto, los usuarios solo podrán seleccionar la primera vista que elijan.
Feature.SIMPLE_UPLOAD_ENABLEDEn las cargas de fotos, puedes controlar si está habilitada la selección por foto (en lugar de la selección por álbum).
Feature.SUPPORT_DRIVES

Obsoleto: Los elementos de las unidades compartidas ahora se incluyen de forma predeterminada.

Indica si los elementos de la unidad compartida se incluyen en los resultados.

Selector

Picker es el objeto de nivel superior que representa la acción de la IU con el usuario. Estos objetos no se crean directamente, sino que usan el objeto PickerBuilder.

Picker.isVisible()Obtén un valor booleano que indica la visibilidad actual del selector.
Picker.setCallback(function(object))Especifica el método de devolución de llamada al que se llama cada vez que el usuario selecciona un elemento (o lo cancela).
Picker.setRelayUrl(string)Especifica una URL de retransmisión para eludir problemas multidominio.
Picker.setVisible(boolean)Controlar la visibilidad del objeto del selector
Picker.dispose()Descarta el objeto de selector.

PickerBuilder

PickerBuilder se usa para crear objetos Picker. Excepto cuando se indique lo contrario, el tipo de métodos que se muestran a continuación es de tipo PickerBuilder, lo que te permite encadenar una llamada tras otra. Consulta la muestra de código del selector de Google para conocer el uso típico.

PickerBuilder()Constructor.
PickerBuilder.addView(View | ViewId)Agrega un objeto View al panel de navegación.
PickerBuilder.addViewGroup(ViewGroup)Agrega un objeto ViewGroup al panel de navegación de nivel superior.
PickerBuilder.build()Construye el objeto Picker. Se muestra el objeto de selector.
PickerBuilder.disableFeature(Feature)Inhabilita una función del selector.
PickerBuilder.enableFeature(Feature)Habilita una función de selector.
PickerBuilder.getRelayUrl()Obtén la URL de retransmisión, que se utiliza para gadgets.rpc.
PickerBuilder.getTitle()Obtén el título del diálogo.
PickerBuilder.hideTitleBar()Inhabilitar la barra de título para que no se muestre. Para volver a habilitarla, llama a setTitle con un título que no esté vacío o no esté definido.
PickerBuilder.isFeatureEnabled(Feature)Comprueba si está habilitado un selector Feature.
PickerBuilder.setAppId(string)Establece el ID de app de Google Drive necesario para permitir que la aplicación acceda a los archivos del usuario a través de la API de Google Drive.
PickerBuilder.setCallback(method)Configura el método de devolución de llamada. Se llama a este método cuando el usuario selecciona elementos o cancela. El método de devolución de llamada recibe un solo objeto de devolución de llamada. La estructura del objeto de devolución de llamada se describe en la guía de JSON.
PickerBuilder.setDeveloperKey(string)Configura la clave de API del navegador que obtuvo en la Consola de API de Google. Consulta la Guía para desarrolladores para conocer los detalles sobre cómo obtener la clave de API del navegador.
PickerBuilder.setDocument(document)Configura el documento.
PickerBuilder.setLocale(string)Código de idioma ISO 639 Si el idioma no es compatible, se usa en-US. Este método proporciona una alternativa a la configuración de la configuración regional en el momento de google.load(). Consulta la Guía para desarrolladores para obtener una lista de las configuraciones regionales compatibles.
PickerBuilder.setMaxItems(number)Establece la cantidad máxima de elementos que puede seleccionar un usuario.
PickerBuilder.setOAuthToken(string)Configura un token de OAuth para autenticar al usuario actual. Según el alcance del token, solo ciertas vistas muestran datos. Los permisos válidos son Documentos de Google, Drive, Fotos y YouTube.
PickerBuilder.setOrigin(string)Establece el origen del cuadro de diálogo del selector de Google. Si la aplicación se ejecuta en un iframe, se debe establecer el origen en el window.location.protocol + '//' + window.location.host de la página superior.
PickerBuilder.setRelayUrl(string)Establece la URL de retransmisión, que se utiliza para gadgets.rpc.
PickerBuilder.setSelectableMimeTypes(string)Establece la lista de tipos de MIME seleccionables. Usa comas para separar los tipos de MIME si se requiere más de uno.
PickerBuilder.setSize()Configura el tamaño de diálogo preferido. El diálogo se centra automáticamente. Tiene un tamaño mínimo de (566,350) y uno máximo de (1051,650).
PickerBuilder.setTitle(string)Define el título del diálogo.
PickerBuilder.toUri()Muestra el URI que generó este compilador.

ResourceId

ResourceId es una clase estática que se utiliza para generar IDs de recursos adecuados para la API de Google Documents List.

ResourceId.generate(Document)Asigna un objeto de documento a un ID de recurso.

Ver

View es la clase base abstracta para las distintas clases de vista, como DocsView.

View(ViewId)Constructor.
View.getId()Muestra el ViewId de esta vista.
View.setMimeTypes(string)Establece los tipos de MIME incluidos en la vista. Usa comas para separar los tipos de MIME si se requiere más de uno. Si no configuras los tipos MIME, se muestran todos los archivos de todos los tipos MIME en la vista.
View.setQuery(string)Para las vistas que implican búsquedas, completa previamente la búsqueda con estos términos.

ViewGroup

ViewGroup es una agrupación visual de vistas. El elemento raíz del objeto ViewGroup debe ser un View.

ViewGroup(View | ViewId)Un objeto ViewGroup es una agrupación visual de vistas en el panel de navegación. El elemento raíz de ViewGroup debe ser View.
ViewGroup.addLabel(string)Agrega una etiqueta a este elemento ViewGroup.
ViewGroup.addView(ViewId | View)Agrega una vista a ViewGroup. El View se puede representar mediante un objeto derivado de view o simplemente mediante ViewId.
ViewGroup.addViewGroup(ViewGroup)Anida un ViewGroup en el ViewGroup actual.

ViewId

ViewId es un tipo enumerado que se usa para construir objetos View y ViewGroup.

ViewId.DOCSTodos los tipos de documentos de Google Drive.
ViewId.DOCS_IMAGESFotos de Google Drive
ViewId.DOCS_IMAGES_AND_VIDEOSFotos y videos de Google Drive
ViewId.DOCS_VIDEOSVideos de Google Drive
ViewId.DOCUMENTSDocumentos de Google Drive.
ViewId.DRAWINGSDibujos de Google Drive
ViewId.FOLDERSCarpetas de Google Drive.
ViewId.FORMSFormularios de Google Drive
ViewId.PDFSLos archivos PDF almacenados en Google Drive.
ViewId.PRESENTATIONSPresentaciones de Google Drive.
ViewId.SPREADSHEETSHojas de cálculo de Google Drive

Tipos de devolución de llamada

Los siguientes tipos enumerados se encuentran en los datos de devolución de llamada que muestra la API de selector de Google.

Acción

Action es un tipo enumerado que representa la acción que realizó el usuario para descartar el diálogo. Este valor se encuentra en el campo Response.ACTION de los datos de devolución de llamada.

Action.CANCELEl usuario canceló el diálogo del selector de Google.
Action.PICKEDEl usuario eligió al menos un elemento.

Documento

Document es un tipo enumerado que se usa para transmitir información sobre un elemento seleccionado específico. Solo se muestran los campos relevantes para el elemento seleccionado. Este valor se encuentra en el campo Response.DOCUMENTS de los datos de devolución de llamada.

Document.DESCRIPTIONUna descripción del elemento seleccionado aportada por el usuario.
Document.DURATIONEs la duración de un video seleccionado.
Document.EMBEDDABLE_URLUna URL de este elemento adecuada para insertarse en una página web.
Document.ICON_URLUna URL a un ícono de este elemento.
Document.IDEl ID del elemento seleccionado.
Document.IS_NEWMuestra true si el elemento seleccionado se acaba de subir.
Document.LAST_EDITED_UTCLa marca de tiempo que indica cuándo se editó este elemento por última vez.
Document.MIME_TYPEEl tipo de MIME de este elemento.
Document.NAMEEs el nombre del artículo.
Document.NUM_CHILDRENEs la cantidad de elementos secundarios incluidos en este elemento. Por ejemplo, la cantidad de archivos en la carpeta seleccionada.
Document.PARENT_IDEl ID principal de este elemento. Por ejemplo, la carpeta que contiene este archivo.
Document.SERVICE_IDUn objeto ServiceId que describe el servicio del que se seleccionó este elemento.
Document.THUMBNAILSEs un array de Thumbnail que describe los atributos de una foto o un video. No se muestran las miniaturas si los elementos seleccionados pertenecen a Google Drive.
Document.TYPEEl Type del elemento seleccionado
Document.URLUna URL a este elemento.

Respuesta

Response es un tipo enumerado que se usa para transmitir información sobre los elementos seleccionados por el usuario.

Response.ACTIONUn tipo Action que representa la acción que realizó el usuario para descartar el diálogo.
Response.DOCUMENTSUn array de Document que selecciona el usuario.
Response.PARENTSLos ID de las carpetas superiores de los elementos seleccionados (Por ejemplo, los IDs de las carpetas superiores cuyos archivos se seleccionaron).
Response.VIEWEs el View del cual el usuario seleccionó estos elementos.

id-servicio

ServiceId es un tipo enumerado que se usa para describir el servicio desde el que se seleccionó el elemento. Este valor se encuentra en el campo Document.SERVICE_ID del Document seleccionado.

ServiceId.DOCSGoogle Drive.

miniatura

Thumbnail es un tipo enumerado que se usa para transmitir información sobre una foto o un video seleccionados. Puedes encontrar este valor en el campo Document.THUMBNAILS de un Document seleccionado.

Thumbnail.HEIGHTLa altura de la foto o el video en píxeles.
Thumbnail.WIDTHEs el ancho de la foto o el video en píxeles.
Thumbnail.URLUna URL para la foto o el video seleccionado

tipo

Type es un tipo enumerado que se usa para categorizar el elemento seleccionado. Puedes encontrar este valor en el campo Document.TYPE de un Document seleccionado.

Type.DOCUMENTEl elemento es un documento.
Type.PHOTOEl elemento es una foto.
Type.VIDEOEl elemento es un video.