Events: patch

Aktualizuje wydarzenie. Ta metoda obsługuje semantykę poprawki. Pamiętaj, że każde żądanie poprawki zużywa 3 jednostki limitu. preferujesz użycie ciągu get, po którym następuje update. Określone przez Ciebie wartości pól zastępują istniejące wartości. Pola, które nie zostaną określone w żądaniu, pozostaną niezmienione. Pola tablicowe (jeśli są określone) zastępują istniejące tablice; powoduje odrzucenie wszystkich poprzednich elementów tablicy. Wypróbuj

Żą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 narzędzia „primary” słowa kluczowego.
eventId string Identyfikator zdarzenia.
Opcjonalne parametry zapytania
alwaysIncludeEmail boolean Wycofane i ignorowane. W przypadku organizatora, twórcy i uczestników w polu email zostanie zawsze zwrócona wartość, nawet jeśli prawdziwy adres e-mail nie będzie dostępny (w tym przypadku zostanie podana wygenerowana, niedziałająca wartość).
conferenceDataVersion integer Numer wersji danych rozmów wideo obsługiwanych przez klienta interfejsu API. Wersja 0 zakłada brak obsługi danych rozmów wideo i ignoruje dane dotyczące konferencji w treści wydarzenia. Wersja 1 umożliwia obsługę kopiowania danych ConferenceData, jak również tworzenia nowych rozmów wideo przy użyciu pola createRequest of contactData. Wartość domyślna to 0. Akceptowane wartości to od 0 do 1 włącznie.
maxAttendees integer Maksymalna liczba uczestników do uwzględnienia w odpowiedzi. Jeśli uczestników jest więcej, zwracany jest tylko uczestnik. Opcjonalnie:
sendNotifications boolean Rola wycofana. Zamiast niej użyj zdarzenia sendUpdates.

Określ, czy chcesz wysyłać powiadomienia o aktualizacji wydarzenia (np. o zmianie opisu itp.). Pamiętaj, że niektóre e-maile mogą nadal zostać wysł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 zmianie tytułu).

Akceptowane wartości to:
  • „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 zostaną wysłane żadne powiadomienia. W przypadku zadań migracji kalendarza rozważ użycie metody Events.import.
supportsAttachments boolean Określa, czy klient interfejsu API, który wykonuje operację, obsługuje załączniki zdarzeń. Opcjonalnie: Wartość domyślna to 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

Więcej informacji znajdziesz na stronie dotyczącej uwierzytelniania i autoryzacji.

Treść żądania

W treści żądania podaj odpowiednie części zasobu Zdarzenia zgodnie z regułami semantyki poprawki.

Odpowiedź

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

Wypróbuj

Użyj poniższego eksploratora interfejsów API, aby wywołać tę metodę na bieżących danych i wyświetlić odpowiedź.