Endpoint di Zoom Calendaring
Servizio di Calendario Web
Il Servizio di Calendario Web è il cuore della capacità di Zoom di fornire informazioni di calendario a tutte le Zoom Apps.
Quali informazioni memorizza Zoom?
App Desktop e Mobile
Le Zoom Apps memorizzano dati di calendario o di contatto?
Le Zoom Apps mantengono le informazioni di calendario in memoria temporanea (RAM) e non salvano alcun elemento sul disco locale. Questo include token di autenticazione, credenziali, informazioni sugli eventi del calendario e dati di contatto. Questi dati non sono più Disponibile una volta che il client esce.
Cosa succede all'accesso?
Le Zoom Apps avviano un aggiornamento completo a ogni accesso per raccogliere l'elenco degli eventi futuri. Ciò comporta la ricezione del suo token OAuth Access o delle credenziali archiviate dal Servizio di Calendario Web di Zoom e quindi l'uso di quell'oggetto per aggiornare direttamente i dati Evento dal provider di calendario. Se il token di accesso non è valido, il Servizio di Calendario Web di Zoom utilizzerà il token di aggiornamento per richiedere e passare un nuovo token di accesso al client Zoom.
Come fa il client a sapere quando aggiornare il proprio elenco di eventi futuri?
Il Servizio di Calendario Web di Zoom si iscrive a un webhook del provider di calendario per ogni utente dopo che il calendario è collegato nel portale web. Questi webhook notificano al Servizio di Calendario Web eventuali modifiche, così può poi notificare al client Zoom che è necessario un aggiornamento. Infine, il client Zoom richiederà un aggiornamento direttamente al provider di calendario. Le app che non ricevono una notifica di aggiornamento aggiorneranno il proprio elenco di eventi ogni 30 minuti.
Quali dettagli della riunione sono disponibili per il client?
Zoom Apps consentono di mostrare i dati della riunione dopo aver sanificato gli eventi che analizza, il che ნიშნავს che ha scartato tutti gli attributi che non utilizza. Gli attributi dell'evento salvati per l'uso e quelli scartati sono illustrati nella tabella seguente.
Oggetto
Partecipanti
Descrizione
Indirizzo e-mail del mittente*
Indirizzo e-mail A/CC/CCN*
Allegati*
Contenuto del corpo della e-mail*
Data e durata
URL della riunione Zoom
Se la riunione include una Zoom Room
Posizione
Risorse della sala
*Solo quando la cattura degli eventi potenziata da AI Companion 2.0 è abilitata
I dati di calendario vengono archiviati nei log del client?
Le Zoom Apps non inseriscono nei log del client dati sensibili del calendario come token, credenziali o eventi.
Strumenti di pianificazione
Zoom offre una varietà di strumenti per semplificare l'esperienza di pianificazione delle riunioni Zoom con i prodotti Microsoft e Google. Questi prodotti includono integrazioni native di pianificazione per Google area di lavoro e Microsoft 365, o estensioni software da usare con browser Seleziona e Outlook.
Come funzionano gli strumenti di pianificazione?
Tutti gli strumenti di pianificazione, ad eccezione del Plug-in di Outlook, inviano direttamente richieste API sia al provider di calendari sia al Servizio di Calendario Web di Zoom. Il Plug-in di Outlook è diverso in quanto pianifica una riunione tramite il Client Zoom Desktop, che invia la richiesta API al Servizio di Calendario Web di Zoom per conto del plug-in.
Quali informazioni vengono inviate a Zoom quando si pianifica con uno strumento?
Gli unici dati conservati quando si utilizza uno strumento di pianificazione sono le informazioni necessarie per Pianificare una riunione. Ad esempio, quando un utente pianifica una riunione Zoom utilizzando il componente aggiuntivo di Microsoft 365, il componente aggiuntivo utilizzerà l'oggetto dell'evento, la data, l'ora, il fuso orario e il flag di ricorrenza per pianificare la riunione Zoom. Il componente aggiuntivo Zoom non richiede né utilizza dettagli aggiuntivi come il corpo o l'elenco dei partecipanti.
Ci sono requisiti di firewall o di sicurezza?
Gli strumenti di pianificazione non richiedono ulteriori modifiche al firewall o alla sicurezza oltre a quelle già necessarie per le integrazioni di calendari. L'elenco completo dei requisiti è documentato in regole di rete e firewall per Zoom.
Qual è la differenza tra il Plug-in di Outlook e il componente aggiuntivo di Outlook?
Il Plug-in di Outlook è installato sul dispositivo di un utente finale e aiuta gli utenti a pianificare riunioni Zoom tramite il proprio client Outlook. Il plug-in comunica con il Client Zoom Desktop Workplace tramite un canale di comunicazione tra processi (IPC). Utilizzando questo IPC, il plug-in invia le pianificazioni al Servizio di Calendario Web di Zoom tramite le risorse del client.
Per offrire la migliore esperienza ai nostri utenti nel rispetto delle policy e delle linee guida stabilite da Apple e Microsoft, Zoom raccomanda vivamente la distribuzione e l'utilizzo del componente aggiuntivo Zoom per Outlook. Il componente aggiuntivo offre una distribuzione più semplice e soluzioni di gestione amministrativa più robuste, è supportato attivamente da Microsoft e risponde meglio ai requisiti di sicurezza recentemente rafforzati da fornitori come Apple.
Avviso
Non verranno implementati nuovi miglioramenti delle Funzionalità per il Plugin di Zoom per Outlook. Si consiglia vivamente di migrare al componente aggiuntivo Zoom per Outlook.
Il componente aggiuntivo di Outlook è un'applicazione basata sul web che non richiede l'installazione locale sulle macchine dell'utente e appare invece come una app web integrata, Disponibile sia nel client locale sia in Outlook sul web. Il componente aggiuntivo funziona tramite API web che comunicano direttamente con il servizio web di calendaring di Zoom.
Il Plugin e il componente aggiuntivo offrono funzionalità simili, ma il componente aggiuntivo richiede che l'insieme di requisiti dell'API JavaScript di Outlook v1.8 — una versione che esiste solo nelle versioni moderne di Outlook e non è affatto disponibile per Exchange Server locale — sia disponibile. Ciò significa:
Il componente aggiuntivo di Outlook non può essere utilizzato per la pianificazione delegata con Exchange Server locale.
I delegati devono usare il client Microsoft 365 Outlook, Outlook 2021 o successivo per Mac/PC, oppure Outlook sul Web per Pianificare le riunioni per conto di un altro utente.
Come posso identificare l'applicazione ufficiale del componente aggiuntivo Zoom?
L'applicazione ufficiale Zoom per Outlook disponibile da Microsoft AppSource store si installa nella directory Enterprise Apps di Entra ID con il nome “Zoom-Office-Aggiungi-in-SSO” con l’ID applicazione ce63c970-e2d7-45e6-bee1-80c330b0800b.
Devo aggiornare il Plug-in di Outlook o il componente aggiuntivo?
A partire da gennaio 2025, Microsoft ha iniziato a sostituire i token legacy di Exchange Online con l’autenticazione Nested app (NAA). Gli amministratori Zoom, in collaborazione con gli amministratori Entra, devono Configura NAA all’interno dello Zoom web portal seguendo le istruzioni nell’articolo di Assistenza Configurazione dell'autenticazione app nidificata per i componenti aggiuntivi di Office.
Nota
L'autenticazione app nidificata (NAA) è supportata solo con Exchange Online. Le organizzazioni che usano Exchange 2019 (o altre versioni on-premises di Exchange) dovranno Continua a utilizzare i token legacy di identità utente di Exchange e i token di callback, poiché questi non sono bloccati negli ambienti on-premises.
In caso contrario, il componente aggiuntivo Zoom per Outlook è un'applicazione basata sul web che non richiede l'installazione locale sulle macchine utente e invece appare come un'applicazione web integrata che opera tramite API web per comunicare con il Servizio di calendario web di Zoom. Il componente aggiuntivo è disponibile per le app Outlook per Windows e macOS, le app Outlook per Android e iOS e Outlook sul web. Il componente aggiuntivo può essere configurato e distribuito in massa dagli amministratori di Outlook oppure installato da singoli utenti.
Il Plug-in di Outlook funziona come un software installato, soggetto a occasionali aggiornamenti e miglioramenti. Di conseguenza, il Plugin richiede la gestione delle versioni e gli upgrade nel tempo.
Nota
L'autenticazione dell'app nidificata non è richiesta per il Plug-in di Outlook.
Quale strumento di pianificazione è più adatto al mio ambiente?
Google area di lavoro
Le organizzazioni che utilizzano Google Workspace possono facilmente abilitare tutti gli utenti a Pianificare Zoom Meetings tramite Google Calendar installando l'app Zoom for GSuite dal Marketplace di Google Workspace. L'app è gestita centralmente e si aggiorna automaticamente mentre Zoom invia miglioramenti a Google.
In alternativa, sono disponibili anche le estensioni basate su browser, ma in genere sono più adatte agli utenti con account personali perché richiedono un'installazione locale, aggiornamenti periodici e non sono gestite centralmente.
Microsoft
Per le organizzazioni che utilizzano Microsoft 365 o Exchange Server locale, la scelta migliore dipende sia dall’ambiente sia da come è configurata l’integrazione del calendario.
Il componente aggiuntivo Zoom per Outlook è lo strumento preferito per gli ambienti Microsoft 365, sia che tu utilizzi le versioni desktop, web o mobile di Outlook. Il componente aggiuntivo richiede Outlook per Microsoft 365, Outlook 2013 o versioni successive per Windows, oppure Outlook 2016 o versioni successive per Mac.
La Sincronizzazione bidirezionale del calendario garantisce aggiornamenti del calendario senza interruzioni ed è abilitata predefinito quando si integrano i calendari. Ciò consente a Zoom di riflettere automaticamente le modifiche apportate agli Evento del calendario di Outlook, come orari riprogrammati o cancellazioni, senza richiedere agli utenti di aggiornare o rimuovere manualmente le riunione tramite il componente aggiuntivo. Questo è particolarmente importante perché i link delle riunione di Zoom possono scadere se le modifiche non vengono acquisite, in particolare quando una riunione viene spostata di oltre 30 giorni oltre la data originale. Gli ID delle riunione in genere scadono dopo 30 giorni, a meno che non facciano parte di una serie ricorrente.
La moderna API JavaScript (v1.8), che alimenta l'automazione basata su evento come OnAppointmentSend, non è supportata dai seguenti ambienti e applicazioni:
Ambienti Exchange locali
Outlook classico connesso a M365
Outlook mobile su iOS e Android
Di conseguenza, Zoom non può rilevare o aggiornare automaticamente le riunione tramite il componente aggiuntivo in queste configurazioni. Senza Sincronizzazione bidirezionale o automazione basata su API, anche le riunione ricorrenti potrebbero non riflettere le modifiche, portando a link Zoom scaduti o non validi.
Il Plug-in Zoom Outlook è supportato solo sui sistemi Windows. Offre una sincronizzazione delle riunione migliorata tramite Integrazioni dirette con l'app Zoom Workplace, bypassando le limitazioni delle API Microsoft. Sebbene sia consigliato per i sistemi Windows senza Sincronizzazione bidirezionale, presenta notevoli limitazioni:
Richiede aggiornamenti MSI gestiti dall'IT
Pianificazione delle riunione più lenta
Nessun supporto per macOS o dispositivi mobili
Zoom Rooms
L’Integrazioni di calendario di Zoom Rooms viene eseguita indipendentemente dall’Integrazioni del client desktop o mobile dell’utente.
Dopo la configurazione, gli eventi del calendario vengono visualizzati sui display di Zoom Rooms, inclusi gli schermi televisivi, le interfacce di pianificazione e i pannelli di controllo. Gli utenti possono avviare o partecipare alle riunioni a un solo tocco sul controller della sala.
I passaggi seguenti costituiscono una panoramica di alto livello del processo di configurazione:
Configura Microsoft Exchange Online e aggiorna gli script PowerShell per le Impostazioni della cassetta postale di Zoom Rooms
Configura le autorizzazioni di Microsoft Graph API per abilitare l’accesso ai dati del calendario
Zoom consiglia Microsoft Graph API con Autorizzazioni dell’applicazione come metodo standard di Integrazioni. Questa raccomandazione è in linea con il piano di Microsoft di rimuovere i protocolli Exchange Web Services (EWS). Il metodo Graph API offre la connessione più stabile tra Zoom Rooms e i calendari di Microsoft 365.
Nota
Le organizzazioni che utilizzano sistemi di sala conferenze di terze parti (come Cisco, Poly e Lifesize) devono completare passaggi aggiuntivi tramite lo Zoom Enhanced API Connettore per garantire il corretto funzionamento del calendario e delle riunioni. Consultare il nostro documento M365 Calendaring Field Guide per ulteriori informazioni sulla configurazione dell’accesso al calendario per Zoom Rooms.
Quali metodi posso usare per concedere Access ai mailbox della sala?
L’Integrazioni di pianificazione di Zoom Rooms si basa sulla Microsoft Graph API (MGAPI). Microsoft ha iniziato eliminazione graduale dei metodi di Exchange Web Services (EWS) che erano precedentemente disponibili per connettere i dati di Microsoft 365 con i Servizi Zoom. Zoom considera questi metodi EWS come opzioni legacy.
Google area di lavoro ha un solo metodo per applicare le autorizzazioni.
Quali autorizzazioni sono richieste per l'account di servizio?
L'Autorizzazione specifica varierà a seconda del metodo selezionato. Ogni opzione e le Autorizzazioni richieste sono dettagliate nella tabella sottostante:
Microsoft 365/Microsoft Exchange Server
Autorizzazioni dell'applicazione (Microsoft Graph API)
Account amministratore: gestione dell'Organizzazione e gestione dei destinatari
Microsoft 365/Microsoft Exchange Server
Access completo delegato (Microsoft Graph API)
Invia come Access completo
Google area di lavoro
-
Apporta modifiche e gestisci la condivisione
Raccomandazione di Zoom
Zoom consiglia che le Integrazioni del calendario utilizzino il metodo delle Autorizzazioni dell'applicazione. Questa configurazione richiede meno lavoro da parte dell'amministratore e non richiede un account di servizio dedicato. È anche l'approccio consigliato da Microsoft per le applicazioni Enterprise in esecuzione come servizi in background.
Connettore API avanzato
L'integrazione del calendario per sistemi room H.323 e SIP basati su standard tramite il Connettore API avanzato (rilasciato all'inizio del 2021) viene eseguita indipendentemente dalla configurazione del client utente e di Zoom Rooms. La metodologia dell'account di servizio e le autorizzazioni sono identiche alla sezione Zoom Rooms trattata in precedenza.
Che cosa c'è di diverso nel flusso dei dati del Connettore API avanzato?
I sistemi room connessi tramite il Connettore API avanzato non contatteranno direttamente i provider di calendario, a differenza dei flussi di connessione del client Zoom e di Zoom Room. Zoom Web Service funge da client per questi sistemi e invierà i dati del calendario direttamente agli endpoint, con un'eccezione per i dispositivi Poly. I dispositivi Poly interrogheranno prima Zoom Web Service per gli aggiornamenti del calendario, che poi trasmetterà i dati del calendario al dispositivo.
Quanti giorni di eventi del calendario vengono recuperati?
Il Connettore API avanzato recupera i dati della riunione imminente per i prossimi 30 giorni e rimuove le riunioni completate dall'archiviazione dopo 30 giorni.
Ultimo aggiornamento
È stato utile?