شما می توانید دوره ها را با نام دیگری با منبع نام مستعار دوره ارجاع دهید. نام مستعار دوره، نقشهبرداری بین شناسههای دوره Google Classroom و شناسههای دوره خارجی است.
توصیه می کنیم هر زمان که یک دوره از یک SIS ایجاد می کنید یا یک دوره را به یک SIS پیوند می دهید، از شناسه دوره SIS به عنوان نام مستعار دوره استفاده شود. Classroom API به شما امکان می دهد این کار را مستقیماً در ایجاد دوره با تعیین پارامتر id
دوره به عنوان نام مستعار انجام دهید. اگر نام مستعار از قبل وجود داشته باشد، ایجاد دوره با خطای ALREADY_EXISTS (409)
ناموفق خواهد بود. این کار از ایجاد دوره های تکراری در صورت وجود اشکال در برنامه همگام سازی جلوگیری می کند.
نام مستعار در دو نوع وجود دارد: دامنه گسترده و پروژه گسترده.
- نام مستعار در سطح دامنه از پیشوند
d:
و برای هر کسی که از API Classroom استفاده می کند قابل مشاهده است. - نام مستعار در سطح پروژه از پیشوند
p:
و فقط توسط برنامه (پروژه کنسول برنامه نویس) که آنها را ایجاد کرده قابل مشاهده و استفاده هستند.
نام مستعار را می توان در هر جایی از API که یک شناسه دوره را انتظار دارد استفاده کرد. این بدان معناست که هنگامی که یک نام مستعار با استفاده از API ثبت شد، می توان از آن نام مستعار برای خواندن و اصلاح دوره ها و اطلاعات فهرست استفاده کرد.
از منظر همگام سازی SIS، این بدان معنی است که شناسه داخلی SIS برای یک دوره می تواند به عنوان نام مستعار در سراسر دامنه برای دوره ثبت شود. به این ترتیب، هر برنامهنویسی که با SIS و Classroom ادغام میشود، میتواند به سادگی از شناسه SIS برای تعامل با دادههای Classroom استفاده کند.
برای مثال، اگر نام SIS را school
فرض کنیم و شناسه داخلی مورد استفاده توسط SIS برای یک دوره خاص math_101
باشد، میتوانید نام مستعار d:school_math_101
ایجاد کنید.
یک نام مستعار برای یک دوره جدید اضافه کنید
برای افزودن نام مستعار برای یک دوره جدید، هنگام ایجاد درخواست courses.create()
course.id
به نام مستعار مورد نظر تنظیم کنید.
اسکریپت برنامه ها
جاوا
پایتون
یک نام مستعار برای یک دوره موجود اضافه کنید
برای اضافه کردن نام مستعار در یک دوره موجود ، می توانید alias
به نام مستعار مورد نظر تنظیم کنید و از متد courses.aliases.create()
استفاده کنید.
اسکریپت برنامه ها
جاوا
پایتون
بازیابی نام مستعار دوره
می توانید نام مستعار یک دوره را با استفاده از متد courses.aliases.list()
بازیابی کنید، همانطور که در نمونه زیر نشان داده شده است:
دات نت
جاوا
پایتون
شما می توانید دوره ها را با نام دیگری با منبع نام مستعار دوره ارجاع دهید. نام مستعار دوره، نقشهبرداری بین شناسههای دوره Google Classroom و شناسههای دوره خارجی است.
توصیه می کنیم هر زمان که یک دوره از یک SIS ایجاد می کنید یا یک دوره را به یک SIS پیوند می دهید، از شناسه دوره SIS به عنوان نام مستعار دوره استفاده شود. Classroom API به شما امکان می دهد این کار را مستقیماً در ایجاد دوره با تعیین پارامتر id
دوره به عنوان نام مستعار انجام دهید. اگر نام مستعار از قبل وجود داشته باشد، ایجاد دوره با خطای ALREADY_EXISTS (409)
ناموفق خواهد بود. این کار از ایجاد دوره های تکراری در صورت وجود اشکال در برنامه همگام سازی جلوگیری می کند.
نام مستعار در دو نوع وجود دارد: دامنه گسترده و پروژه گسترده.
- نام مستعار در سطح دامنه از پیشوند
d:
و برای هر کسی که از API Classroom استفاده می کند قابل مشاهده است. - نام مستعار در سطح پروژه از پیشوند
p:
و فقط توسط برنامه (پروژه کنسول برنامه نویس) که آنها را ایجاد کرده قابل مشاهده و استفاده هستند.
نام مستعار را می توان در هر جایی از API که یک شناسه دوره را انتظار دارد استفاده کرد. این بدان معناست که هنگامی که یک نام مستعار با استفاده از API ثبت شد، می توان از آن نام مستعار برای خواندن و اصلاح دوره ها و اطلاعات فهرست استفاده کرد.
از منظر همگام سازی SIS، این بدان معنی است که شناسه داخلی SIS برای یک دوره می تواند به عنوان نام مستعار در سراسر دامنه برای دوره ثبت شود. به این ترتیب، هر برنامهنویسی که با SIS و Classroom ادغام میشود، میتواند به سادگی از شناسه SIS برای تعامل با دادههای Classroom استفاده کند.
برای مثال، اگر نام SIS را school
فرض کنیم و شناسه داخلی مورد استفاده توسط SIS برای یک دوره خاص math_101
باشد، میتوانید نام مستعار d:school_math_101
ایجاد کنید.
یک نام مستعار برای یک دوره جدید اضافه کنید
برای افزودن نام مستعار برای یک دوره جدید، هنگام ایجاد درخواست courses.create()
course.id
به نام مستعار مورد نظر تنظیم کنید.
اسکریپت برنامه ها
جاوا
پایتون
یک نام مستعار برای یک دوره موجود اضافه کنید
برای اضافه کردن نام مستعار در یک دوره موجود ، می توانید alias
به نام مستعار مورد نظر تنظیم کنید و از متد courses.aliases.create()
استفاده کنید.
اسکریپت برنامه ها
جاوا
پایتون
بازیابی نام مستعار دوره
می توانید نام مستعار یک دوره را با استفاده از متد courses.aliases.list()
بازیابی کنید، همانطور که در نمونه زیر نشان داده شده است: