Riferimento API Google Picker

Questa pagina contiene un elenco di classi, metodi e tipi enumerati disponibili nell'API Google Picker. Tutti questi elementi appartengono allo spazio dei nomi. google.picker.* Esistono due tipi di classi e tipi enumerati: quelli utilizzati per creare e configurare il selettore di Google e quelli che vengono restituiti dal selettore di Google dopo che l'utente ha selezionato un elemento.

Classi e tipi di configurazione

Le classi e i tipi enumerati seguenti vengono utilizzati per creare e configurare il selettore Google.

DocsUploadView

Utilizza DocsUploadView per caricare documenti su Google Drive.

DocsUploadView()Costruttore.
DocsUploadView.setIncludeFolders(boolean)Consente all'utente di selezionare una cartella di Google Drive in cui eseguire il caricamento.
DocsUploadView.setParent(string)Imposta la destinazione di caricamento sulla cartella specificata. Questo sostituisce setIncludeFolders su false.

DocsView

DocsView è una sottoclasse di View che può essere utilizzata per le visualizzazioni di Google Drive.

DocsView(ViewId | undefined)Costruttore. L'elemento ViewId deve essere una delle visualizzazioni di Google Drive. Il valore predefinito è ViewId.DOCS.
DocsView.setEnableDrives(boolean)Mostra i Drive condivisi e i file che contengono. Prima dell'attivazione, consulta la documentazione dell'API Google Drive per abilitare i Drive condivisi.
DocsView.setIncludeFolders(boolean)Mostra le cartelle negli elementi di visualizzazione. Non combinare con setOwnedByMe. Quando viene impostato setIncludeFolders(true), setOwnedByMe viene ignorato.
DocsView.setSelectFolderEnabled(boolean)Consente all'utente di selezionare una cartella su Google Drive.
DocsView.setMode(DocsViewMode)Consente di selezionare la modalità utilizzata dalla visualizzazione per mostrare i documenti.
DocsView.setOwnedByMe(boolean | undefined)Filtra i documenti in base al fatto che siano di proprietà dell'utente o condivisi con l'utente. Non combinare questa impostazione con setIncludeFolders. Quando viene impostato setIncludeFolders(true), setOwnedByMe viene ignorato.
DocsView.setParent(string)Consente di impostare la cartella principale iniziale da visualizzare.
DocsView.setStarred(boolean)Filtra i documenti in base all'eventuale aggiunta a Speciali dall'utente.

DocsViewMode

DocsViewMode è un tipo enumerato per la visualizzazione dei dati all'interno di DocumentiView. Utilizza questi valori nelle chiamate a DocsView.setMode.

DocsViewMode.GRIDVisualizza i documenti in una griglia delle miniature.
DocsViewMode.LISTVisualizza i documenti in un elenco dettagliato.

Selezione delle

Feature è un tipo enumerato, per attivare/disattivare le funzionalità per varie viste. Utilizza questi valori nelle chiamate a PickerBuilder.enableFeature e PickerBuilder.disableFeature.

Feature.MINE_ONLYMostra solo i documenti di proprietà dell'utente quando mostri elementi da Google Drive.
Feature.MULTISELECT_ENABLEDConsenti all'utente di scegliere più di un elemento.
Feature.NAV_HIDDENNascondi il riquadro di navigazione. Se il riquadro di navigazione è nascosto, gli utenti possono selezionare solo la prima visualizzazione scelta.
Feature.SIMPLE_UPLOAD_ENABLEDPer i caricamenti di foto, consente di stabilire se attivare o meno la selezione per foto (anziché per album).
Feature.SUPPORT_DRIVES

Obsoleto: gli elementi dei Drive condivisi sono ora inclusi per impostazione predefinita.

Indica se gli elementi del Drive condiviso sono inclusi nei risultati.

Selettore

Picker è l'oggetto di primo livello che rappresenta l'azione della UI con l'utente. Questi oggetti non vengono creati direttamente, ma utilizzano l'oggetto PickerBuilder.

Picker.isVisible()Ottieni un valore booleano che indica la visibilità attuale del selettore.
Picker.setCallback(function(object))Specifica il metodo di callback che viene chiamato ogni volta che l'utente seleziona un articolo (o annulla).
Picker.setRelayUrl(string)Specifica un URL di inoltro per aggirare i problemi tra domini.
Picker.setVisible(boolean)Controlla la visibilità dell'oggetto selettore.
Picker.dispose()Elimina l'oggetto selettore.

PickerBuilder

PickerBuilder viene utilizzato per creare oggetti Picker. Salvo dove diversamente indicato, il tipo restituito di seguito è di tipo PickerBuilder, consentendoti di concatenare una chiamata dopo un'altra. Consulta l'esempio di codice del selettore Google per l'utilizzo tipico.

