Events: quickAdd

Tworzy zdarzenie na podstawie prostego ciągu tekstowego. Wypróbuj lub zobacz przykład.

Prośba

Żądanie HTTP

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/quickAdd

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”.
Wymagane parametry zapytania
text string Tekst opisujący zdarzenie do utworzenia.
Opcjonalne parametry zapytania
sendNotifications boolean Rola wycofana. Użyj funkcji sendUpdates.

Określ, czy chcesz wysłać powiadomienia o utworzeniu wydarzenia. 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 utworzeniu nowego wydarzenia.

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.

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

Nie podawaj treści żądania z tą metodą.

Odpowiedź

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

// Quick-add an event
String eventText = "Appointment at Somewhere on June 3rd 10am-10:25am";
Event createdEvent =
    service.events().quickAdd('primary').setText(eventText).execute();

System.out.println(createdEvent.getId());

Python

Używa biblioteki klienta dla języka Python.

created_event = service.events().quickAdd(
    calendarId='primary',
    text='Appointment at Somewhere on June 3rd 10am-10:25am').execute()

print created_event['id']

PHP

Korzysta z biblioteki klienta PHP.

$createdEvent = $service->events->quickAdd(
    'primary',
    'Appointment at Somewhere on June 3rd 10am-10:25am');

echo $createdEvent->getId();

Ruby

Używa biblioteki klienta Ruby.

result = client.quick_add_event(
  'primary',
  'Appointment at Somewhere on June 3rd 10am-10:25am')
print result.id

Wypróbuj

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