# Zoom Takvim Uç Noktaları

### Web Takvim Hizmeti

Web Takvim Hizmeti, takvim bilgilerini tüm Zoom uygulamalarına iletme yeteneğinin kalbidir.

#### <mark style="color:mavi;">Zoom hangi bilgileri saklar?</mark>

Zoom Web Takvim Hizmeti, her kullanıcının takvim sağlayıcısını doğrulamak için gereken nesneleri depolar. Bu, kuruluşlar OAuth kullanarak Outlook veya Google Takvimi Zoom hizmetlerine bağladığında Zoom'un yenileme belirtecini sakladığı anlamına gelir. Ayrıca, Exchange On-Premises'a Temel kimlik doğrulaması kullanan kuruluşlar için Zoom'un hesap kullanıcı adı ve parolasını sakladığı anlamına gelir.

| Eşlenen Etkinlikler      |
| ------------------------ |
| `katılımcılarAtlandı`    |
| `açıklama`               |
| `görünenAd` (katılımcı)  |
| `e-posta` (katılımcı)    |
| `sabitÇalışmaKonumu`     |
| `iCalUID`                |
| `konum`                  |
| `görünenAd` (düzenleyen) |
| `e-posta` (düzenleyen)   |
| `özet`                   |
| `zamanÖnerisi`           |
| `çalışmaKonumuEtkin`     |

