Ta strona została przetłumaczona przez Cloud Translation API.

Integracja z menu kontekstowym „Otwórz za pomocą” interfejsu Dysku

Gdy użytkownik wybierze plik i kliknie element menu „Otwórz za pomocą” w interfejsie Dysku, Dysk przekieruje go pod adres URL do otwierania tej aplikacji zdefiniowany w artykule Konfigurowanie integracji interfejsu Dysku.

Jeśli podczas konfigurowania interfejsu użytkownika Dysku zaznaczono pole „Importowanie”, użytkownik może wybrać kombinację plików aplikacji i plików Google Workspace, które chce otworzyć. Podczas konfigurowania interfejsu użytkownika Dysku pliki aplikacji są 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 porównuje typy MIME pod kątem zdefiniowanych domyślnych i dodatkowych typów MIME:

W przypadku typów MIME zdefiniowanych w polu „Domyślne typy MIME” identyfikator pliku jest przekazywany do aplikacji. Informacje o obsłudze plików aplikacji znajdziesz w sekcji Obsługa otwierania adresu URL dokumentów aplikacji.
W przypadku typów MIME zdefiniowanych w polu „Dodatkowe typy MIME” w interfejsie Dysku pojawia się okno z pytaniem, na jaki typ pliku ma zostać przekonwertowany plik Google Workspace. Jeśli na przykład wybierzesz plik Dokumentów Google w interfejsie Dysku, a pole „Dodatkowe typy MIME” wskazuje, że aplikacja obsługuje tekst/zwykły tekst lub application/pdf, interfejs Dysku zapyta użytkownika, czy chce przekonwertować go na zwykły tekst lub na PDF.

Informacje o obsłudze plików Google Workspace znajdziesz w artykule Obsługa otwartego adresu URL dokumentów Google Workspace (w języku angielskim). Listę dokumentów Google Workspace i formaty konwersji według typu MIME znajdziesz w artykule Eksportowanie typów MIME dokumentów Google Workspace.

Obsługa otwartego adresu URL w przypadku dokumentów dotyczących aplikacji

Jak wspomnieliśmy w sekcji Konfigurowanie integracji interfejsu Dysku, aplikacja otrzymuje zmienne szablonu z informacjami, które pozwalają aplikacji otworzyć plik. Aplikacja otrzymuje domyślny zestaw zmiennych szablonu w parametrze state. Domyślne informacje state dla otwartego adresu URL 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 zawierający identyfikatory plików zmapowane na odpowiednie klucze zasobów.
open: wykonywana czynność. Gdy korzystasz z otwartego adresu URL, wartość wynosi open.
USER_ID: niepowtarzalny identyfikator profilu, który identyfikuje użytkownika.

Aplikacja musi zareagować na to żądanie w ten sposób:

Sprawdź, czy pole action ma wartość open i czy występuje pole ids.
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.
Użyj metody files.get, aby sprawdzić uprawnienia, pobrać metadane pliku i pobrać treść pliku za pomocą wartości ID.
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 Uzyskiwanie dostępu do plików udostępnionych przez link za pomocą kluczy zasobów.

Parametr state jest zakodowany na potrzeby adresu URL, więc aplikacja musi obsługiwać znaki zmiany znaczenia i analizować go jako JSON.

Obsługa otwartego adresu URL dokumentów Google Workspace

Jak wspomnieliśmy w artykule Konfigurowanie integracji interfejsu Dysku, aplikacja otrzymuje domyślny zestaw zmiennych szablonu w parametrze state. Domyślne informacje state w przypadku otwartego adresu URL w 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 eksportowanych identyfikatorów plików (używana tylko podczas otwierania wbudowanych dokumentów Google).
RESOURCE_KEYS: słownik JSON zawierający identyfikatory plików zmapowane na odpowiednie klucze zasobów.
open: wykonywana czynność. Gdy korzystasz z otwartego adresu URL, wartość wynosi open.
USER_ID: identyfikator profilu, który identyfikuje użytkownika.

Aplikacja musi zareagować na to żądanie w ten sposób:

Sprawdź, czy jest to żądanie otwarcia pliku – wykrywaj zarówno wartość open w polu state, jak i obecność pola exportIds.
Użyj metody files.get, aby sprawdzić uprawnienia, pobrać metadane pliku i określić typ MIME za pomocą wartości EXPORT_ID.
Przekonwertuj treść pliku metodą files.export. Poniższy przykładowy kod pokazuje, jak wyeksportować dokument Google Workspace do żądanego typu MIME.

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 Uzyskiwanie dostępu do plików udostępnionych przez link za pomocą 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

from __future__ import print_function

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

/**
 * 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

Wyświetl w GitHubie

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 pokaż okno, w którym użytkownik może zapisać plik jako nowy typ.

Parametr state jest zakodowany na potrzeby adresu URL, więc aplikacja musi obsługiwać znaki zmiany znaczenia i analizować go jako JSON.

Użytkownicy i nowe zdarzenia

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

Powiązane artykuły

Aplikacje mogą nie tylko otwierać aplikacje z poziomu interfejsu Dysku Google, ale także wyświetlać selektor plików, który pozwala wybrać treści z poziomu aplikacji. Więcej informacji znajdziesz w artykule o selektorze Google.