feat: Automated regeneration of classroom v1 client (googleapis#22368)

Auto-created at 2025-04-06 09:59:57 +0000 using the toys pull request generator.

Author: yoshi-code-bot

api_names_out.yaml

@@ -58835,6 +58835,7 @@
 "/classroom:v1/CourseWork/dueDate": due_date
 "/classroom:v1/CourseWork/dueTime": due_time
 "/classroom:v1/CourseWork/gradeCategory": grade_category
+"/classroom:v1/CourseWork/gradingPeriodId": grading_period_id
 "/classroom:v1/CourseWork/id": id
 "/classroom:v1/CourseWork/individualStudentsOptions": individual_students_options
 "/classroom:v1/CourseWork/materials": materials
@@ -58915,6 +58916,15 @@
 "/classroom:v1/GradebookSettings/displaySetting": display_setting
 "/classroom:v1/GradebookSettings/gradeCategories": grade_categories
 "/classroom:v1/GradebookSettings/gradeCategories/grade_category": grade_category
+"/classroom:v1/GradingPeriod": grading_period
+"/classroom:v1/GradingPeriod/endDate": end_date
+"/classroom:v1/GradingPeriod/id": id
+"/classroom:v1/GradingPeriod/startDate": start_date
+"/classroom:v1/GradingPeriod/title": title
+"/classroom:v1/GradingPeriodSettings": grading_period_settings
+"/classroom:v1/GradingPeriodSettings/applyToExistingCoursework": apply_to_existing_coursework
+"/classroom:v1/GradingPeriodSettings/gradingPeriods": grading_periods
+"/classroom:v1/GradingPeriodSettings/gradingPeriods/grading_period": grading_period
 "/classroom:v1/Guardian": guardian
 "/classroom:v1/Guardian/guardianId": guardian_id
 "/classroom:v1/Guardian/guardianProfile": guardian_profile
@@ -59365,6 +59375,8 @@
 "/classroom:v1/classroom.courses.delete/id": id
 "/classroom:v1/classroom.courses.get": get_course
 "/classroom:v1/classroom.courses.get/id": id
+"/classroom:v1/classroom.courses.getGradingPeriodSettings": get_course_grading_period_settings
+"/classroom:v1/classroom.courses.getGradingPeriodSettings/courseId": course_id
 "/classroom:v1/classroom.courses.list": list_courses
 "/classroom:v1/classroom.courses.list/courseStates": course_states
 "/classroom:v1/classroom.courses.list/pageSize": page_size
@@ -59463,6 +59475,9 @@
 "/classroom:v1/classroom.courses.topics.patch/updateMask": update_mask
 "/classroom:v1/classroom.courses.update": update_course
 "/classroom:v1/classroom.courses.update/id": id
+"/classroom:v1/classroom.courses.updateGradingPeriodSettings": update_course_grading_period_settings
+"/classroom:v1/classroom.courses.updateGradingPeriodSettings/courseId": course_id
+"/classroom:v1/classroom.courses.updateGradingPeriodSettings/updateMask": update_mask
 "/classroom:v1/classroom.invitations.accept": accept_invitation
 "/classroom:v1/classroom.invitations.accept/id": id
 "/classroom:v1/classroom.invitations.create": create_invitation

generated/google-apis-classroom_v1/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-classroom_v1
 
+### v0.41.0 (2025-04-06)
+
+* Regenerated from discovery document revision 20250331
+
 ### v0.40.0 (2025-03-09)
 
 * Regenerated from discovery document revision 20250303

generated/google-apis-classroom_v1/lib/google/apis/classroom_v1/classes.rb

@@ -781,6 +781,15 @@ class CourseWork
         # @return [Google::Apis::ClassroomV1::GradeCategory]
         attr_accessor :grade_category
 
+        # Identifier of the grading period associated with the coursework. * At creation,
+        # if unspecified, the grading period ID will be set based on the `dueDate` (or `
+        # scheduledTime` if no `dueDate` is set). * To indicate no association to any
+        # grading period, set this field to an empty string (""). * If specified, it
+        # must match an existing grading period ID in the course.
+        # Corresponds to the JSON property `gradingPeriodId`
+        # @return [String]
+        attr_accessor :grading_period_id
+      
         # Classroom-assigned identifier of this course work, unique per course. Read-
         # only.
         # Corresponds to the JSON property `id`
@@ -865,6 +874,7 @@ def update!(**args)
           @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)
+          @grading_period_id = args[:grading_period_id] if args.key?(:grading_period_id)
           @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)
@@ -1396,6 +1406,93 @@ def update!(**args)
         end
       end
 
