TypeScript typings for Google Classroom API v1

Manages classes, rosters, and invitations in Google Classroom.
For detailed description please check documentation.

Installing

Install typings for Google Classroom API:

``
npm install @types/gapi.client.classroom@v1 --save-dev
`

Usage

You need to initialize Google API client in your code:

`typescript
gapi.load('client', () => {
// now we can use gapi.client
// ...
});
`

Then load api client wrapper:

`typescript
gapi.client.load('classroom', 'v1', () => {
// now we can use gapi.client.classroom
// ...
});
`

Don't forget to authenticate your client before sending any request to resources:

`typescript
// declare client_id registered in Google Developers Console
var client_id = '',
scope = [
// View and manage announcements in Google Classroom
'https://www.googleapis.com/auth/classroom.announcements',

// View announcements in Google Classroom
'https://www.googleapis.com/auth/classroom.announcements.readonly',

// See, edit, create, and permanently delete your Google Classroom classes
'https://www.googleapis.com/auth/classroom.courses',

// View your Google Classroom classes
'https://www.googleapis.com/auth/classroom.courses.readonly',

// See, create and edit coursework items including assignments, questions, and grades
'https://www.googleapis.com/auth/classroom.coursework.me',

// View your course work and grades in Google Classroom
'https://www.googleapis.com/auth/classroom.coursework.me.readonly',

// Manage course work and grades for students in the Google Classroom classes you teach and view the course work and grades for classes you administer
'https://www.googleapis.com/auth/classroom.coursework.students',

// View course work and grades for students in the Google Classroom classes you teach or administer
'https://www.googleapis.com/auth/classroom.coursework.students.readonly',

// See, edit, and create classwork materials in Google Classroom
'https://www.googleapis.com/auth/classroom.courseworkmaterials',

// See all classwork materials for your Google Classroom classes
'https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly',

// View your Google Classroom guardians
'https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly',

// View and manage guardians for students in your Google Classroom classes
'https://www.googleapis.com/auth/classroom.guardianlinks.students',

// View guardians for students in your Google Classroom classes
'https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly',

// View the email addresses of people in your classes
'https://www.googleapis.com/auth/classroom.profile.emails',

// View the profile photos of people in your classes
'https://www.googleapis.com/auth/classroom.profile.photos',

// Receive notifications about your Google Classroom data
'https://www.googleapis.com/auth/classroom.push-notifications',

// Manage your Google Classroom class rosters
'https://www.googleapis.com/auth/classroom.rosters',

// View your Google Classroom class rosters
'https://www.googleapis.com/auth/classroom.rosters.readonly',

// View your course work and grades in Google Classroom
'https://www.googleapis.com/auth/classroom.student-submissions.me.readonly',

// View course work and grades for students in the Google Classroom classes you teach or administer
'https://www.googleapis.com/auth/classroom.student-submissions.students.readonly',

// See, create, and edit topics in Google Classroom
'https://www.googleapis.com/auth/classroom.topics',

// View topics in Google Classroom
'https://www.googleapis.com/auth/classroom.topics.readonly',
],
immediate = true;
// ...

gapi.auth.authorize(
{ client_id: client_id, scope: scope, immediate: immediate },
authResult => {
if (authResult && !authResult.error) {
/ handle successful authorization /
} else {
/ handle authorization error /
}
});
`

After that you can use Google Classroom API resources:

`typescript

/*
Creates a course. The user specified in ownerId is the owner of the created course and added as a teacher. A non-admin requesting user can only create a course with themselves as the owner. Domain admins can create courses owned by any user within their domain. This method returns the following error codes: PERMISSION_DENIED if the requesting user is not permitted to create courses or for access errors. NOT_FOUND if the primary teacher is not a valid user. FAILED_PRECONDITION if the course owner's account is disabled or for the following request errors: UserGroupsMembershipLimitReached * ALREADY_EXISTS if an alias was specified in the id and already exists.
*/
await gapi.client.classroom.courses.create({ });

/*
Deletes a course. This method returns the following error codes: PERMISSION_DENIED if the requesting user is not permitted to delete the requested course or for access errors. NOT_FOUND if no course exists with the requested ID.
*/
await gapi.client.classroom.courses.delete({ id: "id", });

/*
Returns a course. This method returns the following error codes: PERMISSION_DENIED if the requesting user is not permitted to access the requested course or for access errors. NOT_FOUND if no course exists with the requested ID.
*/
await gapi.client.classroom.courses.get({ id: "id", });

