Canva Admin API'yi kurun ve kullanın

Canva Admin API'yi kullanarak kuruluş yönetimini kendi sistemlerinizden otomatikleştirebilirsiniz. Kullanıcıları, ekipleri, grupları ve üyelikleri yönetin; bu işlemleri Canva'da manuel olarak yapmak zorunda kalmadan denetim günlüğü etkinliklerini alın.

• Şirketler İçin Canva, Canva Districts ve Kampüs İçin Canva planlarında kullanılabilir.
• Kuruluş yöneticileri erişebilir.
• Tek ekipli ve çok ekipli kuruluşlarda kullanılabilir.

Admin API'yi ayarlamadan önce kuruluşunuzun aşağıdaki gereksinimleri karşıladığından emin olun:

• Kuruluş düzeyi: Admin API, kuruluş düzeyinde çalışır. Şirketler İçin Canva, Canva Districts ve Kampüs İçin Canva planlarındaki tek ekipli ve çok ekipli kuruluşlarda kullanılabilir.
• Kuruluş yöneticisi hesabı: Canva ayarlarında Admin API istemcilerini yalnızca kuruluş yöneticileri oluşturabilir ve yönetebilir.
• Kurum içi veya dış kaynaklı mühendislik desteği: Kuruluşunuzun entegrasyonu oluşturup sürdürebilecek mühendislik kaynaklarına ihtiyacı vardır. Canva uygulama desteği sağlamaz.
  • Ekibiniz bir API ile entegrasyon geliştiremiyorsa kuruluşunuzdaki kullanıcı yönetimini otomatikleştirmek için SCIM kullanıcı yönetimi daha uygun bir seçenektir.
• Canva yapınıza aşinalık: Entegrasyonunuzu oluşturmadan önce kuruluşunuzun, ekiplerinizin ve gruplarınızın Canva'da nasıl yapılandırıldığını iyice anladığınızdan emin olun.
• Çok Faktörlü Kimlik Doğrulama (MFA) veya Tek Hesapla Oturum Açma (SSO) ile yönetilen hesap: Admin API'yi yapılandıran kuruluş yöneticisinin hesabında MFA etkin olmalı veya hesap SSO ile yönetilmelidir. Hesap, adına işlem yapılan kuruluş tarafından yönetilmeli ya da kuruluşun sahibi olmalıdır.

Admin API şu işlemler için uç noktalar sunar:

• Kullanıcılar, ekipler ve gruplar: Oluşturma, görüntüleme, güncelleme ve silme.
• Üyelikler: Kişileri ekiplere ve gruplara ekleme veya bu birimlerden çıkarma ve rollerini belirleme.
• Denetim günlükleri: Denetim günlüğü etkinliklerini planlı olarak alma.
• Ekip davetleri: Kişileri bir ekibe davet etme (kuruluşunuz dışındaki kişiler de dahil), bekleyen davetleri görüntüleme, e-posta adresini tam olarak belirterek mevcut bir davet bağlantısını alma ve davetleri iptal etme.

Bir kuruluş yöneticisi Admin API istemcisi oluşturur ve API'yi çağırmak için bu istemciyi kullanır.

İstemci kimlik bilgilerinizi erişim token'ıyla değiştirmek ve API istekleri göndermeye başlamak için Canva Admin API belgelerinin talimatlarını izleyin.

API isteklerinin kimliğini doğrulama ve OAuth 2.0 bearer token'larını kullanma hakkındaki teknik ayrıntılar için Canva Admin API kimlik doğrulama belgelerini mühendislik ekibinizle paylaşın.

Admin API üzerinden gerçekleştirilen işlemler, API istemcisini kullanan yönetici yerine Admin API istemcisiyle ilişkilendirilerek kaydedilir.

Denetim günlüklerinde Aktör alanında Admin API istemcisinin adı ve istemci kimliği gösterilir. Böylece hangi entegrasyonun işlem yaptığını belirleyebilirsiniz.

