設定並使用 Canva 管理員 API

你可以使用 Canva 管理員 API，透過自己的系統自動管理組織。管理使用者、團隊、群組和成員資格，並擷取稽核日誌事件，不必在 Canva 手動完成這些工作。

• 適用於 Canva Enterprise、Canva 學區和 Canva 校園版。
• 組織管理員可使用。
• 適用於單一團隊和多團隊組織。

設定管理員 API 之前，請先確認組織符合以下需求：

• 組織層級： 管理員 API 的適用範圍為組織。Canva Enterprise、Canva 學區和 Canva 校園版方案中的單一團隊和多團隊組織皆可使用。
• 組織管理員帳戶： 只有組織管理員可以在 Canva 設定中建立及管理管理員 API 用戶端。
• 內部或外包工程資源：組織需要具備工程資源來建置及維護整合。Canva 不提供導入支援。
  • 如果團隊無法使用 API 進行建置，SCIM 佈建 會更適合用來自動管理組織中的使用者。
• 熟悉 Canva 組織架構：建置整合之前，請先清楚了解組織、團隊和群組在 Canva 中的設定方式。
• 多重要素驗證 (MFA) 或透過單一登入 (SSO) 管理的帳戶： 設定管理員 API 的組織管理員必須啟用 MFA，或使用透過 SSO 管理的帳戶。該帳戶必須由其代表的組織管理或擁有。

管理員 API 提供以下端點：

• 使用者、團隊和群組：建立、讀取、更新及刪除。
• 成員資格：將人員新增至團隊和群組，或從中移除，並設定其角色。
• 稽核日誌：依排程擷取稽核日誌事件。
• 團隊邀請：邀請人員加入團隊（包括組織外部的人員）、檢視待處理的邀請、使用完整電子郵件地址擷取現有邀請連結，以及取消邀請。

組織管理員會建立管理員 API 用戶端，並使用該用戶端呼叫 API。

請依照 Canva Admin API 文件，使用用戶端憑證換取存取權杖，並開始提出 API 要求。

如需 API 要求驗證和使用 OAuth 2.0 持有人權杖的技術細節，請將 Canva Admin API 驗證說明文件分享給工程團隊。

透過管理員 API 執行的動作會記錄在管理員 API 用戶端名下，而非呼叫該用戶端的個別管理員名下。

在稽核日誌中，「操作者」欄位會顯示管理員 API 用戶端名稱和用戶端 ID。這有助於你辨識是哪個整合執行了動作。

你也可以查出建立、更新或刪除特定 API 用戶端的組織管理員。

如需更多資訊，請參閱關於 Canva 稽核日誌。

組織管理員可以使用管理員 API 邀請人員加入團隊，包括組織外部的協作者。

注意事項

• 每個邀請僅適用於一個團隊和一個電子郵件地址。
• 每個邀請只能使用一次，並會在 30 天後到期。
• 視設定而定，Canva 不一定會自動寄送邀請電子郵件給受邀者。如有需要，請直接將邀請連結分享給受邀者。
• 請妥善保管邀請連結。邀請連結僅適用於建立邀請時所指定的電子郵件地址。
• 團隊目前的邀請和網域設定仍適用於你邀請的人員。
• 如果受邀者已有待處理的邀請，建立新邀請時會傳回同一筆邀請記錄，並將到期日重設為提出要求後 30 天，同時將邀請角色更新為要求的角色。

如需端點詳細資訊，請參閱Canva Admin API 說明文件。

管理員 API 和 SCIM 都可用於使用者佈建。

管理員 API 除了使用者佈建，也支援 Canva 組織管理功能，包括團隊、群組、成員資格和稽核日誌。

SCIM 支援標準佈建和取消佈建。如果你只需要標準的使用者佈建，或團隊無法建置自訂 API 整合，SCIM 會更符合需求。

組織需要聘請開發人員才能使用管理員 API 嗎？

需要。組織必須具備內部或外包工程資源，才能建置及維護整合。Canva 不提供導入支援。如果團隊無法使用 API 進行建置，SCIM 佈建會更適合用來自動管理組織中的使用者。

組織中的每個人都需要啟用 MFA 或 SSO，才能使用管理員 API 嗎？

不需要。只有設定管理員 API 的組織管理員必須啟用 MFA，或使用透過 SSO 管理的帳戶。該帳戶必須由其代表的組織管理或擁有。組織中的其他成員不需要特別啟用 MFA 或 SSO，管理員 API 才能運作。

組織可以使用管理員 API 邀請外部協作者嗎？

可以。組織管理員可以使用管理員 API 邀請人員加入團隊，包括外部協作者。團隊目前的邀請和網域設定仍適用於你邀請的人員。

不建立新邀請，也能再次擷取現有邀請連結嗎？

可以。你可以使用受邀者的完整電子郵件地址擷取現有邀請連結，而不必建立新邀請。