ตั้งค่าและใช้งาน 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) หรือบัญชีที่จัดการผ่าน Single Sign-On (SSO): แอดมินขององค์กรที่กำหนดค่า Admin API ต้องเปิดใช้ MFA หรือใช้บัญชีที่จัดการผ่าน SSO โดยบัญชีนั้นต้องได้รับการจัดการหรือเป็นขององค์กรที่แอดมินดำเนินการแทน

Admin API มีปลายทางสำหรับดำเนินการต่อไปนี้:

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

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

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

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

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

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

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

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

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

สิ่งที่ควรรู้

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

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

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

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

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

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

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

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

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

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

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

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

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