Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Wydarzenia cykliczne

W tym dokumencie opisujemy, jak pracować z wydarzeniami cyklicznymi i ich wystąpieniami.

Tworzenie wydarzenia cyklicznego

Tworzenie wydarzeń cyklicznych jest podobne do tworzenia zwykłego (pojedynczego) wydarzenia z ustawionym polem recurrence zasobu Event.

Protokół

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

Dostęp do instancji

Aby wyświetlić wszystkie wystąpienia danego wydarzenia cyklicznego, użyj metody events.instances.

Domyślnie metoda events.list zwraca pojedyncze wydarzenia, wydarzenia cykliczne i wyjątki. Wystąpienia, które nie są wyjątkami, nie są zwracane. Jeśli singleEvents parametr jest ustawiony na true, w wyniku pojawią się wszystkie pojedyncze wystąpienia, ale nie podstawowe wydarzenia cykliczne. Gdy użytkownik, który ma uprawnienia do sprawdzania dostępności, wysyła zapytanie events.list, zachowuje się ono tak, jakby singleEvents miało wartość true. Więcej informacji o regułach listy kontroli dostępu znajdziesz w artykule ACL.

Pojedyncze wystąpienia są podobne do pojedynczych wydarzeń. W przeciwieństwie do nadrzędnych wydarzeń cyklicznych, wystąpienia nie mają ustawionego pola recurrence.

Te pola wydarzeń są specyficzne dla wystąpień:

recurringEventId – identyfikator nadrzędnego wydarzenia cyklicznego, do którego należy to wystąpienie.
originalStartTime – czas rozpoczęcia tego wystąpienia zgodnie z danymi cyklicznymi w nadrzędnym wydarzeniu cyklicznym. Może się różnić od rzeczywistego start czasu, jeśli wystąpienie zostało przełożone. Unikalnie identyfikuje wystąpienie w serii wydarzeń cyklicznych, nawet jeśli zostało ono przeniesione.

Modyfikowanie lub usuwanie wystąpień

Aby zmodyfikować pojedyncze wystąpienie (utworzyć wyjątek), aplikacje klienckie muszą najpierw pobrać wystąpienie, a następnie zaktualizować je, wysyłając autoryzowane żądanie PUT na adres URL edycji wystąpienia z zaktualizowanymi danymi w treści. Adres URL ma postać:

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

Zamiast calendarId i instanceId użyj odpowiednich wartości.

Uwaga: specjalna wartość calendarId primary może służyć do odwoływania się do głównego kalendarza uwierzytelnionego użytkownika.

W przypadku powodzenia serwer odpowiada kodem stanu HTTP 200 OK ze zaktualizowanym wystąpieniem. Poniższy przykład pokazuje, jak anulować wystąpienie wydarzenia cyklicznego.

Protokół

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

PHP

$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

Modyfikowanie wszystkich kolejnych wystąpień

Aby zmienić wszystkie wystąpienia wydarzenia cyklicznego w danym wystąpieniu (docelowym) lub po nim, wyślij 2 oddzielne żądania do interfejsu API. Te żądania dzielą pierwotne wydarzenie cykliczne na 2 części: pierwotne, które zachowuje wystąpienia bez zmian, oraz nowe wydarzenie cykliczne z wystąpieniami, w których zastosowano zmianę:

Wywołaj events.update aby przyciąć pierwotne wydarzenie cykliczne z wystąpień, które mają zostać zaktualizowane. Aby to zrobić, ustaw komponent UNTIL w RRULE tak, aby wskazywał czas przed czasem rozpoczęcia pierwszej instancji docelowej. Możesz też ustawić komponent COUNT zamiast UNTIL.
Wywołaj events.insert aby utworzyć nowe wydarzenie cykliczne ze wszystkimi tymi samymi danymi co pierwotne, z wyjątkiem wprowadzanej zmiany. Nowe wydarzenie cykliczne musi mieć czas rozpoczęcia instancji docelowej.

Ten przykład pokazuje, jak zmienić lokalizację na „Gdzieś indziej”, zaczynając od trzeciego wystąpienia wydarzenia cyklicznego z poprzednich przykładów.

Protokół

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

Wydarzenia cykliczne Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Tworzenie wydarzenia cyklicznego

Protokół

Java

.NET

Python

PHP

Ruby

Dostęp do instancji

Modyfikowanie lub usuwanie wystąpień

Protokół

Java

.NET

Python

PHP

Ruby

Modyfikowanie wszystkich kolejnych wystąpień

Protokół

Wydarzenia cykliczne