Questa pagina è stata tradotta dall'API Cloud Translation.

Integrazione con il menu contestuale"Apri con " dell'interfaccia utente di Drive

Quando un utente seleziona un file e fa clic sulla voce di menu "Apri con" dell'interfaccia utente di Drive, Drive reindirizza l'utente all'URL di apertura dell'app definito in Configurare un'integrazione dell'interfaccia utente di Drive.

Se hai selezionato la casella "Importazione" quando hai configurato un'integrazione dell'interfaccia utente di Drive, l'utente può selezionare una combinazione di file specifici dell'app e di Google Workspace da aprire. Quando configuri un'integrazione dell'interfaccia utente di Drive, i file specifici dell'app vengono definiti nei campi "Tipi MIME predefiniti" e "Estensioni file predefinite", mentre i file di Google Workspace vengono definiti nei campi "Tipi MIME secondari" ed "Estensioni file secondarie".

Per ogni file che l'utente vuole aprire, Drive controlla i tipi MIME in base ai tipi MIME predefiniti e secondari che hai definito:

Per i tipi MIME definiti nel campo "Tipi MIME predefiniti", l'ID file viene trasmesso alla tua app. Per informazioni su come gestire i file specifici dell'app, vedi Gestire un URL di apertura per documenti specifici dell'app.
Per i tipi MIME definiti nel campo "Tipi MIME secondari", l'interfaccia utente di Drive mostra una finestra di dialogo che chiede all'utente in quale tipo di file convertire il file Google Workspace. Ad esempio, se selezioni un file Google Docs nell'interfaccia utente di Drive e il campo "Tipi MIME secondari" suggerisce che la tua app supporta text/plain o application/pdf, l'interfaccia utente di Drive chiede all'utente se vuole eseguire la conversione in testo normale o PDF.

Per informazioni su come gestire i file di Google Workspace, vedi Gestire un URL aperto per i documenti Google Workspace. Per un elenco dei documenti di Google Workspace e dei formati di conversione dei tipi MIME, vedi Tipi MIME di esportazione per i documenti di Google Workspace.

Gestire un URL aperto per documenti specifici dell'app

Come indicato in Configurare un'integrazione dell'interfaccia utente di Drive, la tua app riceve variabili di modello con informazioni per aprire il file. La tua app riceve un insieme predefinito di variabili modello all'interno di un parametro state. Le informazioni state predefinite per un'apertura URL specifica per l'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 alle rispettive chiavi di risorse.
open: l'azione in corso. Il valore è open quando utilizzi un URL aperto.
USER_ID: l'ID profilo che identifica in modo univoco l'utente.

La tua app deve agire in base a questa richiesta seguendo questi passaggi:

Verifica che il campo action abbia il valore open e che il campo ids sia presente.
Utilizza il valore userId per creare una nuova sessione per l'utente. Per ulteriori informazioni sugli utenti che hanno eseguito l'accesso, consulta Utenti ed eventi nuovi.
Utilizza il metodo files.get per controllare le autorizzazioni, recuperare i metadati del file e scaricare i contenuti del file utilizzando i valori ID.
Se resourceKeys è stato impostato nella richiesta, imposta l'intestazione della richiesta X-Goog-Drive-Resource-Keys. Per saperne di più sulle chiavi delle risorse, consulta Accedere ai file condivisi tramite link utilizzando le chiavi delle risorse.

Il parametro state è codificato tramite URL, quindi la tua app deve gestire i caratteri di escape e analizzarlo come JSON.

Gestire un URL aperto per i documenti Google Workspace

Come indicato in Configurare un'integrazione dell'interfaccia utente di Drive, la tua app riceve un insieme predefinito di variabili modello all'interno di un parametro state. Le informazioni state predefinite per un URL aperto di Google Workspace sono:

{
  "exportIds": ["ID"],
  "resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
  "action":"open",
  "userId":"USER_ID"
}

Questo output include i seguenti valori:

EXPORT_ID: un elenco separato da virgole di ID file da esportare (utilizzato solo per l'apertura di documenti Google integrati).
RESOURCE_KEYS: un dizionario JSON di ID file mappati alle rispettive chiavi di risorse.
open: l'azione in corso. Il valore è open quando utilizzi un URL aperto.
USER_ID: l'ID profilo che identifica l'utente.

La tua app deve agire in base a questa richiesta seguendo questi passaggi:

Verifica che si tratti di una richiesta di apertura di un file rilevando sia il valore open nel campo state sia la presenza del campo exportIds.
Utilizza il metodo files.get per controllare le autorizzazioni, recuperare i metadati dei file e determinare il tipo MIME utilizzando i valori EXPORT_ID.
Converti i contenuti del file utilizzando il metodo files.export. Il seguente esempio di codice mostra come esportare un documento Google Workspace nel tipo MIME richiesto.

Se resourceKey è stato impostato nella richiesta, imposta l'intestazione della richiesta X-Goog-Drive-Resource-Keys. Per saperne di più sulle chiavi delle risorse, consulta Accedere ai file condivisi tramite link utilizzando le chiavi delle risorse.

Java

drive/snippets/drive_v3/src/main/java/ExportPdf.java

Visualizza su GitHub

import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.HttpRequestInitializer;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.drive.Drive;
import com.google.api.services.drive.DriveScopes;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.util.Arrays;

/* Class to demonstrate use-case of drive's export pdf. */
public class ExportPdf {

  /**
   * Download a Document file in PDF format.
   *
   * @param realFileId file ID of any workspace document format file.
   * @return byte array stream if successful, {@code null} otherwise.
   * @throws IOException if service account credentials file not found.
   */
  public static ByteArrayOutputStream exportPdf(String realFileId) throws IOException {
    // Load pre-authorized user credentials from the environment.
    // TODO(developer) - See https://developers.google.com/identity for
    // guides on implementing OAuth2 for your application.
    GoogleCredentials credentials = GoogleCredentials.getApplicationDefault()
        .createScoped(Arrays.asList(DriveScopes.DRIVE_FILE));
    HttpRequestInitializer requestInitializer = new HttpCredentialsAdapter(
        credentials);

    // Build a new authorized API client service.
    Drive service = new Drive.Builder(new NetHttpTransport(),
        GsonFactory.getDefaultInstance(),
        requestInitializer)
        .setApplicationName("Drive samples")
        .build();

    OutputStream outputStream = new ByteArrayOutputStream();
    try {
      service.files().export(realFileId, "application/pdf")
          .executeMediaAndDownloadTo(outputStream);

      return (ByteArrayOutputStream) outputStream;
    } catch (GoogleJsonResponseException e) {
      // TODO(developer) - handle error appropriately
      System.err.println("Unable to export file: " + e.getDetails());
      throw e;
    }
  }
}

Python

drive/snippets/drive-v3/file_snippet/export_pdf.py

Visualizza su GitHub

import io

import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError
from googleapiclient.http import MediaIoBaseDownload


def export_pdf(real_file_id):
  """Download a Document file in PDF format.
  Args:
      real_file_id : file ID of any workspace document format file
  Returns : IO object with location

  Load pre-authorized user credentials from the environment.
  TODO(developer) - See https://developers.google.com/identity
  for guides on implementing OAuth2 for the application.
  """
  creds, _ = google.auth.default()

  try:
    # create drive api client
    service = build("drive", "v3", credentials=creds)

    file_id = real_file_id

    # pylint: disable=maybe-no-member
    request = service.files().export_media(
        fileId=file_id, mimeType="application/pdf"
    )
    file = io.BytesIO()
    downloader = MediaIoBaseDownload(file, request)
    done = False
    while done is False:
      status, done = downloader.next_chunk()
      print(f"Download {int(status.progress() * 100)}.")

  except HttpError as error:
    print(f"An error occurred: {error}")
    file = None

  return file.getvalue()


if __name__ == "__main__":
  export_pdf(real_file_id="1zbp8wAyuImX91Jt9mI-CAX_1TqkBLDEDcr2WeXBbKUY")

Node.js

drive/snippets/drive_v3/file_snippets/export_pdf.js

Visualizza su GitHub

/**
 * Download a Document file in PDF format
 * @param{string} fileId file ID
 * @return{obj} file status
 * */
async function exportPdf(fileId) {
  const {GoogleAuth} = require('google-auth-library');
  const {google} = require('googleapis');

  // Get credentials and build service
  // TODO (developer) - Use appropriate auth mechanism for your app
  const auth = new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/drive',
  });
  const service = google.drive({version: 'v3', auth});

  try {
    const result = await service.files.export({
      fileId: fileId,
      mimeType: 'application/pdf',
    });
    console.log(result.status);
    return result;
  } catch (err) {
    // TODO(developer) - Handle error
    throw err;
  }
}

PHP

drive/snippets/drive_v3/src/DriveExportPdf.php

Visualizza su GitHub

<?php
use Google\Client;
use Google\Service\Drive;
function exportPdf()
{
    try {
        $client = new Client();
        $client->useApplicationDefaultCredentials();
        $client->addScope(Drive::DRIVE);
        $driveService = new Drive($client);
        $realFileId = readline("Enter File Id: ");
        $fileId = '1ZdR3L3qP4Bkq8noWLJHSr_iBau0DNT4Kli4SxNc2YEo';
        $fileId = $realFileId;
        $response = $driveService->files->export($fileId, 'application/pdf', array(
            'alt' => 'media'));
        $content = $response->getBody()->getContents();
        return $content;

    }  catch(Exception $e) {
         echo "Error Message: ".$e;
    }

}

Visualizza i file convertiti come di 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 tramite URL, quindi la tua app deve gestire i caratteri di escape e analizzarlo come JSON.

Utenti e nuovi eventi

Le app Drive devono trattare tutti gli eventi "Apri con" come potenziali accessi. Alcuni utenti potrebbero avere più account, quindi l'ID utente nel parametro state potrebbe non corrispondere alla sessione corrente. Se l'ID utente nel parametro state non corrisponde alla sessione corrente, termina la sessione corrente per la tua app e accedi come utente richiesto.

Argomenti correlati

Oltre ad aprire un'applicazione dall'interfaccia utente di Google Drive, le applicazioni possono visualizzare un selettore di file per selezionare i contenuti dall'interno di un'app. Per ulteriori informazioni, consulta Google Picker.

Integrazione con il menu contestuale"Apri con " dell'interfaccia utente di Drive Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Gestire un URL aperto per documenti specifici dell'app

Gestire un URL aperto per i documenti Google Workspace

Java

Python

Node.js

PHP

Utenti e nuovi eventi

Argomenti correlati

Integrazione con il menu contestuale"Apri con " dell'interfaccia utente di Drive