Events: import

Pamiętaj, że iCalUID i id nie są identyczne i podczas tworzenia zdarzenia należy podać tylko jeden z nich. Jednym z różnic w ich semantyce jest to, że w przypadku cyklicznych zdarzeń wszystkie wystąpienia jednego zdarzenia mają różne wartości id, ale wszystkie mają te same wartości iCalUID. Aby pobrać zdarzenie za pomocą jego iCalUID, wywołaj metodę events.list, podając parametr iCalUID. Aby pobrać zdarzenie za pomocą jego id, wywołaj metodę events.get.

Aby dodać załączniki plików z Dysku Google, użyj tego samego formatu co w właściwości alternateLink zasobu Files w interfejsie Drive API.

Wymagane podczas dodawania załącznika.

Wymagane podczas dodawania uczestnika.

• „needsAction” – uczestnik nie odpowiedział na zaproszenie (zalecane w przypadku nowych wydarzeń).
• „declined” – uczestnik odrzucił zaproszenie.
• „tentative” – uczestnik zaakceptował wstępnie zaproszenie.
• „accepted” – uczestnik zaakceptował zaproszenie.

• „icon” – gadżet wyświetla się obok tytułu wydarzenia w widoku kalendarza.
• „chip” – gadżet wyświetla się po kliknięciu zdarzenia.

• „email” – przypomnienia są wysyłane pocztą e-mail.
• „popup” – przypomnienia są wysyłane przez wyskakujące okienko w interfejsie.

Wymagany podczas dodawania przypomnienia.

Wymagany podczas dodawania przypomnienia.

• „confirmed” – zdarzenie jest potwierdzone. Jest to stan domyślny.
• „tentative” – zdarzenie jest wstępnie potwierdzone.
• „cancelled” – zdarzenie zostało anulowane (usunięte). Metoda list zwraca anulowane zdarzenia tylko w przypadku synchronizacji przyrostowej (gdy są określone parametry syncToken lub updatedMin) albo jeśli flaga showDeleted ma wartość true. Metoda get zawsze zwraca te wartości.

  Stan „Anulowano” może oznaczać 2 różne stany w zależności od typu zdarzenia:

  1. Anulowane wyjątki nieanulowanego wydarzenia cyklicznego wskazują, że to wystąpienie nie powinno być już wyświetlane użytkownikowi. Klienci powinni przechowywać te zdarzenia przez cały czas trwania nadrzędnego wydarzenia cyklicznego.

     Wyjątki anulowanych reklam mają wypełnione tylko pola id, recurringEventId i originalStartTime. Pozostałe pola mogą być puste.

  2. Wszystkie inne anulowane wydarzenia to usunięte wydarzenia. Klienci powinni usunąć skopiowane lokalnie pliki. Anulowane wydarzenia ostatecznie znikną, więc nie należy zakładać, że będą dostępne bezterminowo.

     W przypadku usuniętych zdarzeń z pewnością wypełnione jest tylko pole id.

  W kalendarzu organizatora anulowane wydarzenia nadal zawierają szczegóły (podsumowanie, lokalizację itp.), dzięki czemu można je przywrócić (odzyskać). Podobnie informacje o wydarzeniu, na które użytkownik został zaproszony i które usunął ręcznie, nadal są dostępne. Jednak żądania stopniowej synchronizacji z wartością showDeleted równą „false” nie zwracają tych szczegółów.

  Jeśli organizator wydarzenia zmieni się (np. za pomocą operacji przenoszenia), a pierwotny organizator nie znajduje się na liście uczestników, pozostanie anulowane wydarzenie, w którym wypełnione będzie tylko pole id.

• „opaque” – wartość domyślna. Wydarzenie blokuje czas w kalendarzu. Jest to równoznaczne z ustawieniem Pokaż mnie jako na Zajęty w interfejsie Kalendarza.
• „transparent” – wydarzenie nie blokuje czasu w kalendarzu. Jest to równoznaczne z ustawieniem Pokaż mnie jako na Dostępny w interfejsie Kalendarza.

• „default” – używa domyślnej widoczności wydarzeń w kalendarzu. Jest to wartość domyślna.
• „public” – wydarzenie jest publiczne, a szczegóły są widoczne dla wszystkich czytelników kalendarza.
• „private” – wydarzenie jest prywatne i tylko uczestnicy mogą wyświetlać jego szczegóły.
• „confidential” – zdarzenie jest prywatne. Ta wartość jest podawana ze względów związanych ze zgodnością.