REST Resource: courses.aliases

资源:CourseAlias

课程的备用标识符。

别名用于唯一标识课程。在以下任一范围内,此 ID 都必须是唯一的:

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

  • 项目:项目级别别名对使用创建别名的 Google Developers Console 项目 ID 的应用发出的任何请求都是可见的,并且可以由任何项目创建。当应用具有备用标识符时,通常会使用项目级别的别名。随机值还可用于避免在传输失败时出现重复课程,因为如果之前的请求成功,重试请求将返回 ALREADY_EXISTS

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

string

别名字符串。字符串的格式表示所需的别名作用域。

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

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

方法

create

为课程创建别名。

delete

删除课程的别名。

list

返回课程的别名列表。