Tworzenie interfejsów Dysku Google

Dodatki do Google Workspace zapewniają gdy użytkownik korzysta z Dysku Google. Dzięki temu użytkownik może z dodatkowymi przydatnymi informacjami, automatyzować zadania i łączyć się na Dysku Google.

Uzyskiwanie dostępu do interfejsu dodatku

Możesz otworzyć dodatek do Google Workspace w: Dysku Google, jeśli jego ikona znajduje się w w prawej części interfejsu Dysku. O Dodatek do Google Workspace może zdefiniuj interfejs strony głównej, interfejsu wyboru elementu albo jedno i drugie:

  • Jeśli użytkownik kliknie ikonę dodatku na Dysku Google, po uruchomieniu dodatku odpowiadający mu element: drive.homepageTrigger (jeśli istnieje). Ta funkcja tworzy i zwraca kartę strony głównej, na Dysku Google, aby je wyświetlać. Jeśli nie drive.homepageTrigger , zamiast niej wyświetla się standardowa karta strony głównej.
  • Jeśli użytkownik wybierze co najmniej jeden element na Dysku Google, a następnie kliknie dodatek lub wybierze elementy, gdy dodatek jest uruchomiony, dodatek uruchomi odpowiednie drive.onItemsSelectedTrigger funkcji kontekstowej (jeśli istnieje). Ta funkcja tworzy Dysk Google dodatku kontekstowe „wybrane elementy” i zwraca go na Dysk Google.

Tworzenie interfejsu dodatku do Dysku

Interfejsy Dysku Google możesz tworzyć, postępując zgodnie z tymi ogólnymi wskazówkami kroki:

  1. Określ, czy chcesz, aby dodatek był specyficzny dla Dysku. stronie głównej. Zdecyduj też, czy chcesz udostępnić interfejs kontekstowy, gdy użytkownik wybiera elementy na Dysku.
  2. Dodaj odpowiednie addOns.common i addOns.drive pól do projekt skryptu uzupełniającego, manifestować, w tym wszystkie wymagane zakresy Dysku.
  3. Jeśli podajesz stronę główną dla Dysku, zastosuj drive.homepageTrigger. do tworzenia tego interfejsu. Możesz też użyć atrybutu common.homepageTrigger dla wielu hostów Google Workspace.
  4. Jeśli udostępniasz interfejs kontekstowego wyboru elementu na Dysku, musisz implementować drive.onItemsSelectedTrigger za pomocą funkcji aktywatora kontekstowego do utworzenia tego interfejsu. Zobacz Interfejs kontekstowy Dysku dla wybranych elementów). .
  5. Zaimplementować powiązane funkcje wywołania zwrotnego niezbędne do reagowania na interakcje z interfejsem, np. kliknięcia przycisków;

Strony główne Dysku

Dysk Google obsługuje wyświetlanie dodatku do Google Workspace stronach głównych. Aby udostępnić na Dysku Google wspólną stronę główną dodatku, po prostu upewnij się, że znajduje się tam jest polem addOns.drive w pliku manifestu dodatku.

Możesz też dodać atrybut drive.homepageTrigger w pliku manifestu dodatku, aby udostępnić stronę główną dla Dysku.

W obu przypadkach musisz w w projekcie skryptu. Funkcja ta jest automatycznie wywoływana w celu utworzenia stronę główną Dysku, gdy jest potrzebna. Funkcję tę należy zaimplementować, aby skompilować zwróci jeden Card lub tablica Card obiekty składające się na stronę główną. Funkcja aktywatora strony głównej jest przekazywana w obiekt zdarzenia jako parametr zawierający ogólne informacje, takie jak platformy. Korzystając z danych obiektu zdarzenia, możesz dostosować konstrukcję stronie głównej.

Interfejs kontekstowy Dysku dla wybranych elementów

Dysk Google określa interfejs na podstawie reguły kontekstowej (jeśli są dostępne), która będzie wyświetlana, gdy użytkownik wybierze co najmniej jeden element na Dysku Google. Gdy uruchamia się, wykonuje on funkcję wyzwalacza kontekstowego wskazaną przez drive.onItemsSelectedTrigger.runFunction w pliku manifestu dodatku.

Aby utworzyć interfejs kontekstowego wyboru elementu na Dysku, musisz wykonać :

  1. Sprawdź, czy plik manifestu dodatku zawiera https://www.googleapis.com/auth/drive.addons.metadata.readonly zakres

  2. Sprawdź, czy plik manifestu zawiera drive.onItemsSelectedTrigger .

  3. Zaimplementuj funkcję o nazwie drive.onItemsSelectedTrigger . Ta funkcja przyjmuje obiekt zdarzenia jako argument i musi zwracać Card lub tablica obiekty Card.

  4. Tak jak w przypadku każdej karty, musisz zaimplementować funkcje wywołania zwrotnego służące do i aktywności widżetów w interfejsie. Jeśli na przykład dodasz przycisk interfejs, powinien mieć dołączony Działanie i wdrożoną funkcję wywołania zwrotnego, która jest uruchamiana po kliknięciu przycisku.

Obiekty zdarzeń

Obiekt zdarzenia jest tworzony i przekazywany. do: drive.homepageTrigger lub drive.onItemsSelectedTrigger . Funkcja aktywująca może używać funkcji informacji w tym obiekcie zdarzenia, aby określić sposób tworzenia kart dodatkowych lub w inny sposób kontrolować jego działanie.

Pełną strukturę obiektów zdarzeń opisano w obiekty zdarzeń – Gdy Dysk jest aplikacją hosta dodatku, obiekty zdarzeń kontekstowych zastosuj Obiekt zdarzenia na Dysku z informacjami o kliencie dotyczącymi Dysku.

Kontekstowe obiekty zdarzeń na Dysku na potrzeby reguł wyboru elementu zawierają informacje o elementach wybranych przez użytkownika po uruchomieniu reguły. Gdy użytkownik wybierze więcej niż jeden element na Dysku, jeden z elementów jest uznawany za jeden z podstawowy interes; jest nazywany aktywnym elementem kursora.

Poniższy przykład pokazuje Obiekt zdarzenia na Dysku i przekazywane do drive.onItemsSelectedTrigger. funkcja:

    {
      "commonEventObject": { ... },
      "drive": {
        "activeCursorItem":{
          "addonHasFileScopePermission": true,
          "id":"0B_sX1fXRRU6Ac3RhcnRlcl9maWxl",
          "iconUrl": "https://drive-thirdparty.googleusercontent.com...",
          "mimeType":"application/pdf",
          "title":"How to get started with Drive"
        },
        "selectedItems": [
          {
            "addonHasFileScopePermission": true,
            "id":"0B_sX1fXRRU6Ac3RhcnRlcl9maWxl",
            "iconUrl":"https://drive-thirdparty.googleusercontent.com...",
            "mimeType":"application/pdf",
            "title":"How to get started with Drive"
          },
          ...
        ]
      },
      ...
    }