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
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:
|
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:
|
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. |