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.