+      # An individual grading period. Grading periods must not have overlapping date
+      # ranges and must be listed in chronological order. For example, if the end_date
+      # of a grading period is 2024-01-25, then the start_date of the next grading
+      # period must be 2024-01-26 or later. Each grading period must have a unique
+      # title within a course.
+      class GradingPeriod
+        include Google::Apis::Core::Hashable
+      
+        # Represents a whole or partial calendar date, such as a birthday. The time of
+        # 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, with a zero year (for example, an anniversary). * A year on its own,
+        # with a zero month and a zero day. * A year and month, with a zero day (for
+        # example, a credit card expiration date). Related types: * google.type.
+        # TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
+        # Corresponds to the JSON property `endDate`
+        # @return [Google::Apis::ClassroomV1::Date]
+        attr_accessor :end_date
+      
+        # Output only. System generated grading period ID. Read-only.
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        # Represents a whole or partial calendar date, such as a birthday. The time of
+        # 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, with a zero year (for example, an anniversary). * A year on its own,
+        # with a zero month and a zero day. * A year and month, with a zero day (for
+        # example, a credit card expiration date). Related types: * google.type.
+        # TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
+        # Corresponds to the JSON property `startDate`
+        # @return [Google::Apis::ClassroomV1::Date]
+        attr_accessor :start_date
+      
+        # Required. Title of the grading period. For example, “Semester 1”.
+        # Corresponds to the JSON property `title`
+        # @return [String]
+        attr_accessor :title
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @end_date = args[:end_date] if args.key?(:end_date)
+          @id = args[:id] if args.key?(:id)
+          @start_date = args[:start_date] if args.key?(:start_date)
+          @title = args[:title] if args.key?(:title)
+        end
+      end
+      
+      # Grading period settings that include all the individual grading periods in a
+      # course.
+      class GradingPeriodSettings
+        include Google::Apis::Core::Hashable
+      
+        # Supports toggling the application of grading periods on existing stream items.
+        # Once set, this value is persisted meaning that it does not need to be set in
+        # every request to update `GradingPeriodSettings`. If not previously set, the
+        # default is False.
+        # Corresponds to the JSON property `applyToExistingCoursework`
+        # @return [Boolean]
+        attr_accessor :apply_to_existing_coursework
+        alias_method :apply_to_existing_coursework?, :apply_to_existing_coursework
+      
+        # The list of grading periods in a specific course. Grading periods must not
+        # have overlapping date ranges and must be listed in chronological order. Each
+        # grading period must have a unique title within a course.
+        # Corresponds to the JSON property `gradingPeriods`
+        # @return [Array<Google::Apis::ClassroomV1::GradingPeriod>]
+        attr_accessor :grading_periods
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @apply_to_existing_coursework = args[:apply_to_existing_coursework] if args.key?(:apply_to_existing_coursework)
+          @grading_periods = args[:grading_periods] if args.key?(:grading_periods)
+        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

generated/google-apis-classroom_v1/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.40.0"
+      GEM_VERSION = "0.41.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.16.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20250303"
+      REVISION = "20250331"
     end
   end
 end

generated/google-apis-classroom_v1/lib/google/apis/classroom_v1/representations.rb

@@ -196,6 +196,18 @@ class Representation < Google::Apis::Core::JsonRepresentation; end
         include Google::Apis::Core::JsonObjectSupport
       end
 
+      class GradingPeriod
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GradingPeriodSettings
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Guardian
         class Representation < Google::Apis::Core::JsonRepresentation; end
 
@@ -674,6 +686,7 @@ class Representation < Google::Apis::Core::JsonRepresentation
 
           property :grade_category, as: 'gradeCategory', class: Google::Apis::ClassroomV1::GradeCategory, decorator: Google::Apis::ClassroomV1::GradeCategory::Representation
 
+          property :grading_period_id, as: 'gradingPeriodId'
           property :id, as: 'id'
           property :individual_students_options, as: 'individualStudentsOptions', class: Google::Apis::ClassroomV1::IndividualStudentsOptions, decorator: Google::Apis::ClassroomV1::IndividualStudentsOptions::Representation
 
@@ -832,6 +845,27 @@ class Representation < Google::Apis::Core::JsonRepresentation
         end
       end
 
