Utwórz wydarzenie
Jeśli masz uprawnienia do zapisu w Kalendarzu Google organizatora, możesz dodać
za pomocą zdarzenia Events: insert
.
Ta metoda dodaje wydarzenie bezpośrednio do kalendarza organizatora niezależnie ustawienia dodawania zaproszeń.
Dodaj uczestników
Dzięki tej metodzie możesz również dodawać uczestników do tego samego wydarzenia, dodając ich
adres e-mail do attendees
we właściwości zdarzenia. Wszelkie przyszłe zmiany wprowadzone przez organizatora w wydarzeniu będą
propagowane uczestnikom.
Uczestnicy otrzymają zaproszenie z adresu e-mail organizatora. Google Użytkownicy Kalendarza otrzymają zaproszenie e-mailem lub w kalendarzu. zgodnie z ustawieniami wydarzeń w Kalendarzu Google tych osób:
- Jeśli mają wybrane ustawienie
From everyone
, zdarzenie zostanie dodane bezpośrednio do: jego kalendarz - Jeśli ma ustawione ustawienie
Only if the sender is known
, zdarzenie zostanie dodane. bezpośrednio do kalendarza, jeśli mieli już do czynienia organizatora, jeśli należy on do tej samej organizacji, jest w jego kontaktach Google. Jeśli organizator nie zna tego nadawcy, może kliknąć Znam tego nadawcę lub Odpowiedz klikając Tak lub Być może w e-mailu z zaproszeniem. Zdarzenie to jest teraz które dodali do swoich kalendarzy. - Jeśli użytkownicy mają włączone ustawienie
When I respond in email
, wszystkie zaproszenia nie są dodane do swojego kalendarza, dopóki użytkownik nie odpowie, klikając Tak, Być może. lub Nie w e-mailu z zaproszeniem.
Więcej informacji na temat dodawania zaproszeń do Kalendarza Google znajdziesz w artykule Zarządzanie zaproszeniami w Kalendarzu
Nie ustawiaj odpowiedzi uczestnika za pomocą
attendees[].responseStatus
na usługę inną niż needsAction
. Wypełniam wstępnie dane uczestnika
nie dodaje zdarzenia automatycznie do zdarzeń użytkownika kalendarze.
Wyświetlaj wydarzenie bezpośrednio u uczestników kalendarze
Aby wyświetlić wydarzenie bezpośrednio w kalendarzach uczestników Kalendarza Google dla każdego ustawienia uczestnika, możesz ustaw odpowiedź uczestnika lub zaimportować kopię wydarzenia bezpośrednio do kalendarza uczestnika. W przypadku obu metod musisz określić uprawnienia do zapisu w uczestnikach kalendarze; Jeśli nie, zastanów się, dodanie organizatora do kontaktów uczestnika, co może wymaga uprawnień do zapisu w kontaktach uczestnika.
Ustawianie odpowiedzi uczestnika
Aby ustawić odpowiedź uczestnika na wydarzenie, wykonaj te czynności:
- Utwórz wydarzenie w kalendarzu organizatora Kalendarza Google i dodaj uczestników (patrz wyżej).
- Używanie metody
Events: update
aby ustawić odpowiedź uczestnika doaccepted
lubtentative
. Musisz mieć uprawnienia do zapisu w kalendarz. Może wystąpić niewielkie opóźnienie w w kalendarzu uczestnika. Więcej informacji o używaniu metodyEvents: update
Ta metoda dodaje wydarzenie do kalendarza uczestnika, ale uczestnik może nadal widzą w e-mailu baner z informacją, że zaproszenie zostało wysłane z adresu. nieznanych im wcześniej.
Zaimportować kopię wydarzenia bezpośrednio do kalendarza uczestnika
Aby zaimportować kopię wydarzenia do kalendarza uczestnika, wykonaj następujące czynności: kroki:
- Jeśli masz uprawnienia do zapisu w Kalendarzu Google organizatora, zaimportuj kopię
zdarzenia za pomocą funkcji
Events: import
. - Zaimportuj kolejną kopię tego samego wydarzenia do folderu uczestnika
kalendarza za pomocą
Events: import
. Musisz mieć uprawnienia do zapisu w kalendarzu uczestnika. Użyj tego samego identyfikatora zdarzenia (iCalUID
) dla elementu kopie organizatora i uczestnika oraz koniecznie określ organizatora. w kopii uczestnika.
Dzięki tej metodzie uczestnik może zobaczyć wydarzenie w swoim kalendarzu, ale ich nie widzi. otrzymasz e-maila z zaproszeniem z Kalendarza Google.
Dodaj organizatora do kontaktów uczestnika
Jeśli nie masz danych logowania uczestnika, możesz przekazać tej osobie instrukcje lub dodanie adresu e-mail organizatora do jego kontaktów Google. wyświetlać wydarzenie bezpośrednio w kalendarzu. Może być konieczne z niewielkim opóźnieniem w stosunku do nowo utworzonego kontaktu.
- Poproś użytkownika Kalendarza Google o dodanie organizatora do swoich kontaktów Google.
- Jeśli uczestnicy należą do organizacji, możesz zapytać jej
programowego dodawania adresów e-mail do kont użytkowników
kontaktów. Poproś administratora o włączenie
przekazywanie dostępu do całej domeny,
podszywać się pod użytkowników i używać
People: createContact
aby utworzyć kontakty dla każdego użytkownika, tak aby przyszłe zaproszenia z tych adresów e-mail automatycznie pojawiają się w kalendarze. - Jeśli masz dostęp do kontaktów uczestnika, możesz też dodać
adresu e-mail organizatora do kontaktów uczestnika za pomocą
People: createContact
.
Zaproś użytkownika z adresu e-mail
Jeśli nie masz uprawnień do zapisu w Kalendarzu Google organizatora lub Jeśli nie chcesz ujawniać adresu e-mail organizatora, użyj pliku iKalendarza. protokół (RFC-5545). zapraszanie użytkowników przy użyciu adresu e-mail przy użyciu pliku .ics.
Jeśli uczestnik jest użytkownikiem Kalendarza Google z ustawieniem Only if the sender
is known
i nie kontaktował się wcześniej z adresem ani nie zarejestrował go jako
nie zostanie mu dodane zaproszenie do kalendarza, dopóki użytkownik nie kliknie I
zna nadawcę albo odpowie na zaproszenie.
Podaj link dla użytkowników, aby mogli dodać wydarzenie
Aby ułatwić użytkownikom Kalendarza Google dodawanie jako jednorazowe, bez aktualizowania, możesz podać link wstępnie wypełnione zdarzenie, które użytkownik może dodać. Ta metoda powoduje utworzenie odrębnego wydarzenia w kalendarzu użytkownika. Nie możesz ich aktualizować, jeśli nie masz dostęp do kalendarza użytkownika.
Użyj tego szablonu linku:
https://calendar.google.com/calendar/r/eventedit?action=TEMPLATE&dates=20230325T224500Z%2F20230326T001500Z&stz=Europe/Brussels&etz=Europe/Brussels&details=EVENT_DESCRIPTION_HERE&location=EVENT_LOCATION_HERE&text=EVENT_TITLE_HERE
Aktualizując te informacje:
- Daty i godziny rozpoczęcia i zakończenia: użyj formatu ISO 8601. W tym przykładzie
zastąp
20230325T224500Z
i20230326T001500Z
. - Strefa czasowa rozpoczęcia i zakończenia: sformatuj ją jako nazwę bazy danych strefy czasowej IANA.
Podaj strefy czasowe w polach
stz
ietz
. - Opis zdarzenia: musi być zakodowany na potrzeby adresu URL.
- Lokalizacja zdarzenia: musi być zakodowana na potrzeby adresu URL.
- Tytuł zdarzenia: musi być zakodowany na potrzeby adresu URL.
Przykład
Przyjrzyjmy się przykładowi usługi rezerwacji spotkań, która pomaga użytkownicy rezerwują spotkania w firmach. Gdy użytkownik zarezerwuje spotkanie, chcesz, aby Twoja usługa dodała wydarzenie do konta Google osoby rezerwującej i tej firmy Kalendarze.
Ze względu na wygodę użytkowników zalecamy, aby firma przyznała uprawnienia do zapisu do kalendarza tej firmy, aby można było dodać wydarzenie bezpośrednio do kalendarz (Utwórz wydarzenie) i zaproś na nie osobę dokonującą rezerwacji. (Dodaj uczestników). Aby mieć pewność, że osoba rezerwująca widzi wydarzenie w do kalendarza, przypomnienia, powiadomienia e-mail i powiadomienia Odpowiedz na wydarzenie Tak od razu po dokonaniu rezerwacji. Po otrzymaniu odpowiedzi zdarzenia, powiadomienia o wydarzeniach z Kalendarza Google zgodnie z jego ustawieniami powiadomień.
Jeśli chcesz dodać wydarzenie bezpośrednio do kalendarza rezerwatora, poinformuj go o tym. dodać je do swoich kontaktów adres e-mail, z którego otrzyma zaproszenie. Ewentualnie poprosić osoby dokonujące rezerwacji o uprawnienia do zapisu w kalendarzu, aby automatycznie odpowiadać na zaproszenia w imieniu (Ustaw odpowiedź uczestnika) i wyślij tej osobie e-maila powiadomienie o potwierdzonej rezerwacji.
Jeśli firma nie chce ujawniać swojego adresu e-mail, użyj atrybutu adres e-mail, na który mamy wysłać wydarzenie do rezerwacji. (Zaproś użytkownika z adresu e-mail).
Propagacja zdarzeń
Poniższy diagram przedstawia dynamikę. Najpierw Jacek tworzy wydarzenie w dniu:
swojego głównego kalendarza (i tym samym jest właścicielem kopii organizatora). Następnie zaprasza
Kalendarz pomocniczy grupy lekcji wiolonczeli i Susan, która ma ustawienie wydarzenia
Only if the sender is known
Uczestnicy w ramach lekcji na wiolonczelę
grupowania w kalendarzu pomocniczym i w kalendarzu Susan, jeśli zna Jacka,
odpowiada na zaproszenie lub mówi, że zna Jacka. Gdy Susan odpowie,
zostanie przesłana z powrotem do organizatora, aktualizując kopię organizatora przy użyciu:
Odpowiedź Susan. Te zmiany zostały wprowadzone w kopii wydarzenia organizatora
zostaną rozpowszechnione wśród pozostałych uczestników.
Właściwości zdarzenia udostępnionego
Kalendarz, w którym tworzone jest wydarzenie, to kalendarz organizatora. Ten kalendarz jest właścicielem udostępnionych informacji o wydarzeniu, w tym identyfikatora, godziny rozpoczęcia i zakończenia; jego podsumowania i opisu. Gdy te informacje zostaną zaktualizowane u organizatora kalendarz, zmiany zostaną rozpowszechnione w kopiach uczestników.
Właściwości wydarzenia prywatnego
Nie wszystkie informacje są udostępniane między wszystkimi kopiami wydarzenia. Niektóre miejsca zakwaterowania
prywatne, takie jak przypomnienia, colorId
, przejrzystość lub
usługę extendedProperties.private
. Te właściwości są kontrolowane przez
na podstawie ustawień uczestnika, a nie w kalendarzu organizatora.
Uczestnicy mogą również zmieniać udostępnione właściwości wydarzenia. Jednak te zmiany są odzwierciedlane tylko w ich własnej kopii i mogą zostać utracone, jeśli organizator wprowadza zmianę.
Jedyną zmianą wydarzenia, która jest przekazywana od uczestników z powrotem do organizatora, jest
stan odpowiedzi uczestnika, zapisany w pliku
attendees[].responseStatus
usłudze.