ตั้งค่าและใช้งาน Canva แอดมิน API

คุณสามารถใช้ Canva Admin API เพื่อทำให้การจัดการองค์กรจากระบบของคุณเองเป็นแบบอัตโนมัติ จัดการผู้ใช้ ทีม กลุ่ม และสมาชิกภาพ รวมถึงเรียกดูเหตุการณ์ในบันทึกการใช้งาน โดยไม่ต้องดำเนินการเหล่านี้ด้วยตนเองใน Canva

• พร้อมให้บริการสำหรับ Canva สำหรับองค์กร, Canva Districts และ Canva สำหรับมหาวิทยาลัย
• แอดมินขององค์กรสามารถเข้าถึงได้
• พร้อมให้บริการสำหรับองค์กรที่มีทีมเดียวและหลายทีม

ก่อนตั้งค่า Admin API โปรดตรวจสอบว่าองค์กรของคุณมีคุณสมบัติตรงตามข้อกำหนดต่อไปนี้:

• ระดับองค์กร: Admin API ใช้ได้ในระดับองค์กร พร้อมให้บริการแก่องค์กรที่มีทีมเดียวและหลายทีมในแพ็กเกจ Canva สำหรับองค์กร, Canva Districts และ Canva สำหรับมหาวิทยาลัย
• บัญชีแอดมินขององค์กร: มีเพียงแอดมินขององค์กรเท่านั้นที่สร้างและจัดการไคลเอ็นต์ Admin API ได้ในการตั้งค่า Canva
• ทีมวิศวกรภายในหรือภายนอกองค์กร: องค์กรของคุณต้องมีทรัพยากรด้านวิศวกรรมเพื่อสร้างและดูแลการผสานการทำงาน Canva ไม่มีบริการช่วยเหลือด้านการติดตั้งใช้งาน
  • หากทีมของคุณไม่สามารถสร้างระบบที่เชื่อมต่อกับ API ได้ การจัดการผู้ใช้ด้วย SCIM จะเหมาะกับการทำให้การจัดการผู้ใช้ในองค์กรของคุณเป็นแบบอัตโนมัติมากกว่า
• คุ้นเคยกับโครงสร้าง Canva ของคุณ: ก่อนสร้างการผสานการทำงาน โปรดทำความเข้าใจให้ชัดเจนว่าองค์กร ทีม และกลุ่มของคุณจัดโครงสร้างไว้อย่างไรใน Canva
• การตรวจสอบสิทธิ์แบบหลายปัจจัย (MFA) หรือบัญชีที่จัดการด้วยการลงชื่อเข้าใช้ครั้งเดียว (SSO): แอดมินขององค์กรที่ตั้งค่า Admin API ต้องเปิดใช้ MFA หรือมีบัญชีที่จัดการด้วย SSO บัญชีดังกล่าวต้องได้รับการจัดการหรือเป็นขององค์กรที่แอดมินดำเนินการแทน

Admin API มี Endpoint สำหรับ:

• ผู้ใช้ ทีม และกลุ่ม: สร้าง ดู อ่าน อัปเดต และลบ
• สมาชิกภาพ: เพิ่มหรือลบผู้ใช้ออกจากทีมและกลุ่ม รวมถึงกำหนดบทบาท
• บันทึกการใช้งาน: เรียกดูเหตุการณ์ในบันทึกการใช้งานตามเวลาที่กำหนด
• คำเชิญเข้าร่วมทีม: เชิญผู้ใช้เข้าร่วมทีม (รวมถึงผู้ใช้ภายนอกองค์กร) ดูคำเชิญที่รอดำเนินการ เรียกดูลิงก์คำเชิญเดิมด้วยอีเมลที่ตรงกันทุกประการ และยกเลิกคำเชิญ

แอดมินขององค์กรสร้างไคลเอ็นต์ Admin API และใช้ไคลเอ็นต์ดังกล่าวเพื่อเรียกใช้ API

ทำตามเอกสารประกอบ Canva Admin API ฉบับนี้ เพื่อแลกเปลี่ยนข้อมูลรับรองไคลเอ็นต์เป็นโทเค็นการเข้าถึงและเริ่มส่งคำขอ API

หากต้องการรายละเอียดทางเทคนิคเกี่ยวกับการตรวจสอบสิทธิ์คำขอ API และการใช้โทเค็นผู้ถือ OAuth 2.0 โปรดแชร์ เอกสารประกอบการตรวจสอบสิทธิ์ Canva Admin API กับทีมวิศวกรของคุณ

ระบบจะบันทึกการดำเนินการผ่าน Admin API ไว้ภายใต้ไคลเอ็นต์ Admin API แทนที่จะบันทึกภายใต้แอดมินแต่ละคนที่เรียกใช้ไคลเอ็นต์

ในบันทึกการใช้งาน ช่อง Actor จะแสดงชื่อและ ID ของไคลเอ็นต์ Admin API ซึ่งช่วยให้คุณระบุได้ว่าการผสานการทำงานใดเป็นผู้ดำเนินการ

