google-apis-classroom_v1 0.9.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5be0aea3f892a04f0b7bceddae7642b0c66c4b054e866864d7861a2bd0765a05
-  data.tar.gz: e6e56e760d2a1146fbe270d73b5075986bad8c97257de819a783e8ec4683ff30
+  metadata.gz: ae614f18bab8324ca24702815981a1114dcc38b358ff5234610116416f898c45
+  data.tar.gz: 07d6cbf4b99a041f0718c1efffc61211965c953e127dbacd27319b4490a4a11a
 SHA512:
-  metadata.gz: fb0edbe418d09fdfc5d45633b067a0bd6c255d43c78d81b6f77cbf6c32a810b97033abc58cf6378180bfd082a566b9ad5388253cf2c139cecc0f4d69abbd240b
-  data.tar.gz: 6842f2ef57e945ca1a0f356d55a06be14e406139691426eb4a40e7f535db4debe49a700bc68705e6c4ae7af6818104f8e2910e189a716bd4a375108e0f4e24e4
+  metadata.gz: e3d20b19a2d22a29c25984cab9345f6c9139db3debc7572353941853c842f7e887784242f89f3077b1052f23a525ffca0bd67d2d6783b5f79ee8cdc8fa35d5b3
+  data.tar.gz: 26795c45d77bbce87ef47bc301def0760722645abe582375f51643b2d5941c97528b1b28a3ee4bd489dbb60aa3f8b1de30ecbe667f0d79bfd0186d485194ed94

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Release history for google-apis-classroom_v1
 
+### v0.13.0 (2022-02-15)
+
+* Regenerated from discovery document revision 20220209
+
+### v0.12.0 (2022-02-08)
+
+* Regenerated from discovery document revision 20220202
+
+### v0.11.0 (2022-02-04)
+
+* Regenerated from discovery document revision 20220131
+* Regenerated using generator version 0.4.1
+
+### v0.10.0 (2021-12-14)
+
+* Unspecified changes
+
 ### v0.9.0 (2021-11-03)
 
 * Regenerated from discovery document revision 20211029

data/OVERVIEW.md

@@ -51,7 +51,7 @@ require "google/apis/classroom_v1"
 client = Google::Apis::ClassroomV1::ClassroomService.new
 
 # Authenticate calls
-client.authentication = # ... use the googleauth gem to create credentials
+client.authorization = # ... use the googleauth gem to create credentials
 ```
 
 See the class reference docs for information on the methods you can call from a client.

data/lib/google/apis/classroom_v1/classes.rb

@@ -274,6 +274,12 @@ module Google
         # @return [String]
         attr_accessor :enrollment_code
       
+        # The gradebook settings for a course. See the [help center article](https://
+        # support.google.com/edu/classroom/answer/9184995) for details.
+        # Corresponds to the JSON property `gradebookSettings`
+        # @return [Google::Apis::ClassroomV1::GradebookSettings]
+        attr_accessor :gradebook_settings
+      
         # Whether or not guardian notifications are enabled for this course. Read-only.
         # Corresponds to the JSON property `guardiansEnabled`
         # @return [Boolean]
@@ -350,6 +356,7 @@ module Google
           @description = args[:description] if args.key?(:description)
           @description_heading = args[:description_heading] if args.key?(:description_heading)
           @enrollment_code = args[:enrollment_code] if args.key?(:enrollment_code)
+          @gradebook_settings = args[:gradebook_settings] if args.key?(:gradebook_settings)
           @guardians_enabled = args[:guardians_enabled] if args.key?(:guardians_enabled)
           @id = args[:id] if args.key?(:id)
           @name = args[:name] if args.key?(:name)
@@ -530,10 +537,10 @@ module Google
         # day and time zone are either specified elsewhere or are insignificant. The
         # date is relative to the Gregorian Calendar. This can represent one of the
         # following: * A full date, with non-zero year, month, and day values * A month
-        # and day value, with a zero year, such as an anniversary * A year on its own,
-        # with zero month and day values * A year and month value, with a zero day, such
-        # as a credit card expiration date Related types are google.type.TimeOfDay and `
-        # google.protobuf.Timestamp`.
+        # and day, with a zero year (e.g., an anniversary) * A year on its own, with a
+        # zero month and a zero day * A year and month, with a zero day (e.g., a credit
+        # card expiration date) Related types: * google.type.TimeOfDay * google.type.
+        # DateTime * google.protobuf.Timestamp
         # Corresponds to the JSON property `dueDate`
         # @return [Google::Apis::ClassroomV1::Date]
         attr_accessor :due_date
@@ -545,6 +552,14 @@ module Google
         # @return [Google::Apis::ClassroomV1::TimeOfDay]
         attr_accessor :due_time
       
