Product: Roster Server
Audience: ClassLink Administrator
Google Classroom integration is available for Roster Server and is set up by adding the Google Classroom app in the Applications page of Roster Server Console. To be able to find the Google Classroom app, you need to toggle the Show Development Apps as shown below.
Note: Please ensure that the Google Classroom app has full permissions.
From the Apps page, find the Google Classroom application you've just added, and click on the Google Classroom Settings
The API Key and Secret are provided by ClassLink itself. In order to obtain them, please contact firstname.lastname@example.org with the subject: "Roster Server - Need API Key and Secret for Google Classroom Application"
Once you have entered the proper Key and Secret, click on the Save Settings button from the bottom right corner. Now you can click the Authenticate button and log into your district's Google Admin account.
If you wish, you can change the values of specific fields by going to Field Mappings tab. These changes will only reflect inside of Google Classroom. Roster Server variables must be encapsulated by percent-signs. (%)
Now click on on the Save Mappings button, then click on Export.
To view the export log/status, click on Open SFTP Logs from the applications page.
Here you will be able to see logs of all your previous exports. To view a log with more details, click on the View button.
After the export is finished, head over to the Management tab where you can see all your synced classes.
If needed, you have the ability to set the status of classes in bulk. This can be done by simply filtering to the classes you need and then clicking Set Bulk Status and choose the status you need.
Clicking on one of the classes in your list, you will be able to see the students and teachers within it. Here you can also Activate/Archive the class.
If a user has any errors, you will be able to view them in the Sync Status column by hovering over ERRORS.
You might also notice two different icons in that column, one is the icon with a "+", and the other with a "-". If you see the "+" icon, this means that the user is present in your Roster Server data but not in Google's data. You can click on Add User to attempt adding that user to Google's data set.
If you see the "-" icon, this means that the user was found in Google's data set but isn't present in your Roster Server data set. You can click Remove User to attempt to remove that user from Google's data set.
As an alternative, to automatically add users found in Roster Server to Google's data and/or remove users found only in Google's data for a certain class, you can click the Sync Enrollments button.
Updated: Oct 2020