אפשר להפנות לקורסים בשם אחר באמצעות כינוי לקורס. כינויים של קורסים יכולים לשמש כמיפוי בין מזהי קורסים ב-Google Classroom למזהי קורסים חיצוניים. לדוגמה, אפשר להגדיר כינוי לקורס כך שיתאים למזהה הקורס ממערכת לניהול מידע על תלמידים (SIS).
יש שתי צורות של כתובת האימייל החלופית של הקורס: ברמת הדומיין וברמת הפרויקט.
כינויים ברמת הדומיין כוללים את הקידומת
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