คุณสามารถอ้างอิงหลักสูตรด้วยชื่ออื่นโดยใช้ ชื่อแทนของหลักสูตร ซึ่งทำหน้าที่เป็นตัวกลางระหว่างตัวระบุหลักสูตรของ Google Classroom กับตัวระบุหลักสูตรภายนอก เช่น คุณสามารถตั้งค่าชื่อแทนของหลักสูตรให้ตรงกับรหัสหลักสูตรจากระบบข้อมูลของนักเรียนนักศึกษา (SIS)
ชื่อแทนของหลักสูตรมี 2 รูปแบบ ได้แก่ ระดับโดเมนและระดับโปรเจ็กต์
ชื่อแทนระดับโดเมน ใช้คำนำหน้า
d:และทุกคนที่ใช้ Classroom API จะเห็นชื่อแทนนี้ได้ เนมสเปซของโดเมนมีประโยชน์สำหรับการสร้างชื่อแทนที่ผู้ใช้ทุกคนต้องเข้าถึง แต่ไม่ได้เฉพาะเจาะจงสำหรับโปรแกรมใดโปรแกรมหนึ่ง เช่น รายการทางเลือกสำหรับหลักสูตร เช่น MATH 127 และ COMSCI 127 ควรสร้างในเนมสเปซของโดเมน เฉพาะผู้ดูแลโดเมนเท่านั้นที่สร้างชื่อแทนในเนมสเปซของโดเมนได้ แต่ผู้ใช้ทุกคนในโดเมนจะเห็นชื่อแทนดังกล่าวชื่อแทนระดับโปรเจ็กต์ ใช้คำนำหน้า
p:และเฉพาะโปรเจ็กต์ Google Cloud ที่สร้างชื่อแทนเท่านั้นที่จะเห็นและใช้ชื่อแทนนี้ได้ เนมสเปซของโปรเจ็กต์นักพัฒนาแอปมีประโยชน์สำหรับการจัดการชื่อแทนที่เฉพาะเจาะจงกับแอปพลิเคชัน เช่น แอปพลิเคชันที่ใช้ตัวระบุทางเลือกสำหรับหลักสูตรสามารถสร้างชื่อแทนเพื่อจับคู่ตัวระบุของแอปพลิเคชันกับหลักสูตรใน Classroom ได้ ชื่อแทนที่สร้างในเนมสเปซนี้จะเชื่อมโยงกับโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google Cloud ที่เฉพาะเจาะจง ผู้ใช้แอปพลิเคชันทุกคนสามารถสร้างและดูชื่อแทนในเนมสเปซสำหรับโปรเจ็กต์นักพัฒนาแอปของแอปพลิเคชันนั้นได้
คุณสามารถใช้ชื่อแทนของหลักสูตรแทนรหัสหลักสูตรใน Classroom สำหรับปลายทาง Classroom API ใดก็ได้ ซึ่งหมายความว่าคุณสามารถใช้ชื่อแทนเพื่ออ่านและแก้ไขหลักสูตรและข้อมูลบัญชีรายชื่อได้
ใช้ชื่อแทนสำหรับการซิงค์กับระบบข้อมูลของนักเรียน
คุณสามารถลงทะเบียนตัวระบุภายในของ SIS สำหรับหลักสูตรเป็นชื่อแทนระดับโดเมนสำหรับหลักสูตรได้ วิธีนี้จะช่วยให้นักพัฒนาแอปที่ผสานรวมกับทั้ง SIS และ Classroom สามารถใช้ตัวระบุ SIS เพื่อโต้ตอบกับข้อมูล Classroom ได้
หากคุณสร้างหลักสูตรจาก SIS หรือลิงก์หลักสูตรกับ SIS เราขอแนะนำ
ให้ใช้รหัสหลักสูตรของ SIS เป็นชื่อแทนของหลักสูตร เมื่อสร้างหลักสูตรโดยใช้เมธอด courses.create() คุณสามารถระบุชื่อแทนในช่อง
id ของคำขอได้ หากชื่อแทนมีอยู่แล้ว การสร้างหลักสูตรจะล้มเหลวโดยมีข้อผิดพลาด 409 ALREADY_EXISTS ซึ่งจะป้องกันไม่ให้มีการสร้างหลักสูตรที่ซ้ำกันหากมีปัญหาในโปรแกรมซิงค์
ตัวอย่างเช่น หากเราสมมติว่า 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