Invitare utenti a un evento

Crea un evento

Se disponi dell'accesso in scrittura al calendario Google dell'organizzatore, puoi aggiungere un evento utilizzando il Events: insert metodo.

Questo metodo aggiunge l'evento direttamente al calendario dell'organizzatore, indipendentemente dall'impostazione per l'aggiunta degli inviti.

Aggiungi invitati

Con questo metodo, puoi anche aggiungere invitati allo stesso evento aggiungendo il loro indirizzo email alla attendees proprietà dell'evento. Le modifiche future apportate dall'organizzatore all'evento vengono propagate agli invitati.

Gli invitati ricevono l'invito dall'indirizzo email dell'organizzatore. Gli utenti di Google Calendar ricevono l'invito via email e/o nel calendario, a seconda delle impostazioni dell'evento nelle impostazioni di Google Calendar:

Se hanno l'impostazione From everyone, l'evento viene aggiunto direttamente al loro calendario.
Se hanno l'impostazione Only if the sender is known, l'evento viene aggiunto direttamente al loro calendario se hanno interagito in precedenza con l' organizzatore, se l'organizzatore fa parte della stessa organizzazione o se l'organizzatore è tra i loro contatti Google. Se l'organizzatore non è noto, possono fare clic su Aggiungi al calendario o rispondere all'invito facendo clic su Sì o Forse nell'email di invito. L'evento viene quindi aggiunto al loro calendario.
Se gli utenti hanno l'impostazione When I respond in email, tutti gli inviti non vengono aggiunti al loro calendario finché l'utente non risponde facendo clic su Sì, Forse, o No nell'email di invito.

Per ulteriori informazioni su come vengono aggiunti gli inviti a Google Calendar, consulta Gestire gli inviti in Calendar.

Visualizza l'evento direttamente nei calendari degli invitati

Per visualizzare un evento direttamente nei calendari dei partecipanti di Google Calendar per qualsiasi impostazione che il partecipante potrebbe avere, puoi impostare la risposta del partecipante o importare una copia dell'evento direttamente nel calendario del partecipante. Per entrambi i metodi, devi disporre dell' accesso in scrittura ai calendari degli invitati; in caso contrario, valuta la possibilità di aggiungere l'organizzatore ai contatti dell'invitato, il che potrebbe richiedere l'accesso in scrittura ai contatti dell'invitato.

Imposta la risposta del partecipante

Per impostare la risposta di un invitato a un evento:

Crea l'evento nel calendario dell'organizzatore di Google Calendar e aggiungi gli invitati (vedi sopra).
Utilizza il Events: update metodo per impostare la risposta dell'invitato su accepted o tentative. Devi disporre dell'accesso in scrittura al calendario dell'invitato. Potrebbe verificarsi un leggero ritardo prima che l'evento venga visualizzato nel calendario dell'invitato. Scopri di più su come utilizzare il metodo Events: update.

Questo metodo aggiunge l'evento al calendario del partecipante, ma il partecipante potrebbe comunque visualizzare il banner nell'email che indica che l'invito è stato inviato da un indirizzo sconosciuto in precedenza.

Importa una copia dell'evento direttamente nel calendario dell'invitato

Per importare una copia di un evento nel calendario di un invitato:

Se disponi dell'accesso in scrittura al Google Calendar dell'organizzatore, importa una copia dell'evento utilizzando il Events: import metodo.
Importa un'altra copia dello stesso evento nel calendario dell'invitato utilizzando Events: import. Devi disporre dell'accesso in scrittura al calendario dell'invitato. Utilizza lo stesso ID evento (iCalUID) per le copie dell'organizzatore e dell'invitato e assicurati di specificare l'organizzatore nella copia dell'invitato.

Con questo metodo, il partecipante può visualizzare l'evento nel suo calendario, ma non riceve un'email di invito da Google Calendar.

Aggiungi l'organizzatore ai contatti dell'invitato

Se non disponi delle credenziali del partecipante, puoi chiedere al partecipante o alla sua organizzazione di aggiungere in anticipo l'indirizzo email dell'organizzatore ai suoi Contatti Google per visualizzare un evento direttamente nel suo calendario. Potrebbe verificarsi un leggero ritardo prima che un contatto appena creato diventi effettivo.

Chiedi all'utente di Google Calendar di aggiungere l'organizzatore ai suoi contatti Google.
Se gli invitati appartengono a un'organizzazione, puoi chiedere all'amministratore dell'organizzazione di aggiungere programmaticamente gli indirizzi email ai contatti dei suoi utenti. Chiedi all'amministratore di attivare la delega a livello di dominio, di impersonare gli utenti e di utilizzare il metodo per creare contatti per ogni utente, in modo che i futuri inviti da questi indirizzi email vengano visualizzati automaticamente nei calendari degli utenti.People: createContact
Se hai accesso ai contatti dell'invitato, puoi anche aggiungere l' indirizzo email dell'organizzatore ai contatti dell'invitato utilizzando il People: createContact metodo.