คุณยังสามารถระบุแอดมินขององค์กรที่สร้าง อัปเดต หรือลบไคลเอ็นต์ API รายการใดรายการหนึ่งได้

ดูข้อมูลเพิ่มเติมได้ที่ เกี่ยวกับบันทึกการใช้งานของ Canva

แอดมินขององค์กรสามารถใช้ Admin API เพื่อเชิญผู้ใช้เข้าร่วมทีม รวมถึงผู้ร่วมงานภายนอกองค์กร

สิ่งที่ควรทราบ

• คำเชิญแต่ละรายการที่คุณสร้างใช้ได้กับทีมเดียวและที่อยู่อีเมลเดียว
• คุณใช้คำเชิญแต่ละรายการได้ครั้งเดียว และคำเชิญจะ< strong>หมดอายุหลังจาก 30 วัน
• การตั้งค่าของคุณอาจทำให้ Canva ไม่ส่งอีเมลถึงผู้ได้รับเชิญโดยอัตโนมัติ หากจำเป็น ให้แชร์ลิงก์คำเชิญกับผู้ได้รับเชิญโดยตรง
• เก็บลิงก์คำเชิญไว้เป็นส่วนตัว ลิงก์คำเชิญใช้ได้เฉพาะกับที่อยู่อีเมลที่สร้างลิงก์นั้นไว้เท่านั้น
• การตั้งค่าคำเชิญและโดเมนที่มีอยู่ของทีมยังคงมีผลกับผู้ที่คุณเชิญ
• หากมีคำเชิญที่รอดำเนินการสำหรับผู้ได้รับเชิญรายนั้นอยู่แล้ว การสร้างคำเชิญใหม่จะส่งคืนบันทึกคำเชิญรายการเดิม โดยรีเซ็ตวันหมดอายุเป็น 30 วันนับจากวันที่ส่งคำขอ และอัปเดตบทบาทในคำเชิญเป็นบทบาทที่ร้องขอ

ดูรายละเอียด Endpoint ได้ที่ เอกสารประกอบ Canva Admin API

ทั้ง Admin API และ SCIM รองรับการจัดการผู้ใช้ได้

Admin API รองรับการจัดการองค์กร Canva นอกเหนือจากการจัดการผู้ใช้ ซึ่งรวมถึงทีม กลุ่ม สมาชิกภาพ และบันทึกการใช้งาน

SCIM รองรับการจัดการผู้ใช้ตามมาตรฐาน รวมถึงการยกเลิกการจัดการผู้ใช้ หากคุณต้องการเพียงการจัดการผู้ใช้ตามมาตรฐาน หรือทีมของคุณไม่สามารถสร้างการผสานการทำงานกับ API แบบกำหนดเองได้ SCIM จะเหมาะกับความต้องการของคุณมากกว่า

องค์กรของฉันจำเป็นต้องมีนักพัฒนาเพื่อใช้ Admin API หรือไม่

ใช่ องค์กรของคุณต้องมีทรัพยากรด้านวิศวกรรมภายในหรือภายนอกเพื่อสร้างและดูแลการผสานการทำงาน Admin API Canva ไม่มีบริการช่วยเหลือด้านการติดตั้งใช้งาน หากทีมของคุณไม่สามารถสร้างระบบที่เชื่อมต่อกับ API ได้ การจัดการผู้ใช้ด้วย SCIM จะเหมาะกับการทำให้การจัดการผู้ใช้ในองค์กรของคุณเป็นแบบอัตโนมัติมากกว่า

ทุกคนในองค์กรของฉันจำเป็นต้องใช้ MFA หรือ SSO เพื่อใช้ Admin API หรือไม่

ไม่จำเป็น เฉพาะแอดมินขององค์กรที่ตั้งค่า Admin API เท่านั้นที่ต้องเปิดใช้ MFA หรือมีบัญชีที่จัดการด้วย SSO บัญชีดังกล่าวต้องได้รับการจัดการหรือเป็นขององค์กรที่แอดมินดำเนินการแทน สมาชิกคนอื่นๆ ในองค์กรไม่จำเป็นต้องใช้ MFA หรือ SSO เป็นการเฉพาะเพื่อให้ Admin API ทำงานได้

องค์กรของฉันสามารถเชิญผู้ร่วมงานภายนอกโดยใช้ Admin API ได้หรือไม่

ได้ แอดมินขององค์กรสามารถใช้ Admin API เพื่อเชิญผู้ใช้เข้าร่วมทีม รวมถึงผู้ร่วมงานภายนอกองค์กร การตั้งค่าคำเชิญและโดเมนที่มีอยู่ของทีมยังคงมีผลกับผู้ที่คุณเชิญ

เราสามารถเรียกลิงก์คำเชิญเดิมอีกครั้งโดยไม่ต้องสร้างคำเชิญใหม่ได้หรือไม่

ได้ คุณสามารถเรียกลิงก์คำเชิญเดิมได้โดยใช้ที่อยู่อีเมลของผู้ได้รับเชิญที่ตรงกันทุกประการ โดยไม่ต้องสร้างคำเชิญใหม่