Events: quickAdd
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Basit bir metin dizesine dayalı bir etkinlik oluşturur.
Şimdi deneyin.
İstek
HTTP isteği
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/quickAdd
Parametreler
| Parametre adı |
Değer |
Açıklama |
| Yol parametreleri |
calendarId |
string |
Takvim tanımlayıcısı. Takvim kimliklerini almak için calendarList.list yöntemini çağırın. Şu anda oturum açmış kullanıcının birincil takvimine erişmek istiyorsanız "primary" anahtar kelimesini kullanın.
|
| Gerekli sorgu parametreleri |
text |
string |
Oluşturulacak etkinliği açıklayan metin.
|
| İsteğe bağlı sorgu parametreleri |
sendNotifications |
boolean |
Kullanımdan kaldırıldı. Bunun yerine lütfen sendUpdates işlevini kullanın.
Etkinliğin oluşturulmasıyla ilgili bildirim gönderilip gönderilmeyeceği. Değeri false olarak ayarlasanız bile bazı e-postaların yine de gönderilebileceğini unutmayın. Varsayılan değer false'tir.
|
sendUpdates |
string |
Yeni etkinliğin oluşturulmasıyla ilgili bildirim alması gereken konuklar.
Kabul edilen değerler şunlardır:
- "
all": Bildirimler tüm davetlilere gönderilir.
- "
externalOnly": Bildirimler yalnızca Google Takvim kullanmayan davetlilere gönderilir.
- "
none": Bildirim gönderilmez. Takvim taşıma görevleri için bunun yerine Events.import yöntemini kullanabilirsiniz.
|
Yetkilendirme
Bu istek için aşağıdaki kapsamlardan en az biri ile yetkilendirme gerekir:
| Kapsam |
|---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.events |
https://www.googleapis.com/auth/calendar.app.created |
https://www.googleapis.com/auth/calendar.events.owned |
Daha fazla bilgi için kimlik doğrulama ve yetkilendirme sayfasına bakın.
İstek içeriği
Bu yöntemle istek gövdesi göndermeyin.
Yanıt
Başarılı olursa bu yöntem, yanıt gövdesinde bir Events kaynağı döndürür.
Deneyin!
Canlı verilerde bu yöntemi çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-25 UTC."],[],[],null,["# Events: quickAdd\n\n| **Note:** Requires [authorization](#auth).\n\nCreates an event based on a simple text string.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/quickAdd\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|---------------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `calendarId` | `string` | Calendar identifier. To retrieve calendar IDs call the [calendarList.list](/workspace/calendar/api/v3/reference/calendarList/list) method. If you want to access the primary calendar of the currently logged in user, use the \"`primary`\" keyword. |\n| **Required query parameters** |||\n| `text` | `string` | The text describing the event to be created. |\n| **Optional query parameters** |||\n| `sendNotifications` | `boolean` | Deprecated. Please use [sendUpdates](/workspace/calendar/api/v3/reference/events/quickAdd#sendUpdates) instead. Whether to send notifications about the creation of the event. Note that some emails might still be sent even if you set the value to `false`. The default is `false`. |\n| `sendUpdates` | `string` | Guests who should receive notifications about the creation of the new event. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`all`\": Notifications are sent to all guests. - \"`externalOnly`\": Notifications are sent to non-Google Calendar guests only. - \"`none`\": No notifications are sent. For calendar migration tasks, consider using the [Events.import](/workspace/calendar/api/v3/reference/events/import) method instead. |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes:\n\n| Scope |\n|---------------------------------------------------------|\n| `https://www.googleapis.com/auth/calendar` |\n| `https://www.googleapis.com/auth/calendar.events` |\n| `https://www.googleapis.com/auth/calendar.app.created` |\n| `https://www.googleapis.com/auth/calendar.events.owned` |\n\nFor more information, see the [authentication and authorization](/workspace/guides/configure-oauth-consent) page.\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns an [Events resource](/workspace/calendar/api/v3/reference/events#resource) in the response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]
