Events: patch

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. 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 obecnie zalogowanego użytkownika, użyj słowa kluczowego „primary”.
eventId string Identyfikator zdarzenia.
Opcjonalne parametry zapytania
alwaysIncludeEmail boolean Wycofane i ignorowane. Wartość w polu email dla organizatora, twórcy i uczestników jest zawsze zwracana, nawet jeśli nie jest dostępny prawdziwy adres e-mail (ta wartość zostanie wygenerowana i nie będzie działać).
conferenceDataVersion integer Numer wersji danych wideo obsługiwanych przez klienta API. Wersja 0 zakłada, że nie będzie obsługiwać danych rozmów wideo, i ignoruje dane konferencyjne w treści wydarzenia. Wersja 1 umożliwia kopiowanie danych ConferenceData oraz tworzenie nowych rozmów wideo w polu createRequest (dane w funkcji DataConference). Wartość domyślna to 0. Akceptowane wartości to 0–1 (włącznie).
maxAttendees integer Maksymalna liczba uczestników uwzględnionych w odpowiedzi. Jeśli uczestników jest więcej niż określona, zwracany jest tylko uczestnik. Opcjonalnie.
sendNotifications boolean Rola wycofana. Zamiast tego użyj zdarzenia sendUpdates.

Określ, czy chcesz wysyłać powiadomienia o aktualizacjach wydarzeń (np. o zmianach opisów itp.). Pamiętaj, że niektóre e-maile mogą być wysyłane nawet wtedy, gdy ustawisz wartość false. Wartość domyślna to false.
sendUpdates string Goście, którzy powinni otrzymywać powiadomienia o aktualizacji wydarzenia (np. o zmianach tytułów itp.).

Akceptowane wartości:
  • „all”: powiadomienia są wysyłane do wszystkich gości.
  • „externalOnly”: powiadomienia są wysyłane tylko do gości, którzy nie korzystają z Kalendarza Google.
  • „none”: nie wysłano żadnych powiadomień. W przypadku zadań migracji kalendarza rozważ użycie metody Events.import.
supportsAttachments boolean Określa, czy operacja klienta API obsługuje załączniki zdarzeń. Opcjonalnie. Wartość domyślna to Fałsz.

Upoważnienie

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

Więcej informacji znajdziesz na stronie uwierzytelniania i autoryzacji.

Treść żądania

W treści żądania podaj odpowiednie części zasobu zdarzeń zgodnie z semantyką poprawki.

Odpowiedź

Jeśli operacja się uda, metoda zwróci zasób zdarzeń w treści odpowiedzi.

Wypróbuj

Skorzystaj z eksploratora interfejsów API poniżej, aby wywołać tę metodę w aktywnych danych i zobaczyć odpowiedź.