İki Yönlü Takvim Senkronizasyonu (Sync 2.0) etkinleştirildiğinde, Zoom harici takvim etkinliği verilerini (Microsoft 365 veya Google Takvim'den) veritabanında saklamaz.\
\
Bunun yerine hizmet, takvim etkinliği için dönen 24 aylık bir pencereyi izler (geçmişte en fazla 6 ay ve gelecekte en fazla 18 ay). Bu pencere içinde değişiklikler olursa, Zoom takvim sağlayıcısından değişiklik bildirimleri alır ve ilgili Zoom Toplantısı güncellemelerini işlemek için güncellenmiş etkinlik verilerini talep üzerine alır. Ardından toplantı hizmetine gerekli değişiklikleri uygulaması için bildirim gönderilir.

Yöneticiler bu özelliği hesap veya kullanıcı grup düzeyinde yapılandırabilir. İlgili bilgiler için [destek belgelerimize](https://support.zoom.us/hc/en-us/articles/8522918261645-Enabling-bi-directional-calendar-sync) bakın.

#### <mark style="color:mavi;">Saklanan belirteçler ve kimlik bilgileri nasıl korunur?</mark>

Saklanan belirteçler ve kimlik bilgileri, dinlenme halindeyken 256 bit AES-GCM şifrelemesi kullanılarak şifrelenir. Bu veriler müşteri içeriği olarak kabul edilir ve Zoom’un erişim kontrolü politikalarına ve standartlarına tabidir. Bu kontroller, güvenlik sertifikalarımızda ve doğrulamalarımızda belirtildiği gibi bağımsız denetim firmaları tarafından değerlendirilir (ör. SOC 2). Altyapı verilerine ve sistemlerine ayrıcalıklı erişim, çok faktörlü kimlik doğrulama ve en az ayrıcalık erişim kontrolleri kullanılarak kaydedilir, izlenir ve kontrol edilir.

#### <mark style="color:mavi;">Uygulamalar ile takvim sağlayıcısı arasındaki trafik nasıl korunur?</mark>

Takvim sağlayıcıları ile herhangi bir Zoom yazılımı — Zoom masaüstü/mobil uygulamaları, Zoom Web Takvim Hizmeti, planlama araçları ve API bağlayıcısı — arasındaki iletişim TLS 1.2 kullanılarak aktarım sırasında şifrelenir.

#### <mark style="color:mavi;">OAuth belirteci ne kadar süre geçerlidir?</mark>

Zoom, 1 saat içinde sona eren erişim belirteçleri ve 90 günde sona eren yenileme belirteçleri talep edecektir, ancak takvim sağlayıcıları farklı sınırlara sahip belirteçler sağlayabilir. Varsayılan değerleri değiştirmeniz gerekiyorsa sağlayıcınızın yönergelerini izleyin.

#### <mark style="color:mavi;">Bir OAuth belirtecini veya kimlik bilgisini iptal edebilir miyim?</mark>

Zoom yöneticileri, takvimin çalışmasını engelleyecek şekilde tek bir Zoom hesabından takvim entegrasyonunu istedikleri zaman kaldırmayı seçebilir. O kullanıcı için saklanan tüm belirteçleri veya kimlik bilgilerini derhal silin.

Microsoft 365 yöneticileri, Entra ID Enterprise Application portalında Zoom uygulamasını silerek tüm kullanıcı hesaplarından Zoom'un takvim erişimini kaldırabilir ve Google Workspace yöneticileri ise Google Cloud Platform Konsolu'nu kullanarak erişimi iptal edebilir.

#### <mark style="color:mavi;">Zoom’un bir sağlayıcıya takvim veya kişi verisi yazma yeteneğini sınırlayabilir miyim?</mark>

İlk yapılandırmadan sonra, Zoom yöneticileri Microsoft 365 yöntemleriyle bağlanırken takvim ve kişiler için Okuma veya Okuma/Yazma izinleri arasında seçim yapabilir. Yöneticiler ayrıca kullanıcı takvimleri için Google Workspace entegrasyonlarını sınırlayabilir.

### Masaüstü ve Mobil Uygulamalar

#### <mark style="color:mavi;">Zoom uygulamaları herhangi bir takvim veya kişi verisi saklar mı?</mark>

Zoom uygulamaları takvim bilgilerini geçici bellekte (RAM) tutar ve öğeleri yerel diske kaydetmez. Bu, kimlik doğrulama belirteçleri, kimlik bilgileri, takvim etkinlik bilgileri ve kişi verilerini içerir. İstemci kapatıldıktan sonra bu verilere artık erişilemez.

#### <mark style="color:mavi;">Oturum açıldığında ne olur?</mark>

Zoom uygulamaları, yaklaşan etkinlik listesini toplamak için her oturum açmada tam bir yenileme başlatır. Bu, Zoom Web Takvim Hizmeti'nden OAuth erişim belirtecini veya saklanan kimlik bilgilerini almayı ve ardından bu nesneyi kullanarak etkinlik verilerini doğrudan takvim sağlayıcısından yenilemeyi içerir. Erişim belirteci geçersizse, Zoom Web Takvim Hizmeti yenileme belirtecini kullanarak yeni bir erişim belirteci talep eder ve istemciye iletir.

#### <mark style="color:mavi;">İstemci yaklaşan etkinlik listesini yenilemesi gerektiğini nasıl bilir?</mark>

Takvim web portalında takvim bağlandıktan sonra Zoom Web Takvim Hizmeti her kullanıcı için bir takvim sağlayıcısı webhook'una abone olur. Bu webhook'lar Web Takvim Hizmeti'ni herhangi bir değişiklikten haberdar eder, böylece Zoom istemcisini bir güncelleme gerektiği konusunda bilgilendirebilir. Son olarak, Zoom istemcisi doğrudan takvim sağlayıcısından bir güncelleme isteyecektir. Güncelleme bildirimi almayan uygulamalar etkinlik listesini her 30 dakikada bir yeniler.

#### <mark style="color:mavi;">İstemciye hangi toplantı ayrıntıları sunulur?</mark>

Zoom uygulamaları, ayrıştırdığı etkinlikleri temizledikten sonra toplantı verilerini gösterir; bu, kullanmadığı tüm özniteliklerin atıldığı anlamına gelir. Kullanım için saklanan ve atılan etkinlik öznitelikleri aşağıdaki tabloda özetlenmiştir.

| İstemcide Görüntüleme için Saklananlar                                                                                                                                                                                                                                             | Atılan ve Saklanmayanlar                       |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
| <ul><li>Konu</li><li>Katılımcılar</li><li>Açıklama</li><li>Gönderen e-posta adresi\*</li><li>Alıcı/CC/BCC e-posta adresi\*</li><li>Ekler\*</li><li>E-posta gövde içeriği\*</li><li>Tarih ve süre</li><li>Zoom Toplantı URL'si</li><li>Toplantı bir Zoom Odası içeriyorsa</li></ul> | <ul><li>Konum</li><li>Oda Kaynakları</li></ul> |
| \*Yalnızca AI Companion 2.0 tarafından etkinleştirilen etkinlik yakalama durumunda                                                                                                                                                                                                 |                                                |

#### <mark style="color:mavi;">İstemci günlüklerinde herhangi bir takvim verisi saklanıyor mu?</mark>

Zoom uygulamaları belirteçler, kimlik bilgileri veya etkinlikler gibi hassas takvim verilerini hiçbir istemci günlüğüne yazmaz.

### Planlama Araçları

Zoom, Microsoft ve Google ürünleriyle Zoom toplantı planlama deneyimini basitleştirmek için çeşitli araçlar sunar. Bu ürünler, Google Workspace ve Microsoft 365 için yerel planlama entegrasyonlarını veya belirli tarayıcılar ve Outlook ile kullanım için yazılım eklentilerini içerir.

#### <mark style="color:mavi;">Planlama araçları nasıl çalışır?</mark>

Outlook Eklentisi hariç tüm planlama araçları, takvim sağlayıcısına ve Zoom'un Web Takvim Hizmetine doğrudan API isteği gönderir. Outlook Eklentisi, eklentinin adına API isteğini Zoom Web Takvim Hizmeti'ne gönderen Zoom masaüstü istemcisi aracılığıyla bir toplantı planladığı için farklıdır.

#### <mark style="color:mavi;">Bir araçla planlama yaparken Zoom'a hangi bilgiler gönderilir?</mark>

Bir planlama aracı kullanıldığında saklanan tek veri, bir toplantı planlamak için gerekli olan bilgilerdir. Örneğin, bir kullanıcı Microsoft 365 eklentisini kullanarak bir Zoom toplantısı planladığında, eklenti Zoom toplantısını planlamak için etkinlik konusunu, tarihini, saatini, saat dilimini ve yineleme bayrağını kullanır. Zoom eklentisi gövde veya katılımcı listesi gibi ek ayrıntıları talep etmez veya kullanmaz.

#### <mark style="color:mavi;">Herhangi bir güvenlik duvarı veya güvenlik gereksinimi var mı?</mark>

Planlama araçları, takvim entegrasyonları için zaten gerekli olanların ötesinde ek güvenlik duvarı veya güvenlik değişiklikleri gerektirmez. Gereksinimlerin tam listesi şu belgede yer almaktadır: [Zoom için ağ ve güvenlik duvarı kuralları](https://support.zoom.us/hc/en-us/articles/201362683-Network-firewall-or-proxy-server-settings-for-Zoom).

#### <mark style="color:mavi;">Outlook Eklentisi ile Outlook eklentisi arasındaki fark nedir?</mark>

Outlook Eklentisi, son kullanıcının makinesine yüklenir ve kullanıcıların Outlook istemcisi aracılığıyla Zoom toplantıları planlamasına yardımcı olur. Eklenti, Zoom Workplace masaüstü istemcisiyle süreçler arası iletişim kanalı (IPC) aracılığıyla iletişim kurar. Bu IPC'yi kullanarak eklenti, istemcinin kaynakları üzerinden Zoom'un Web Takvim Hizmetine planlamalar gönderir.

Kullanıcılarımıza en iyi deneyimi sunmak ve Apple ile Microsoft tarafından belirlenen politika ve yönergelere uymak için Zoom, Zoom for Outlook eklentisinin dağıtımını ve kullanımını şiddetle tavsiye etmektedir. Eklenti, daha kolay dağıtım ve daha sağlam yönetsel çözümler sunar, Microsoft tarafından aktif olarak desteklenir ve Apple gibi satıcıların yakın zamanda güçlendirdiği güvenlik gereksinimlerini daha iyi karşılar.

{% hint style="danger" %}
**Uyarı**

Zoom for Outlook Eklentisi için yeni özellik iyileştirmeleri uygulanmayacaktır. Zoom for Outlook eklentisine geçiş yapmanız şiddetle tavsiye edilir.
{% endhint %}

Outlook eklentisi, kullanıcı makinelerine yerel kurulum gerektirmeyen web tabanlı bir uygulamadır ve bunun yerine yerel istemcide ve web üzerindeki Outlook'ta kullanılabilen yerleşik bir web uygulaması olarak görünür. Eklenti, Zoom’un Web Takvim Hizmeti ile doğrudan iletişim kuran web API'leri aracılığıyla çalışır.

Eklenti ve eklenti benzer işlevsellik sağlar, ancak eklenti Outlook JavaScript API gereksinim seti v1.8'i gerektirir — bu sürüm yalnızca modern Outlook sürümlerinde vardır ve Exchange Server on-premises için hiç mevcut değildir — Bu şu anlama gelir:

* Outlook eklentisi, yerel Exchange Server ile delege planlama için kullanılamaz.
* Temsilciler, başka bir kullanıcı adına toplantı planlamak için Microsoft 365 Outlook istemcisini, Mac/PC için Outlook 2021 veya sonraki sürümlerini veya Web üzerindeki Outlook'u kullanmalıdır.

#### <mark style="color:mavi;">Resmi Zoom eklenti uygulamasını nasıl tanımlayabilirim?</mark>

Resmi Zoom for Outlook uygulaması şu kaynaktan temin edilebilir: [Microsoft AppSource mağazası](https://appsource.microsoft.com/en-us/product/office/WA104381712?tab=Overview) Entra ID Enterprise Apps dizininize “Zoom-Office-add-in-SSO” adıyla ve uygulama kimliği ce63c970-e2d7-45e6-bee1-80c330b0800b ile yüklenir.

#### <mark style="color:mavi;">Outlook Eklentisini veya eklentiyi güncellemem gerekiyor mu?</mark>

Ocak 2025 itibarıyla Microsoft, eski Exchange Online belirteçlerini Nested app authentication (NAA) ile değiştirmeye başladı. Zoom yöneticileri, Entra yöneticileriyle iş birliği içinde, destek makalesindeki talimatları izleyerek Zoom web portalında NAA'yı yapılandırmalıdır: [Office eklentileri için iç içe uygulama kimlik doğrulamasının yapılandırılması](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0078410).

{% hint style="info" %}
**Not**

Nested app authentication (NAA) yalnızca Exchange Online ile desteklenir. Exchange 2019 (veya diğer yerel Exchange sürümlerini) kullanan kuruluşlar, bu ortamlar engellenmediği için eski Exchange kullanıcı kimlik belirteçleri ve geri arama belirteçlerini kullanmaya devam etmelidir.
{% endhint %}

Aksi takdirde, Zoom for Outlook eklentisi kullanıcı makinelerine yerel kurulum gerektirmeyen web tabanlı bir uygulamadır ve bunun yerine Zoom’un Web Takvim Hizmeti ile iletişim kurmak için web API'leri aracılığıyla çalışan yerleşik bir web uygulaması olarak görünür. Eklenti Windows ve macOS Outlook uygulamaları, Android ve iOS Outlook uygulamaları ve Web üzerindeki Outlook için mevcuttur. Eklenti Outlook yöneticileri tarafından yapılandırılabilir ve toplu dağıtılabilir veya bireysel kullanıcılar tarafından yüklenebilir.

Outlook Eklentisi, zaman zaman güncellemeler ve iyileştirmelere tabi olan yüklü bir yazılım parçası olarak çalışır. Sonuç olarak, eklentinin sürüm yönetimi ve zaman içinde yükseltmeler gereklidir.

{% hint style="info" %}
**Not**

Outlook Eklentisi için iç içe uygulama kimlik doğrulaması gerekli değildir.
{% endhint %}

#### <mark style="color:mavi;">Hangi planlama aracı benim ortamım için en uygunudur?</mark>

**Google Workspace**

Google Workspace kullanan kuruluşlar, Google Workspace Marketplace'ten Zoom for GSuite uygulamasını yükleyerek tüm kullanıcıların Google Takvim üzerinden Zoom Toplantıları planlamasını kolayca etkinleştirebilir. Uygulama merkezi olarak yönetilir ve Zoom’un Google'a sunduğu iyileştirmeler doğrultusunda otomatik olarak güncellenir.

Alternatif olarak, tarayıcı tabanlı uzantılar da kullanım için mevcuttur, ancak genellikle yerel kurulum, periyodik güncellemeler gerektirdikleri ve merkezi olarak yönetilmedikleri için kişisel hesap kullanıcıları için daha uygundur.

**Microsoft**

Microsoft 365 veya yerel Exchange Server kullanan kuruluşlar için en iyi seçenek hem ortamınıza hem de takvim entegrasyonunun nasıl yapılandırıldığına bağlıdır.

Zoom for Outlook eklentisi, masaüstü, web veya mobil Outlook sürümlerini kullanıyor olsanız da Microsoft 365 ortamları için tercih edilen araçtır. Eklenti, Outlook for Microsoft 365, Windows için Outlook 2013 veya sonraki sürümlerini veya Mac için Outlook 2016 veya sonraki sürümlerini gerektirir.

İki Yönlü Takvim Senkronizasyonu, takvim güncellemelerinin sorunsuz olmasını sağlar ve takvimler entegre edildiğinde varsayılan olarak etkinleştirilir. Bu, Zoom'un Outlook takvim etkinliklerinde yapılan yeniden planlanan saatler veya iptaller gibi değişiklikleri otomatik olarak yansıtmasını sağlar ve kullanıcıların eklenti aracılığıyla toplantıları manuel olarak güncellemesi veya kaldırması gerekmez. Bu özellikle önemlidir çünkü bir toplantı 30 günden fazla ileri taşındığında Zoom toplantı bağlantıları değişiklikler yakalanmazsa süresi dolabilir. Toplantı kimlikleri genellikle yinelenen bir dizinin parçası olmadıkça 30 günden sonra süresi dolar.

Etkinliğe dayalı otomasyonları (ör. OnAppointmentSend) güçlendiren modern JavaScript API'si (v1.8), aşağıdaki ortamlar ve uygulamalar tarafından desteklenmez:

* Yerel Exchange ortamları
* M365'ye bağlı klasik Outlook
* iOS ve Android'de Mobil Outlook

Sonuç olarak, Zoom bu kurulumlarda eklenti aracılığıyla toplantıları otomatik olarak algılayamaz veya güncelleyemez. İki Yönlü Senkronizasyon veya API tabanlı otomasyon olmadan, yinelenen toplantılar bile değişiklikleri yansıtmayabilir—bu da süresi dolmuş veya geçersiz Zoom bağlantılarına yol açabilir.

Zoom Outlook Eklentisi yalnızca Windows sistemlerinde desteklenir. Microsoft API sınırlamalarını aşarak Zoom Workplace uygulamasıyla doğrudan entegrasyon yoluyla geliştirilmiş toplantı senkronizasyonu sağlar. Bi-Directional Sync olmayan Windows sistemleri için önerilse de, belirgin kısıtlamaları vardır:

* BT tarafından yönetilen MSI güncellemeleri gerektirir
* Toplantı planlamada daha yavaş
* macOS veya mobil destek yok

### Zoom Odaları

Zoom Odaları takvim entegrasyonu, kullanıcının masaüstü veya mobil istemci entegrasyonundan bağımsız olarak gerçekleştirilir.

Kurulumdan sonra takvim etkinlikleri Zoom Odaları ekranlarında, televizyon ekranları, planlama arayüzleri ve kontrol panelleri dahil olmak üzere görünür. Kullanıcılar oda denetleyicisinde tek dokunuşla toplantı başlatabilir veya katılabilir.

Aşağıdaki adımlar kurulum sürecinin yüksek düzey bir özetidir:

1. Microsoft Exchange Online'ı yapılandırın ve Zoom Odaları posta kutusu ayarları için PowerShell komut dosyalarını güncelleyin
2. Takvim verilerine erişimi etkinleştirmek için Microsoft Graph API izinlerini ayarlayın

Zoom, entegrasyon yöntemi olarak Microsoft Graph API'yi Uygulama İzinleri ile standart entegrasyon yöntemi olarak önermektedir. Bu öneri, Microsoft'un Exchange Web Services (EWS) protokollerini kaldırma planıyla uyumludur. Graph API yöntemi, Zoom Odaları ile Microsoft 365 takvimleri arasında en istikrarlı bağlantıyı sağlar.

{% hint style="info" %}
**Not**

Cisco, Poly ve Lifesize gibi üçüncü taraf konferans odası sistemlerini kullanan kuruluşların, takvim ve toplantı işlevlerinin düzgün çalışmasını sağlamak için Zoom Gelişmiş API Bağlayıcısı aracılığıyla ek adımları tamamlaması gerekir. Zoom Odaları için takvim erişimini yapılandırma hakkında daha fazla bilgi için M365 Takvim Alan Kılavuzu belgemize bakın.
{% endhint %}

#### <mark style="color:mavi;">Oda posta kutularına erişim vermek için hangi yöntemleri kullanabilirim?</mark>

Zoom Odaları takvim entegrasyonu Microsoft Graph API (MGAPI) 'ye dayanır. Microsoft, [Exchange Web Services (EWS) yöntemlerini aşamalı olarak kaldırmaya](https://techcommunity.microsoft.com/blog/exchange/retirement-of-exchange-web-services-in-exchange-online/3924440) başlamıştır; bu yöntemler daha önce Microsoft 365 verilerini Zoom hizmetleriyle bağlamak için kullanılabilirdi. Zoom bu EWS yöntemlerini eski (legacy) seçenekler olarak değerlendirir.

Google Workspace için izin uygulamanın tek bir yöntemi vardır.

#### <mark style="color:mavi;">Hizmet hesabı için hangi izinler gereklidir?</mark>

Belirli izin, seçilen yönteme bağlı olarak değişecektir. Her seçenek ve gereken izinler aşağıdaki tabloda detaylandırılmıştır:

| Sağlayıcı                               | Yöntem                                   | Gerekli İzinler                                                  |
| --------------------------------------- | ---------------------------------------- | ---------------------------------------------------------------- |
| Microsoft 365/Microsoft Exchange Server | Uygulama İzinleri (Microsoft Graph API)  | Yönetici Hesabı: Organization Management ve Recipient Management |
| Microsoft 365/Microsoft Exchange Server | Tam Delege Erişimi (Microsoft Graph API) | Send As Tam Erişim                                               |
| Google Workspace                        | -                                        | Değişiklik yapma ve paylaşımı yönetme                            |

{% hint style="info" %}
**Zoom Önerisi**

Zoom, takvim entegrasyonlarının Uygulama İzinleri yöntemini kullanmasını önerir. Bu yapılandırma daha az yönetici çabası gerektirir ve özel bir hizmet hesabı gerektirmez. Ayrıca arka plan hizmetleri olarak çalışan Kurumsal uygulamalar için Microsoft'un önerdiği yaklaşımdır.
{% endhint %}

### Gelişmiş API Bağlayıcı

Standartlara dayalı H.323 ve SIP oda sistemleri için Gelişmiş API Bağlayıcı (2021 başlarında yayınlandı) aracılığıyla takvim entegrasyonu, kullanıcı istemcisi ve Zoom Odaları yapılandırmasından bağımsız olarak gerçekleştirilir. Hizmet hesabı metodolojisi ve izinler, önceki Zoom Odaları bölümünde ele alındığıyla aynıdır.

#### <mark style="color:mavi;">Gelişmiş API Bağlayıcı veri akışında ne farklıdır?</mark>

Gelişmiş API Bağlayıcı aracılığıyla bağlanan oda sistemleri takvim sağlayıcılarıyla doğrudan iletişim kurmayacaktır; bu durum Zoom istemcisi ve Zoom Odası bağlantı akışlarından farklıdır. Zoom Web Hizmeti bu sistemler için bir istemci görevi görür ve takvim verilerini uç noktalara doğrudan iletecektir; Poly cihazları için bir istisna vardır. Poly cihazları önce takvim güncellemeleri için Zoom Web Hizmetini sorgulayacak, ardından hizmet takvim verilerini cihaza iletecektir.

#### <mark style="color:mavi;">Kaç günlük takvim etkinliği alınır?</mark>

Gelişmiş API Bağlayıcı, önümüzdeki 30 gün için yaklaşan toplantı verilerini alır ve tamamlanan toplantıları saklamadan 30 gün sonra kaldırır.
