คุณสามารถอ้างอิงหลักสูตรโดยใช้ชื่ออื่นได้โดยใช้ชื่อแทนหลักสูตร นามแฝงหลักสูตรใช้เป็นการแมประหว่างตัวระบุหลักสูตร 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