Autoryzacja usług Google

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Skrypt Apps Script wymaga autoryzacji użytkownika do uzyskania dostępu do danych prywatnych z wbudowanych usług Google lub zaawansowanych usług Google.

Przyznawanie uprawnień dostępu

Apps Script automatycznie określa zakresy autoryzacji (na przykład dostęp do plików Arkuszy Google czy Gmaila) na podstawie zeskanowanego kodu. Skomentowany kod może wygenerować żądanie autoryzacji. Jeśli skrypt wymaga autoryzacji, po uruchomieniu pojawi się tutaj jedno z okien dialogowych.

Skrypty, które wcześniej zostały przez Ciebie autoryzowane, wymagają również dodatkowej autoryzacji, jeśli zmiana kodu spowoduje dodanie nowych usług. Skrypty nie mogą żądać autoryzacji, jeśli korzystasz ze skryptu jako aplikacji internetowej, która działa w ramach tożsamości użytkownika skryptu.

Unieważnianie praw dostępu

Aby cofnąć dostęp skryptu do danych, wykonaj te czynności:

  1. Wejdź na stronę uprawnień konta Google. Aby w przyszłości wrócić do tej strony, wejdź na Google.com i kliknij zdjęcie konta w prawym górnym rogu ekranu. Następnie kliknij Moje konto, w sekcji Połączone aplikacje i witryny oraz w sekcji Logowanie się i zabezpieczenia, a następnie Zarządzaj aplikacjami.
  2. Kliknij nazwę skryptu, którego autoryzację chcesz unieważnić, a następnie po prawej stronie kliknij Usuń, a potem w wyświetlonym oknie kliknij OK.

Uprawnienia i typy skryptów

Tożsamość użytkownika, z którym skrypt się uruchamia – i tym samym dane, do których ma dostęp – zależą od scenariusza, w którym skrypt jest uruchamiany, jak pokazano w poniższej tabeli.

Typ skryptu Skrypt działa jako...
Samodzielne, dodatek lub powiązanie z Dokumentami, Arkuszami, Prezentacjami lub Formularzami Użytkownik na klawiaturze
Funkcja niestandardowa w arkuszu kalkulacyjnym Anonimowy użytkownik, ale limity są wliczane do użytkownika na klawiaturze
Aplikacja internetowa lub gadżet Witryny Google Użytkownik korzystający z klawiatury lub skryptu w zależności od opcji wybranych podczas wdrażania aplikacji
Aktywator umożliwiający instalację Użytkownik, który utworzył regułę

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

Jeśli tworzysz dodatek lub inny skrypt, który korzysta z usługi arkusza kalkulacyjnego, usługi Dokumenty, usługi Prezentacji lub Formularzy, możesz wymusić wyświetlanie tylko tych plików, w których dodatek lub skrypt jest używany zamiast wszystkich arkuszy kalkulacyjnych, dokumentów lub formularzy użytkownika. Aby to zrobić, dodaj do komentarza na poziomie pliku tę adnotację: JsDoc:

/**
 * @OnlyCurrentDoc
 */

Przeciwna adnotacja (@NotOnlyCurrentDoc) jest dostępna, jeśli skrypt zawiera bibliotekę, która deklaruje właściwość @OnlyCurrentDoc, ale skrypt nadrzędny wymaga dostępu do więcej niż bieżącego pliku.

Cykl życia autoryzacji dla dodatków

Dodatki do Arkuszy, Dokumentów, Prezentacji i Formularzy Google zwykle cechują się tym samym modelem autoryzacji co skrypty, które są powiązane z dokumentem. Jednak w pewnych okolicznościach funkcje onOpen(e) i onEdit(e) działają w trybie bez autoryzacji, co stwarza pewne powikłania. Więcej informacji znajdziesz w przewodniku po cyklu życia dodatku do autoryzacji.

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 projektów Apps Script, podlegają limitom autoryzacji. Więcej informacji znajdziesz w artykule na temat limitów użytkowników aplikacji OAuth.