Ayrıca belirli bir API istemcisini oluşturan, güncelleyen veya silen kuruluş yöneticisini de belirleyebilirsiniz.

Daha fazla bilgi için Canva denetim günlükleri hakkında başlıklı makaleye bakın.

Kuruluş yöneticileri, kuruluş dışındaki harici iş ortakları da dahil olmak üzere kişileri bir ekibe davet etmek için Admin API'yi kullanabilir.

Bilmeniz gerekenler

• Oluşturduğunuz her davet, tek bir ekip ve tek bir e-posta adresi için geçerlidir.
• Her daveti bir kez kullanabilirsiniz ve davetin geçerliliği 30 gün sonra sona erer.
• Ayarlarınıza bağlı olarak Canva, davet edilen kişiye otomatik olarak e-posta göndermeyebilir. Gerekirse davet bağlantısını doğrudan davet edilen kişiyle paylaşın.
• Davet bağlantılarını gizli tutun. Bir davet bağlantısı yalnızca oluşturulduğu e-posta adresi için geçerlidir.
• Ekibinizin mevcut davet ve alan adı ayarları, davet ettiğiniz kişiler için de geçerlidir.
• Davet edilen kişi için bekleyen bir davet zaten varsa yeni bir davet oluşturduğunuzda aynı davet kaydı döndürülür. Bu durumda davetin geçerlilik süresi isteğin gönderildiği tarihten itibaren 30 gün olarak yenilenir ve davet edilen kişinin rolü istenen rolle güncellenir.

Uç nokta ayrıntıları için Canva Admin API belgelerine bakın.

Hem Admin API hem de SCIM, kullanıcı yönetimini destekleyebilir.

Admin API, kullanıcı yönetiminin yanı sıra Canva kuruluş yönetimini de destekler. Buna ekipler, gruplar, üyelikler ve denetim günlükleri dahildir.

SCIM, standart kullanıcı yönetimi ve kullanıcı erişiminin kaldırılmasını destekler. Yalnızca standart kullanıcı yönetimine ihtiyacınız varsa veya ekibiniz özel bir API entegrasyonu geliştiremiyorsa SCIM ihtiyaçlarınıza daha uygundur.

Kuruluşumun Admin API'yi kullanmak için bir geliştiriciye ihtiyacı var mı?

Evet. Admin API'yi kullanmak için kuruluşunuzun entegrasyonu oluşturup sürdürebilecek kurum içi veya dış kaynaklı mühendislik kaynaklarına sahip olması gerekir. Canva uygulama desteği sağlamaz. Ekibiniz bir API ile entegrasyon geliştiremiyorsa kuruluşunuzdaki kullanıcı yönetimini otomatikleştirmek için SCIM kullanıcı yönetimi daha uygun bir seçenektir.

Kuruluşumdaki herkesin Admin API'yi kullanmak için MFA veya SSO kullanması gerekiyor mu?

Hayır. Yalnızca Admin API'yi yapılandıran kuruluş yöneticisinin hesabında MFA etkin olmalı veya hesap SSO ile yönetilmelidir. Hesap, adına işlem yapılan kuruluş tarafından yönetilmeli ya da kuruluşun sahibi olmalıdır. Admin API'nin çalışması için kuruluştaki diğer üyelerin MFA veya SSO kullanması gerekmez.

Kuruluşum Admin API'yi kullanarak harici iş ortaklarını davet edebilir mi?

Evet. Kuruluş yöneticileri, harici iş ortakları da dahil olmak üzere kişileri ekiplere davet etmek için Admin API'yi kullanabilir. Ekibinizin mevcut davet ve alan adı ayarları, davet ettiğiniz kişiler için de geçerlidir.

Yeni bir davet oluşturmadan mevcut bir davet bağlantısını tekrar alabilir miyiz?

Evet. Yeni bir davet oluşturmadan, davet edilen kişinin e-posta adresini tam olarak belirterek mevcut davet bağlantısını alabilirsiniz.