반복 일정

이 문서에서는 반복 이벤트 및 그 인스턴스를 사용하는 방법을 설명합니다.

반복 일정 만들기

반복 일정을 만드는 방법은 event 리소스의 recurrence 필드 집합을 사용하여 일반 (단일) 일정을 만드는 것과 비슷합니다.

프로토콜

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']

2,399필리핀

$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

인스턴스 액세스

특정 반복 이벤트의 모든 인스턴스를 보려면 events.instances() 요청을 사용하세요.

기본적으로 events.list() 요청은 단일 이벤트, 반복 이벤트, 예외만 반환합니다. 예외가 아닌 인스턴스는 반환되지 않습니다. singleEvents 매개변수가 true로 설정된 경우 모든 개별 인스턴스가 결과에 표시되지만 기본 반복 이벤트는 표시되지 않습니다. 한가함/바쁨 권한이 있는 사용자가 events.list()을 쿼리하면 singleEvent가 true인 것처럼 동작합니다. 액세스제어 목록(ACL) 규칙에 대한 자세한 내용은 Acl을 참조하세요.

경고: 전체 반복 일정 또는 '이 항목 및 다음 항목' 인스턴스를 수정하려는 경우 인스턴스를 개별적으로 수정하지 마세요. 이로 인해 캘린더를 복잡하게 하는 예외가 많이 발생하여 액세스 속도가 느려지고 사용자에게 다량의 변경 알림이 전송됩니다.

개별 인스턴스는 단일 이벤트와 유사합니다. 상위 반복 이벤트와 달리 인스턴스에는 recurrence 필드가 설정되어 있지 않습니다.

다음 이벤트 필드는 인스턴스별로 지정됩니다.

• recurringEventId: 이 인스턴스가 속한 상위 반복 이벤트의 ID
• originalStartTime: 이 인스턴스가 상위 반복 이벤트의 반복 데이터에 따라 시작되는 시간입니다. 이 시간은 인스턴스 일정이 변경된 경우 실제 start 시간과 다를 수 있습니다. 인스턴스가 이동된 경우에도 반복 일정 시리즈 내에서 인스턴스를 고유하게 식별합니다.

인스턴스 수정 또는 삭제

단일 인스턴스를 수정 (예외 생성)하려면 클라이언트 애플리케이션이 먼저 인스턴스를 검색한 다음, 승인된 PUT 요청을 본문에 업데이트된 데이터가 포함된 인스턴스 수정 URL로 전송하여 인스턴스를 업데이트해야 합니다. URL 형식은 다음과 같습니다.

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

calendarId 및 instanceId 대신 적절한 값을 사용합니다.

참고: 특수 calendarId 값 primary을 사용하여 인증된 사용자의 기본 캘린더를 참조할 수 있습니다.

성공하면 서버는 업데이트된 인스턴스와 함께 HTTP 200 OK 상태 코드로 응답합니다. 다음 예는 반복 일정의 인스턴스를 취소하는 방법을 보여줍니다.

프로토콜

PUT /calendar/v3/calendars/primary/events/instanceId
...

{
  "kind": "calendar#event",
  "id": "instanceId",
  "etag": "instanceEtag",
  "status": "cancelled",
  "htmlLink": "https://www.google.com/calendar/event?eid=instanceEid",
  "created": "2011-05-23T22:27:01.000Z",
  "updated": "2011-05-23T22:27:01.000Z",
  "summary": "Recurring event",
  "location": "Somewhere",
  "creator": {
    "email": "userEmail"
  },
  "recurringEventId": "recurringEventId",
  "originalStartTime": "2011-06-03T10:00:00.000-07:00",
  "organizer": {
    "email": "userEmail",
    "displayName": "userDisplayName"
  },
  "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"
  },
  "iCalUID": "eventUID",
  "sequence": 0,
  "attendees": [
    {
      "email": "attendeeEmail",
      "displayName": "attendeeDisplayName",
      "responseStatus": "needsAction"
    },
    # ...
    {
      "email": "userEmail",
      "displayName": "userDisplayName",
      "responseStatus": "accepted",
      "organizer": true,
      "self": true
    }
  ],
  "guestsCanInviteOthers": false,
  "guestsCanSeeOtherGuests": false,
  "reminders": {
    "useDefault": true
  }
}

Java

// First retrieve the instances from the API.
Events instances = service.events().instances("primary", "recurringEventId").execute();

// Select the instance to cancel.
Event instance = instances.getItems().get(0);
instance.setStatus("cancelled");

Event updatedInstance = service.events().update("primary", instance.getId(), instance).execute();

// Print the updated date.
System.out.println(updatedInstance.getUpdated());

.NET

// First retrieve the instances from the API.
Events instances = service.Events.Instances("primary", "recurringEventId").Fetch();

// Select the instance to cancel.
Event instance = instances.Items[0];
instance.Status = "cancelled";

Event updatedInstance = service.Events.Update(instance, "primary", instance.Id).Fetch();

// Print the updated date.
Console.WriteLine(updatedInstance.Updated);

Python

# First retrieve the instances from the API.
instances = service.events().instances(calendarId='primary', eventId='recurringEventId').execute()

# Select the instance to cancel.
instance = instances['items'][0]
instance['status'] = 'cancelled'

updated_instance = service.events().update(calendarId='primary', eventId=instance['id'], body=instance).execute()

# Print the updated date.
print updated_instance['updated']

2,399필리핀

$events = $service->events->instances("primary", "eventId");

// Select the instance to cancel.
$instance = $events->getItems()[0];
$instance->setStatus('cancelled');

$updatedInstance = $service->events->update('primary', $instance->getId(), $instance);

// Print the updated date.
echo $updatedInstance->getUpdated();

Ruby

# First retrieve the instances from the API.
instances = client.list_event_instances('primary', 'recurringEventId')

# Select the instance to cancel.
instance = instances.items[0]
instance.status = 'cancelled'

response = client.update_event('primary', instance.id, instance)
print response.updated

다음 인스턴스 모두 수정

특정 (대상) 인스턴스 이후 또는 그 이후의 반복 이벤트의 모든 인스턴스를 변경하려면 별도의 API 요청을 두 번 해야 합니다. 이러한 요청은 원래의 반복 이벤트를 두 개로 분할합니다. 하나는 변경 없이 인스턴스를 유지하는 원래 이벤트이고, 다른 하나는 변경사항이 적용된 인스턴스가 있는 새로운 반복 이벤트입니다.

1. events.update()를 호출하여 업데이트할 인스턴스의 원래 반복 이벤트를 잘라냅니다. RRULE의 UNTIL 구성요소를 첫 번째 대상 인스턴스의 시작 시간 이전으로 설정하면 됩니다. 또는 UNTIL 대신 COUNT 구성요소를 설정할 수 있습니다.
2. events.insert()를 호출하여 변경하려는 사항을 제외하고 원본과 동일한 데이터로 새 반복 이벤트를 만듭니다. 새 반복 이벤트에는 대상 인스턴스의 시작 시간이 있어야 합니다.

이 예에서는 이전 예의 반복 일정의 세 번째 인스턴스부터 위치를 '다른 위치'로 변경하는 방법을 보여줍니다.

프로토콜

# Updating the original recurring event to trim the instance list:

PUT /calendar/v3/calendars/primary/events/recurringEventId
...

{
  "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=20110617T065959Z",
  ],
  "attendees": [
    {
      "email": "attendeeEmail",
      # Other attendee's data...
    },
    # ...
  ],
}


# Creating a new recurring event with the change applied:

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

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

참고: 다음의 모든 인스턴스를 변경하면 대상 인스턴스 이후에 발생하는 모든 예외가 재설정됩니다.