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 yapmadan 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 kurmadan önce kuruluşunuzun şu gereksinimleri karşıladığından emin olun:

• Kuruluş katmanı: Admin API kuruluş kapsamındadı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ürmek için mühendislik kaynaklarına ihtiyacı vardır. Canva uygulama desteği sağlamaz.
  • Ekibiniz bir API'yle çalışacak çözümü geliştiremiyorsa kuruluşunuzdaki kullanıcı yönetimini otomatikleştirmek için SCIM kullanıcı yönetimi daha uygundur.
• 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ı net bir şekilde 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 MFA'sı etkin olmalı veya hesabı SSO ile yönetilmelidir. Hesap, adına işlem yaptığı kuruluş tarafından yönetilmeli ya da bu kuruluşa ait olmalıdır.

Admin API şu uç noktaları sağlar:

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

Kuruluş yöneticisi bir 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 belgelerini izleyin.

API isteklerinin kimliğini doğrulama ve OAuth 2.0 bearer token'larını kullanma hakkında 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'yi kullanan yöneticiye değil Admin API istemcisine kaydedilir.

Denetim günlüklerindeki Actor 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 sayfasına bakın.

Kuruluş yöneticileri, kuruluşunuz 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 süresi 30 gün sonra dolar.
• 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 bu 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 çalışır.
• 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 süresi, istek tarihinden itibaren 30 gün olacak şekilde sıfırlanır ve davetin rolü istenen rolle güncellenir.

Uç noktalarla ilgili 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 ötesinde 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şimini kaldırma işlemlerini 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 için kuruluşunuzun entegrasyonu oluşturup sürdürmek üzere kurum içi veya dış kaynaklı mühendislik kaynaklarına sahip olması gerekir. Canva uygulama desteği sağlamaz. Ekibiniz bir API'yle çalışacak çözümü geliştiremiyorsa kuruluşunuzdaki kullanıcı yönetimini otomatikleştirmek için SCIM kullanıcı yönetimi daha uygundur.

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 MFA'sı etkin olmalı veya hesabı SSO ile yönetilmelidir. Hesap, adına işlem yaptığı kuruluş tarafından yönetilmeli ya da bu kuruluşa ait olmalıdır. Admin API'nin çalışması için kuruluştaki diğer üyelerin özellikle 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.