Autoryzacja dla usług Google

Apps Script wymaga autoryzacji użytkownika, aby uzyskać dostęp do danych prywatnych z wbudowanych usług Google lub zaawansowanych usług Google.

Przyznawanie uprawnień dostępu

Apps Script automatycznie określa zakresy autoryzacji (np. dostęp do plików Arkuszy Google czy Gmaila) na podstawie skanowania kodu. Skomentowany kod nadal może generować żądanie autoryzacji. Jeśli skrypt wymaga autoryzacji, po uruchomieniu zobaczysz jedno z okna autoryzacji.

Skrypty, które zostały wcześniej autoryzowane, również proszą o dodatkową autoryzację, jeśli zmiana kodu spowoduje dodanie nowych usług. Skrypty nie mogą żądać autoryzacji, jeśli uzyskujesz do nich dostęp jako aplikacja internetowa uruchamiana z tożsamością użytkownika właściciela skryptu.

Anulowanie praw dostępu

Aby odebrać skryptowi dostęp do Twoich danych, wykonaj te czynności:

  1. Otwórz stronę uprawnień na swoim koncie Google. (Aby później wejść na tę stronę, wejdź na Google.com i kliknij swoje zdjęcie profilowe w prawym górnym rogu ekranu. Następnie w sekcji „Logowanie i bezpieczeństwo” kliknij Moje konto, Połączone aplikacje i witryny i Zarządzaj aplikacjami).
  2. Kliknij nazwę skryptu, którego autoryzację chcesz anulować, a następnie kliknij Usuń po prawej stronie i OK w wyświetlonym oknie.

Uprawnienia i typy skryptów

Tożsamość użytkownika, z której korzysta skrypt, a tym samym dane, do których ma dostęp, różni się w zależności od scenariusza, w którym został uruchomiony skrypt, jak pokazano w tabeli poniżej.

Typ skryptu Skrypt działa jako...
Samodzielne, dodatek lub powiązane z Dokumentami, Arkuszami, Prezentacjami lub Formularzami. Użytkownik przy klawiaturze
Funkcja niestandardowa w arkuszu kalkulacyjnym Użytkownik anonimowy; jednak limity są wliczane do limitu użytkownika na klawiaturze
Aplikacja internetowa lub gadżet Witryny Google Użytkownik z klawiatury lub właściciela skryptu w zależności od opcji wybranych podczas wdrażania aplikacji
Aktywator możliwy do zainstalowania Użytkownik, który utworzył regułę

Zakresy ręcznej autoryzacji w Arkuszach, Dokumentach, Prezentacjach i Formularzach

Jeśli tworzysz dodatek lub inny skrypt korzystający z usługi Arkuszy kalkulacyjnych, usługi Dokumenty, usługi Prezentacje lub usługi Formularze, możesz w oknie autoryzacji zezwolić na wyświetlanie tylko tych plików, w których jest używany ten dodatek lub skrypt, a nie wszystkich arkuszy kalkulacyjnych, dokumentów czy formularzy użytkownika. Aby to zrobić, dodaj następującą adnotację JsDoc do komentarza na poziomie pliku:

/**
 * @OnlyCurrentDoc
 */

Adnotacja przeciwstawna (@NotOnlyCurrentDoc) jest dostępna, jeśli skrypt zawiera bibliotekę, która deklaruje @OnlyCurrentDoc, ale skrypt główny wymaga dostępu do większej liczby plików niż bieżący plik.

Cykl życia autoryzacji dodatków

Dodatki do Arkuszy, Dokumentów, Prezentacji i Formularzy Google są zwykle zgodne z tym samym modelem autoryzacji co skrypty powiązane z dokumentem. Jednak w pewnych okolicznościach ich funkcje onOpen(e) i onEdit(e) działają w trybie braku autoryzacji, co wiąże się z kilkoma dodatkowymi komplikacjami. Więcej informacji znajdziesz w przewodniku po cyklu życia autoryzacji dodatków.

Limity liczby użytkowników aplikacji OAuth

Aplikacje używające protokołu OAuth do uzyskiwania dostępu do danych użytkowników Google (w tym projekty Apps Script) podlegają limitom autoryzacji. Więcej informacji znajdziesz w artykule Limity użytkowników aplikacji OAuth.