Google Classroom-Add-ons sind jetzt allgemein für Entwickler verfügbar. Weitere Informationen finden Sie in der
Dokumentation zu Add-ons.
REST Resource: userProfiles
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ressource: UserProfile
Globale Informationen zu einem Nutzer.
JSON-Darstellung |
{
"id": string,
"name": {
object (Name )
},
"emailAddress": string,
"photoUrl": string,
"permissions": [
{
object (GlobalPermission )
}
],
"verifiedTeacher": boolean
} |
Felder |
id |
string
Kennung des Nutzers. Schreibgeschützt.
|
name |
object (Name )
Name des Nutzers. Schreibgeschützt.
|
emailAddress |
string
E-Mail-Adresse des Nutzers Es muss der Umfang https://www.googleapis.com/auth/classroom.profile.emails angefordert werden, damit dieses Feld im Antworttext ausgefüllt werden kann. Schreibgeschützt.
|
photoUrl |
string
URL des Profilbilds des Nutzers. Es muss der Umfang https://www.googleapis.com/auth/classroom.profile.photos angefordert werden, damit dieses Feld in einem Antworttext ausgefüllt werden kann. Schreibgeschützt.
|
permissions[] |
object (GlobalPermission )
Globale Berechtigungen des Nutzers. Schreibgeschützt.
|
verifiedTeacher |
boolean
Gibt an, ob der Domainadministrator eines Google Workspace for Education-Nutzers ihn ausdrücklich als Lehrkraft bestätigt hat. Dieses Feld ist immer falsch, wenn der Nutzer kein Mitglied einer Google Workspace for Education-Domain ist. Schreibgeschützt
|
Name
Details zum Namen des Nutzers.
JSON-Darstellung |
{
"givenName": string,
"familyName": string,
"fullName": string
} |
Felder |
givenName |
string
Der Vorname des Nutzers. Schreibgeschützt.
|
familyName |
string
Der Nachname des Nutzers. Schreibgeschützt.
|
fullName |
string
Der vollständige Name des Nutzers, der durch Zusammenführen der Werte für den Vornamen und den Nachnamen gebildet wird. Schreibgeschützt.
|
GlobalPermission
Beschreibung der globalen Nutzerberechtigung.
JSON-Darstellung |
{
"permission": enum (Permission )
} |
Felder |
permission |
enum (Permission )
Berechtigungswert.
|
Berechtigung
Mögliche Berechtigungen, die ein Nutzer haben kann.
Enums |
PERMISSION_UNSPECIFIED |
Es wurde keine Berechtigung angegeben. Dieser Wert wird nicht zurückgegeben und ist ungültig. |
CREATE_COURSE |
Der Nutzer ist berechtigt, einen Kurs zu erstellen. |
Methoden |
|
Gibt an, ob ein Nutzer die angegebene Classroom-Funktion verwenden kann. |
|
Gibt ein Nutzerprofil zurück. |
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,["# REST Resource: userProfiles\n\n- [Resource: UserProfile](#UserProfile)\n - [JSON representation](#UserProfile.SCHEMA_REPRESENTATION)\n - [Name](#UserProfile.Name)\n - [JSON representation](#UserProfile.Name.SCHEMA_REPRESENTATION)\n - [GlobalPermission](#UserProfile.GlobalPermission)\n - [JSON representation](#UserProfile.GlobalPermission.SCHEMA_REPRESENTATION)\n - [Permission](#UserProfile.Permission)\n- [Methods](#METHODS_SUMMARY)\n\nResource: UserProfile\n---------------------\n\nGlobal information for a user.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"id\": string, \"name\": { object (/workspace/classroom/reference/rest/v1/userProfiles#UserProfile.Name) }, \"emailAddress\": string, \"photoUrl\": string, \"permissions\": [ { object (/workspace/classroom/reference/rest/v1/userProfiles#UserProfile.GlobalPermission) } ], \"verifiedTeacher\": boolean } ``` |\n\n| Fields ||\n|-------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `id` | `string` Identifier of the user. Read-only. |\n| `name` | `object (`[Name](/workspace/classroom/reference/rest/v1/userProfiles#UserProfile.Name)`)` Name of the user. Read-only. |\n| `emailAddress` | `string` Email address of the user. Must request `https://www.googleapis.com/auth/classroom.profile.emails` scope for this field to be populated in a response body. Read-only. |\n| `photoUrl` | `string` URL of user's profile photo. Must request `https://www.googleapis.com/auth/classroom.profile.photos` scope for this field to be populated in a response body. Read-only. |\n| `permissions[]` | `object (`[GlobalPermission](/workspace/classroom/reference/rest/v1/userProfiles#UserProfile.GlobalPermission)`)` Global permissions of the user. Read-only. |\n| `verifiedTeacher` | `boolean` Represents whether a Google Workspace for Education user's domain administrator has explicitly verified them as being a teacher. This field is always false if the user is not a member of a Google Workspace for Education domain. Read-only |\n\n### Name\n\nDetails of the user's name.\n\n| JSON representation |\n|---------------------------------------------------------------------------|\n| ``` { \"givenName\": string, \"familyName\": string, \"fullName\": string } ``` |\n\n| Fields ||\n|--------------|--------------------------------------------------------------------------------------------------|\n| `givenName` | `string` The user's first name. Read-only. |\n| `familyName` | `string` The user's last name. Read-only. |\n| `fullName` | `string` The user's full name formed by concatenating the first and last name values. Read-only. |\n\n### GlobalPermission\n\nGlobal user permission description.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------|\n| ``` { \"permission\": enum (/workspace/classroom/reference/rest/v1/userProfiles#UserProfile.Permission) } ``` |\n\n| Fields ||\n|--------------|-----------------------------------------------------------------------------------------------------------------------|\n| `permission` | `enum (`[Permission](/workspace/classroom/reference/rest/v1/userProfiles#UserProfile.Permission)`)` Permission value. |\n\n### Permission\n\nPossible permissions that a user may have.\n\n| Enums ||\n|--------------------------|----------------------------------------------------------------------------|\n| `PERMISSION_UNSPECIFIED` | No permission is specified. This is not returned and is not a valid value. |\n| `CREATE_COURSE` | User is permitted to create a course. |\n\n| Methods ------- ||\n|----------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### [checkUserCapability](/workspace/classroom/reference/rest/v1/userProfiles/checkUserCapability) | | **Developer Preview:** Available as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), which grants early access to certain features. This feature is available in [V1_20240930_PREVIEW](https://developers.google.com/workspace/classroom/reference/rest/v1/PreviewVersion) and later. See [Access Preview APIs](https://developers.google.com/workspace/classroom/reference/preview) to learn more. Returns whether a user may use the specified Classroom capability. |\n| ### [get](/workspace/classroom/reference/rest/v1/userProfiles/get) | Returns a user profile. |"]]