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 niedrive.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:
- 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.
- Dodaj odpowiednie
addOns.common
iaddOns.drive
pól do projekt skryptu uzupełniającego, manifestować, w tym wszystkie wymagane zakresy Dysku. - Jeśli podajesz stronę główną dla Dysku,
zastosuj
drive.homepageTrigger
. do tworzenia tego interfejsu. Możesz też użyć atrybutucommon.homepageTrigger
dla wielu hostów Google Workspace. - 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). . - 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ć :
Sprawdź, czy plik manifestu dodatku zawiera
https://www.googleapis.com/auth/drive.addons.metadata.readonly
zakresSprawdź, czy plik manifestu zawiera
drive.onItemsSelectedTrigger
.Zaimplementuj funkcję o nazwie
drive.onItemsSelectedTrigger
. Ta funkcja przyjmuje obiekt zdarzenia jako argument i musi zwracaćCard
lub tablica obiektyCard
.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"
},
...
]
},
...
}