Events: patch

Aktualizuje zdarzenie. Ta metoda obsługuje semantykę poprawki. Pamiętaj, że każde żądanie zmiany zużywa 3 jednostki limitu; preferuj użycie get, a następnie update. Podane przez Ciebie wartości pól zastąpią dotychczasowe wartości. Pola, których nie podasz w żądaniu, pozostaną niezmienione. Pola tablic, jeśli są określone, zastępują istniejące tablice. Spowoduje to 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 głównego kalendarza aktualnie zalogowanego użytkownika, użyj słowa kluczowego „primary”.
eventId string Identyfikator zdarzenia.
Parametry opcjonalne zapytania
alwaysIncludeEmail boolean Ta wersja jest wycofana i ignorowana. W polu email zawsze będzie zwracana wartość dla organizatora, twórcy i uczestników, nawet jeśli nie ma prawdziwego adresu e-mail (czyli zostanie podana wygenerowana, niedziałająca 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 danych konferencji oraz tworzenie nowych konferencji za pomocą pola createRequest w danych konferencji. Wartość domyślna to 0. Akceptowane wartości to od 0 do 1 (włącznie).
maxAttendees integer Maksymalna liczba uczestników, których można uwzględnić w odpowiedzi. Jeśli liczba uczestników jest większa od określonej, zwracany jest tylko jeden uczestnik. Opcjonalnie:
sendNotifications boolean Rola wycofana. Zamiast tego użyj parametru sendUpdates.

Czy wysyłać powiadomienia o aktualizacjach wydarzenia (np. zmianach opisu). 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 zmianach w wydarzeniu (np. zmianach tytułu).

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 są wysyłane żadne powiadomienia. W przypadku zadań związanych z migracją kalendarza rozważ użycie metody Events.import.
supportsAttachments boolean Określa, czy klient interfejsu API wykonujący operację obsługuje załączniki zdarzeń. Opcjonalnie: Wartość domyślna to False (fałsz).

Autoryzacja

Ta prośba 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 Zdarzenia zgodnie z zasadami semantyki poprawki.

Odpowiedź

Jeśli operacja się powiedzie, zwróci ona w swoim ciele odpowiedź z zasobem Events.

Wypróbuj

Aby wywołać tę metodę na podstawie danych na żywo i zobaczyć odpowiedź, użyj narzędzia APIs Explorer.