+        # Details for a grade category in a course. Coursework may have zero or one
+        # grade category, and the category may be used in computing the overall grade.
+        # See the [help center article](https://support.google.com/edu/classroom/answer/
+        # 9184995) for details.
+        # Corresponds to the JSON property `gradeCategory`
+        # @return [Google::Apis::ClassroomV1::GradeCategory]
+        attr_accessor :grade_category
+      
         # Classroom-assigned identifier of this course work, unique per course. Read-
         # only.
         # Corresponds to the JSON property `id`
@@ -628,6 +643,7 @@ module Google
           @description = args[:description] if args.key?(:description)
           @due_date = args[:due_date] if args.key?(:due_date)
           @due_time = args[:due_time] if args.key?(:due_time)
+          @grade_category = args[:grade_category] if args.key?(:grade_category)
           @id = args[:id] if args.key?(:id)
           @individual_students_options = args[:individual_students_options] if args.key?(:individual_students_options)
           @materials = args[:materials] if args.key?(:materials)
@@ -772,10 +788,10 @@ module Google
       # day and time zone are either specified elsewhere or are insignificant. The
       # date is relative to the Gregorian Calendar. This can represent one of the
       # following: * A full date, with non-zero year, month, and day values * A month
-      # and day value, with a zero year, such as an anniversary * A year on its own,
-      # with zero month and day values * A year and month value, with a zero day, such
-      # as a credit card expiration date Related types are google.type.TimeOfDay and `
-      # google.protobuf.Timestamp`.
+      # and day, with a zero year (e.g., an anniversary) * A year on its own, with a
+      # zero month and a zero day * A year and month, with a zero day (e.g., a credit
+      # card expiration date) Related types: * google.type.TimeOfDay * google.type.
+      # DateTime * google.protobuf.Timestamp
       class Date
         include Google::Apis::Core::Hashable
       
@@ -983,6 +999,50 @@ module Google
         end
       end
       
+      # Details for a grade category in a course. Coursework may have zero or one
+      # grade category, and the category may be used in computing the overall grade.
+      # See the [help center article](https://support.google.com/edu/classroom/answer/
+      # 9184995) for details.
+      class GradeCategory
+        include Google::Apis::Core::Hashable
+      
+        # Default value of denominator. Only applicable when grade calculation type is
+        # TOTAL_POINTS.
+        # Corresponds to the JSON property `defaultGradeDenominator`
+        # @return [Fixnum]
+        attr_accessor :default_grade_denominator
+      
+        # ID of the grade category.
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        # Name of the grade category.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # The weight of the category average as part of overall average. A weight of 12.
+        # 34% is represented as 123400 (100% is 1,000,000). The last two digits should
+        # always be zero since we use two decimal precision. Only applicable when grade
+        # calculation type is WEIGHTED_CATEGORIES.
+        # Corresponds to the JSON property `weight`
+        # @return [Fixnum]
+        attr_accessor :weight
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @default_grade_denominator = args[:default_grade_denominator] if args.key?(:default_grade_denominator)
+          @id = args[:id] if args.key?(:id)
+          @name = args[:name] if args.key?(:name)
+          @weight = args[:weight] if args.key?(:weight)
+        end
+      end
+      
       # The history of each grade on this submission.
       class GradeHistory
         include Google::Apis::Core::Hashable
@@ -1026,6 +1086,38 @@ module Google
         end
       end
       
+      # The gradebook settings for a course. See the [help center article](https://
+      # support.google.com/edu/classroom/answer/9184995) for details.
+      class GradebookSettings
+        include Google::Apis::Core::Hashable
+      
+        # Indicates how the overall grade is calculated.
+        # Corresponds to the JSON property `calculationType`
+        # @return [String]
+        attr_accessor :calculation_type
+      
+        # Indicates who can see the overall grade..
+        # Corresponds to the JSON property `displaySetting`
+        # @return [String]
+        attr_accessor :display_setting
+      
+        # Grade categories that are available for coursework in the course.
+        # Corresponds to the JSON property `gradeCategories`
+        # @return [Array<Google::Apis::ClassroomV1::GradeCategory>]
+        attr_accessor :grade_categories
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @calculation_type = args[:calculation_type] if args.key?(:calculation_type)
+          @display_setting = args[:display_setting] if args.key?(:display_setting)
+          @grade_categories = args[:grade_categories] if args.key?(:grade_categories)
+        end
+      end
+      
       # Association between a student and a guardian of that student. The guardian may
       # receive information about the student's course work.
       class Guardian

data/lib/google/apis/classroom_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module ClassroomV1
       # Version of the google-apis-classroom_v1 gem
-      GEM_VERSION = "0.9.0"
+      GEM_VERSION = "0.13.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.4.0"
+      GENERATOR_VERSION = "0.4.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20211029"
+      REVISION = "20220209"
     end
   end
 end

data/lib/google/apis/classroom_v1/representations.rb

