Poziom kodowania: średnio zaawansowany
Czas trwania: 30 minut
Typ projektu: dodatek do Google Workspace
Cele
- Dowiedz się, do czego służy dane rozwiązanie.
- dowiedzieć się, jak usługi Apps Script działają w danym rozwiązaniu.
- Skonfiguruj środowisko.
- Skonfiguruj skrypt.
- Uruchom skrypt.
Informacje o rozwiązaniu
Ręczne kopiowanie makr Arkuszy Google z jednego arkusza kalkulacyjnego do innego 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. Choć to rozwiązanie koncentruje się na makrach Arkuszy, możesz za jego pomocą kopiować i udostępniać dowolny skrypt powiązany z kontenerem.
Jak to działa
Skrypt kopiuje projekt Apps Script powiązany z oryginalnym arkuszem kalkulacyjnym i tworzy duplikat projektu Apps Script powiązany z arkuszem kalkulacyjnym określonym przez użytkownika.
Usługi Apps Script
To rozwiązanie korzysta z następujących usług:
- Usługa pobierania adresu URL – łączy się z interfejsem Apps Script API, aby skopiować projekt źródłowy i utworzyć kopię.
- Usługa skryptu – autoryzuje interfejs Apps Script API, aby uniknąć drugiego promptu autoryzacji.
- Usługa arkusza kalkulacyjnego – otwiera docelowy arkusz kalkulacyjny, aby dodać skopiowany projekt Apps Script.
- Usługa karty – tworzy interfejs użytkownika dodatku.
Wymagania wstępne
Aby korzystać z tego przykładu, musisz spełnić te wymagania wstępne:
- konta Google (konta Google Workspace mogą wymagać zatwierdzenia przez administratora),
Przeglądarka z dostępem do internetu.
Interfejs Google Apps Script API został 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 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 utworzysz projekt Google Cloud, może być konieczne włączenie dla niego płatności.
Włączanie interfejsu Google Apps Script API
W tym krótkim wprowadzeniu używamy interfejsu Google Apps Script API.
Zanim zaczniesz korzystać z interfejsów API Google, musisz włączyć je 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 do Google Workspace wymagają konfiguracji ekranu zgody. Konfigurowanie ekranu zgody OAuth dodatku określa, co Google wyświetla użytkownikom.
- W konsoli Google Cloud otwórz Menu > Interfejsy API i usługi > Ekran akceptacji OAuth.
- W polu Typ użytkownika wybierz Wewnętrzny i kliknij Utwórz.
- Wypełnij formularz rejestracji aplikacji, a następnie kliknij Zapisz i kontynuuj.
Na razie możesz pominąć dodawanie zakresów i kliknąć Zapisz i kontynuuj. Gdy w przyszłości będziesz tworzyć aplikację do użytku poza organizacją Google Workspace, musisz zmienić Typ użytkownika na Zewnętrzny, a następnie dodać zakresy autoryzacji wymagane przez Twoją aplikację.
- Przejrzyj podsumowanie rejestracji aplikacji. Aby wprowadzić zmiany, kliknij Edytuj. Jeśli rejestracja aplikacji wygląda na prawidłową, kliknij Back to Dashboard (Powrót do panelu).
Konfigurowanie skryptu
Tworzenie projektu Apps Script
- Kliknij przycisk, aby otworzyć projekt Apps Script Udostępnij makro.
Otwórz projekt - Kliknij Przegląd .
- Na stronie przeglądu kliknij Utwórz kopię .
Kopiowanie numeru projektu Cloud
- W konsoli Google Cloud kliknij Menu > Administracja > Ustawienia.
- Skopiuj wartość z pola Numer projektu.
Ustawianie projektu Cloud dla projektu 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 wdrożenia testowego
- 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 informacji o skrypcie makra i arkuszu kalkulacyjnym
- Otwórz arkusz kalkulacyjny Arkuszy, który zawiera makro i masz uprawnienia do edycji. Aby użyć przykładowego arkusza kalkulacyjnego, utwórz kopię arkusza Przykładowe makro.
- Kliknij Rozszerzenia > Apps Script.
- W projekcie Apps Script kliknij Ustawienia projektu .
- Pod identyfikatorem skryptu kliknij Kopiuj.
- Zachowaj identyfikator skryptu do użycia w późniejszym kroku.
- Otwórz lub utwórz nowy arkusz kalkulacyjny, do którego chcesz dodać makro. Musisz mieć uprawnienia do edycji arkusza kalkulacyjnego.
- Skopiuj adres URL arkusza kalkulacyjnego i odłóż go do użycia w późniejszym kroku.
Uruchom skrypt
Upewnij się, że interfejs Google Apps Script API jest włączony w ustawieniach panelu. Aby uruchomić skrypt, wykonaj czynności opisane w sekcjach poniżej.
Skopiuj makro
- W Arkuszach na prawym pasku bocznym otwórz dodatek Udostępnij makro .
- W sekcji Makro źródłowe wklej identyfikator skryptu.
- W sekcji Docelowy arkusz kalkulacyjny wklej adres URL arkusza kalkulacyjnego.
- Kliknij Udostępnij makro.
- Kliknij Autoryzuj dostęp i autoryzuj dodatek.
- Powtórz kroki 2–4.
Otwórz skopiowane makro
- Otwórz arkusz kalkulacyjny, do którego zostało skopiowane makro, jeśli nie jest on jeszcze otwarty.
- 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, i powtórz czynności podane w sekcji Kopiowanie makra.
Sprawdź kod
Aby sprawdzić kod Apps Script dla 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
Ta próbka jest opracowywana przez Google z pomocą Ekspertów Produktowych Google.
Dalsze kroki
- Rozszerzanie możliwości Google Workspace za pomocą dodatków
- Tworzenie dodatków do Google Workspace
- Publikowanie aplikacji