Ten dokument zawiera informacje o autoryzacji i uwierzytelnianiu w interfejsie Google Calendar API. Zanim przeczytasz ten dokument, zapoznaj się z ogólnymi informacjami o uwierzytelnianiu i autoryzacji w Google Workspace, które znajdziesz w artykule Uwierzytelnianie i autoryzacja.
Konfigurowanie OAuth 2.0 na potrzeby autoryzacji
Skonfiguruj ekran zgody OAuth i wybierz zakresy, aby określić, jakie informacje będą wyświetlane użytkownikom i osobom weryfikującym aplikację, oraz zarejestruj aplikację, aby móc ją później opublikować.
Zakresy interfejsu Calendar API
Aby określić poziom dostępu przyznany aplikacji, musisz zidentyfikować i zadeklarować zakresy autoryzacji. Zakres autoryzacji to ciąg znaków URI OAuth 2.0, który zawiera nazwę aplikacji Google Workspace, rodzaj danych, do których ma ona dostęp, oraz poziom dostępu. Zakresy to żądania aplikacji dotyczące pracy z danymi Google Workspace, w tym z danymi kont Google użytkowników.
Gdy aplikacja zostanie zainstalowana, użytkownik jest proszony o potwierdzenie zakresów używanych przez aplikację. Zazwyczaj należy wybrać jak najwęższy zakres i unikać żądania zakresów, których aplikacja nie potrzebuje. Użytkownicy chętniej przyznają dostęp do ograniczonych, jasno opisanych zakresów.
Interfejs Calendar API obsługuje te zakresy:
| Zakres | Znaczenie |
|---|---|
https://www.googleapis.com/auth/calendar |
Przeglądaj, edytuj i trwale usuwaj wszystkie kalendarze, do których masz dostęp w Kalendarzu Google. |
https://www.googleapis.com/auth/calendar.readonly |
Wyświetlanie i pobieranie wszystkich kalendarzy, do których masz dostęp w Kalendarzu. |
https://www.googleapis.com/auth/calendar.freebusy |
Wyświetlanie dostępności w kalendarzach. |
https://www.googleapis.com/auth/calendar.events |
wyświetlać i edytować wydarzenia we wszystkich kalendarzach; |
https://www.googleapis.com/auth/calendar.events.readonly |
wyświetlać wydarzenia we wszystkich kalendarzach; |
https://www.googleapis.com/auth/calendar.settings.readonly |
Wyświetl ustawienia Kalendarza. |
https://www.googleapis.com/auth/calendar.addons.execute |
Uruchamianie jako dodatku w Kalendarzu. |
https://www.googleapis.com/auth/calendar.addons.current.event.read |
wyświetlać wydarzenia otwierane przez Ciebie w Kalendarzu Google. |
https://www.googleapis.com/auth/calendar.addons.current.event.write |
Edytowanie wydarzeń otwieranych przez Ciebie w Kalendarzu Google. |
https://www.googleapis.com/auth/calendar.events.owned |
wyświetlać, tworzyć, zmieniać i usuwać wydarzenia w Kalendarzach Google, których jesteś właścicielem; |
https://www.googleapis.com/auth/calendar.events.owned.readonly |
Wyświetlanie wydarzeń w Kalendarzach Google, których jesteś właścicielem. |
https://www.googleapis.com/auth/calendar.events.freebusy |
wyświetlanie dostępności w Kalendarzach Google, do których masz dostęp; |
https://www.googleapis.com/auth/calendar.app.created |
Tworzenie drugorzędnych Kalendarzy Google oraz wyświetlanie, tworzenie, zmienianie i usuwanie wydarzeń w tych kalendarzach. |
https://www.googleapis.com/auth/calendar.calendarlist |
Wyświetlanie, dodawanie i usuwanie Kalendarzy Google, które subskrybujesz. |
https://www.googleapis.com/auth/calendar.calendarlist.readonly |
Wyświetl listę Kalendarzy Google, które subskrybujesz. |
https://www.googleapis.com/auth/calendar.calendars |
Wyświetlanie i zmienianie właściwości Kalendarzy Google, do których masz dostęp, oraz tworzenie kalendarzy drugorzędnych. |
https://www.googleapis.com/auth/calendar.calendars.readonly |
Wyświetlanie tytułu, opisu, domyślnej strefy czasowej i innych właściwości Kalendarzy Google, do których masz dostęp. |
https://www.googleapis.com/auth/calendar.acls |
Wyświetlanie i zmienianie uprawnień udostępniania w Kalendarzach Google, których jesteś właścicielem. |
https://www.googleapis.com/auth/calendar.acls.readonly |
Wyświetlanie uprawnień udostępniania Kalendarzy Google, których jesteś właścicielem. |
https://www.googleapis.com/auth/calendar.events.public.readonly |
Wyświetlanie wydarzeń w kalendarzach publicznych. |