API Reference

To odniesienie do interfejsu API jest uporządkowane według typu zasobu. Każdy typ zasobu ma co najmniej 1 reprezentację danych i co najmniej 1 metodę.

Typy zasobów

1. ACL
2. ListaLista
3. Kalendarze
4. Kanały
5. Kolory
6. Zdarzenia
7. Wolny/Zajęty
8. Ustawienia

Lista ACL

Szczegóły zasobu ACL znajdziesz na stronie Reprezentowanie zasobów.

Metoda	Żądanie HTTP	Opis
Identyfikatory URI względem https://www.googleapis.com/calendar/v3, chyba że zaznaczono inaczej
usuń	DELETE  /calendars/calendarId/acl/ruleId	Usunięcie reguły kontroli dostępu.
pobierz	GET  /calendars/calendarId/acl/ruleId	Zwraca regułę kontroli dostępu.
wstaw	POST  /calendars/calendarId/acl	Tworzy regułę kontroli dostępu.
list	GET  /calendars/calendarId/acl	Zwraca reguły na liście kontroli dostępu do kalendarza.
poprawka	PATCH  /calendars/calendarId/acl/ruleId	Aktualizuje regułę kontroli dostępu. Ta metoda obsługuje semantykę poprawki. Zwróć uwagę na to, że każde żądanie poprawki zużywa trzy jednostki limitu. Zalecamy użycie get, a następnie update. Podane wartości pól zastępują istniejące wartości. Pola, których nie określisz w żądaniu, pozostaną bez zmian. Pola tablicowe (jeśli zostały określone) zastępują istniejące tablice. Spowoduje to odrzucenie wszystkich poprzednich elementów tablicy.
zaktualizuj	PUT  /calendars/calendarId/acl/ruleId	Aktualizuje regułę kontroli dostępu.
zegarek	POST  /calendars/calendarId/acl/watch	Zwróć uwagę na zmiany zasobów ACL.

Listakalendarz

Szczegóły zasobu CalendarList znajdziesz na stronie reprezentowania zasobów.

Metoda	Żądanie HTTP	Opis
Identyfikatory URI względem https://www.googleapis.com/calendar/v3, chyba że zaznaczono inaczej
usuń	DELETE  /users/me/calendarList/calendarId	Usuwa kalendarz z listy kalendarzy użytkownika.
pobierz	GET  /users/me/calendarList/calendarId	Zwraca kalendarz z listy kalendarzy użytkownika.
wstaw	POST  /users/me/calendarList	Wstawia istniejący kalendarz do listy kalendarzy użytkownika.
list	GET  /users/me/calendarList	Zwraca kalendarze na liście kalendarzy użytkownika.
poprawka	PATCH  /users/me/calendarList/calendarId	Aktualizuje istniejący kalendarz na liście kalendarzy użytkownika. Ta metoda obsługuje semantykę poprawki. Zwróć uwagę na to, że każde żądanie poprawki zużywa trzy jednostki limitu. Zalecamy użycie get, a następnie update. Podane wartości pól zastępują istniejące wartości. Pola, których nie określisz w żądaniu, pozostaną bez zmian. Pola tablicowe (jeśli zostały określone) zastępują istniejące tablice. Spowoduje to odrzucenie wszystkich poprzednich elementów tablicy.
zaktualizuj	PUT  /users/me/calendarList/calendarId	Aktualizuje istniejący kalendarz na liście kalendarzy użytkownika.
zegarek	POST  /users/me/calendarList/watch	Zwróć uwagę na zmiany zasobów kalendarza.

Kalendarze

Szczegółowe informacje o zasobach Kalendarza znajdziesz na stronie reprezentowania zasobów.

Metoda	Żądanie HTTP	Opis
Identyfikatory URI względem https://www.googleapis.com/calendar/v3, chyba że zaznaczono inaczej
wyczyść	POST  /calendars/calendarId/clear	Usuwa kalendarz główny. Ta operacja usuwa wszystkie wydarzenia powiązane z kalendarzem głównym konta.
usuń	DELETE  /calendars/calendarId	Usunięcie kalendarza pomocniczego. Aby wyczyścić wszystkie wydarzenia w kalendarzach głównych, użyj calendar.clear.
pobierz	GET  /calendars/calendarId	Zwraca metadane kalendarza.
wstaw	POST  /calendars	Tworzy kalendarz pomocniczy.
poprawka	PATCH  /calendars/calendarId	Aktualizuje metadane kalendarza. Ta metoda obsługuje semantykę poprawki. Zwróć uwagę na to, że każde żądanie poprawki zużywa trzy jednostki limitu. Zalecamy użycie get, a następnie update. Podane wartości pól zastępują istniejące wartości. Pola, których nie określisz w żądaniu, pozostaną bez zmian. Pola tablicowe (jeśli zostały określone) zastępują istniejące tablice. Spowoduje to odrzucenie wszystkich poprzednich elementów tablicy.
zaktualizuj	PUT  /calendars/calendarId	Aktualizuje metadane kalendarza.

Kanały

Szczegółowe informacje o zasobach kanałów znajdziesz na stronie Reprezentowanie zasobów.

Metoda	Żądanie HTTP	Opis
Identyfikatory URI względem https://www.googleapis.com/calendar/v3, chyba że zaznaczono inaczej
postój	POST  /channels/stop	Przestań oglądać zasoby w tym kanale.

Kolory

Szczegółowe informacje o zasobach kolorów znajdziesz na stronie Reprezentowanie zasobów.

Metoda	Żądanie HTTP	Opis
Identyfikatory URI względem https://www.googleapis.com/calendar/v3, chyba że zaznaczono inaczej
pobierz	GET  /colors	Zwraca definicje kolorów kalendarzy i wydarzeń.

Zdarzenia

Szczegóły zasobu zasobu zdarzeń znajdziesz na stronie reprezentowania zasobów.

Metoda	Żądanie HTTP	Opis
Identyfikatory URI względem https://www.googleapis.com/calendar/v3, chyba że zaznaczono inaczej
usuń	DELETE  /calendars/calendarId/events/eventId	Usuwa wydarzenie.
pobierz	GET  /calendars/calendarId/events/eventId	Zwraca wydarzenie na podstawie jego identyfikatora Kalendarza Google. Aby pobrać wydarzenie za pomocą jego identyfikatora iCalendar, wywołaj events.list przy użyciu parametru iCalUID.
import	POST  /calendars/calendarId/events/import	Importuje zdarzenie. Ta operacja służy do dodawania do kalendarza prywatnej kopii istniejącego wydarzenia.
wstaw	POST  /calendars/calendarId/events	Tworzy wydarzenie.
instancje	GET  /calendars/calendarId/events/eventId/instances	Zwraca instancje określonego wydarzenia cyklicznego.
list	GET  /calendars/calendarId/events	Zwraca wydarzenia z określonego kalendarza.
przenieś	POST  /calendars/calendarId/events/eventId/move	Przenosi wydarzenie do innego kalendarza, tj. zmienia organizatora wydarzenia. Wymagane parametry zapytania: destination
poprawka	PATCH  /calendars/calendarId/events/eventId	Aktualizuje wydarzenie. Ta metoda obsługuje semantykę poprawki. Zwróć uwagę na to, że każde żądanie poprawki zużywa trzy jednostki limitu. Zalecamy użycie get, a następnie update. Podane wartości pól zastępują istniejące wartości. Pola, których nie określisz w żądaniu, pozostaną bez zmian. Pola tablicowe (jeśli zostały określone) zastępują istniejące tablice. Spowoduje to odrzucenie wszystkich poprzednich elementów tablicy.
szybkiedodawanie	POST  /calendars/calendarId/events/quickAdd	Tworzy zdarzenie na podstawie prostego ciągu tekstowego. Wymagane parametry zapytania: text
zaktualizuj	PUT  /calendars/calendarId/events/eventId	Aktualizuje wydarzenie. Ta metoda nie obsługuje semantyki poprawki i zawsze aktualizuje cały zasób zdarzenia. Aby wykonać częściową aktualizację, wykonaj get, a następnie update za pomocą tagów, aby zyskać uwagę.
zegarek	POST  /calendars/calendarId/events/watch	Informacje o zmianach w zasobach dotyczących wydarzeń.

Wolny/Zajęty

Więcej informacji o zasobach Wolny/Zajęty znajdziesz na stronie reprezentowania zasobów.

Metoda	Żądanie HTTP	Opis
Identyfikatory URI względem https://www.googleapis.com/calendar/v3, chyba że zaznaczono inaczej
zapytanie	POST  /freeBusy	Zwraca informacje o stanie Wolny/Zajęty dla zestawu kalendarzy.

Ustawienia

Szczegółowe informacje o zasobie ustawień znajdziesz na stronie Reprezentowanie zasobów.

Metoda	Żądanie HTTP	Opis
Identyfikatory URI względem https://www.googleapis.com/calendar/v3, chyba że zaznaczono inaczej
pobierz	GET  /users/me/settings/setting	Zwraca ustawienie pojedynczego użytkownika.
list	GET  /users/me/settings	Zwraca wszystkie ustawienia uwierzytelnionego użytkownika.
zegarek	POST  /users/me/settings/watch	Informacje o zmianach w zasobach dotyczących ustawień znajdziesz tutaj.