Integracja z interfejsem Dysku „Otwórz za pomocą menu kontekstowego”

Gdy użytkownik wybierze plik i kliknie w interfejsie Dysku opcję „Otwórz za pomocą”, Dysk przekieruje go do adresu URL otwierania aplikacji zdefiniowanego w sekcji Konfigurowanie integracji z interfejsem Dysku.

Jeśli podczas konfigurowania integracji z interfejsem Dysku zaznaczysz pole „Importowanie”, użytkownik będzie mógł wybrać kombinację plików specyficznych dla aplikacji i plików Google Workspace. Gdy skonfigurujesz integrację z interfejsem Dysku, pliki specyficzne dla aplikacji zostaną zdefiniowane w polach „Domyślne typy MIME” i „Domyślne rozszerzenia plików”, a pliki Google Workspace – w polach „Dodatkowe typy MIME” i „Dodatkowe rozszerzenia plików”.

W przypadku każdego pliku, który użytkownik chce otworzyć, Dysk sprawdza typy MIME w porównaniu ze zdefiniowanymi przez Ciebie domyślnymi i dodatkowymi typami MIME:

• W przypadku typów MIME zdefiniowanych w polu „Domyślne typy MIME” identyfikator pliku jest przekazywany do aplikacji. Więcej informacji o tym, jak obsługiwać pliki specyficzne dla aplikacji, znajdziesz w artykule Obsługa adresu URL otwierania dokumentów specyficznych dla aplikacji.

• W przypadku typów MIME zdefiniowanych w polu „Dodatkowe typy MIME” w interfejsie Dysku wyświetla się okno z pytaniem, na jaki typ pliku przekonwertować plik Google Workspace. Jeśli na przykład w interfejsie Dysku wybierzesz plik Dokumentów Google, a w polu „Dodatkowe typy MIME” będzie sugerowane, że Twoja aplikacja obsługuje typy text/plain lub application/pdf, interfejs Dysku zapyta użytkownika, czy chce przekonwertować plik na tekst lub PDF.

  Więcej informacji o tym, jak obsługiwać pliki Google Workspace , znajdziesz w artykule Obsługa adresu URL otwierania dokumentów Google Workspace. Listę dokumentów Google Workspace i formatów konwersji typów MIME znajdziesz w artykule Eksportowanie typów MIME dokumentów Google Workspace dokumentów.

Obsługa adresu URL otwierania dokumentów specyficznych dla aplikacji

Jak wspomnieliśmy w artykule Konfigurowanie integracji z interfejsem Dysku, Twoja aplikacja otrzymuje zmienne szablonu z informacjami, które pozwalają jej otworzyć plik. Aplikacja otrzymuje domyślny zestaw zmiennych szablonu w parametrze state. Domyślne informacje state dla adresu URL otwierania specyficznego dla aplikacji to:

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

Dane wyjściowe zawierają te wartości:

• ID: identyfikator folderu nadrzędnego.
• RESOURCE_KEYS: słownik JSON identyfikatorów plików mapowanych na odpowiednie klucze zasobów.
• open: wykonywane działanie. Gdy używasz adresu URL otwierania, wartość to open.
• USER_ID: identyfikator profilu, który jednoznacznie identyfikuje użytkownika.

Twoja aplikacja musi zareagować na to żądanie, wykonując te czynności:

1. Sprawdź, czy pole action ma wartość open i czy pole ids jest obecne.
2. Użyj wartości userId, aby utworzyć nową sesję dla użytkownika. Więcej informacji o zalogowanych użytkownikach znajdziesz w artykule Użytkownicy i nowe zdarzenia.
3. Użyj metody files.get, aby sprawdzić uprawnienia, pobrać metadane pliku i pobrać zawartość pliku za pomocą wartości ID.
4. Jeśli w żądaniu ustawiono resourceKeys, ustaw nagłówek żądania X-Goog-Drive-Resource-Keys. Więcej informacji o kluczach zasobów znajdziesz w artykule Dostęp do plików udostępnionych za pomocą linku przy użyciu kluczy zasobów.

Parametr state jest zakodowany w adresie URL, więc Twoja aplikacja musi obsługiwać znaki ucieczki i analizować go jako JSON.

