Aby wyświetlać aplikację na Dysku Google, gdy użytkownik utworzy lub otworzy plik, musisz najpierw skonfigurować integrację z interfejsem użytkownika Dysku. Konfiguracja jest też wymagana, aby umieścić aplikację na Google Workspace Marketplace.
Włączanie interfejsu Drive API
Zanim zaczniesz używać interfejsów API Google, musisz je włączyć w projekcie Google Cloud. W jednym projekcie Google Cloud możesz włączyć 1 lub więcej interfejsów API.
Aby rozpocząć integrację z interfejsem Dysku Google, musisz włączyć interfejs Drive API. Daje to dostęp do interfejsu API i funkcji integracji interfejsu użytkownika.
W konsoli Google Cloud włącz interfejs Google Drive API.
Konfigurowanie integracji z interfejsem Dysku
- W Konsoli interfejsu API Google kliknij Menu > Interfejsy API i usługi > Włączone interfejsy API i usługi.
- U dołu panelu Interfejsy API i usługi kliknij Interfejs API Dysku Google. Pojawi się strona konfiguracji interfejsu API Dysku Google.
- Wybierz kartę Integracja z interfejsem Dysku.
- (Opcjonalnie) Wpisz nazwę w polu Nazwa aplikacji. Nazwa aplikacji jest wyświetlana użytkownikom na karcie Zarządzaj aplikacjami w ustawieniach Dysku.
- (Opcjonalnie) W polu Krótki opis wpisz krótki opis składający się z 1 wiersza. Krótki opis wyświetla się użytkownikom na karcie Zarządzaj aplikacjami w ustawieniach Dysku.
- (Opcjonalnie) W polu Długi opis wpisz pełny opis.
Prześlij co najmniej jedną ikonę aplikacji, która będzie widoczna na liście połączonych aplikacji Dysku użytkownika oraz w menu kontekstowym „Otwórz w”. Ikony powinny być w formacie PNG i na przezroczystym tle. Mogą minąć 24 godziny, zanim ikony pojawią się na Dysku.
Aby użyć pozycji menu „Otwórz w” w interfejsie Dysku, wpisz adres URL aplikacji w polu Otwórz URL. Ten URL jest używany przez menu kontekstowe „Otwórz za pomocą”.
- Adres URL musi zawierać pełną i jednoznaczną nazwę domeny. Nie działa znak
localhost
. - Ten adres URL powinien być dostępny dla użytkowników aplikacji. Jeśli masz wiele wersji aplikacji, np. jedną dla wersji publicznej, a drugą dla wybranych użytkowników z ograniczonym dostępem, każda z nich powinna używać unikalnego adresu URL. Możesz utworzyć różne konfiguracje aplikacji dla każdej wersji.
- Zanim dodasz aplikację do Google Workspace Marketplace, musisz potwierdzić własność tego adresu URL.
- Domyślnie do tego adresu URL dołączany jest parametr zapytania
state
, który służy do przekazywania danych z interfejsu Drive do aplikacji. Informacje o treści parametrustate
znajdziesz w sekcji Parametry zapytaniastate
.
- Adres URL musi zawierać pełną i jednoznaczną nazwę domeny. Nie działa znak
(Opcjonalnie) W polach Domyślne typy MIME i Domyślne rozszerzenia plików wpisz domyślne typy MIME i rozszerzenia plików. Domyślne typy MIME i rozszerzenia plików reprezentują pliki, które aplikacja może otworzyć. Aplikacja może na przykład otworzyć wbudowany format do nakładania i edytowania obrazów. Uwzględniaj tylko standardowe typy multimediów i upewnij się, że nie zawierają one literówek. Jeśli aplikacja otwiera tylko pliki skrótów lub skróty innych firm, pole Typ MIME możesz pozostawić puste.
(Opcjonalnie) W polach Dodatkowe typy MIME i Dodatkowe rozszerzenia plików wpisz dodatkowe typy MIME i ich rozszerzenia. Dodatkowe typy MIME i ich rozszerzenia to pliki, które aplikacja może otworzyć, ale nie są one związane z tą aplikacją. Możesz na przykład mieć aplikację do edycji zdjęć, która otwiera obrazy PNG i JPG. Uwzględniaj tylko standardowe typy multimediów i upewnij się, że nie zawierają one literówek. Jeśli aplikacja otwiera tylko pliki skrótów lub skróty innych firm, pole Typ MIME możesz pozostawić puste.
Aby używać przycisku „Nowy” w interfejsie Dysku i umożliwić użytkownikom tworzenie plików w aplikacji, zaznacz pole Tworzenie plików. Pojawi się pole Nowy adres URL i opcjonalne pole Nazwa dokumentu.
- Adres URL musi zawierać pełną i jednoznaczną nazwę domeny. Nie działa znak
localhost
. - Zanim umieścisz aplikację w Google Workspace Marketplace, musisz potwierdzić własność tego adresu URL.
- Domyślnie do tego adresu URL dołączany jest parametr zapytania
state
, który służy do przekazywania danych z interfejsu Drive do aplikacji. Informacje o treści parametrustate
znajdziesz w sekcji Parametry zapytaniastate
.
- Adres URL musi zawierać pełną i jednoznaczną nazwę domeny. Nie działa znak
Wpisz adres URL w polu Nowy adres URL. Ten URL jest używany przez przycisk „Nowy”, aby przekierować użytkownika do Twojej aplikacji.
(Opcjonalnie) Jeśli chcesz, aby aplikacja otwierała pliki obsługiwane przez Google Workspace, zaznacz pole Importowanie.
(Opcjonalnie) Jeśli aplikacja musi zarządzać plikami na dyskach współdzielonych, zaznacz pole Obsługa dysków współdzielonych. Więcej informacji o obsługiwaniu dysków współdzielonych w aplikacji znajdziesz w artykule Wdrażanie obsługi dysków współdzielonych.
Kliknij Prześlij.
Poproś o zakres drive.install
Aby umożliwić aplikacjom wyświetlanie się jako opcji w menu „Otwórz za pomocą” lub „Nowy”, poproś o uprawnienia https://www.googleapis.com/auth/drive.install
, aby zintegrować aplikację z interfejsem Dysku. Gdy użytkownicy otrzymają prośbę o taki zakres, zobaczą okno podobne do tego:
Więcej informacji o zakresach, o które możesz poprosić w przypadku aplikacji na Dysku, oraz o tym, jak je poprosić, znajdziesz w artykule Informacje na temat autoryzacji i uwierzytelniania w interfejsie API (w języku angielskim).
Parametr state
Domyślnie parametr state
jest dołączany do otwartego adresu URL i nowego adresu URL, aby przekazywać dane z interfejsu Dysku do aplikacji. Ten parametr zawiera ciąg znaków w formacie JSON ze zmiennymi szablonu i danymi o żądaniu wysyłanym do aplikacji. Uwzględnione zmienne zależą od typu użytego adresu URL (otwarty URL lub nowy URL):
Zmienna szablonu | Opis | Zastosowanie adresu URL |
---|---|---|
{ids} |
Lista identyfikatorów otwieranych plików rozdzielona przecinkami. | Otwórz URL |
{exportIds} |
Lista identyfikatorów plików rozdzielana przecinkami (używana tylko podczas otwierania wbudowanych dokumentów Google). | Otwórz URL |
{resourceKeys} |
słownik JSON z identyfikatorami plików mapowanymi na odpowiednie klucze zasobów. | Otwórz URL |
{folderId} |
Identyfikator folderu nadrzędnego. | Nowy URL |
{folderResourceKey} |
Klucz zasobu folderu nadrzędnego. | Nowy URL |
{userId} |
Identyfikator profilu, który identyfikuje użytkownika. | Otwórz adres URL i Nowy adres URL |
{action} |
Wykonywane działanie. Wartość to:
open , gdy używasz polecenia Otwórz URL, lub create , gdy używasz polecenia Nowy URL.
|
Otwórz adres URL i Nowy adres URL |
Parametr state
jest zakodowany w formacie URL, więc aplikacja musi obsługiwać znaki ucieczki i przetwarzać go jako dane JSON. Aplikacje mogą wykrywać wartość create
w parametrze state
, aby zweryfikować żądanie utworzenia pliku.
Przykład informacji o stanie w formacie JSON dla nowego adresu URL
Informacje state
dotyczące nowego adresu URL:
{
"action":"create",
"folderId":"FOLDER_ID",
"folderResourceKey":"FOLDER_RESOURCE_KEY",
"userId":"USER_ID"
}
Przykład informacji o stanie w formacie JSON dla akcji Otwieranie adresu URL
Informacje state
dotyczące adresu URL otwierającego stronę:
{
"ids": ["ID"],
"resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
"action":"open",
"userId":"USER_ID"
}
Identyfikatory i klucze zasobów służą do pobierania metadanych plików i treści plików. Gdy aplikacja ma identyfikator pliku i token dostępu, może sprawdzać uprawnienia, pobierać metadane pliku i pobierać zawartość pliku zgodnie z opisem w metodzie files.get
.
Powiązane artykuły
Zainstalowana aplikacja musi umożliwiać tworzenie, zarządzanie i otwieranie działań uruchamianych z interfejsu Dysku. Więcej informacji znajdziesz w artykule Integracja z przyciskiem „Nowy” w interfejsie Dysku lub Integracja z menu „Otwórz za pomocą” w interfejsie Dysku.