Delete Playback Viewable Users
This is an LMS classroom activity API used to remove users who can view the client-side playback for a classroom activity.
Notes
- The following general logic applies to playback viewing permission settings:
- Only classroom activities are supported, and settings can only be configured after the class ends (via both API and backend).
- Default users = lesson instructor + lesson co-instructor + lesson students (including transfer students) + other teachers in the class + class head teacher
- Selectable users = lesson instructor + lesson co-instructor + lesson students + other teachers in the class + head teacher - transferred out students
- Based on the above rules, if a student was configured not to view historical recordings when joining the class, they will be treated as a transferred-out student for historical lessons. As a result, they cannot be added to the playback viewer list for those lessons.
- For compatibility, the API supports either activityId or classId, but it is strongly recommended to use activityId.
- About this API -- Delete Playback Viewable Users
- When deleting viewable users, each user has a separate return code in the data field.
- If a user being deleted is not in the viewable list, no error will be returned; the user will be returned in the success list and processed normally.
- To set all selectable users as viewable, use the Set Playback All Viewable API.
- To set all selectable users as non-viewable, use the Set Playback All Forbidden API.
URL
https://root_url/playback/deletePlaybackUser
HTTP Request Methods
Request Parameters
| key |
Required |
Type |
Description |
| X-EEO-SIGN |
Yes |
string |
Signature. Rules can be found here |
| X-EEO-UID |
Yes |
string |
Institution SID |
| X-EEO-TS |
Yes |
string |
Timestamp |
Body Parameters
| key |
Required |
Type |
Description |
Rules |
| courseId |
Yes |
integer |
Class (Course) ID |
|
| activityId |
No |
integer |
Classroom Activity ID |
Choose one with classId; activityId is preferred if available |
| classId |
No |
integer |
Class Session ID |
Choose one with activityId; activityId is preferred if available |
| uidList |
Yes |
array[string] |
Student UID array |
Response Parameters
| Parameter |
Type |
Example |
Description |
| code |
integer |
1 |
Error code |
| msg |
string |
"Success" |
Error message |
| data |
object |
null |
Response data |
| └ successList |
array[int] |
|
UIDs successfully deleted |
| └ failedList |
array[object] |
|
Failed user information |
| └ uid |
int |
|
User UID |
| └ code |
int |
|
Error code |
| └ msg |
string |
|
Error message |
Examples
POST /playback/deletePlaybackUser HTTP/1.1
root_url
ceb7a2c0534999960c02c191d409c41e
409864
1722938382
application/json
117
{
"courseId": 414193,
"activityId": 25096097,
"uidList": [
504026,
504028
]
}
curl -X POST \
-H 'Host: root_url' \
-H 'X-EEO-SIGN: ceb7a2c0534999960c02c191d409c41e' \
-H 'X-EEO-UID: 409864' \
-H 'X-EEO-TS: 1722938382' \
-H 'Content-Type: application/json' \
-d '{"courseId": 414193, "activityId": 25096097, "uidList": [504026, 504028]}' \
'https://root_url/playback/deletePlaybackUser'
Response Example (Normal JSON Response)
{
"code": 1,
"msg": "Success",
"data": {
"successList": [504026,504028],
"failedList": []
}
}
Error Codes
| Error Code |
Description |
| 147 |
No such course information |
| 29149 |
Activity has been deleted |
| 30002 |
Activity does not exist |
| 101002005 |
Signature exception |
| 101002006 |
Timestamp expired |
| 101002008 |
Timestamp does not exist |
| 121601020 |
Business parameter error |
| 121601021 |
Course does not belong to current institution |
| 121601022 |
Course is not a standard course |
| 121601023 |
Course has expired |
| 121609004 |
Class session does not exist or does not belong to the institution |
| 121609005 |
Class session has not ended |
| 121609006 |
Class session recording is not enabled |
| 121609007 |
Account has been set to not viewable |