Uwaga: wszystkie aplikacje, w tym aplikacje otwierające pliki ze skrótów i skrótów innych firm, powinny wywoływać metodę files.get, aby sprawdzić uprawnienia użytkownika do dokumentu. Aplikacje powinny ostrzegać użytkowników z uprawnieniami tylko do odczytu, gdy otwierają plik, którego nie mogą edytować ani zapisać (zamiast pozwolić im na edycję, a potem wyświetlić błąd podczas zapisywania).

Obsługa adresu URL otwierania dokumentów Google Workspace

Jak wspomnieliśmy w artykule Konfigurowanie integracji z interfejsem Dysku, Twoja aplikacja otrzymuje domyślny zestaw zmiennych szablonu w parametrze state. Domyślne informacje state dla adresu URL otwierania Google Workspace to:

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

Dane wyjściowe zawierają te wartości:

• EXPORT_ID: rozdzielona przecinkami lista identyfikatorów eksportowanych plików. Używane tylko podczas otwierania plików Google Workspace.
• RESOURCE_KEYS: słownik JSON identyfikatorów plików mapowanych na odpowiednie klucze zasobów.
• open: wykonywane działanie. Gdy używasz adresu URL otwierania, wartość to open.
• USER_ID: identyfikator profilu, który identyfikuje użytkownika.

Twoja aplikacja musi zareagować na to żądanie, wykonując te czynności:

1. Sprawdź, czy jest to żądanie otwarcia pliku, wykrywając zarówno wartość open w polu state, jak i obecność pola exportIds.

2. Użyj metody files.get, aby sprawdzić uprawnienia, pobrać metadane pliku i określić typ MIME za pomocą wartości EXPORT_ID.

3. Przekonwertuj zawartość pliku za pomocą metody files.export. Poniższy przykładowy kod pokazuje, jak wyeksportować dokument Google Workspace do żądanego typu MIME.

4. Jeśli w żądaniu ustawiono resourceKey, ustaw nagłówek żądania X-Goog-Drive-Resource-Keys. Więcej informacji o kluczach zasobów znajdziesz w artykule Dostęp do plików udostępnionych za pomocą linku przy użyciu kluczy zasobów.

   Java

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

   Wyświetl w GitHubie

   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

   Wyświetl w GitHubie

   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

   Wyświetl w GitHubie

   import {GoogleAuth} from 'google-auth-library';
   import {google} from 'googleapis';
   
   /**
    * Exports a Google Doc as a PDF.
    * @param {string} fileId The ID of the file to export.
    * @return {Promise<number>} The status of the export request.
    */
   async function exportPdf(fileId) {
     // Authenticate with Google and get an authorized client.
     // TODO (developer): Use an appropriate auth mechanism for your app.
     const auth = new GoogleAuth({
       scopes: 'https://www.googleapis.com/auth/drive',
     });
   
     // Create a new Drive API client (v3).
     const service = google.drive({version: 'v3', auth});
   
     // Export the file as a PDF.
     const result = await service.files.export({
       fileId,
       mimeType: 'application/pdf',
     });
   
     // Print the status of the export.
     console.log(result.status);
     return result.status;
   }

   PHP

   drive/snippets/drive_v3/src/DriveExportPdf.php

   Wyświetl w GitHubie

   <?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;
       }
   
   }

Wyświetl przekonwertowane pliki jako tylko do odczytu lub wyświetl okno, w którym użytkownik może zapisać plik w nowym typie.

Parametr state jest zakodowany w adresie URL, więc Twoja aplikacja musi obsługiwać znaki ucieczki i analizować go jako JSON.

Użytkownicy i nowe zdarzenia

Aplikacje na Dysku powinny traktować wszystkie zdarzenia „Otwórz za pomocą” jako potencjalne logowanie. Niektórzy użytkownicy mogą mieć kilka kont, więc identyfikator użytkownika w parametrze state może nie pasować do bieżącej sesji. Jeśli identyfikator użytkownika w parametrze state nie pasuje do bieżącej sesji, zakończ bieżącą sesję w aplikacji i zaloguj się jako żądany użytkownik.

Powiązane artykuły

Oprócz otwierania aplikacji z interfejsu Dysku Google aplikacje mogą wyświetlać okno wyboru plików, aby wybierać treści w aplikacji. Więcej informacji znajdziesz w artykule Google Picker.