Calendars: update

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

Prośba

Żą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 aktualnie zalogowanego użytkownika, użyj słowa kluczowego „primary”.

Upoważnienie

To żądanie wymaga autoryzacji w tym zakresie:

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

Więcej informacji znajdziesz na stronie uwierzytelniania i autoryzacji.

Treść żądania

W treści żądania podaj zasób kalendarzy 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 Położenie geograficzne kalendarza w postaci tekstu dowolnego. Opcjonalnie. z możliwością zapisu
summary string Nazwa 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 kalendarzy 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

Korzysta z 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 dla języka Python.

# 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

Korzysta z 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 Eksploratora interfejsów API poniżej, aby wywołać tę metodę na aktywnych danych i zobaczyć odpowiedź.