Alexa.Education.Profile.Student Interface
Implement the Alexa.Education.Profile.Student interface in your Alexa education skill to provide a list of student profiles that are associated with the linked user account. For more information about education skills, see About Alexa Education Skills.
All education skills must support the Profile.Student interface. Student profiles must contain the name and a unique identifier for each student profile. You can use the identifier to query for grades, assignments or announcements when you use the other Alexa.Education interfaces.
For the list of languages that the Profile.Student interface supports, see List of Alexa Interfaces and Supported Languages.
Utterances
There are no utterances associated with this interface.
Request
The Get request queries a list of student profiles associated with the linked user account.
The payload of the Get request contains the following fields.
| Field | Description | Type |
|---|---|---|
|
|
Pagination information |
|
|
|
Locale that identifies the user's language |
|
The following is an example of a Get request.
{
"request": {
"header": {
"namespace": "Alexa.Education.Profile.Student",
"name": "Get",
"messageId": "ExampleMessageID",
"interfaceVersion": "1.0"
},
"authorization": {
"type": "BearerToken",
"token": "ExampleBearerToken"
},
"payload": {
"paginationContext": {
"maxResults": 5,
"nextToken": "ExampleNextToken"
},
"locale": "en-US"
}
}
}
Response
If you handle a Get request successfully, respond with a GetResponse object.
The payload of a GetResponse object contains the following fields.
| Field | Description | Type | Required |
|---|---|---|---|
|
|
Pagination information |
|
No |
|
|
The results of the query |
Array of |
Yes |
The following is an example of GetResponse.
{
"response": {
"header": {
"namespace": "Alexa.Education.Profile.Student",
"name": "GetResponse",
"messageId": "ExampleMessageID",
"interfaceVersion": "1.0"
},
"payload": {
"paginationContext": {
"totalCount": 2
},
"studentProfiles": [
{
"id": "student_001",
"accountRelationType": "GUARDIAN",
"name": {
"full": "John Doe",
"given": "John",
"family": "Doe",
"nicknames": [
"Johnny"
]
}
},
{
"id": "student_002",
"accountRelationType": "GUARDIAN",
"name": {
"full": "Jane Doe",
"given": "Jane",
"family": "Doe"
}
}
]
}
}
}
