Aktualizuje wydarzenie. Ta metoda nie obsługuje semantyki poprawki i zawsze aktualizuje cały zasób zdarzenia. Aby wykonać częściową aktualizację, wykonaj polecenie get
, a następnie polecenie update
, używając étagów, aby zapewnić swobodę.
Wypróbuj lub zobacz przykład.
Żądanie
Żądanie HTTP
PUT 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:
|
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 zasób Zdarzenia z tymi właściwościami:
Nazwa usługi | Wartość | Opis | Uwagi |
---|---|---|---|
Właściwości wymagane | |||
end |
nested object |
Godzina zakończenia wydarzenia (wyłączna). W przypadku wydarzenia cyklicznego jest to godzina zakończenia pierwszego wystąpienia. | |
start |
nested object |
Godzina rozpoczęcia wydarzenia (włącznie). W przypadku wydarzenia cyklicznego jest to godzina rozpoczęcia pierwszego wystąpienia. | |
Właściwości opcjonalne | |||
anyoneCanAddSelf |
boolean |
Określa, czy każdy może zaprosić na wydarzenie siebie (funkcja wycofana). Opcjonalnie: Wartość domyślna to Fałsz. | z możliwością zapisu |
attachments[].fileUrl |
string |
adres URL załącznika. Aby dodać załączniki z plikami z Dysku Google, użyj tego samego formatu co we właściwości Wymagane przy dodawaniu załącznika. |
z możliwością zapisu |
attendees[] |
list |
Uczestnicy wydarzenia. Więcej informacji o planowaniu wydarzeń z innymi użytkownikami kalendarza znajdziesz w przewodniku Wydarzenia z uczestnikami. Aby zapełnić listę uczestników, konta usługi muszą korzystać z przekazywania uprawnień w całej domenie. | z możliwością zapisu |
attendees[].additionalGuests |
integer |
Liczba dodatkowych gości. Opcjonalnie: Wartość domyślna to 0. | z możliwością zapisu |
attendees[].comment |
string |
Komentarz uczestnika do odpowiedzi. Opcjonalnie: | z możliwością zapisu |
attendees[].displayName |
string |
Imię i nazwisko uczestnika (jeśli są dostępne). Opcjonalnie: | z możliwością zapisu |
attendees[].email |
string |
Adres e-mail uczestnika, jeśli jest dostępny. To pole musi być obecne podczas dodawania uczestnika. To musi być prawidłowy adres e-mail zgodnie z RFC5322. Wymagane podczas dodawania uczestnika. |
z możliwością zapisu |
attendees[].optional |
boolean |
Określa, czy jest to opcjonalny uczestnik. Opcjonalnie: Wartość domyślna to Fałsz. | z możliwością zapisu |
attendees[].resource |
boolean |
Określa, czy uczestnik jest zasobem. Można to ustawić tylko wtedy, gdy uczestnik jest dodawany do wydarzenia po raz pierwszy. Kolejne modyfikacje są ignorowane. Opcjonalnie: Wartość domyślna to Fałsz. | z możliwością zapisu |
attendees[].responseStatus |
string |
Stan odpowiedzi uczestnika. Możliwe wartości:
|
z możliwością zapisu |
attendeesOmitted |
boolean |
Określa, czy uczestnicy mogli zostać pominięci w reprezentacji wydarzenia. Podczas pobierania zdarzenia może to być spowodowane ograniczeniem określonym przez parametr zapytania maxAttendee . Podczas aktualizowania wydarzenia można użyć tych danych tylko do zmiany odpowiedzi uczestnika. Opcjonalnie: Wartość domyślna to Fałsz. |
z możliwością zapisu |
colorId |
string |
Kolor wydarzenia. To identyfikator odnoszący się do wpisu w sekcji event definicji kolorów (patrz punkt końcowy kolorów). Opcjonalnie: |
z możliwością zapisu |
conferenceData |
nested object |
informacje związane z konferencją, na przykład szczegóły rozmowy wideo w Google Meet; Aby utworzyć nowe szczegóły rozmowy wideo, użyj pola createRequest . Aby zachować zmiany, ustaw parametr żądania conferenceDataVersion na 1 w przypadku wszystkich żądań modyfikacji zdarzenia. |
z możliwością zapisu |
description |
string |
Opis wydarzenia. Może zawierać kod HTML. Opcjonalnie: | z możliwością zapisu |
end.date |
date |
Data w formacie „rrrr-mm-dd”, jeśli jest to wydarzenie całodniowe. | z możliwością zapisu |
end.dateTime |
datetime |
Czas jako połączona wartość daty i godziny (sformatowana zgodnie z RFC3339). Przesunięcie strefy czasowej jest wymagane, chyba że w polu timeZone wyraźnie określisz strefę czasową. |
z możliwością zapisu |
end.timeZone |
string |
Strefa czasowa, w której określono godzinę. (Sformatowana jako nazwa bazy danych strefy czasowej IANA, np. „Europa/Zurych”). W przypadku wydarzeń cyklicznych to pole jest wymagane i określa strefę czasową, do której powtarza się. W przypadku pojedynczych wydarzeń to pole jest opcjonalne i wskazuje niestandardową strefę czasową rozpoczęcia i zakończenia wydarzenia. | z możliwością zapisu |
extendedProperties.private |
object |
Właściwości, które są prywatne dla kopii wydarzenia widocznego w tym kalendarzu. | z możliwością zapisu |
extendedProperties.shared |
object |
Właściwości, które są współdzielone przez kopie wydarzenia dla innych uczestników kalendarze. | z możliwością zapisu |
focusTimeProperties |
nested object |
Dane zdarzenia Czas skupienia. Używana, jeśli eventType ma wartość focusTime . |
z możliwością zapisu |
gadget.display |
string |
Tryb wyświetlania gadżetu. Rola wycofana. Możliwe wartości:
|
z możliwością zapisu |
gadget.height |
integer |
Wysokość gadżetu w pikselach. Wysokość musi być liczbą całkowitą większą od 0. Opcjonalnie: Rola wycofana. | z możliwością zapisu |
gadget.iconLink |
string |
Adres URL ikony gadżetu. Schematem adresu URL musi być HTTPS. Rola wycofana. | z możliwością zapisu |
gadget.link |
string |
Adres URL gadżetu. Schematem adresu URL musi być HTTPS. Rola wycofana. | z możliwością zapisu |
gadget.preferences |
object |
Ustawienia. | z możliwością zapisu |
gadget.title |
string |
Tytuł gadżetu. Rola wycofana. | z możliwością zapisu |
gadget.type |
string |
Typ gadżetu. Rola wycofana. | z możliwością zapisu |
gadget.width |
integer |
Szerokość gadżetu w pikselach. Szerokość musi być liczbą całkowitą większą od 0. Opcjonalnie: Rola wycofana. | z możliwością zapisu |
guestsCanInviteOthers |
boolean |
Określa, czy uczestnicy inne niż organizator mogą zapraszać na wydarzenie inne osoby. Opcjonalnie: Wartość domyślna to Prawda. | z możliwością zapisu |
guestsCanModify |
boolean |
Określa, czy uczestnicy inni niż organizator mogą modyfikować wydarzenie. Opcjonalnie: Wartość domyślna to Fałsz. | z możliwością zapisu |
guestsCanSeeOtherGuests |
boolean |
Określa, czy uczestnicy inni niż organizator mogą zobaczyć, kim są uczestnicy wydarzenia. Opcjonalnie: Wartość domyślna to Prawda. | z możliwością zapisu |
location |
string |
Lokalizacja geograficzna wydarzenia jako dowolny tekst. Opcjonalnie: | z możliwością zapisu |
originalStartTime.date |
date |
Data w formacie „rrrr-mm-dd”, jeśli jest to wydarzenie całodniowe. | z możliwością zapisu |
originalStartTime.dateTime |
datetime |
Czas jako połączona wartość daty i godziny (sformatowana zgodnie z RFC3339). Przesunięcie strefy czasowej jest wymagane, chyba że w polu timeZone wyraźnie określisz strefę czasową. |
z możliwością zapisu |
originalStartTime.timeZone |
string |
Strefa czasowa, w której określono godzinę. (Sformatowana jako nazwa bazy danych strefy czasowej IANA, np. „Europa/Zurych”). W przypadku wydarzeń cyklicznych to pole jest wymagane i określa strefę czasową, do której powtarza się. W przypadku pojedynczych wydarzeń to pole jest opcjonalne i wskazuje niestandardową strefę czasową rozpoczęcia i zakończenia wydarzenia. | z możliwością zapisu |
outOfOfficeProperties |
nested object |
Dane dotyczące wydarzeń poza biurem. Używana, jeśli eventType ma wartość outOfOffice . |
z możliwością zapisu |
recurrence[] |
list |
Lista wierszy RRULE, EXRULE, RDATE i EXDATE dla wydarzenia cyklicznego, zgodnie z opisem w RFC5545. Pamiętaj, że wiersze DTSTART i DTEND są w tym polu niedozwolone. czasy rozpoczęcia i zakończenia wydarzenia są podane w polach start i end . To pole jest pomijane w przypadku pojedynczych wydarzeń lub wystąpień wydarzeń cyklicznych. |
z możliwością zapisu |
reminders.overrides[] |
list |
Jeśli dla wydarzenia nie są używane przypomnienia domyślne, zobaczysz listę przypomnień związanych z tym wydarzeniem lub, jeśli nie zostanie skonfigurowana, wskazuje, że dla tego wydarzenia nie są ustawione żadne przypomnienia. Maksymalna liczba przypomnień o zastąpieniu to 5. | z możliwością zapisu |
reminders.overrides[].method |
string |
Metoda użyta w tym przypomnieniu. Możliwe wartości:
Wymagane przy dodawaniu przypomnienia. |
z możliwością zapisu |
reminders.overrides[].minutes |
integer |
Liczba minut przed rozpoczęciem wydarzenia, kiedy powinno wyświetlić się przypomnienie. Prawidłowe wartości mieszczą się w zakresie od 0 do 40 320 (4 tygodnie w minutach). Wymagane przy dodawaniu przypomnienia. |
z możliwością zapisu |
reminders.useDefault |
boolean |
Określa, czy domyślne przypomnienia kalendarza mają zastosowanie do wydarzenia. | z możliwością zapisu |
sequence |
integer |
Numer sekwencyjny zgodnie z iKalendarzem. | z możliwością zapisu |
source.title |
string |
Tytuł źródła; na przykład tytuł strony internetowej lub temat e-maila. | z możliwością zapisu |
source.url |
string |
Adres URL źródła wskazującego zasób. Schematem adresu URL musi być HTTP lub HTTPS. | z możliwością zapisu |
start.date |
date |
Data w formacie „rrrr-mm-dd”, jeśli jest to wydarzenie całodniowe. | z możliwością zapisu |
start.dateTime |
datetime |
Czas jako połączona wartość daty i godziny (sformatowana zgodnie z RFC3339). Przesunięcie strefy czasowej jest wymagane, chyba że w polu timeZone wyraźnie określisz strefę czasową. |
z możliwością zapisu |
start.timeZone |
string |
Strefa czasowa, w której określono godzinę. (Sformatowana jako nazwa bazy danych strefy czasowej IANA, np. „Europa/Zurych”). W przypadku wydarzeń cyklicznych to pole jest wymagane i określa strefę czasową, do której powtarza się. W przypadku pojedynczych wydarzeń to pole jest opcjonalne i wskazuje niestandardową strefę czasową rozpoczęcia i zakończenia wydarzenia. | z możliwością zapisu |
status |
string |
Stan wydarzenia. Opcjonalnie: Możliwe wartości:
|
z możliwością zapisu |
summary |
string |
Nazwa wydarzenia, | z możliwością zapisu |
transparency |
string |
Określa, czy wydarzenie ma blokować czas w kalendarzu. Opcjonalnie: Możliwe wartości:
|
z możliwością zapisu |
visibility |
string |
Widoczność wydarzenia. Opcjonalnie: Możliwe wartości:
|
z możliwością zapisu |
workingLocationProperties |
nested object |
Dane zdarzenia w lokalizacji miejsca pracy. | z możliwością zapisu |
workingLocationProperties.customLocation |
object |
Jeśli ta opcja jest dostępna, oznacza, że użytkownik pracuje w lokalizacji niestandardowej. | z możliwością zapisu |
workingLocationProperties.customLocation.label |
string |
Opcjonalna dodatkowa etykieta z dodatkowymi informacjami. | z możliwością zapisu |
workingLocationProperties.homeOffice |
any value |
Jeśli ten parametr jest dostępny, oznacza, że użytkownik pracuje w domu. | z możliwością zapisu |
workingLocationProperties.officeLocation |
object |
Jeśli ten parametr jest dostępny, oznacza, że użytkownik pracuje w biurze. | z możliwością zapisu |
workingLocationProperties.officeLocation.buildingId |
string |
Opcjonalny identyfikator budynku. Powinien odwoływać się do identyfikatora budynku w bazie danych zasobów organizacji. | z możliwością zapisu |
workingLocationProperties.officeLocation.deskId |
string |
Opcjonalny identyfikator biurka. | z możliwością zapisu |
workingLocationProperties.officeLocation.floorId |
string |
Opcjonalny identyfikator piętra. | z możliwością zapisu |
workingLocationProperties.officeLocation.floorSectionId |
string |
Opcjonalny identyfikator obszaru piętra. | z możliwością zapisu |
workingLocationProperties.officeLocation.label |
string |
Nazwa biura wyświetlana w klientach internetowych i mobilnych. Zalecamy odwołanie do nazwy budynku w bazie danych zasobów organizacji. | z możliwością zapisu |
workingLocationProperties.type |
string |
Typ lokalizacji miejsca pracy. Możliwe wartości:
Wymagane przy dodawaniu właściwości lokalizacji miejsca pracy. |
z możliwością zapisu |
Odpowiedź
Jeśli operacja się uda, metoda zwróci zasób Zdarzenia w treści odpowiedzi.
Przykłady
Uwaga: dostępne dla tej metody przykłady kodu nie odzwierciedlają wszystkich obsługiwanych języków programowania. Listę obsługiwanych języków znajdziesz na stronie z bibliotekami klienta.
Java
Używa biblioteki klienta Java.
import com.google.api.services.calendar.Calendar; import com.google.api.services.calendar.model.Event; // ... // Initialize Calendar service with valid OAuth credentials Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials) .setApplicationName("applicationName").build(); // Retrieve the event from the API Event event = service.events().get("primary", "eventId").execute(); // Make a change event.setSummary("Appointment at Somewhere"); // Update the event Event updatedEvent = service.events().update("primary", event.getId(), event).execute(); System.out.println(updatedEvent.getUpdated());
Python
Używa biblioteki klienta w Pythonie.
# First retrieve the event from the API. event = service.events().get(calendarId='primary', eventId='eventId').execute() event['summary'] = 'Appointment at Somewhere' updated_event = service.events().update(calendarId='primary', eventId=event['id'], body=event).execute() # Print the updated date. print updated_event['updated']
PHP
Używa biblioteki klienta PHP.
// First retrieve the event from the API. $event = $service->events->get('primary', 'eventId'); $event->setSummary('Appointment at Somewhere'); $updatedEvent = $service->events->update('primary', $event->getId(), $event); // Print the updated date. echo $updatedEvent->getUpdated();
Ruby
Używa biblioteki klienta Ruby.
event = client.get_event('primary', 'eventId') event.summary = 'Appointment at Somewhere' result = client.update_event('primary', event.id, event) print result.updated
Wypróbuj
Użyj poniższego eksploratora interfejsów API, aby wywołać tę metodę na bieżących danych i wyświetlić odpowiedź.