Zapraszanie użytkowników na wydarzenie

Tworzenie wydarzenia

Jeśli masz uprawnienia do zapisu w Kalendarzu Google organizatora, możesz dodać wydarzenie za pomocą Events: insert metody.

Ta metoda dodaje wydarzenie bezpośrednio do kalendarza organizatora, niezależnie od jego ustawienia dotyczącego dodawania zaproszeń.

Dodawanie uczestników

Za pomocą tej metody możesz też dodać uczestników do tego samego wydarzenia, dodając ich adresy e-mail do attendees właściwości wydarzenia. Wszelkie przyszłe zmiany wprowadzone przez organizatora w wydarzeniu są przekazywane uczestnikom.

Uczestnicy otrzymują zaproszenie z adresu e-mail organizatora. Użytkownicy Kalendarza otrzymują zaproszenie w e-mailu lub w kalendarzu, w zależności od ustawień wydarzenia w Kalendarzu:

  • Jeśli mają ustawienie From everyone, wydarzenie jest dodawane bezpośrednio do ich kalendarza.
  • Jeśli mają ustawienie Only if the sender is known, wydarzenie jest dodawane bezpośrednio do ich kalendarza, jeśli wcześniej kontaktowali się z organizatorem, jeśli organizator należy do tej samej organizacji lub jeśli organizator znajduje się w ich Kontaktach Google. Jeśli organizator nie jest im znany, mogą kliknąć Dodaj do kalendarza lub odpowiedzieć na zaproszenie, klikając Tak lub Być może w e-mailu z zaproszeniem. Wtedy wydarzenie zostanie dodane do ich kalendarza.
  • Jeśli użytkownicy mają ustawienie When I respond in email, wszystkie zaproszenia nie są dodawane do ich kalendarza, dopóki użytkownik nie odpowie na zaproszenie, klikając Tak, Być może, lub Nie w e-mailu z zaproszeniem.

Więcej informacji o tym, jak zaproszenia są dodawane do Kalendarza, znajdziesz w artykule Zarządzanie zaproszeniami w Kalendarzu.

Wyświetlanie wydarzenia bezpośrednio w kalendarzach uczestników

Aby wyświetlić wydarzenie bezpośrednio w kalendarzach uczestników Kalendarza niezależnie od ustawień uczestnika, możesz ustawić odpowiedź uczestnika lub zaimportować kopię wydarzenia bezpośrednio do kalendarza uczestnika. W przypadku obu metod musisz mieć uprawnienia do zapisu w kalendarzach uczestników. Jeśli ich nie masz, rozważ dodanie organizatora do kontaktów uczestnika. Może to wymagać uprawnień do zapisu w kontaktach uczestnika.

Ustawianie odpowiedzi uczestnika

Aby ustawić odpowiedź uczestnika na wydarzenie, wykonaj te czynności:

  1. Utwórz wydarzenie w kalendarzu organizatora Kalendarza i dodaj uczestników (patrz Dodawanie uczestników).
  2. Użyj metody Events: update , aby ustawić odpowiedź uczestnika na accepted lub tentative. Musisz mieć uprawnienia do zapisu w kalendarzu uczestnika. Zanim wydarzenie pojawi się w kalendarzu uczestnika, może upłynąć trochę czasu. Dowiedz się więcej o tym, jak używać metody Events: update.

Ta metoda dodaje wydarzenie do kalendarza uczestnika, ale uczestnik może nadal widzieć w e-mailu baner informujący, że zaproszenie zostało wysłane z adresu, który nie był mu wcześniej znany.

Importowanie kopii wydarzenia bezpośrednio do kalendarza uczestnika

Aby zaimportować kopię wydarzenia do kalendarza uczestnika, wykonaj te czynności:

  1. Jeśli masz uprawnienia do zapisu w kalendarzu organizatora Kalendarza, zaimportuj kopię wydarzenia za pomocą Events: import metody.
  2. Zaimportuj kolejną kopię tego samego wydarzenia do kalendarza uczestnika za pomocą metody Events: import. Musisz mieć uprawnienia do zapisu w kalendarzu uczestnika. Użyj tego samego identyfikatora wydarzenia (iCalUID) w przypadku kopii organizatora i uczestnika oraz pamiętaj, aby określić organizatora w kopii uczestnika.

Dzięki tej metodzie uczestnik może zobaczyć wydarzenie w swoim kalendarzu, ale nie otrzyma e-maila z zaproszeniem z Kalendarza.

Dodawanie organizatora do kontaktów uczestnika

Jeśli nie masz danych logowania uczestnika, możesz poprosić uczestnika lub jego organizację o dodanie adresu e-mail organizatora do Kontaktów Google, aby wydarzenie było wyświetlane bezpośrednio w jego kalendarzu. Zanim nowo utworzony kontakt zacznie obowiązywać, może upłynąć trochę czasu.

  • Poproś użytkownika Kalendarza o dodanie organizatora do Kontaktów Google.
  • Jeśli uczestnicy należą do organizacji, możesz poprosić administratora organizacji o programowe dodanie adresów e-mail do kontaktów użytkowników. Poproś administratora o włączenie delegowania w całej domenie, podszywanie się pod użytkowników i użycie metody People: createContact do utworzenia kontaktów dla każdego użytkownika, aby przyszłe zaproszenia z tych adresów e-mail automatycznie pojawiały się w kalendarzach użytkowników.
  • Jeśli masz dostęp do kontaktów uczestnika, możesz też dodać adres e-mail organizatora do kontaktów uczestnika za pomocą metody People: createContact.

