Poziom zaawansowania w zakresie programowania: średni
Czas trwania: 30 minut
Typ projektu: dodatek do Google Workspace
Cele
- Dowiedz się, na czym polega działanie rozwiązania.
- Dowiedz się, jak usługi Apps Script działają w ramach rozwiązania.
- Skonfiguruj środowisko.
- Skonfiguruj skrypt.
- Uruchom skrypt.
Informacje o rozwiązaniu
Ręczne kopiowanie makr arkuszy kalkulacyjnych Google z jednego arkusza do drugiego może być czasochłonne i podatne na błędy. Ten dodatek do Google Workspace automatycznie kopiuje projekt skryptu i dołącza go do arkusza kalkulacyjnego określonego przez użytkownika. Chociaż to rozwiązanie skupia się na makrach w Arkuszach, możesz go użyć do kopiowania i udostępniania dowolnego skryptu powiązanego z kontenerem.
Jak to działa
Skrypt kopiuje projekt Apps Script powiązany z oryginalnym skoroszytem i tworzy jego kopię powiązaną z skoroszytem wskazanym przez użytkownika.
Usługi Apps Script
To rozwiązanie korzysta z tych usług:
- Usługa pobierania danych z adresów URL – łączy się z interfejsem Apps Script API, aby skopiować projekt źródłowy i utworzyć jego kopię.
- Usługa skryptu – autoryzuje interfejs API Apps Script, aby uniknąć drugiego prompta autoryzacji.
- Usługa Arkuszy Google – otwiera arkusz docelowy, aby dodać skopiowany projekt Apps Script.
- Usługa kart – tworzy interfejs dodatku.
Wymagania wstępne
Aby skorzystać z tego przykładu, musisz spełnić te wymagania wstępne:
- Konto Google (konta Google Workspace mogą wymagać zatwierdzenia przez administratora).
przeglądarka internetowa z dostępem do internetu;
interfejs Google Apps Script API włączony w ustawieniach panelu Apps Script;
Konfigurowanie środowiska
Otwieranie projektu Cloud w konsoli Google Cloud
Jeśli nie jest jeszcze otwarty, otwórz projekt Cloud, którego chcesz użyć w przypadku tej próbki:
- 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 płatności.
Włącz interfejs Google Apps Script API
W tym krótkim wprowadzeniu użyjemy interfejsu Google Apps Script API.
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 projekcie Cloud włącz interfejs Google Apps Script API.
Konfigurowanie ekranu zgody OAuth
Dodatki Google Workspace wymagają konfiguracji ekranu z prośbą o zgodę. Konfiguracja ekranu zgody OAuth w Twoim dodatku określa, co Google wyświetla użytkownikom.
- W konsoli Google Cloud otwórz Menu > > Identyfikacja marki.
- Jeśli masz już skonfigurowany projekt , możesz skonfigurować te ustawienia ekranu zgody OAuth: Markowanie, Odbiorcy i Dostęp do danych. Jeśli zobaczysz komunikat nie skonfigurowano, kliknij Rozpocznij:
- W sekcji Informacje o aplikacji w polu Nazwa aplikacji wpisz nazwę aplikacji.
- W sekcji Adres e-mail zespołu pomocy wybierz adres e-mail zespołu pomocy, na który użytkownicy będą mogli się z Tobą kontaktować w sprawie pytań dotyczących zgody.
- Kliknij Dalej.
- W sekcji Odbiorcy wybierz Wewnętrzny.
- Kliknij Dalej.
- W sekcji Dane kontaktowe wpisz adres e-mail, na który będą wysyłane powiadomienia o zmianach w projekcie.
- Kliknij Dalej.
- W sekcji Zakończ zapoznaj się z zasadami dotyczącymi danych użytkownika w usługach interfejsu API Google, a potem, jeśli się z nimi zgadzasz, kliknij Akceptuję zasady dotyczące danych użytkownika w usługach interfejsu API Google.
- Kliknij Dalej.
- Kliknij Utwórz.
- Na razie możesz pominąć dodawanie zakresów. Gdy w przyszłości będziesz tworzyć aplikację do użytku poza organizacją Google Workspace, musisz zmienić Typ użytkownika na Zewnętrzny. Następnie dodaj zakresy autoryzacji wymagane przez aplikację. Więcej informacji znajdziesz w pełnym przewodniku Konfigurowanie zgody OAuth.
Konfigurowanie skryptu
Tworzenie projektu Apps Script
- Kliknij ten przycisk, aby otworzyć projekt Apps Script Udostępnij makro.
Otwórz projekt - Kliknij Przegląd .
- Na stronie przeglądu kliknij Utwórz kopię
.
Skopiuj numer projektu Cloud
- W konsoli Google Cloud kliknij Menu > Administracja > Ustawienia.
- W polu Numer projektu skopiuj wartość.
Ustawianie projektu Google Cloud w projekcie Apps Script
- W skopiowanym 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 Ustaw projekt.
Instalowanie testowego wdrożenia
- W skopiowanym projekcie Apps Script kliknij Edytor .
- Otwórz plik
UI.gs
i kliknij Uruchom. Gdy pojawi się odpowiedni komunikat, autoryzuj skrypt. - Kliknij Wdróż > Testuj wdrożenia.
- Kliknij Zainstaluj > Gotowe.
Pobieranie skryptu makra i informacji o arkuszu kalkulacyjnym
- Otwórz arkusz kalkulacyjny w Arkuszach, który zawiera makro, i sprawdź, czy masz uprawnienia do jego edycji. Aby użyć przykładowego arkusza kalkulacyjnego, utwórz kopię przykładowego makraarkusza kalkulacyjnego.
- Kliknij Rozszerzenia > Apps Script.
- W projekcie Apps Script kliknij Ustawienia projektu
.
- Pod identyfikatorem skryptu kliknij Kopiuj.
- Zapisz identyfikator skryptu, aby użyć go w następnym kroku.
- Otwórz lub utwórz nowy arkusz kalkulacyjny, do którego chcesz dodać makro. Musisz mieć uprawnienia do edytowania arkusza kalkulacyjnego.
- Skopiuj adres URL arkusza kalkulacyjnego i odłóż go na później.
Uruchamianie skryptu
Upewnij się, że interfejs Google Apps Script API jest włączony w ustawieniach panelu. Aby uruchomić skrypt, wykonaj czynności opisane w poniższych sekcjach.
Kopiowanie makra
- W Arkuszach na pasku bocznym po prawej stronie otwórz dodatek Udostępnianie makr
.
- W sekcji Źródło makra wklej identyfikator skryptu.
- W sekcji Docelowy arkusz kalkulacyjny wklej adres URL arkusza kalkulacyjnego.
- Kliknij Udostępnij makro.
- Kliknij Zezwól na dostęp i autoryzuj dodatek.
- Powtórz kroki 2–4.
Otwórz skopiowane makro
- Otwórz arkusz kalkulacyjny, do którego skopiowano makro.
- Kliknij Rozszerzenia > Apps Script.
- Jeśli nie widzisz skopiowanego projektu Apps Script, sprawdź, czy interfejs Google Apps Script API jest włączony w ustawieniach panelu, a potem powtórz czynności opisane w sekcji Kopiowanie makra.
Sprawdzanie kodu
Aby sprawdzić kod Apps Script tego rozwiązania, kliknij Wyświetl kod źródłowy poniżej:
Pokaż kod źródłowy
Code.gs
UI.gs
appsscript.json
Współtwórcy
Ten przykład jest obsługiwany przez Google przy pomocy ekspertów Google ds. programowania.
Dalsze kroki
- Rozszerzanie Google Workspace za pomocą dodatków
- Tworzenie dodatków do Google Workspace
- Publikowanie aplikacji