Events: insert

• „all”: powiadomienia są wysyłane do wszystkich gości.
• „externalOnly”: powiadomienia są wysyłane tylko do gości, którzy nie korzystają z Kalendarza Google.
• „none”: nie są wysyłane żadne powiadomienia.

Do dodawania załączników z Dysku Google używaj tego samego formatu co we 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 wstępnie zaakceptował zaproszenie.
• „accepted” – uczestnik zaakceptował zaproszenie.

• "anniversary" – rocznica inna niż urodziny. Zawsze ma contact.
• "birthday" – wydarzenie związane z urodzinami. Jest to wartość domyślna.
• "custom" – specjalna data, której etykieta jest określona w polu customTypeName. Zawsze ma contact.
• "other" – specjalna data, która nie należy do żadnej z innych kategorii i nie ma niestandardowej etykiety. Zawsze ma contact.
• "self" – urodziny właściciela kalendarza. Nie może zawierać znaku contact.

Ta właściwość zastępuje właściwość colorId opartą na indeksie. Aby ustawić lub zmienić tę właściwość, musisz określić eventLabelVersion=1 w parametrach metod insert, import, update i patch.

Ustawienie pustego ciągu znaków lub nieustawienie tego pola spowoduje usunięcie z wydarzenia dotychczasowej etykiety.

• „birthday” – specjalne wydarzenie całodniowe, które odbywa się co roku.
• „default” – zwykłe wydarzenie lub wydarzenie nieokreślone.
• „focusTime” – wydarzenie w czasie skupienia.
• „fromGmail” – wydarzenie z Gmaila. Nie można utworzyć tego typu wydarzenia.
• „outOfOffice” – wydarzenie poza biurem.
• „workingLocation” – zdarzenie związane z lokalizacją miejsca pracy.

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

• Dozwolone znaki w identyfikatorze to znaki używane w kodowaniu base32hex, czyli małe litery a–v i cyfry 0–9.Więcej informacji znajdziesz w sekcji 3. 1.2 w RFC2938.
• długość identyfikatora musi wynosić od 5 do 1024 znaków;
• Identyfikator musi być unikalny w przypadku każdego kalendarza.

Jeśli nie podasz identyfikatora, zostanie on automatycznie wygenerowany przez serwer.

Pamiętaj, że tagi icalUID i id nie są identyczne i podczas tworzenia zdarzenia należy podać tylko jeden z nich. Jedną z różnic w ich semantyce jest to, że w przypadku wydarzeń cyklicznych wszystkie wystąpienia jednego wydarzenia mają różne wartości id, ale wszystkie mają te same wartości icalUID.

• „email” – przypomnienia są wysyłane e-mailem.
• „popup” – przypomnienia są wysyłane w wyskakującym okienku interfejsu.

Wymagane podczas dodawania przypomnienia.

Wymagane podczas dodawania przypomnienia.

• „confirmed” – wydarzenie jest potwierdzone. Jest to stan domyślny.
• „tentative” – wydarzenie jest wstępnie potwierdzone.
• „cancelled” – wydarzenie zostało anulowane (usunięte). Metoda list zwraca anulowane wydarzenia tylko podczas synchronizacji przyrostowej (gdy określono syncToken lub updatedMin) lub jeśli flaga showDeleted ma wartość true. Metoda get zawsze je zwraca.

  Stan „Anulowano” 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ż prezentowane użytkownikowi. Klienci powinni przechowywać te zdarzenia przez cały okres istnienia nadrzędnego wydarzenia cyklicznego.

     W przypadku anulowanych wyjątków gwarantujemy tylko wypełnienie pól id, recurringEventId i originalStartTime. Pozostałe pola mogą być puste.

  2. Wszystkie inne odwołane wydarzenia to usunięte wydarzenia. Klienci powinni usunąć lokalnie zsynchronizowane kopie. Takie odwołane wydarzenia znikną z czasem, więc nie zakładaj, że będą dostępne bezterminowo.

     W przypadku usuniętych zdarzeń gwarantujemy tylko wypełnienie pola id.

  W kalendarzu organizatora anulowane wydarzenia nadal zawierają szczegóły (podsumowanie, lokalizacja itp.), dzięki czemu można je przywrócić (cofnąć usunięcie). Podobnie wydarzenia, na które użytkownik został zaproszony i które ręcznie usunął, nadal dostarczają szczegółowych informacji. Żądania synchronizacji przyrostowej z parametrem showDeleted ustawionym na wartość false nie będą jednak zwracać tych szczegółów.

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

• „opaque” – wartość domyślna. Wydarzenie blokuje czas w kalendarzu. Odpowiada to ustawieniu opcji Pokaż mnie jako na Zajęty w interfejsie Kalendarza.
• „transparent” – wydarzenie nie blokuje czasu w kalendarzu. Odpowiada to ustawieniu Wyświetlaj 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 wydarzenia są widoczne dla wszystkich osób, które mają dostęp do kalendarza.
• „private” – wydarzenie jest prywatne i tylko uczestnicy mogą wyświetlać jego szczegóły.
• „confidential” – wydarzenie jest prywatne. Ta wartość jest podawana ze względu na zgodność.

• „homeOffice” – użytkownik pracuje w domu.
• „officeLocation” – użytkownik pracuje w biurze.
• „customLocation” – użytkownik pracuje z niestandardowej lokalizacji.

Wymagane podczas dodawania właściwości lokalizacji miejsca pracy.