Bir etkinliği içe aktarır. Bu işlem, mevcut bir etkinliğin gizli kopyasını bir takvime eklemek için kullanılır. Yalnızca eventType
/default
olan etkinlikler içe aktarılabilir.
Kullanımdan kaldırılan davranış: default
olmayan bir etkinlik içe aktarılırsa türü default
olarak değiştirilir ve sahip olabileceği etkinlik türüne özgü tüm özellikler çıkarılır.
İstek
HTTP isteği
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/import
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 kullanın. Şu anda giriş yapmış olan kullanıcının birincil takvimine erişmek istiyorsanız "primary " anahtar kelimesini kullanın.
|
İsteğe bağlı sorgu parametreleri | ||
conferenceDataVersion |
integer |
API istemcisi tarafından desteklenen konferans verilerinin sürüm numarası. Sürüm 0, konferans veri desteğinin olmadığını varsayar ve etkinliğin gövdesindeki konferans verilerini yoksayar. Sürüm 1, ConferenceData'yı kopyalamayı ve ConferenceData'nın createRequest alanını kullanarak yeni konferanslar oluşturmayı destekler. Varsayılan değer 0'dır.
Kabul edilebilir değerler 0 ile 1 arasındadır (bu değerler dahil).
|
supportsAttachments |
boolean |
İşlem gerçekleştiren API istemcisinin etkinlik eklerini destekleyip desteklemediği. İsteğe bağlı. Varsayılan, Yanlış'tır. |
Yetkilendirme
Bu istek için aşağıdaki kapsamlardan en az biriyle yetkilendirme gerekiyor:
Kapsam |
---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.events |
Daha fazla bilgi için kimlik doğrulama ve yetkilendirme sayfasına bakın.
İstek içeriği
İstek gövdesinde, aşağıdaki özelliklere sahip bir Etkinlikler kaynağı sağlayın:
Mülk adı | Değer | Açıklama | Notlar |
---|---|---|---|
Zorunlu Özellikler | |||
end |
nested object |
Etkinliğin (hariç) bitiş zamanı. Düzenli bir etkinlik için bu, ilk örneğin bitiş zamanıdır. | |
iCalUID |
string |
RFC5545'te tanımlandığı şekliyle etkinlik benzersiz tanımlayıcısı. Bu kimlik, takvim sistemleri genelinde etkinlikleri benzersiz şekilde tanımlamak için kullanılır ve etkinlikler import yöntemiyle içe aktarılırken sağlanmalıdır.
|
|
start |
nested object |
Etkinliğin (dahil) başlangıç zamanı. Düzenli bir etkinlik için bu, ilk örneğin başlangıç zamanıdır. | |
İsteğe Bağlı Özellikler | |||
anyoneCanAddSelf |
boolean |
Herkesin kendisini etkinliğe davet edip edemeyeceği (kullanımdan kaldırıldı). İsteğe bağlı. Varsayılan, Yanlış'tır. | yazılabilir |
attachments[].fileUrl |
string |
Ekin URL bağlantısı. Google Drive dosya ekleri eklemek için Drive API'deki Ek iliştirirken gereklidir. |
yazılabilir |
attendees[] |
list |
Etkinliğin katılımcıları. Diğer takvim kullanıcılarıyla etkinlik planlama hakkında daha fazla bilgi edinmek için Katılımcıları olan etkinlikler rehberine göz atın. Hizmet hesaplarının katılımcı listesini doldurmak için alan genelinde yetki verme özelliğini kullanması gerekir. | yazılabilir |
attendees[].additionalGuests |
integer |
Ek konuk sayısı. İsteğe bağlı. Varsayılan değer 0'dır. | yazılabilir |
attendees[].comment |
string |
Katılımcının yanıtı yorumu. İsteğe bağlı. | yazılabilir |
attendees[].displayName |
string |
Varsa katılımcının adı. İsteğe bağlı. | yazılabilir |
attendees[].email |
string |
Varsa katılımcının e-posta adresi. Katılımcı eklerken bu alan mevcut olmalıdır. RFC5322 uyarınca geçerli bir e-posta adresi olmalıdır. Katılımcı eklerken gereklidir. |
yazılabilir |
attendees[].optional |
boolean |
Bu katılımcının isteğe bağlı olup olmadığı. İsteğe bağlı. Varsayılan, Yanlış'tır. | yazılabilir |
attendees[].resource |
boolean |
Katılımcının bir kaynak olup olmadığı. Yalnızca katılımcı etkinliğe ilk kez eklendiğinde ayarlanabilir. Daha sonraki değişiklikler yoksayılır. İsteğe bağlı. Varsayılan, Yanlış'tır. | yazılabilir |
attendees[].responseStatus |
string |
Katılımcının yanıt durumu. Olası değerler:
|
yazılabilir |
attendeesOmitted |
boolean |
Katılımcıların etkinlik temsilinden çıkarılıp çıkarılmayacağı. Bir etkinlik alınırken bunun nedeni, maxAttendee sorgu parametresi tarafından belirtilen bir kısıtlama olabilir. Bir etkinliği güncellerken, bu seçenek yalnızca katılımcının yanıtını güncellemek için kullanılabilir. İsteğe bağlı. Varsayılan, Yanlış'tır. |
yazılabilir |
colorId |
string |
Etkinliğin rengi. Bu kimlik, renk tanımının event bölümündeki bir girişi ifade eden bir kimliktir ( renk uç noktasına bakın). İsteğe bağlı. |
yazılabilir |
conferenceData |
nested object |
Konferansla ilgili bilgiler (ör. bir Google Meet konferansının ayrıntıları) Yeni konferans ayrıntılarını oluşturmak için createRequest alanını kullanın. Değişikliklerinizi kaybetmemek için tüm etkinlik değişiklik isteklerinde conferenceDataVersion istek parametresini 1 olarak ayarlamayı unutmayın. |
yazılabilir |
description |
string |
Etkinliğin açıklaması. HTML içerebilir. İsteğe bağlı. | yazılabilir |
end.date |
date |
Bu tüm gün süren bir etkinlikse, "yyyy-aa-gg" biçiminde tarih. | yazılabilir |
end.dateTime |
datetime |
Birleşik bir tarih-saat değeri (RFC3339'a göre biçimlendirilmiş) olarak saat. timeZone ürününde saat dilimi açıkça belirtilmediği sürece saat dilimi farkı gereklidir. |
yazılabilir |
end.timeZone |
string |
Saatin belirtildiği saat dilimi. (IANA Saat Dilimi Veritabanı adı olarak biçimlendirilir, ör. "Avrupa/Zürih".) Düzenli etkinlikler için bu alan zorunludur ve yinelemenin genişletildiği saat dilimini belirtir. Tek etkinlikler için bu alan isteğe bağlıdır ve etkinlik başlangıcı/sonu için özel bir saat dilimini belirtir. | yazılabilir |
extendedProperties.private |
object |
Bu takvimde görünen etkinliğin kopyasına özel özellikler. | yazılabilir |
extendedProperties.shared |
object |
Etkinliğin diğer katılımcıların takvimlerindeki kopyaları arasında paylaşılan özellikler. | yazılabilir |
focusTimeProperties |
nested object |
Odaklanma Zamanı etkinlik verileri. eventType değeri focusTime ise kullanılır. |
yazılabilir |
gadget.display |
string |
Gadget'ın görüntü modu. Kullanımdan kaldırıldı. Olası değerler:
|
yazılabilir |
gadget.height |
integer |
Gadget'ın piksel cinsinden yüksekliği. Yükseklik 0'dan büyük bir tam sayı olmalıdır. İsteğe bağlı. Kullanımdan kaldırıldı. | yazılabilir |
gadget.iconLink |
string |
Gadget'ın simge URL'si. URL şeması HTTPS olmalıdır. Kullanımdan kaldırıldı. | yazılabilir |
gadget.link |
string |
Gadget'ın URL'si. URL şeması HTTPS olmalıdır. Kullanımdan kaldırıldı. | yazılabilir |
gadget.preferences |
object |
Tercihler'e dokunun. | yazılabilir |
gadget.title |
string |
Gadget'ın başlığı. Kullanımdan kaldırıldı. | yazılabilir |
gadget.type |
string |
Gadget'ın türü. Kullanımdan kaldırıldı. | yazılabilir |
gadget.width |
integer |
Gadget'ın piksel cinsinden genişliği. Genişlik 0'dan büyük bir tam sayı olmalıdır. İsteğe bağlı. Kullanımdan kaldırıldı. | yazılabilir |
guestsCanInviteOthers |
boolean |
Etkinliği düzenleyen kullanıcı dışındaki katılımcıların etkinliğe başkalarını davet edip edemeyeceği. İsteğe bağlı. Varsayılan, Doğru değeridir. | yazılabilir |
guestsCanModify |
boolean |
Düzenleyen kişi dışındaki katılımcıların etkinliği değiştirip değiştiremeyeceğini belirler. İsteğe bağlı. Varsayılan, Yanlış'tır. | yazılabilir |
guestsCanSeeOtherGuests |
boolean |
Etkinliği düzenleyen kişi dışındaki katılımcıların, etkinlik katılımcılarının kimler olduğunu görüp göremeyeceği. İsteğe bağlı. Varsayılan, Doğru değeridir. | yazılabilir |
location |
string |
Serbest biçimli metin olarak etkinliğin coğrafi konumu. İsteğe bağlı. | yazılabilir |
organizer |
object |
Etkinliği düzenleyen kullanıcı. Düzenleyen aynı zamanda bir katılımcıysa bu, attendees içinde organizer alanı True olarak ayarlanmış ayrı bir girişle belirtilir. Düzenleyeni değiştirmek için taşı işlemini kullanın. Salt okunur (bir etkinliğin içe aktarıldığı durumlar hariç). |
yazılabilir |
organizer.displayName |
string |
Varsa düzenleyenin adı. | yazılabilir |
organizer.email |
string |
Varsa düzenleyen kişinin e-posta adresi. RFC5322 uyarınca geçerli bir e-posta adresi olmalıdır. | yazılabilir |
originalStartTime.date |
date |
Bu tüm gün süren bir etkinlikse, "yyyy-aa-gg" biçiminde tarih. | yazılabilir |
originalStartTime.dateTime |
datetime |
Birleşik bir tarih-saat değeri (RFC3339'a göre biçimlendirilmiş) olarak saat. timeZone ürününde saat dilimi açıkça belirtilmediği sürece saat dilimi farkı gereklidir. |
yazılabilir |
originalStartTime.timeZone |
string |
Saatin belirtildiği saat dilimi. (IANA Saat Dilimi Veritabanı adı olarak biçimlendirilir, ör. "Avrupa/Zürih".) Düzenli etkinlikler için bu alan zorunludur ve yinelemenin genişletildiği saat dilimini belirtir. Tek etkinlikler için bu alan isteğe bağlıdır ve etkinlik başlangıcı/sonu için özel bir saat dilimini belirtir. | yazılabilir |
outOfOfficeProperties |
nested object |
Ofis dışında etkinlik verileri. eventType değeri outOfOffice ise kullanılır. |
yazılabilir |
recurrence[] |
list |
RFC5545'te belirtildiği şekilde, düzenli bir etkinliğe ait RRULE, EXRULE, RDATE ve EXDATE satırlarının listesi. Bu alanda DTSTART ve DTEND satırlarına izin verilmediğini unutmayın. Etkinlik başlangıç ve bitiş zamanları start ve end alanlarında belirtilir. Bu alan, tek etkinlikler veya yinelenen etkinlik örnekleri için atlanır. |
yazılabilir |
reminders.overrides[] |
list |
Etkinlikte varsayılan hatırlatıcılar kullanılmıyorsa bu, etkinliğe özel hatırlatıcıları listeler. Ayarlanmamışsa bu etkinlik için hatırlatıcı ayarlanmadığını gösterir. Maksimum geçersiz kılma hatırlatıcısı sayısı 5'tir. | yazılabilir |
reminders.overrides[].method |
string |
Bu hatırlatıcının kullandığı yöntem. Olası değerler:
Hatırlatıcı eklerken gerekir. |
yazılabilir |
reminders.overrides[].minutes |
integer |
Hatırlatıcının, etkinliğin başlamasından kaç dakika önce tetikleneceği. Geçerli değerler 0 ile 40320 arasındadır (dakika cinsinden 4 hafta). Hatırlatıcı eklerken gerekir. |
yazılabilir |
reminders.useDefault |
boolean |
Takvimdeki varsayılan hatırlatıcıların etkinliğe uygulanıp uygulanmayacağı. | yazılabilir |
sequence |
integer |
iTakvim'e göre sıra numarası. | yazılabilir |
source.title |
string |
Kaynağın başlığı. Örneğin, bir web sayfasının başlığı veya e-posta konusu. | yazılabilir |
source.url |
string |
Bir kaynağa işaret eden kaynağın URL'si. URL şeması HTTP veya HTTPS olmalıdır. | yazılabilir |
start.date |
date |
Bu tüm gün süren bir etkinlikse, "yyyy-aa-gg" biçiminde tarih. | yazılabilir |
start.dateTime |
datetime |
Birleşik bir tarih-saat değeri (RFC3339'a göre biçimlendirilmiş) olarak saat. timeZone ürününde saat dilimi açıkça belirtilmediği sürece saat dilimi farkı gereklidir. |
yazılabilir |
start.timeZone |
string |
Saatin belirtildiği saat dilimi. (IANA Saat Dilimi Veritabanı adı olarak biçimlendirilir, ör. "Avrupa/Zürih".) Düzenli etkinlikler için bu alan zorunludur ve yinelemenin genişletildiği saat dilimini belirtir. Tek etkinlikler için bu alan isteğe bağlıdır ve etkinlik başlangıcı/sonu için özel bir saat dilimini belirtir. | yazılabilir |
status |
string |
Etkinliğin durumu. İsteğe bağlı. Olası değerler:
|
yazılabilir |
summary |
string |
Etkinliğin adı. | yazılabilir |
transparency |
string |
Etkinliğin takvimde zamanı engelleyip engellemediği. İsteğe bağlı. Olası değerler:
|
yazılabilir |
visibility |
string |
Etkinliğin görünürlüğü. İsteğe bağlı. Olası değerler:
|
yazılabilir |
Yanıt
Başarılı olursa bu yöntem, yanıt gövdesinde bir Etkinlikler kaynağı döndürür.
Örnekler
Not: Bu yöntem için kullanıma sunulan kod örnekleri, desteklenen tüm programlama dillerini kapsamaz (Desteklenen dillerin listesi için istemci kitaplıkları sayfasını inceleyin).
Java
Java istemci kitaplığı'nı kullanmalıdır.
import com.google.api.services.calendar.Calendar; import com.google.api.services.calendar.model.Event; import com.google.api.services.calendar.model.EventAttendee; import com.google.api.services.calendar.model.EventDateTime; import com.google.api.client.util.DateTime; import java.util.Date; // ... // Initialize Calendar service with valid OAuth credentials Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials) .setApplicationName("applicationName").build(); // Create and initialize a new event (could also retrieve an existing event) Event event = new Event(); event.setICalUID("originalUID"); Event.Organizer organizer = new Event.Organizer(); organizer.setEmail("organizerEmail"); organizer.setDisplayName("organizerDisplayName"); event.setOrganizer(organizer); ArrayList<EventAttendee> attendees = new ArrayList<EventAttendee>(); attendees.add(new EventAttendee().setEmail("attendeeEmail")); // ... event.setAttendees(attendees); Date startDate = new Date(); Date endDate = new Date(startDate.getTime() + 3600000); DateTime start = new DateTime(startDate, TimeZone.getTimeZone("UTC")); event.setStart(new EventDateTime().setDateTime(start)); DateTime end = new DateTime(endDate, TimeZone.getTimeZone("UTC")); event.setEnd(new EventDateTime().setDateTime(end)); // Import the event into a calendar Event importedEvent = service.events().calendarImport('primary', event).execute(); System.out.println(importedEvent.getId());
Python
Python istemci kitaplığını kullanır.
event = { 'summary': 'Appointment', 'location': 'Somewhere', 'organizer': { 'email': 'organizerEmail', 'displayName': 'organizerDisplayName' }, 'start': { 'dateTime': '2011-06-03T10:00:00.000-07:00' }, 'end': { 'dateTime': '2011-06-03T10:25:00.000-07:00' }, 'attendees': [ { 'email': 'attendeeEmail', 'displayName': 'attendeeDisplayName', }, # ... ], 'iCalUID': 'originalUID' } imported_event = service.events().import_(calendarId='primary', body=event).execute() print imported_event['id']
PHP
PHP istemci kitaplığını kullanır.
$event = new Google_Service_Calendar_Event(); $event->setSummary('Appointment'); $event->setLocation('Somewhere'); $start = new Google_Service_Calendar_EventDateTime(); $start->setDateTime('2011-06-03T10:00:00.000-07:00'); $event->setStart($start); $end = new Google_Service_Calendar_EventDateTime(); $end->setDateTime('2011-06-03T10:25:00.000-07:00'); $event->setEnd($end); $attendee1 = new Google_Service_Calendar_EventAttendee(); $attendee1->setEmail('attendeeEmail'); // ... $attendees = array($attendee1, // ..., ); $event->attendees = $attendees; $organizer = new Google_Service_Calendar_EventOrganizer(); $organizer->setEmail('organizerEmail'); $organizer->setDisplayName('organizerDisplayName'); $event->setOrganizer($organizer); $event->setICalUID('originalUID'); $importedEvent = $service->events->import('primary', $event); echo $importedEvent->getId();
Ruby
Ruby istemci kitaplığı'nı kullanır.
event = Google::Apis::CalendarV3::Event.new( summary: 'Appointment', location: 'Somewhere', organizer: { email: 'organizerEmail', display_name: 'organizerDisplayName' }, start: { date_time: '2011-06-03T10:00:00.000-07:00' }, end: { date_time: '2011-06-03T10:25:00.000-07:00' }, attendees: [ { email: 'attendeeEmail', display_name: 'attendeeDisplayName', }, # ... ], i_cal_uid: 'originalUID' ) result = client.import_event('primary', event) print result.id
Deneyin.
Canlı verilerde bu yöntemi çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.