Google Classroom-Add-ons sind jetzt allgemein für Entwickler verfügbar. Weitere Informationen finden Sie in der
Dokumentation zu Add-ons.
Method: courses.aliases.create
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Erstellt einen Alias für einen Kurs.
Diese Methode gibt die folgenden Fehlercodes zurück:
PERMISSION_DENIED, wenn der anfragende Nutzer nicht berechtigt ist, den Alias zu erstellen, oder bei Zugriffsfehlern.NOT_FOUND, wenn der Kurs nicht vorhanden ist.ALREADY_EXISTS, wenn der Alias bereits vorhanden ist.FAILED_PRECONDITION, wenn der angeforderte Alias für den anfragenden Nutzer oder Kurs keinen Sinn ergibt (z. B. wenn ein Nutzer, der nicht zu einer Domain gehört, versucht, auf einen Alias auf Domainebene zuzugreifen).
HTTP-Anfrage
POST https://classroom.googleapis.com/v1/courses/{courseId}/aliases
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
courseId |
string
Kennung des Kurses, für den ein Alias erstellt werden soll. Diese Kennung kann entweder die in Classroom zugewiesene Kennung oder eine alias sein.
|
Anfragetext
Der Anfragetext enthält eine Instanz von CourseAlias.
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von CourseAlias.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/classroom.courses
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[],[],null,["# Method: courses.aliases.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates an alias for a course.\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` if the requesting user is not permitted to create the alias or for [access errors](/workspace/classroom/reference/Access.Errors).\n- `NOT_FOUND` if the course does not exist.\n- `ALREADY_EXISTS` if the alias already exists.\n- `FAILED_PRECONDITION` if the alias requested does not make sense for the requesting user or course (for example, if a user not in a domain attempts to access a domain-scoped alias).\n\n### HTTP request\n\n`POST https://classroom.googleapis.com/v1/courses/{courseId}/aliases`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `courseId` | `string` Identifier of the course to alias. This identifier can be either the Classroom-assigned identifier or an [alias](/workspace/classroom/reference/rest/v1/courses.aliases#CourseAlias). |\n\n### Request body\n\nThe request body contains an instance of [CourseAlias](/workspace/classroom/reference/rest/v1/courses.aliases#CourseAlias).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [CourseAlias](/workspace/classroom/reference/rest/v1/courses.aliases#CourseAlias).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.courses`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
