Quando un utente seleziona un file e fa clic sul pulsante "Apri con" dell'interfaccia utente di Drive voce di menu, Reindirizzamenti di Drive l'utente all'URL di apertura dell'app definito in Configurare una UI di Drive integrazione.
Se hai selezionato la casella di controllo "Importazione" quando hai configurato una UI di Drive. integrazione, l'utente può selezionare una combinazione di opzioni specifiche dell'app e File di Google Workspace da aprire. Quando configuri una UI di Drive i file specifici delle app sono definiti nella sezione "Tipi MIME predefiniti" e "Estensioni di file predefinite" mentre Google Workspace sono definiti nella sezione "Tipi MIME secondari" ed "Estensioni file secondarie" campi.
Per ogni file che l'utente vuole aprire, Drive controlla lo stato MIME rispetto ai tipi MIME predefiniti e secondari definiti:
Per i tipi MIME definiti in "Tipi MIME predefiniti" , l'ID del file è passati all'app. Per informazioni su come gestire file specifici delle app, consulta Gestire un URL di apertura per i documenti specifici dell'app.
Per i tipi MIME definiti in "Tipi MIME secondari" il campo La UI di Drive mostra una finestra di dialogo che chiede all'utente quale tipo di file deve converti il file di Google Workspace. Ad esempio, se selezioni un File di Documenti Google nella UI di Drive e "MIME secondario tipi" suggerisce che la tua app supporta testo/normale o applicazione/pdf, il La UI di Drive chiede all'utente se vuole effettuare la conversione in testo normale o PDF.
Per informazioni su come gestire Google Workspace vedi Gestire un URL di apertura per i documenti di Google Workspace. Per un elenco dei documenti di Google Workspace e dei formati di conversione di tipo MIME: consulta Esportare i tipi MIME per Google Workspace documenti.
Gestire un URL di apertura per i documenti specifici dell'app
Come accennato in Configurare una UI di Drive
integrazione,
la tua app riceve variabili di modello con informazioni per l'apertura dell'app
del file. La tua app riceve un insieme predefinito di variabili del modello
in un parametro state
. La
Le informazioni predefinite di state
per un URL di apertura specifico dell'app sono:
{
"ids": ["ID"],
"resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
"action":"open",
"userId":"USER_ID"
}
Questo output include i seguenti valori:
- ID: l'ID della cartella principale.
- RESOURCE_KEYS: un dizionario JSON di ID file mappati a e le rispettive chiavi delle risorse.
open
: l'azione eseguita. Il valore èopen
quando viene utilizzato un modello URL.- USER_ID: l'ID profilo che identifica in modo univoco l'utente.
L'app deve rispondere a questa richiesta seguendo questa procedura:
- Verifica che il campo
action
abbia il valoreopen
e che il campoids
sia presenti. - Utilizza il valore
userId
per creare una nuova sessione per l'utente. Per ulteriori informazioni informazioni sugli utenti che hanno eseguito l'accesso, vedi Utenti e nuovi eventi. - Utilizza il metodo
files.get
per controllare autorizzazioni, recuperare i metadati dei file e scaricare i contenuti i valoriID
. - Se nella richiesta era impostato il valore
resourceKeys
, imposta il valore Intestazione della richiestaX-Goog-Drive-Resource-Keys
. Per ulteriori informazioni e chiavi delle risorse, consulta Accedere a file condivisi tramite link utilizzando le risorse. chiave.
Il parametro state
è codificato nell'URL, quindi la tua app deve gestire il carattere di escape
e analizzarlo come JSON.
Gestire un URL di apertura per i documenti di Google Workspace
Come accennato in Configurare una UI di Drive
integrazione, la tua app riceve un insieme predefinito
all'interno di un parametro state
. Le informazioni predefinite per state
per un URL aperto di Google Workspace è:
{
"exportIds": ["ID"],
"resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
"action":"open",
"userId":"USER_ID"
}
Questo output include i seguenti valori:
- EXPORT_ID: un elenco di ID file separati da virgole esportati (utilizzati solo all'apertura dei documenti Google integrati).
- RESOURCE_KEYS: un dizionario JSON di ID file mappati a e le rispettive chiavi delle risorse.
open
: l'azione eseguita. Il valore èopen
quando viene utilizzato un modello URL.- USER_ID: l'ID profilo che identifica l'utente.
L'app deve rispondere a questa richiesta seguendo questa procedura:
Verifica che si tratti di una richiesta di apertura di un file rilevando sia
open
nel campostate
e la presenza del campoexportIds
.Utilizza il metodo
files.get
per controllare autorizzazioni, recuperare i metadati dei file e determinare il tipo MIMEEXPORT_ID
valori.Converti il contenuto del file utilizzando
files.export
. Le seguenti l'esempio di codice mostra come esportare un documento di Google Workspace tipo MIME richiesto.Se nella richiesta era impostato il valore
resourceKey
, imposta il valore Intestazione della richiestaX-Goog-Drive-Resource-Keys
. Per ulteriori informazioni e chiavi delle risorse, consulta Accedere a file condivisi tramite link utilizzando le risorse. chiave.Java
Python
Node.js
PHP
Visualizza i file convertiti in sola lettura o presenta una finestra di dialogo che consente all'utente di salvare il file come nuovo tipo di file.
Il parametro state
è codificato nell'URL, quindi la tua app deve gestire il carattere di escape
e analizzarlo come JSON.
Utenti e nuovi eventi
Le app di Drive devono considerare tutti gli elementi "apri con" eventi come potenziali
accessi. Alcuni utenti potrebbero avere più account, quindi l'ID utente indicato in state
potrebbe non corrispondere alla sessione corrente. Se l'ID utente in state
non corrisponde alla sessione corrente, termina la sessione corrente per
e accedi con l'account dell'utente richiesto.
Argomenti correlati
Oltre ad aprire un'applicazione dall'interfaccia utente di Google Drive, le applicazioni possono mostrare un selettore file per selezionare contenuti dall'interno di un'app. Per ulteriori informazioni informazioni, consulta il selettore Google.