Integracja z przyciskiem „Nowy” w interfejsie Dysku

Gdy użytkownik kliknie przycisk „Nowy” w interfejsie Dysku i wybierze aplikację w interfejsie Dysku, Dysk przekieruje go pod nowy adres URL tej aplikacji zdefiniowany w artykule Konfigurowanie integracji interfejsu Dysku.

Aplikacja otrzymuje wtedy domyślny zestaw zmiennych szablonu w parametrze state. Domyślną informacją state w przypadku nowego adresu URL:

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

Dane wyjściowe zawierają te wartości:

  • create: wykonywana czynność. Wartość wynosi create, 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: unikalny identyfikator profilu, który identyfikuje użytkownika.

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

  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. Aby utworzyć zasób pliku, użyj metody files.create. Jeśli w żądaniu ustawiono folderId, ustaw pole parents na wartość folderId.
  4. Jeśli w żądaniu ustawiono folderResourceKey, 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.

Użytkownicy i nowe zdarzenia

Aplikacje Dysku powinny traktować wszystkie zdarzenia „create” 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.