Creare un evento
Se disponi dell'accesso in scrittura al Google Calendar dell'organizzatore, puoi aggiungere un
utilizzando Events: insert
.
Questo metodo aggiunge l'evento direttamente al calendario dell'organizzatore, indipendentemente dall'impostazione di aggiunta degli inviti.
Aggiungi partecipanti
Con questo metodo, puoi anche aggiungere partecipanti allo stesso evento aggiungendo i loro
indirizzo email a attendees
proprietà dell'evento. Eventuali modifiche future apportate dall'organizzatore all'evento vengono
propagata ai partecipanti.
I partecipanti ricevono l'invito dall'indirizzo email dell'organizzatore. Gli utenti di Google Calendar ricevono l'invito nella posta elettronica e/o nel calendario, a seconda delle impostazioni degli eventi nelle impostazioni di Google Calendar:
- Se l'utente ha l'impostazione
From everyone
, l'evento viene aggiunto direttamente a il suo calendario - Se l'utente ha l'impostazione
Only if the sender is known
, l'evento viene aggiunto direttamente al proprio calendario se hanno interagito in precedenza con organizzatore, se l'organizzatore fa parte della stessa organizzazione o se l'organizzatore è tra i suoi contatti Google. Se l'organizzatore non è noto, può fare clic su Aggiungi al calendario o rispondere entro il facendo clic su Sì o Forse nell'email di invito. Quindi l'evento è aggiunti al proprio calendario. - Se gli utenti hanno l'impostazione
When I respond in email
, non tutti gli inviti vengono aggiunto al proprio calendario fino a quando 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 nella sezione dei partecipanti calendari
Per visualizzare un evento direttamente nel riquadro dei partecipanti di Google Calendar calendari per qualsiasi l'impostazione del partecipante, puoi impostare la risposta RSVP del partecipante oppure Importa una copia dell'evento direttamente nel calendario del partecipante. Per entrambi i metodi, è necessario accesso in scrittura ai partecipanti calendari; In caso contrario, considera l'opportunità aggiungendo l'organizzatore ai contatti del partecipante, richiedere l'accesso in scrittura ai contatti del partecipante.
Imposta la risposta RSVP del partecipante
Per impostare la risposta RSVP di un partecipante a un evento, procedi nel seguente modo:
- Crea l'evento nel calendario dell'organizzatore di Google Calendar e aggiungi i partecipanti (vedi sopra).
- Utilizza il metodo
Events: update
per impostare la risposta di partecipazione del partecipante suaccepted
otentative
. Devi avere accesso in scrittura al calendario. Potrebbe verificarsi un leggero ritardo prima che l'evento venga visualizzato nella calendario del partecipante. Scopri di più su come utilizzare il metodoEvents: update
.
Questo metodo aggiunge l'evento al calendario del partecipante, ma quest'ultimo potrebbe ancora vedere il banner nell'email che indica che l'invito è stato inviato da un indirizzo precedentemente sconosciuto.
Importa una copia dell'evento direttamente nel calendario del partecipante
Per importare una copia di un evento nel calendario di un partecipante, tieni presente quanto segue passaggi:
- Se disponi dell'accesso in scrittura al Google Calendar dell'organizzatore, importa una copia
dell'evento utilizzando
Events: import
. - Importa un'altra copia dello stesso evento nella cartella
calendario utilizzando
Events: import
. Devi disporre dell'accesso in scrittura al calendario del partecipante. Usare lo stesso ID evento (iCalUID
) per le copie dell'organizzatore e del partecipante e di specificare l'organizzatore nella copia del partecipante.
Con questo metodo, il partecipante può vedere l'evento nel proprio calendario, ma non riceve un'email di invito da Google Calendar.
Aggiungi l'organizzatore ai contatti del partecipante
Se non disponi delle credenziali dei partecipanti, puoi chiedere al partecipante o alla sua organizzazione di aggiungere in anticipo l'indirizzo email dell'organizzatore ai propri contatti Google per visualizzare un evento direttamente nel loro calendario. L'applicazione della modifica potrebbe non essere immediata.
- Chiedi all'utente di Google Calendar di aggiungere l'organizzatore ai propri contatti Google.
- Se i partecipanti appartengono a un'organizzazione, puoi chiedere informazioni
di aggiungere in modo programmatico gli indirizzi email agli utenti
contatti. Chiedi all'amministratore di abilitare
delega a livello di dominio,
impersonificare gli utenti e utilizzare
People: createContact
: per creare contatti per ciascun utente, al fine di garantire che gli inviti futuri da questi indirizzi email vengono automaticamente visualizzati calendari. - Se hai accesso ai contatti dei partecipanti, puoi anche aggiungere l'indirizzo email dell'organizzatore ai contatti dei partecipanti utilizzando il metodo
People: createContact
.
Invitare un utente da un indirizzo email
Se non disponi dell'accesso in scrittura a Google Calendar dell'organizzatore o se non vuoi esporre il suo indirizzo email, utilizza il protocollo iCalendar (RFC-5545) per invitare gli utenti via 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 mai interagito o registrato l'indirizzo come
noto, l'invito viene aggiunto al loro calendario solo dopo che l'utente fa clic
Aggiungi al calendario o rispondi all'evento.
Fornisci un link per consentire agli utenti di aggiungere l'evento
In alternativa, se vuoi semplificare per gli utenti di Google Calendar l'aggiunta di un singolo evento senza doverlo aggiornare, puoi fornire un link con un evento precompilato che l'utente può aggiungere autonomamente. Questo metodo crea un ambiente evento sul calendario dell'utente, che non puoi aggiornare se non hai l'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 di fine: utilizza il formato ISO 8601. Nell'esempio precedente,
sostituisci
20230325T224500Z
e20230326T001500Z
. - Fusi orari di inizio e di fine: formatta come nome di un database di fusi orari IANA.
Inserisci i fusi orari nei campi
stz
eetz
. - Descrizione dell'evento: deve essere codificato nell'URL.
- Posizione dell'evento: deve essere codificato nell'URL.
- Titolo evento: deve essere codificato come URL.
Esempio
Consideriamo l'esempio di creazione di un servizio di prenotazione degli appuntamenti per gli utenti prenotano appuntamenti con un'attività commerciale. Quando un utente prenota un appuntamento, vuoi che il tuo servizio aggiunga un evento ai calendari Google dell'utente e dell'attività.
Per la migliore esperienza utente, consigliamo all'attività di concedere l'accesso in scrittura al suo calendario in modo che tu possa aggiungere l'evento direttamente alla calendario (Crea evento) e invita l'utente che ha prenotato all'evento. (Aggiungi partecipanti). Per assicurarti che l'autore della prenotazione visualizzi l'evento in calendario e riceve un promemoria, invitali a controllare le email Rispondi Sì all'evento subito dopo aver effettuato una prenotazione. Dopo aver risposto all'invito, all'evento, vengono inviate notifiche di eventi da Google Calendar in base alle rispettive impostazioni di notifica.
Se vuoi aggiungere l'evento direttamente al calendario dell'utente che ha prenotato, informa chi effettua la prenotazione di aggiungere ai propri contatti L'indirizzo email da cui riceveranno l'invito. In alternativa, chiedi agli utenti che hanno prenotato l'accesso in scrittura al calendario per rispondere in modo programmatico all'invito sul proprio calendario (Imposta la risposta agli inviti per i partecipanti) e invia loro un'email. notifica sulla prenotazione confermata.
Se l'attività non vuole esporre il proprio indirizzo email, utilizza un indirizzo email indirizzo email per inviare l'evento all'utente che ha prenotato via email (Invita un utente da un indirizzo email).
Propagazione eventi
Il seguente diagramma spiega la dinamica. Innanzitutto, Jack crea un evento
il suo calendario principale (e quindi possiede la copia dell'organizzatore). Quindi, invita i
Calendario secondario del gruppo di lezioni di violoncello e Susanna, che ha l'impostazione Evento
Only if the sender is known
. Partecipanti vengono create copie durante la lezione di violoncello
calendario secondario di gruppo e sul calendario di Susan, se conosce Jack, altrimenti
quando risponde o indica di conoscere Jack. Quando Susan risponde, le risposte cambiano
vengono propagati di nuovo all’organizzatore, aggiornando la copia dell’organizzatore con
La risposta di Susan. Queste modifiche sono state apportate alla copia dell'evento dell'organizzatore, quindi
vengono propagate agli altri partecipanti.
Proprietà degli eventi condivisi
Il calendario in cui viene creato l'evento è il calendario dell'organizzatore. Questo calendario possiede le informazioni sugli eventi condivisi, tra cui ID, ora di inizio e di fine, un riepilogo e una descrizione. Quando queste informazioni vengono aggiornate sull'organizzatore calendario, le modifiche vengono propagate alle copie dei partecipanti.
Proprietà evento privato
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
impostazioni del partecipante e non in base al calendario dell'organizzatore.
I partecipanti possono anche modificare le proprietà condivise dell'evento. Tuttavia, questi le modifiche si riflettono solo sulla propria copia e potrebbero andare perse se l'organizzatore apporta una modifica.
L’unica modifica dell’evento che viene propagata dai partecipanti all’organizzatore è
lo stato di risposta del partecipante, memorizzato
attendees[].responseStatus
proprietà.