Aktualizuje wydarzenie. Ta metoda obsługuje semantykę poprawki. Pamiętaj, że każde żądanie PATCH zużywa 3 jednostki limitu. Zalecamy używanie żądania get, a potem żądania update. Podane wartości pól zastąpią dotychczasowe wartości. Pola, których nie określisz w żądaniu, pozostaną bez zmian. Pola tablicy, jeśli są określone, zastępują istniejące tablice, co powoduje odrzucenie wszystkich poprzednich elementów tablicy.
Wypróbuj teraz
Żądanie
Żądanie HTTP
PATCH https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId
Parametry
| Nazwa parametru | Wartość | Opis |
|---|---|---|
| Parametry ścieżki | ||
calendarId |
string |
Identyfikator kalendarza. Aby pobrać identyfikatory kalendarzy, wywołaj metodę calendarList.list. Jeśli chcesz uzyskać dostęp do kalendarza głównego aktualnie zalogowanego użytkownika, użyj słowa kluczowego „primary”.
|
eventId |
string |
Identyfikator zdarzenia. |
| Opcjonalne parametry zapytania | ||
alwaysIncludeEmail |
boolean |
Wycofane i ignorowane. W polu email zawsze będzie zwracana wartość dla organizatora, twórcy i uczestników, nawet jeśli nie jest dostępny żaden prawdziwy adres e-mail (czyli zostanie podana wygenerowana, nieprawidłowa wartość).
|
conferenceDataVersion |
integer |
Numer wersji danych konferencji obsługiwanych przez klienta interfejsu API. Wersja 0 zakłada brak obsługi danych konferencji i ignoruje dane konferencji w treści wydarzenia. Wersja 1 umożliwia kopiowanie obiektu ConferenceData, a także tworzenie nowych rozmów wideo za pomocą pola createRequest obiektu conferenceData. Wartość domyślna to 0.
Akceptowane wartości to od 0 do 1 włącznie.
|
eventLabelVersion |
integer |
Numer wersji funkcji etykiety zdarzenia obsługiwanej przez klienta API. Wersja 0 zakłada brak obsługi etykiety zdarzenia i przetwarza pole colorId na potrzeby zarządzania kolorami. Wersja 1 umożliwia obsługę etykiet zdarzeń i przetwarza parametr eventLabelId w treści zdarzenia. W takim przypadku pole colorId jest ignorowane. Wartość domyślna to 0.
Akceptowane wartości to od 0 do 1 włącznie.
|
maxAttendees |
integer |
Maksymalna liczba uczestników, których należy uwzględnić w odpowiedzi. Jeśli uczestników jest więcej niż określona liczba, zwracany jest tylko uczestnik. Opcjonalnie. |
sendNotifications |
boolean |
Rola wycofana. Zamiast tego użyj sendUpdates. Określa, czy wysyłać powiadomienia o aktualizacji wydarzenia (np. o zmianach w opisie). Pamiętaj, że niektóre e-maile mogą być nadal wysyłane, nawet jeśli ustawisz wartość false. Wartość domyślna to false.
|
sendUpdates |
string |
Goście, którzy powinni otrzymywać powiadomienia o aktualizacji wydarzenia (np. o zmianach tytułu itp.).
Akceptowane wartości:
|
supportsAttachments |
boolean |
Określa, czy klient API wykonujący operację obsługuje załączniki do zdarzeń. Opcjonalnie. Wartość domyślna to False (fałsz). |
Autoryzacja
To żądanie wymaga autoryzacji z co najmniej jednym z tych zakresów:
| Zakres |
|---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.events |
https://www.googleapis.com/auth/calendar.app.created |
https://www.googleapis.com/auth/calendar.events.owned |
Więcej informacji znajdziesz na stronie Uwierzytelnianie i autoryzacja.
Treść żądania
W treści żądania podaj odpowiednie części zasobu Events zgodnie z regułami semantyki poprawki.
Odpowiedź
Jeśli operacja się uda, ta metoda zwróci w treści odpowiedzi zasób Events.
Wypróbuj
Użyj narzędzia APIs Explorer poniżej, aby wywołać tę metodę na danych na żywo i zobaczyć odpowiedź.