@@ -142,12 +142,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GradeCategory
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GradeHistory
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GradebookSettings
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Guardian
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -458,6 +470,8 @@ module Google
           property :description, as: 'description'
           property :description_heading, as: 'descriptionHeading'
           property :enrollment_code, as: 'enrollmentCode'
+          property :gradebook_settings, as: 'gradebookSettings', class: Google::Apis::ClassroomV1::GradebookSettings, decorator: Google::Apis::ClassroomV1::GradebookSettings::Representation
+      
           property :guardians_enabled, as: 'guardiansEnabled'
           property :id, as: 'id'
           property :name, as: 'name'
@@ -524,6 +538,8 @@ module Google
       
           property :due_time, as: 'dueTime', class: Google::Apis::ClassroomV1::TimeOfDay, decorator: Google::Apis::ClassroomV1::TimeOfDay::Representation
       
+          property :grade_category, as: 'gradeCategory', class: Google::Apis::ClassroomV1::GradeCategory, decorator: Google::Apis::ClassroomV1::GradeCategory::Representation
+      
           property :id, as: 'id'
           property :individual_students_options, as: 'individualStudentsOptions', class: Google::Apis::ClassroomV1::IndividualStudentsOptions, decorator: Google::Apis::ClassroomV1::IndividualStudentsOptions::Representation
       
@@ -633,6 +649,16 @@ module Google
         end
       end
       
+      class GradeCategory
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :default_grade_denominator, as: 'defaultGradeDenominator'
+          property :id, as: 'id'
+          property :name, as: 'name'
+          property :weight, as: 'weight'
+        end
+      end
+      
       class GradeHistory
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -644,6 +670,16 @@ module Google
         end
       end
       
+      class GradebookSettings
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :calculation_type, as: 'calculationType'
+          property :display_setting, as: 'displaySetting'
+          collection :grade_categories, as: 'gradeCategories', class: Google::Apis::ClassroomV1::GradeCategory, decorator: Google::Apis::ClassroomV1::GradeCategory::Representation
+      
+        end
+      end
+      
       class Guardian
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/classroom_v1/service.rb

@@ -50,7 +50,9 @@ module Google
         end
         
         # Creates a course. The user specified in `ownerId` is the owner of the created
-        # course and added as a teacher. This method returns the following error codes: *
+        # 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
@@ -1577,12 +1579,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Adds a user as a student of a course. This method returns the following error
-        # codes: * `PERMISSION_DENIED` if the requesting user is not permitted to create
-        # students in this course or for access errors. * `NOT_FOUND` if the requested
-        # course ID does not exist. * `FAILED_PRECONDITION` if the requested user's
-        # account is disabled, for the following request errors: *
-        # CourseMemberLimitReached * CourseNotModifiable *
+        # Adds a user as a student of a course. Domain administrators are permitted to [
+        # directly add](https://developers.google.com/classroom/guides/manage-users)
+        # users within their domain as students to courses within their domain. Students
+        # are permitted to add themselves to a course using an enrollment code. This
+        # method returns the following error codes: * `PERMISSION_DENIED` if the
+        # requesting user is not permitted to create students in this course or for
+        # access errors. * `NOT_FOUND` if the requested course ID does not exist. * `
+        # FAILED_PRECONDITION` if the requested user's account is disabled, for the
+        # following request errors: * CourseMemberLimitReached * CourseNotModifiable *
         # UserGroupsMembershipLimitReached * `ALREADY_EXISTS` if the user is already a
         # student or teacher in the course.
         # @param [String] course_id
@@ -1743,11 +1748,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a teacher of a course. This method returns the following error codes: *
-        # `PERMISSION_DENIED` if the requesting user is not permitted to create
-        # teachers in this course or for access errors. * `NOT_FOUND` if the requested
-        # course ID does not exist. * `FAILED_PRECONDITION` if the requested user's
-        # account is disabled, for the following request errors: *
+        # Creates a teacher of a course. Domain administrators are permitted to [
+        # directly add](https://developers.google.com/classroom/guides/manage-users)
+        # users within their domain as teachers to courses within their domain. Non-
+        # admin users should send an Invitation instead. This method returns the
+        # following error codes: * `PERMISSION_DENIED` if the requesting user is not
+        # permitted to create teachers in this course or for access errors. * `NOT_FOUND`
+        # if the requested course ID does not exist. * `FAILED_PRECONDITION` if the
+        # requested user's account is disabled, for the following request errors: *
         # CourseMemberLimitReached * CourseNotModifiable * CourseTeacherLimitReached *
         # UserGroupsMembershipLimitReached * `ALREADY_EXISTS` if the user is already a
         # teacher or student in the course.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-classroom_v1
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.13.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-11-08 00:00:00.000000000 Z
+date: 2022-02-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-classroom_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-classroom_v1/v0.9.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-classroom_v1/v0.13.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-classroom_v1
 post_install_message: 
 rdoc_options: []
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.17
+rubygems_version: 3.3.5
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Google Classroom API V1