/*
Returns a list of courses that the requesting user is permitted to view, restricted to those that match the request. Returned courses are ordered by creation time, with the most recently created coming first. This method returns the following error codes: PERMISSION_DENIED for access errors. INVALID_ARGUMENT if the query argument is malformed. * NOT_FOUND if any users specified in the query arguments do not exist.
*/
await gapi.client.classroom.courses.list({ });

/*
Updates one or more fields in a course. This method returns the following error codes: PERMISSION_DENIED if the requesting user is not permitted to modify the requested course or for access errors. NOT_FOUND if no course exists with the requested ID. INVALID_ARGUMENT if invalid fields are specified in the update mask or if no update mask is supplied. FAILED_PRECONDITION for the following request errors: CourseNotModifiable InactiveCourseOwner
*/
await gapi.client.classroom.courses.patch({ id: "id", });

/*
Updates a course. This method returns the following error codes: PERMISSION_DENIED if the requesting user is not permitted to modify the requested course or for access errors. NOT_FOUND if no course exists with the requested ID. FAILED_PRECONDITION for the following request errors: CourseNotModifiable
*/
await gapi.client.classroom.courses.update({ id: "id", });

/*
Accepts an invitation, removing it and adding the invited user to the teachers or students (as appropriate) of the specified course. Only the invited user may accept an invitation. This method returns the following error codes: PERMISSION_DENIED if the requesting user is not permitted to accept the requested invitation or for access errors. FAILED_PRECONDITION for the following request errors: CourseMemberLimitReached CourseNotModifiable CourseTeacherLimitReached UserGroupsMembershipLimitReached * NOT_FOUND if no invitation exists with the requested ID.
*/
await gapi.client.classroom.invitations.accept({ id: "id", });

/*
Creates an invitation. Only one invitation for a user and course may exist at a time. Delete and re-create an invitation to make changes. This method returns the following error codes: PERMISSION_DENIED if the requesting user is not permitted to create invitations for this course or for access errors. NOT_FOUND if the course or the user does not exist. FAILED_PRECONDITION if the requested user's account is disabled or if the user already has this role or a role with greater permissions. ALREADY_EXISTS if an invitation for the specified user and course already exists.
*/
await gapi.client.classroom.invitations.create({ });

/*
Deletes an invitation. This method returns the following error codes: PERMISSION_DENIED if the requesting user is not permitted to delete the requested invitation or for access errors. NOT_FOUND if no invitation exists with the requested ID.
*/
await gapi.client.classroom.invitations.delete({ id: "id", });

/*
Returns an invitation. This method returns the following error codes: PERMISSION_DENIED if the requesting user is not permitted to view the requested invitation or for access errors. NOT_FOUND if no invitation exists with the requested ID.
*/
await gapi.client.classroom.invitations.get({ id: "id", });

/*
Returns a list of invitations that the requesting user is permitted to view, restricted to those that match the list request. Note: At least one of user_id or course_id must be supplied. Both fields can be supplied. This method returns the following error codes: * PERMISSION_DENIED for access errors.
*/
await gapi.client.classroom.invitations.list({ });

/*
Creates a Registration, causing Classroom to start sending notifications from the provided feed to the destination provided in cloudPubSubTopic. Returns the created Registration. Currently, this will be the same as the argument, but with server-assigned fields such as expiry_time and id filled in. Note that any value specified for the expiry_time or id fields will be ignored. While Classroom may validate the cloudPubSubTopic and return errors on a best effort basis, it is the caller's responsibility to ensure that it exists and that Classroom has permission to publish to it. This method may return the following error codes: PERMISSION_DENIED if: the authenticated user does not have permission to receive notifications from the requested field; or the current user has not granted access to the current Cloud project with the appropriate scope for the requested feed. Note that domain-wide delegation of authority is not currently supported for this purpose. If the request has the appropriate scope, but no grant exists, a Request Errors is returned. another access error is encountered. INVALID_ARGUMENT if: no cloudPubsubTopic is specified, or the specified cloudPubsubTopic is not valid; or no feed is specified, or the specified feed is not valid. NOT_FOUND if: the specified feed cannot be located, or the requesting user does not have permission to determine whether or not it exists; or the specified cloudPubsubTopic cannot be located, or Classroom has not been granted permission to publish to it.
*/
await gapi.client.classroom.registrations.create({ });

/*
Deletes a Registration, causing Classroom to stop sending notifications for that Registration.
*/
await gapi.client.classroom.registrations.delete({ registrationId: "registrationId", });

/*
Returns a user profile. This method returns the following error codes: * PERMISSION_DENIED if the requesting user is not permitted to access this user profile, if no profile exists with the requested ID, or for access errors.
*/
await gapi.client.classroom.userProfiles.get({ userId: "userId", });
``