คุณอ้างอิงหลักสูตรโดยใช้ชื่ออื่นได้โดยใช้แหล่งข้อมูลของชื่อแทนหลักสูตร ชื่อแทนหลักสูตรคือการจับคู่ระหว่างตัวระบุหลักสูตรของ Google Classroom กับตัวระบุหลักสูตรภายนอก
เราขอแนะนำว่าทุกครั้งที่คุณสร้างหลักสูตรจาก SIS หรือลิงก์หลักสูตรกับ SIS ระบบจะใช้รหัสหลักสูตรของ SIS เป็นชื่อแทนหลักสูตร Classroom API ช่วยให้คุณดำเนินการนี้ได้โดยตรงในการสร้างหลักสูตรโดยการระบุพารามิเตอร์ id
ของหลักสูตรเป็นชื่อแทน หากมีชื่อแทนอยู่แล้ว การสร้างหลักสูตรจะล้มเหลวโดยมีข้อผิดพลาด ALREADY_EXISTS (409)
วิธีนี้จะป้องกันไม่ให้มีการสร้างหลักสูตรซ้ำ
หากมีข้อบกพร่องในโปรแกรมการซิงค์
ชื่อแทนมี 2 เวอร์ชัน ได้แก่ ทั้งโดเมนและทั่วทั้งโปรเจ็กต์
- ชื่อแทนทั้งโดเมนจะใช้คำนำหน้า
d:
และทุกคนที่ใช้ Classroom API จะดูได้ - ชื่อแทนของทั้งโปรเจ็กต์ใช้คํานําหน้า
p:
และมีเพียงแอปพลิเคชัน (โปรเจ็กต์ใน Developer Console) ที่สร้างชื่อแทนนั้นเท่านั้นที่จะมองเห็นและใช้
คุณจะใช้ชื่อแทนที่ใดก็ได้ใน API ที่คาดหวังตัวระบุหลักสูตร ซึ่งหมายความว่าเมื่อลงทะเบียนชื่อแทนด้วย API แล้ว ชื่อแทนนั้นจะใช้เพื่ออ่านและแก้ไขหลักสูตรและบัญชีรายชื่อได้
จากมุมมองการซิงค์ข้อมูล SIS คุณจะลงทะเบียนตัวระบุภายใน SIS สำหรับหลักสูตรเป็นชื่อแทนทั้งโดเมนสำหรับหลักสูตรได้ เพื่อให้นักพัฒนาซอฟต์แวร์ที่ผสานรวมทั้ง SIS และ Classroom สามารถใช้ตัวระบุ SIS เพื่อโต้ตอบกับข้อมูลใน Classroom ได้อย่างง่ายดาย
ตัวอย่างเช่น หากเราถือว่าชื่อ SIS คือ school
และตัวระบุภายในที่ SIS ใช้สําหรับหลักสูตรใดหลักสูตรหนึ่งคือ math_101
คุณจะสร้างชื่อแทนเป็น d:school_math_101
ได้
เพิ่มชื่อแทนให้หลักสูตรใหม่
หากต้องการเพิ่มชื่อแทนสำหรับหลักสูตรใหม่ ให้ตั้งค่า course.id
เป็นชื่อแทนที่ต้องการเมื่อส่งคำขอ courses.create()
Apps Script
Java
Python
เพิ่มชื่อแทนให้หลักสูตรที่มีอยู่
หากต้องการเพิ่มชื่อแทนในหลักสูตรที่มีอยู่ ให้ตั้งค่า alias
เป็นชื่อชื่อแทนที่ต้องการและใช้เมธอด courses.aliases.create()
Apps Script
Java
Python
เรียกข้อมูลชื่อแทนของหลักสูตร
คุณเรียกข้อมูลชื่อแทนของหลักสูตรได้โดยใช้เมธอด courses.aliases.list()
ตามที่แสดงในตัวอย่างต่อไปนี้
.NET
Java
Python