+      class GradingPeriod
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :end_date, as: 'endDate', class: Google::Apis::ClassroomV1::Date, decorator: Google::Apis::ClassroomV1::Date::Representation
+      
+          property :id, as: 'id'
+          property :start_date, as: 'startDate', class: Google::Apis::ClassroomV1::Date, decorator: Google::Apis::ClassroomV1::Date::Representation
+      
+          property :title, as: 'title'
+        end
+      end
+      
+      class GradingPeriodSettings
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :apply_to_existing_coursework, as: 'applyToExistingCoursework'
+          collection :grading_periods, as: 'gradingPeriods', class: Google::Apis::ClassroomV1::GradingPeriod, decorator: Google::Apis::ClassroomV1::GradingPeriod::Representation
+      
+        end
+      end
+      
       class Guardian
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

generated/google-apis-classroom_v1/lib/google/apis/classroom_v1/service.rb

@@ -158,6 +158,39 @@ def get_course(id, fields: nil, quota_user: nil, options: nil, &block)
           execute_or_queue_command(command, &block)
         end
 
+        # Returns the grading period settings in a course. This method returns the
+        # following error codes: * `PERMISSION_DENIED` if the requesting user isn't
+        # permitted to access the grading period settings in the requested course or for
+        # access errors. * `NOT_FOUND` if the requested course does not exist.
+        # @param [String] course_id
+        #   Required. The identifier of the course.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ClassroomV1::GradingPeriodSettings] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ClassroomV1::GradingPeriodSettings]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_course_grading_period_settings(course_id, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/courses/{courseId}/gradingPeriodSettings', options)
+          command.response_representation = Google::Apis::ClassroomV1::GradingPeriodSettings::Representation
+          command.response_class = Google::Apis::ClassroomV1::GradingPeriodSettings
+          command.params['courseId'] = course_id unless course_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # 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
@@ -303,6 +336,59 @@ def update_course(id, course_object = nil, fields: nil, quota_user: nil, options
           execute_or_queue_command(command, &block)
         end
 
+        # Updates grading period settings of a course. Individual grading periods can be
+        # added, removed, or modified using this method. The requesting user and course
+        # owner must be eligible to modify Grading Periods. For details, see [licensing
+        # requirements](https://developers.google.com/classroom/grading-periods/manage-
+        # grading-periods#licensing_requirements). This method returns the following
+        # error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to
+        # modify the grading period settings in a course or for access errors: *
+        # UserIneligibleToUpdateGradingPeriodSettings * `INVALID_ARGUMENT` if the
+        # request is malformed. * `NOT_FOUND` if the requested course does not exist.
+        # @param [String] course_id
+        #   Required. The identifier of the course.
+        # @param [Google::Apis::ClassroomV1::GradingPeriodSettings] grading_period_settings_object
+        # @param [String] update_mask
+        #   Mask that identifies which fields in the GradingPeriodSettings to update. The
+        #   GradingPeriodSettings `grading_periods` list will be fully replaced by the
+        #   grading periods specified in the update request. For example: * Grading
+        #   periods included in the list without an ID are considered additions, and a new
+        #   ID will be assigned when the request is made. * Grading periods that currently
+        #   exist, but are missing from the request will be considered deletions. *
+        #   Grading periods with an existing ID and modified data are considered edits.
+        #   Unmodified data will be left as is. * Grading periods included with an unknown
+        #   ID will result in an error. The following fields may be specified: * `
+        #   grading_periods` * `apply_to_existing_coursework`
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ClassroomV1::GradingPeriodSettings] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ClassroomV1::GradingPeriodSettings]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def update_course_grading_period_settings(course_id, grading_period_settings_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v1/courses/{courseId}/gradingPeriodSettings', options)
+          command.request_representation = Google::Apis::ClassroomV1::GradingPeriodSettings::Representation
+          command.request_object = grading_period_settings_object
+          command.response_representation = Google::Apis::ClassroomV1::GradingPeriodSettings::Representation
+          command.response_class = Google::Apis::ClassroomV1::GradingPeriodSettings
+          command.params['courseId'] = course_id unless course_id.nil?
+          command.query['updateMask'] = update_mask unless update_mask.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Creates an alias for a course. This method returns the following error codes: *
         # `PERMISSION_DENIED` if the requesting user is not permitted to create the
         # alias or for access errors. * `NOT_FOUND` if the course does not exist. * `
@@ -1310,9 +1396,7 @@ def modify_course_course_work_assignees(course_id, id, modify_course_work_assign
         #   CourseWork` object, an `INVALID_ARGUMENT` error is returned. The following
         #   fields may be specified by teachers: * `title` * `description` * `state` * `
         #   due_date` * `due_time` * `max_points` * `scheduled_time` * `
-        #   submission_modification_mode` * `topic_id` * `grading_period_id` Available in [
-        #   V1_20240401_PREVIEW](https://developers.google.com/classroom/reference/preview)
-        #   and later.
+        #   submission_modification_mode` * `topic_id` * `grading_period_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user