Zapraszanie użytkowników e-mailem

Jeśli nie masz uprawnień do zapisu w kalendarzu organizatora Kalendarza lub nie chcesz ujawniać adresu e-mail organizatora, użyj protokołu iCalendar (RFC-5545) aby zaprosić użytkowników za pomocą e-maila i pliku .ICS.

Jeśli uczestnik jest użytkownikiem Kalendarza z ustawieniem Only if the sender is known i nie kontaktował się wcześniej z tym adresem ani nie zapisał go jako znanego, zaproszenie nie zostanie dodane do jego kalendarza, dopóki nie kliknie Dodaj do kalendarza lub nie odpowie na wydarzenie.

Jeśli chcesz ułatwić użytkownikom Kalendarza dodawanie wydarzenia jako jednorazowego bez aktualizowania go, możesz podać link z wstępnie wypełnionym wydarzeniem, aby użytkownik mógł dodać się do niego samodzielnie. Ta metoda tworzy w kalendarzu użytkownika osobne wydarzenie, którego nie możesz aktualizować, chyba że 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:

  • Data i godzina rozpoczęcia oraz zakończenia: użyj formatu ISO 8601. W powyższym przykładzie zastąp 20230325T224500Z i 20230326T001500Z.
  • Strefy czasowe rozpoczęcia i zakończenia: formatuj jako nazwę z bazy danych stref czasowych IANA. Umieść strefy czasowe w polach stz i etz.
  • Opis wydarzenia: musi być zakodowany w formacie URL.
  • Lokalizacja wydarzenia: musi być zakodowana w formacie URL.
  • Tytuł wydarzenia: musi być zakodowany w formacie URL.

Przykład

Rozważmy przykład tworzenia usługi rezerwacji wizyt, która pomaga użytkownikom rezerwować wizyty w firmie. Gdy użytkownik zarezerwuje wizytę, chcesz, aby Twoja usługa dodała wydarzenie do kalendarzy Google użytkownika i firmy.

Aby zapewnić użytkownikom jak najlepsze wrażenia, zalecamy, aby firma przyznała Ci uprawnienia do zapisu w swoim kalendarzu, abyś mógł dodać wydarzenie bezpośrednio do kalendarza firmy (Tworzenie wydarzenia) i zaprosić użytkownika na to wydarzenie (Dodawanie uczestników). Aby mieć pewność, że użytkownik zobaczy wydarzenie w swoim kalendarzu i otrzyma przypomnienie o nim, poinformuj go, aby sprawdził e-maile i odpowiedział Tak na wydarzenie zaraz po dokonaniu rezerwacji. Gdy użytkownik odpowie na wydarzenie, będzie otrzymywać powiadomienia o wydarzeniu z Kalendarza zgodnie z ustawieniami powiadomień.

Jeśli chcesz dodać wydarzenie bezpośrednio do kalendarza użytkownika, poinformuj użytkowników aby dodali do swoich kontaktów adres e-mail, z którego otrzymają zaproszenie. Możesz też poprosić użytkowników o uprawnienia do zapisu w ich kalendarzu, aby programowo odpowiedzieć na zaproszenie w ich imieniu (Ustawianie odpowiedzi uczestnika) i wysłać im e-maila z powiadomieniem o potwierdzeniu rezerwacji.

Jeśli firma nie chce ujawniać swojego adresu e-mail, użyj adresu e-mail przypisanego do użytkownika , aby wysłać wydarzenie do użytkownika za pomocą e-maila (Zapraszanie użytkownika za pomocą adresu e-mail).

Przekazywanie wydarzeń

Poniższy diagram wyjaśnia dynamikę. Najpierw Jan tworzy wydarzenie w swoim kalendarzu głównym (i tym samym jest właścicielem kopii organizatora). Następnie zaprasza do udziału w wydarzeniu grupę lekcji wiolonczeli w kalendarzu pomocniczym oraz Zuzannę, która ma ustawienie wydarzenia Only if the sender is known. Kopie uczestników są tworzone w kalendarzu dodatkowym grupy lekcji wiolonczeli oraz w kalendarzu Zuzanny, jeśli zna ona Jana. W przeciwnym razie, gdy odpowie na zaproszenie lub wskaże, że zna Jana. Gdy Zuzanna odpowie, zmiana odpowiedzi zostanie przekazana organizatorowi, a kopia organizatora zostanie zaktualizowana o odpowiedź Zuzanny. Te zmiany wprowadzone w kopii wydarzenia organizatora są następnie przekazywane innym uczestnikom.

Diagram przedstawiający dynamikę wydarzenia i uczestników

Wspólne właściwości wydarzenia

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, podsumowania oraz opisu. Gdy te informacje zostaną zaktualizowane w kalendarzu organizatora, zmiany zostaną przekazane do kopii uczestników.

Prywatne właściwości wydarzenia

Nie wszystkie informacje są udostępniane we wszystkich kopiach wydarzenia. Niektóre właściwości są prywatne, np. przypomnienia, colorId, przezroczystość lub właściwość extendedProperties.private. Te właściwości są kontrolowane przez ustawienia uczestnika, a nie przez kalendarz organizatora.

Uczestnicy mogą też zmieniać udostępnione właściwości wydarzenia. Te zmiany są jednak widoczne tylko w ich własnej kopii i mogą zostać utracone, jeśli organizator wprowadzi zmiany.

Jedyną zmianą w wydarzeniu, która jest przekazywana od uczestników do organizatora, jest stan odpowiedzi uczestnika przechowywany we attendees[].responseStatus właściwości.