Invita un utente da un indirizzo email

Se non disponi dell'accesso in scrittura al calendario Google dell'organizzatore o se non vuoi esporre l'indirizzo email dell'organizzatore, utilizza il protocollo iCalendar protocollo (RFC-5545) per invitare gli utenti con email utilizzando un file .ICS.

Se il partecipante è un utente di Google Calendar con l'impostazione Only if the sender is known e non ha interagito in precedenza con l'indirizzo o non lo ha registrato come noto, l'invito non viene aggiunto al suo calendario finché non fa clic su Aggiungi al calendario o non risponde all'evento.

Fornisci un link per consentire agli utenti di aggiungere l'evento

In alternativa, se vuoi semplificare l'aggiunta di un evento una tantum per gli utenti di Google Calendar senza mantenerlo aggiornato, puoi fornire un link con un evento precompilato che l'utente può aggiungere autonomamente. Questo metodo crea un evento distinto nel calendario dell'utente, che non puoi aggiornare a meno che tu non abbia accesso al calendario dell'utente.

Utilizza il seguente modello di link:


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

aggiornando le seguenti informazioni:

Date e ore di inizio e fine: utilizza il formato ISO 8601. Nell'esempio sopra, sostituisci 20230325T224500Z e 20230326T001500Z.
Fusi orari di inizio e fine: formatta come nome del database dei fusi orari IANA. Inserisci i fusi orari nei campi stz e etz.
Descrizione dell'evento: deve essere codificata come URL.
Luogo dell'evento: deve essere codificato come URL.
Titolo dell'evento: deve essere codificato come URL.

Esempio

Consideriamo l'esempio della creazione di un servizio di prenotazione di appuntamenti per aiutare gli utenti a prenotare appuntamenti con un'attività. Quando un utente prenota un appuntamento, vuoi che il tuo servizio aggiunga un evento ai calendari Google del prenotatore e dell'attività.

Per un'esperienza utente ottimale, ti consigliamo di chiedere all'attività di concedere l'accesso in scrittura al suo calendario, in modo che tu possa aggiungere l'evento direttamente al calendario dell'attività (Crea evento) e invitare il prenotatore all'evento (Aggiungi invitati). Per assicurarti che il prenotatore veda l'evento nel suo calendario e riceva un promemoria, chiedigli di controllare le email e di rispondere Sì all'evento immediatamente dopo aver effettuato la prenotazione. Una volta che ha risposto a l'evento, riceve le notifiche degli eventi da Google Calendar in base alle impostazioni di notifica.

Se vuoi aggiungere l'evento direttamente al calendario del prenotatore, chiedi ai prenotatori di aggiungere ai loro contatti l'indirizzo email da cui riceveranno l'invito. In alternativa, chiedi ai prenotatori l'accesso in scrittura al loro calendario per rispondere programmaticamente per loro conto (Imposta la risposta dell'invitato) e invia loro una notifica via email relativa alla prenotazione confermata.

Se l'attività non vuole esporre il suo indirizzo email, utilizza un indirizzo email specifico dell'utente per inviare l'evento al prenotatore via email (Invita un utente da un indirizzo email).

Propagazione degli eventi

Il seguente diagramma spiega le dinamiche. Innanzitutto, Jack crea un evento nel suo calendario principale (e quindi possiede la copia dell'organizzatore). Poi, invita il calendario secondario del gruppo di lezioni di violoncello e Susan, che ha l'impostazione dell'evento Only if the sender is known. Le copie degli invitati vengono create nel calendario secondario del gruppo di lezioni di violoncello e nel calendario di Susan se conosce Jack, altrimenti quando risponde o indica di conoscere Jack. Quando Susan risponde, la modifica della risposta viene propagata all'organizzatore, aggiornando la copia dell'organizzatore con la risposta di Susan. Queste modifiche apportate alla copia dell'evento dell'organizzatore vengono quindi propagate agli altri invitati.

Proprietà degli eventi condivisi

Il calendario in cui viene creato l'evento è il calendario dell'organizzatore. Questo calendario possiede le informazioni sull'evento condiviso, inclusi ID, ora di inizio e fine, riepilogo e descrizione. Quando queste informazioni vengono aggiornate nel calendario dell'organizzatore, le modifiche vengono propagate alle copie degli invitati.

Proprietà degli eventi privati

Non tutte le informazioni vengono condivise tra tutte le copie dell'evento. Alcune proprietà sono private, ad esempio promemoria, colorId, trasparenza o la proprietà extendedProperties.private. Queste proprietà sono controllate dalle impostazioni dell'invitato e non dal calendario dell'organizzatore.

Gli invitati possono anche modificare le proprietà condivise dell'evento. Tuttavia, queste modifiche vengono applicate solo alla loro copia e potrebbero andare perse se l'organizzatore apporta una modifica.

L'unica modifica dell'evento che viene propagata dagli invitati all'organizzatore è lo stato della risposta dell'invitato, memorizzato nella attendees[].responseStatus proprietà.