Calendars: update

Aktualizuje metadane kalendarza. Wypróbuj lub zobacz przykład.

Żądanie

Żądanie HTTP

PUT https://www.googleapis.com/calendar/v3/calendars/calendarId

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.

Autoryzacja

To żądanie wymaga autoryzacji w tym zakresie:

Zakres
https://www.googleapis.com/auth/calendar

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

Treść żądania

W treści żądania podaj zasób Kalendarze z tymi właściwościami:

Nazwa usługi Wartość Opis Uwagi
Właściwości opcjonalne
description string Opis kalendarza. Opcjonalnie: z możliwością zapisu
location string Lokalizacja geograficzna kalendarza jako dowolny tekst. Opcjonalnie: z możliwością zapisu
summary string Tytuł kalendarza. z możliwością zapisu
timeZone string Strefa czasowa kalendarza. (Sformatowana jako nazwa bazy danych strefy czasowej IANA, np. „Europa/Zurych”). Opcjonalnie: z możliwością zapisu

Odpowiedź

Jeśli operacja się uda, metoda zwróci zasób Kalendarze 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;

// ...

// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
    .setApplicationName("applicationName").build();

// Retrieve a calendar
com.google.api.services.calendar.model.Calendar calendar =
    service.calendars().get('primary').execute();

// Make a change
calendar.setSummary("calendarSummary");

// Update the altered calendar
com.google.api.services.calendar.model.Calendar updatedCalendar =
    service.calendars().update(calendar.getId(), calendar).execute();

System.out.println(updatedCalendar.getEtag());

Python

Używa biblioteki klienta w Pythonie.

# First retrieve the calendar from the API.
calendar = service.calendars().get(calendarId='primary').execute()

calendar['summary'] = 'New Summary'

updated_calendar = service.calendars().update(calendarId=calendar['id'], body=calendar).execute()

print updated_calendar['etag']

PHP

Używa biblioteki klienta PHP.

// First retrieve the calendar from the API.
$calendar = $service->calendars->get('primary');

$calendar->setSummary('New Summary');

$updatedCalendar = $service->calendars->update('primary', $calendar);

echo $updatedCalendar->getEtag();

Ruby

Używa biblioteki klienta Ruby.

calendar = client.get_calendar('primary')
calendar.summary = "New Summary"
result = client.update_calendar(calendar.id, calendar)
print result.etag

Wypróbuj

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