Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Düzenli etkinlikler

Bu belgede, düzenli etkinlikler ve bunların örnekleriyle nasıl çalışılacağı açıklanmaktadır.

Düzenli etkinlikler oluşturma

Tekrarlanan etkinlik oluşturmak, event kaynağının recurrence alanı ayarlanmış şekilde normal (tek seferlik) bir etkinlik oluşturmaya benzer.

Protokol

POST /calendar/v3/calendars/primary/events
...

{
  "summary": "Appointment",
  "location": "Somewhere",
  "start": {
    "dateTime": "2011-06-03T10:00:00.000-07:00",
    "timeZone": "America/Los_Angeles"
  },
  "end": {
    "dateTime": "2011-06-03T10:25:00.000-07:00",
    "timeZone": "America/Los_Angeles"
  },
  "recurrence": [
    "RRULE:FREQ=WEEKLY;UNTIL=20110701T170000Z",
  ],
  "attendees": [
    {
      "email": "attendeeEmail",
      # Other attendee's data...
    },
    # ...
  ],
}

Java

Event event = new Event();

event.setSummary("Appointment");
event.setLocation("Somewhere");

ArrayList<EventAttendee> attendees = new ArrayList<EventAttendee>();
attendees.add(new EventAttendee().setEmail("attendeeEmail"));
// ...
event.setAttendees(attendees);

DateTime start = DateTime.parseRfc3339("2011-06-03T10:00:00.000-07:00");
DateTime end = DateTime.parseRfc3339("2011-06-03T10:25:00.000-07:00");
event.setStart(new EventDateTime().setDateTime(start).setTimeZone("America/Los_Angeles"));
event.setEnd(new EventDateTime().setDateTime(end).setTimeZone("America/Los_Angeles"));
event.setRecurrence(Arrays.asList("RRULE:FREQ=WEEKLY;UNTIL=20110701T170000Z"));

Event recurringEvent = service.events().insert("primary", event).execute();

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

.NET

Event event = new Event()
    {
      Summary = "Appointment",
      Location = "Somewhere",
      Start = new EventDateTime() {
          DateTime = new DateTime("2011-06-03T10:00:00.000:-07:00")
          TimeZone = "America/Los_Angeles"
      },
      End = new EventDateTime() {
          DateTime = new DateTime("2011-06-03T10:25:00.000:-07:00")
          TimeZone = "America/Los_Angeles"
      },
      Recurrence = new String[] {
          "RRULE:FREQ=WEEKLY;UNTIL=20110701T170000Z"
      },
      Attendees = new List<EventAttendee>()
          {
            new EventAttendee() { Email: "attendeeEmail" },
            // ...
          }
    };

Event recurringEvent = service.Events.Insert(event, "primary").Fetch();

Console.WriteLine(recurringEvent.Id);

Python

event = {
  'summary': 'Appointment',
  'location': 'Somewhere',
  'start': {
    'dateTime': '2011-06-03T10:00:00.000-07:00',
    'timeZone': 'America/Los_Angeles'
  },
  'end': {
    'dateTime': '2011-06-03T10:25:00.000-07:00',
    'timeZone': 'America/Los_Angeles'
  },
  'recurrence': [
    'RRULE:FREQ=WEEKLY;UNTIL=20110701T170000Z',
  ],
  'attendees': [
    {
      'email': 'attendeeEmail',
      # Other attendee's data...
    },
    # ...
  ],
}

recurring_event = service.events().insert(calendarId='primary', body=event).execute()

print recurring_event['id']

PHP

$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');
$start->setTimeZone('America/Los_Angeles');
$event->setStart($start);
$end = new Google_Service_Calendar_EventDateTime();
$end->setDateTime('2011-06-03T10:25:00.000-07:00');
$end->setTimeZone('America/Los_Angeles');
$event->setEnd($end);
$event->setRecurrence(array('RRULE:FREQ=WEEKLY;UNTIL=20110701T170000Z'));
$attendee1 = new Google_Service_Calendar_EventAttendee();
$attendee1->setEmail('attendeeEmail');
// ...
$attendees = array($attendee1,
                   // ...
                   );
$event->attendees = $attendees;
$recurringEvent = $service->events->insert('primary', $event);

echo $recurringEvent->getId();

Ruby

event = Google::Apis::CalendarV3::Event.new(
  summary: 'Appointment',
  location: 'Somewhere',
  start: {
    date_time: '2011-06-03T10:00:00.000-07:00',
    time_zone:  'America/Los_Angeles'
  },
  end: {
    date_time: '2011-06-03T10:25:00.000-07:00',
    time_zone: 'America/Los_Angeles'
  },
  recurrence: ['RRULE:FREQ=WEEKLY;UNTIL=20110701T170000Z']
  attendees: [
    {
      email: 'attendeeEmail'
    },
    #...
  ]
)
response = client.insert_event('primary', event)
print response.id

Erişim örnekleri

Belirli bir düzenli etkinliğin tüm örneklerini görmek için events.instances() isteğini kullanabilirsiniz.

events.list() isteği varsayılan olarak yalnızca tek seferlik etkinlikleri, düzenli etkinlikleri ve istisnaları döndürür. İstisna olmayan örnekler döndürülmez. singleEvents parametresi true olarak ayarlanırsa sonuçta tüm tekil örnekler gösterilir ancak temel yinelenen etkinlikler gösterilmez. Boş/meşgul izinlerine sahip bir kullanıcı events.list() sorgusu yaptığında, singleEvent true olarak kabul edilir. Erişim denetimi listesi kuralları hakkında daha fazla bilgi için Acl başlıklı makaleyi inceleyin.

Ayrı ayrı örnekler, tek etkinliklere benzer. Örnekler, üst yinelenen etkinliklerin aksine recurrence alanı ayarlanmamış.

Aşağıdaki etkinlik alanları, örnekler için geçerlidir:

recurringEventId: Bu örneğin ait olduğu üst düzenli etkinliğin kimliği
originalStartTime — Bu örneğin, üst düzenli etkinlikteki tekrarlama verilerine göre başladığı saat. Örnek yeniden planlandıysa bu, gerçek start zamanından farklı olabilir. Örnek taşınmış olsa bile, düzenli etkinlik dizisindeki örneği benzersiz şekilde tanımlar.

Örnekleri değiştirme veya silme

Tek bir örneği değiştirmek (istisna oluşturmak) için istemci uygulamalarının önce örneği alması, ardından gövdede güncellenmiş verilerle birlikte örnek düzenleme URL'sine yetkili bir PUT isteği göndererek örneği güncellemesi gerekir. URL şu biçimde olmalıdır:

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

calendarId ve instanceId yerine uygun değerler kullanın.

Not: Kimliği doğrulanmış kullanıcının birincil takvimine başvurmak için özel calendarId değeri primary kullanılabilir.

Başarılı olduğunda sunucu, güncellenen örnekle birlikte bir HTTP 200 OK durum koduyla yanıt verir. Aşağıdaki örnekte, yinelenen bir etkinliğin bir örneğinin nasıl iptal edileceği gösterilmektedir.