Ten dokument zawiera informacje na temat autoryzacji i uwierzytelniania w interfejsie Google Calendar API. Zanim zaczniesz czytać ten dokument, zapoznaj się z ogólnymi informacjami o uwierzytelnianiu i autoryzacji w Google Workspace, które znajdziesz w artykule Więcej informacji o uwierzytelnianiu i autoryzacji.
Konfigurowanie OAuth 2.0 na potrzeby autoryzacji
Konfigurowanie ekranu zgody OAuth i wybieranie zakresów, aby określić, jakie informacje są wyświetlane użytkownikom i sprawdzającym aplikację, oraz zarejestrować aplikację, aby można ją było opublikować.
Zakresy Calendar API
Aby określić poziom dostępu przyznanego aplikacji, musisz zidentyfikować i zadeklarować zakresy autoryzacji. Zakres autoryzacji to ciąg znaków URI OAuth 2, 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 danych Google Workspace, w tym danych z konta Google użytkowników.
Po zainstalowaniu aplikacji użytkownik musi zatwierdzić zakresy używane przez aplikację. Zazwyczaj należy wybrać jak najbardziej ograniczony zakres i unikać żądania zakresów, których aplikacja nie wymaga. Użytkownicy chętniej udzielają dostępu 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świetlanie wydarzeń we wszystkich kalendarzach. |
https://www.googleapis.com/auth/calendar.settings.readonly |
Wyświetlanie ustawień 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 |
edytować wydarzenia otwierane przez Ciebie w Kalendarzu Google. |
https://www.googleapis.com/auth/calendar.events.owned |
Wyświetlanie, tworzenie, zmienianie i usuwanie wydarzeń 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świetlanie listy 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świetlać wydarzeń w kalendarzach publicznych. |