Integracja z interfejsem Dysku

Gdy użytkownik kliknie przycisk „Nowy” w interfejsie Dysku i wybierze aplikację w interfejsie Dysku, Dysk przekieruje użytkownika do nowego adresu URL aplikacji zdefiniowanego w konfiguracji integracji interfejsu Dysku.

Twoja aplikacja otrzymuje domyślny zestaw zmiennych szablonu w ramach parametru state. Domyślne informacje state dotyczące nowego adresu URL:

{
  "action":"create",
  "folderId":"FOLDER_ID",
  "folderResourceKey":"FOLDER_RESOURCE_KEY",
  "userId":"USER_ID"
}

Dane wyjściowe zawierają te wartości:

  • create: wykonywane działanie. Wartość create jest wyświetlana, gdy użytkownik kliknie przycisk „Nowy” w interfejsie Dysku.
  • FOLDER_ID: identyfikator folderu nadrzędnego.
  • FOLDER_RESOURCE_KEY: klucz zasobu folderu nadrzędnego.
  • USER_ID: identyfikator profilu, który jednoznacznie identyfikuje użytkownika.

Aplikacja musi wykonać tę prośbę, wykonując te czynności:

  1. Sprawdź, czy pole action ma wartość create.
  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.create, aby utworzyć zasób pliku. Jeśli w żądaniu ustawiono wartość folderId, ustaw pole parents na wartość folderId.
  4. Jeśli w żądaniu ustawiono wartość folderResourceKey, ustaw nagłówek X-Goog-Drive-Resource-Keys. Więcej informacji o kluczach zasobów znajdziesz w artykule Uzyskiwanie dostępu do plików udostępnionych za pomocą linku za pomocą kluczy zasobów.

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

Użytkownicy i nowe zdarzenia

Aplikacje Dysku powinny traktować wszystkie zdarzenia „tworzenie” jako potencjalne logowania. Niektórzy użytkownicy mogą mieć wiele kont, dlatego 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ę aplikacji i zaloguj się jako żądany użytkownik.