Assignments Audit Activity Events

This document lists the events and parameters for various types of Assignments Audit activity events. You can retrieve these events by calling Activities.list() with applicationName=assignments.

Course content changes

A type of event where a user makes changes to course work and submissions in a course. Events of this type are returned with type=course_work_update.

Course work published

Event where a user publishes a piece of coursework.

Event details
Event name published_course_work
Parameters
course_id

string

The identifier of a course.

course_title

string

The name of a course.

course_work_title

string

The title of a piece of coursework.

course_work_type

string

The type of a piece of coursework. Possible values:

  • assignment
    Column value indicating that the type of this coursework is an assignment.
post_id

string

The identifier of a piece of coursework.

Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/assignments?eventName=published_course_work&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
{actor} published course work '{course_work_title}' in {course_title}

Submission graded

Event where a user sets the grade for a submission.

Event details
Event name set_grade
Parameters
course_id

string

The identifier of a course.

course_title

string

The name of a course.

course_work_title

string

The title of a piece of coursework.

impacted_users

string

The email of one or more users.

post_id

string

The identifier of a piece of coursework.

Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/assignments?eventName=set_grade&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
{actor} graded submission(s) for course work '{course_work_title}' in {course_title}. New state: {submission_state}

Submission state changed

Event where a user changes the state of a submission.

Event details
Event name changed_submission_state
Parameters
course_id

string

The identifier of a course.

course_title

string

The name of a course.

course_work_title

string

The title of a piece of coursework.

has_grade

boolean

Indicates whether or not a submission has a grade.

impacted_users

string

The email of one or more users.

is_late

boolean

Indicates whether or not a submission is late.

post_id

string

The identifier of a piece of coursework.

submission_state

string

The state of a submission. Possible values:

  • reclaimed_by_student
    Indicates that a submission was reclaimed by a student.
  • returned
    Indicates that the submission state was changed to returned.
  • student_edited_after_turn_in
    Indicates that the student edited their submission after having turned it in.
  • turned_in
    Indicates the submission state was changed to turned in.
Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/assignments?eventName=changed_submission_state&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
{actor} changed the state of submission(s) for course work '{course_work_title}' in {course_title}. New state: {submission_state}

Course membership changes

A type of event including changes to course membership. Events of this type are returned with type=course_membership_change.

User joined course

Event where a user joins a course.

Event details
Event name user_joined_course
Parameters
course_id

string

The identifier of a course.

course_join_method

string

The way a user joined a course (i.e., using a course code or from an invitation).

course_role

string

The role a user plays in a course. Possible values:

  • student
    Indicates that the user is a student.
  • teacher
    Indicates that the user is a teacher.
course_title

string

The name of a course.

Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/assignments?eventName=user_joined_course&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
{actor} joined {course_title} in role: {course_role}

User removed from course

Event where a user removes another user from a course.

Event details
Event name user_removed_from_course
Parameters
course_id

string

The identifier of a course.

course_role

string

The role a user plays in a course. Possible values:

  • student
    Indicates that the user is a student.
  • teacher
    Indicates that the user is a teacher.
course_title

string

The name of a course.

impacted_users

string

The email of one or more users.

Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/assignments?eventName=user_removed_from_course&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
{actor} removed user(s) from {course_title} (previous role: {course_role})

Course updates

A type of event including changes to a course itself. Events of this type are returned with type=course_update.

Course created

Event where a user creates a course.

Event details
Event name created_course
Parameters
course_id

string

The identifier of a course.

course_title

string

The name of a course.

Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/assignments?eventName=created_course&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
{actor} created {course_title}

Course deleted

Event where a user deletes a course.

Event details
Event name deleted_course
Parameters
course_id

string

The identifier of a course.

course_title

string

The name of a course.

Sample request
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/assignments?eventName=deleted_course&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Admin Console message format
{actor} deleted {course_title}