Events: patch

Aktualizuje wydarzenie. Ta metoda obsługuje semantykę poprawki. Pamiętaj, że każde żądanie poprawki zużywa 3 jednostki limitu. Lepiej użyć obiektu get, po którym następuje update. Określone przez Ciebie wartości pól zastępują obecne wartości. Pola, których nie określisz w żądaniu, pozostaną niezmienione. Pola tablicy (jeśli są określone) zastępują istniejące tablice. Spowoduje to odrzucenie wszystkich poprzednich elementów tablicy. Wypróbuj teraz

Prośba

Żą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 Wycofano i ignorowano. W polu email organizatora, twórca i uczestnicy zawsze zwracana jest wartość, nawet jeśli nie będzie dostępny żaden prawdziwy adres e-mail (tzn. zostanie podany wygenerowany, niedziałający adres).
conferenceDataVersion integer Numer wersji danych konferencji obsługiwanych przez klienta interfejsu API. W wersji 0 założono brak obsługi danych i ignoruje takie dane w treści wydarzenia. Wersja 1 umożliwia obsługę kopiowania danych ConferenceData, a także umożliwia tworzenie nowych rozmów wideo przy użyciu pola createRequest pola konferencjiData. 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 niż określona, zwracany jest tylko uczestnik. Opcjonalnie.
sendNotifications boolean Rola wycofana. Użyj funkcji sendUpdates.

Czy chcesz wysyłać powiadomienia o aktualizacji wydarzenia (np. o zmianach opisu). 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 (na przykład o zmianie nazwy 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 są wysyłane żadne powiadomienia. W przypadku zadań migracji kalendarzy rozważ użycie metody Events.import.
supportsAttachments boolean Określa, czy klient interfejsu API wykonujący operację obsługuje załączniki do wydarzeń. Opcjonalnie. Wartością domyślną jest False (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 przekaż odpowiednie części zasobu zdarzeń zgodnie z regułami semantyki poprawki.

Odpowiedź

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

Wypróbuj

Użyj Eksploratora interfejsów API poniżej, aby wywołać tę metodę na aktywnych danych i zobaczyć odpowiedź.