REST Resource: courses.aliases

资源:CourseAlias

课程的替代标识符。

别名可唯一标识课程。它在以下某个范围内必须是唯一的:

  • 域:域范围的别名对别名创建者所在域中的所有用户可见,并且只能由域管理员创建。如果课程具有 Google 课堂外部的标识符,则通常会使用网域级别名。

  • 项目:对于使用 Developer Console 项目 ID 创建别名的应用发出的任何请求,均可看到项目级别名,并且该别名可由任何项目创建。当应用具有备用标识符时,通常使用项目级范围的别名。您还可以使用随机值在传输失败时避免重复路线,因为如果前一个请求成功,则重试当前请求将返回 ALREADY_EXISTS

JSON 表示法
{
  "alias": string
}
字段
alias

string

别名字符串。字符串的格式表示所需的别名范围。

  • d:<name> 表示域范围的别名。示例:d:math_101
  • p:<name> 表示项目级别名。示例:p:abc123

此字段的最大长度为 256 个字符。

方法

create

为课程创建别名。

delete

删除课程的别名。

list

返回课程的别名列表。