PickerBuilder()Costruttore.
PickerBuilder.addView(View | ViewId)Aggiungi un elemento View al riquadro di navigazione.
PickerBuilder.addViewGroup(ViewGroup)Aggiungi un elemento ViewGroup al riquadro di navigazione di primo livello.
PickerBuilder.build()Costruire l'oggetto Selettore. Viene restituito l'oggetto selettore.
PickerBuilder.disableFeature(Feature)Disattiva una funzionalità di selezione.
PickerBuilder.enableFeature(Feature)Attiva una funzionalità selettore.
PickerBuilder.getRelayUrl()Ottieni l'URL di inoltro, utilizzato per gadget.rpc.
PickerBuilder.getTitle()Recupera il titolo della finestra di dialogo.
PickerBuilder.hideTitleBar()Disattiva la visualizzazione della barra del titolo. Per riattivarla, chiama setTitle con un titolo non vuoto o con un titolo non definito.
PickerBuilder.isFeatureEnabled(Feature)Controlla se è attivo un selettore Feature.
PickerBuilder.setAppId(string)Imposta l'ID app Google Drive necessario per consentire all'applicazione di accedere ai file dell'utente tramite l'API Google Drive.
PickerBuilder.setCallback(method)Imposta il metodo di callback. Questo metodo viene richiamato quando l'utente seleziona gli articoli o annulla. Il metodo di callback riceve un singolo oggetto callback. La struttura dell'oggetto callback è descritta nella guida JSON.
PickerBuilder.setDeveloperKey(string)Consente di impostare la chiave API del browser ottenuta dalla console API di Google. Per informazioni dettagliate su come ottenere la chiave API del browser, consulta la Guida per gli sviluppatori.
PickerBuilder.setDocument(document)Imposta il documento.
PickerBuilder.setLocale(string)codice lingua ISO 639. Se la lingua non è supportata, viene utilizzato en-US. Questo metodo fornisce un'alternativa all'impostazione delle impostazioni internazionali al momento di google.load(). Consulta la Guida per gli sviluppatori per un elenco delle impostazioni internazionali supportate.
PickerBuilder.setMaxItems(number)Imposta il numero massimo di elementi che un utente può selezionare.
PickerBuilder.setOAuthToken(string)Consente di impostare un token OAuth da utilizzare per autenticare l'utente corrente. A seconda dell'ambito del token, solo alcune viste mostrano dati. Gli ambiti validi sono Documenti Google e Drive.
PickerBuilder.setOrigin(string)Imposta l'origine della finestra di dialogo del selettore Google. L'origine deve essere impostata su window.location.protocol + '//' + window.location.host della pagina più in alto, se l'applicazione è eseguita in un iframe.
PickerBuilder.setRelayUrl(string)Imposta l'URL di inoltro, utilizzato per gadget.rpc.
PickerBuilder.setSelectableMimeTypes(string)Consente di impostare l'elenco di tipi MIME selezionabili. Utilizza le virgole per separare i tipi MIME se sono necessari più tipi MIME.
PickerBuilder.setSize()Imposta le dimensioni preferite per la finestra di dialogo. La finestra di dialogo è centrata automaticamente. Ha una dimensione minima di (566.350) e una dimensione massima di (1051.650).
PickerBuilder.setTitle(string)Imposta il titolo della finestra di dialogo.
PickerBuilder.toUri()Restituisce l'URI generato da questo builder.

ResourceId

ResourceId è una classe statica utilizzata per generare ID risorsa adatti all'API Google Documents List.

ResourceId.generate(Document)Mappa un oggetto documento a un ID risorsa.

Visualizza

View è la classe base astratta per le varie classi View, come DocsView.

View(ViewId)Costruttore.
View.getId()Restituisce il valore ViewId per questa vista.
View.setMimeTypes(string)Imposta i tipi MIME inclusi nella visualizzazione. Utilizza le virgole per separare i tipi MIME se sono necessari più tipi MIME. Se non imposti i tipi MIME, nella visualizzazione vengono mostrati i file di tutti i tipi.
View.setQuery(string)Per le visualizzazioni che coinvolgono le ricerche, precompila la query di ricerca con questi termini.

ViewGroup

ViewGroup è un raggruppamento visivo di visualizzazioni. L'elemento principale dell'elemento ViewGroup stesso deve essere un View.

ViewGroup(View | ViewId)Una ViewGroup è un raggruppamento visivo di viste nel riquadro di navigazione. L'elemento principale di ViewGroup deve essere View.
ViewGroup.addLabel(string)Aggiungi un'etichetta a questa ViewGroup.
ViewGroup.addView(ViewId | View)Aggiungi una vista alla ViewGroup. View può essere rappresentato da un oggetto derivato da view o semplicemente da ViewId.
ViewGroup.addViewGroup(ViewGroup)Nidifica una ViewGroup all'interno dell'attuale ViewGroup.

ViewId

ViewId è un tipo enumerato, utilizzato per creare oggetti View e ViewGroup.

ViewId.DOCSTutti i tipi di documenti di Google Drive.
ViewId.DOCS_IMAGESFoto di Google Drive.
ViewId.DOCS_IMAGES_AND_VIDEOSFoto e video di Google Drive.
ViewId.DOCS_VIDEOSVideo di Google Drive.
ViewId.DOCUMENTSDocumenti di Google Drive.
ViewId.DRAWINGSDisegni Google Drive.
ViewId.FOLDERSCartelle di Google Drive.
ViewId.FORMSModuli di Google Drive.
ViewId.PDFSFile PDF archiviati su Google Drive.
ViewId.PRESENTATIONSPresentazioni su Google Drive.
ViewId.SPREADSHEETSFogli di lavoro Google Drive.

Tipi di callback

I seguenti tipi enumerati sono presenti nei dati di callback restituiti dall'API Google Picker.

Azione

Action è un tipo enumerato che rappresenta l'azione intrapresa dall'utente per chiudere la finestra di dialogo. Questo valore si trova nel campo Response.ACTION nei dati di callback.

Action.CANCELL'utente ha annullato la finestra di dialogo del selettore Google.
Action.PICKEDL'utente ha scelto almeno un elemento.

Documento

Document è un tipo enumerato utilizzato per fornire informazioni su uno specifico elemento selezionato. Vengono restituiti solo i campi pertinenti all'elemento selezionato. Questo valore si trova nel campo Response.DOCUMENTS nei dati di callback.

Document.DESCRIPTIONUna descrizione dell'elemento selezionato fornita dall'utente.
Document.DURATIONLa durata del video selezionato.
Document.EMBEDDABLE_URLUn URL per questo elemento adatto per l'incorporamento in una pagina web.
Document.ICON_URLUn URL che rimanda a un'icona per questo elemento.
Document.IDL'ID dell'elemento selezionato.
Document.IS_NEWRestituisce true se l'elemento selezionato è stato appena caricato.
Document.LAST_EDITED_UTCIl timestamp che descrive la data dell'ultima modifica dell'elemento.
Document.MIME_TYPEIl tipo MIME di questo elemento.
Document.NAMEIl nome di questo elemento.
Document.NUM_CHILDRENIl numero di elementi secondari contenuti in questo elemento. Ad esempio, il numero di file nella cartella selezionata.
Document.PARENT_IDL'ID principale di questo elemento. ad esempio la cartella contenente questo file.
Document.SERVICE_IDUna ServiceId che descrive il servizio da cui è stato selezionato questo elemento.
Document.THUMBNAILSUn array di Thumbnail che descrivono gli attributi di una foto o di un video. Le miniature non vengono restituite se gli elementi selezionati appartengono a Google Drive.
Document.TYPEIl Type dell'elemento selezionato.
Document.URLUn URL per questo elemento.

Risposta

Response è un tipo enumerato utilizzato per fornire informazioni sugli elementi selezionati dall'utente.

Response.ACTIONUn tipo Action che rappresenta l'azione intrapresa dall'utente per chiudere la finestra di dialogo.
Response.DOCUMENTSUn array di Document selezionati dall'utente.
Response.PARENTSGli ID delle cartelle principali per gli elementi selezionati. ad esempio gli ID delle cartelle principali i cui file sono stati selezionati.
Response.VIEWIl View da cui l'utente ha selezionato questi elementi.

ID servizio

ServiceId è un tipo enumerato utilizzato per descrivere il servizio da cui è stato selezionato l'elemento. Questo valore si trova nel campo Document.SERVICE_ID dell'elemento Document selezionato.

ServiceId.DOCSGoogle Drive.

thumbnail

Thumbnail è un tipo enumerato utilizzato per fornire informazioni su una foto o un video selezionato. Questo valore si trova nel campo Document.THUMBNAILS di una Document selezionata.

Thumbnail.HEIGHTL'altezza della foto o del video in pixel.
Thumbnail.WIDTHLa larghezza della foto o del video in pixel.
Thumbnail.URLUn URL alla foto o al video selezionato.

Tipo

Type è un tipo enumerato utilizzato per classificare l'elemento selezionato. Questo valore si trova nel campo Document.TYPE di una Document selezionata.

Type.DOCUMENTL'elemento è un documento.
Type.PHOTOL'elemento è una foto.
Type.VIDEOL'elemento è un video.