Poziom kodowania: dla średnio zaawansowanych
Czas trwania: 30 minut
Typ projektu: dodatek do Google Workspace
Cele
- Dowiedz się, do czego służy ten dodatek.
- Dowiedz się, jak utworzyć dodatek za pomocą Apps Script, i do czego służą usługi Apps Script.
- skonfigurować środowisko,
- Skonfiguruj skrypt.
- Uruchom skrypt.
Informacje o tym dodatku do Google Workspace
W tym przykładzie utworzysz dodatek do Google Workspace, który wyświetla podgląd linków z Książek Google w dokumencie Dokumentów Google. Gdy wpiszesz lub wkleisz URL z Książek Google w dokumencie, dodatek rozpozna link i wyświetli jego podgląd. Aby wyświetlić podgląd linku, możesz przekonwertować link na element inteligentny, najeżdżając na niego kursorem i wyświetlając kartę zawierającą więcej informacji o książce.
Ten dodatek używa usługi UrlFetch Apps Script do łączenia się z interfejsem API Książek Google i pobierania informacji o Książkach Google do wyświetlenia w Dokumentach Google.
Jak to działa
W pliku manifestu dodatku Google Workspace skrypt konfiguruje dodatek tak, aby rozszerzał pliki Dokumentów Google i uruchamiał podgląd linków dla adresów URL, które pasują do określonych wzorców z witryny Książek Google (https://books.google.com
).
W pliku kodu skrypt łączy się z interfejsem API Książek Google i używa adresu URL do pobrania informacji o książce (która jest instancją zasobu Volume
). Na podstawie tych informacji skrypt generuje element inteligentny wyświetlający tytuł książki oraz kartę podglądu z podsumowaniem, liczbą stron, zdjęciem okładki książki i liczbą ocen.
Usługi Apps Script
Ten dodatek korzysta z następujących usług:
- UrlFetch Service – łączy się z interfejsem API Książek Google, by pobierać informacje o książkach (które są wystąpieniami zasobu
Volume
API). - Card Service (Usługa karty) – tworzy interfejs użytkownika dodatku.
Wymagania wstępne
Aby korzystać z tego przykładu, musisz spełnić te wymagania wstępne:
- Konto Google (konta Google Workspace mogą wymagać zatwierdzenia przez administratora).
Przeglądarka z dostępem do internetu.
Projekt Google Cloud z powiązanym kontem rozliczeniowym. Więcej informacji znajdziesz w artykule Włączanie płatności za projekt.
Konfigurowanie środowiska
W sekcjach poniżej dowiesz się, jak skonfigurować środowisko, w którym chcesz utworzyć dodatek.
Otwieranie projektu Cloud w konsoli Google Cloud
Jeśli projekt nie jest jeszcze otwarty, otwórz go, którego zamierzasz użyć w tym przykładzie:
- W konsoli Google Cloud otwórz stronę Wybierz projekt.
- Wybierz projekt Google Cloud, którego chcesz użyć. Możesz też kliknąć Utwórz projekt i postępować zgodnie z instrukcjami wyświetlanymi na ekranie. Jeśli tworzysz projekt Google Cloud, konieczne może być włączenie dla niego płatności.
Włączanie interfejsu API Książek Google
Ten dodatek łączy się z interfejsem API Książek Google. Zanim zaczniesz korzystać z 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.
W swoim projekcie Cloud włącz Books API.
Konfigurowanie ekranu zgody OAuth
Ten dodatek wymaga projektu Cloud ze skonfigurowanym ekranem zgody. Skonfigurowanie ekranu akceptacji OAuth określa, co Google wyświetla użytkownikom, oraz rejestruje aplikację, aby można ją było później opublikować.
- W konsoli Google Cloud otwórz Menu > Interfejsy API i usługi > Ekran zgody OAuth.
- Jako Typ użytkownika wybierz Wewnętrzny i kliknij Utwórz.
- Wypełnij formularz rejestracji aplikacji, a potem kliknij Zapisz i kontynuuj.
Na razie możesz pominąć dodawanie zakresów i kliknąć Zapisz i kontynuuj. W przyszłości, gdy utworzysz aplikację do użytku poza swoją organizacją Google Workspace, musisz zmienić Typ użytkownika na Zewnętrzny, a następnie dodać zakresy autoryzacji wymagane przez aplikację.
- Przejrzyj podsumowanie rejestracji aplikacji. Aby wprowadzić zmiany, kliknij Edytuj. Jeśli rejestracja aplikacji wygląda dobrze, kliknij Wróć do panelu.
Uzyskiwanie klucza interfejsu API Książek Google
- Otwórz konsolę Google Cloud. Sprawdź, czy projekt z włączonymi płatnościami jest otwarty.
W konsoli Google Cloud otwórz Menu > Interfejsy API i usługi > Dane logowania.
Kliknij Utwórz dane logowania > Klucz interfejsu API.
Zanotuj swój klucz interfejsu API – będzie Ci potrzebny w późniejszym kroku.
Konfigurowanie skryptu
Skrypt tworzenia dodatku został omówiony w poniższych sekcjach.
Tworzenie projektu Apps Script
- Kliknij ten przycisk, aby otworzyć projekt Podgląd linków z Książek Google
Apps Script.
Otwórz projekt - Kliknij Przegląd.
- Na stronie Przegląd kliknij Utwórz kopię.
- Przejdź do pliku
Code.gs
w kopii projektu Apps Script i zastąpYOUR_API_KEY
kluczem interfejsu API wygenerowanym w poprzedniej sekcji.
Kopiuj numer projektu Cloud
- W konsoli Google Cloud otwórz Menu > Administracja > Ustawienia.
- Skopiuj wartość z pola Numer projektu.
Ustawianie projektu Cloud w projekcie Apps Script
- W projekcie Apps Script kliknij Ustawienia projektu.
- W sekcji Projekt Google Cloud Platform (GCP) kliknij Zmień projekt.
- W polu Numer projektu GCP wklej numer projektu Google Cloud.
- Kliknij Set project (Ustaw projekt).
Testowanie dodatku
Poniższe sekcje pozwalają przetestować utworzony dodatek.
Instalowanie wdrożenia testowego
- W projekcie Apps Script kliknij Edytor.
- Zastąp
YOUR_API_KEY
kluczem interfejsu Google Books API utworzonym w poprzedniej sekcji. - Kliknij Wdróż > Testuj wdrożenia.
- Kliknij Zainstaluj > Gotowe.
Wyświetlanie podglądu linku w Dokumentach Google
- Utwórz dokument w Dokumentach Google na stronie docs.new.
- Wklej ten adres URL do dokumentu i naciśnij klawisz Tab, aby przekonwertować adres URL na element inteligentny:
https://www.google.com/books/edition/Software_Engineering_at_Google/V3TTDwAAQBAJ
- Najedź kursorem na element inteligentny, a gdy pojawi się prośba, autoryzuj dostęp, aby uruchomić dodatek. Na karcie podglądu zobaczysz informacje o książce.
Na tej ilustracji widać podgląd linku:
Sprawdź kod
Jeśli chcesz przejrzeć kod Apps Script tego dodatku, kliknij Wyświetl kod źródłowy w celu rozwinięcia sekcji: