google-apis-classroom_v1 0.31.0 → 0.32.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5d6c1ce571b0fd2cba57676114ea5432bb0da842053376fd656b1b374e6a39aa
-  data.tar.gz: e8205fe1066f0d70b74ae4be4b37415cc2f37f00ab3db97005771cef212c48fd
+  metadata.gz: 52fb871e9cb0af99e10c557c7a3765e4a79996d25ce0ab3a909e676164755f8f
+  data.tar.gz: 590e23d1b1e79ab4559b39df87ad106e0fdac0837788653acc0a52fb28c13777
 SHA512:
-  metadata.gz: 3a627bc13831a796a63e0f6e354611aef1b702d2251f029958c90806c1d8c15234eaa9f138c396069fa0a47766d774be9848c6f72e666e92e256ca6d1a2ee967
-  data.tar.gz: 99a8e9d89e84c3d81be9de64aedceabeeff2e87d9c907702563bc75410985128f8d1a4e5cd788b7dec6372d81679491d63aab76705504d8aba03d3eb197f966c
+  metadata.gz: a818558e70e6c239cc4e4870c2df795b716bb61cd93b0ab5c4d985bda22e2025f6855b8ef8cf215ab8f75634162fd275457bf57ec0e714718269af4a272b6275
+  data.tar.gz: b55f878059807700f41d98f45c00b5aab42465cb16b5352cabf9f84c07cbf821cfa374b5a12de9fec9183d6d4ae8aea0fedd85bcf1670fd74816547f5febf6ae

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-classroom_v1
 
+### v0.32.0 (2024-06-23)
+
+* Regenerated from discovery document revision 20240617
+
 ### v0.31.0 (2024-05-19)
 
 * Regenerated using generator version 0.15.0

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

@@ -22,6 +22,193 @@ module Google
   module Apis
     module ClassroomV1
       
+      # An add-on attachment on a post.
+      class AddOnAttachment
+        include Google::Apis::Core::Hashable
+      
+        # Output only. Identifiers of attachments that were previous copies of this
+        # attachment. If the attachment was previously copied by virtue of its parent
+        # post being copied, this enumerates the identifiers of attachments that were
+        # its previous copies in ascending chronological order of copy.
+        # Corresponds to the JSON property `copyHistory`
+        # @return [Array<Google::Apis::ClassroomV1::CopyHistory>]
+        attr_accessor :copy_history
+      
+        # Immutable. Identifier of the course.
+        # Corresponds to the JSON property `courseId`
+        # @return [String]
+        attr_accessor :course_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 `dueDate`
+        # @return [Google::Apis::ClassroomV1::Date]
+        attr_accessor :due_date
+      
+        # Represents a time of day. The date and time zone are either not significant or
+        # are specified elsewhere. An API may choose to allow leap seconds. Related
+        # types are google.type.Date and `google.protobuf.Timestamp`.
+        # Corresponds to the JSON property `dueTime`
+        # @return [Google::Apis::ClassroomV1::TimeOfDay]
+        attr_accessor :due_time
+      
+        # Immutable. Classroom-assigned identifier for this attachment, unique per post.
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial
+        # under which the attachment is attached. Unique per course.
+        # Corresponds to the JSON property `itemId`
+        # @return [String]
+        attr_accessor :item_id
+      
+        # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri`
+        # is set. Set to a non-zero value to indicate that the attachment supports grade
+        # passback. If set, this must be a non-negative integer value. When set to zero,
+        # the attachment will not support grade passback.
+        # Corresponds to the JSON property `maxPoints`
+        # @return [Float]
+        attr_accessor :max_points
+      
+        # Immutable. Deprecated, use item_id instead.
+        # Corresponds to the JSON property `postId`
+        # @return [String]
+        attr_accessor :post_id
+      
+        # URI to be iframed after being populated with query parameters.
+        # Corresponds to the JSON property `studentViewUri`
+        # @return [Google::Apis::ClassroomV1::EmbedUri]
+        attr_accessor :student_view_uri
+      
+        # URI to be iframed after being populated with query parameters.
+        # Corresponds to the JSON property `studentWorkReviewUri`
+        # @return [Google::Apis::ClassroomV1::EmbedUri]
+        attr_accessor :student_work_review_uri
+      
+        # URI to be iframed after being populated with query parameters.
+        # Corresponds to the JSON property `teacherViewUri`
+        # @return [Google::Apis::ClassroomV1::EmbedUri]
+        attr_accessor :teacher_view_uri
+      
+        # Required. Title of this attachment. The title must be between 1 and 1000
+        # characters.
+        # 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)
+          @copy_history = args[:copy_history] if args.key?(:copy_history)
+          @course_id = args[:course_id] if args.key?(:course_id)
+          @due_date = args[:due_date] if args.key?(:due_date)
+          @due_time = args[:due_time] if args.key?(:due_time)
+          @id = args[:id] if args.key?(:id)
+          @item_id = args[:item_id] if args.key?(:item_id)
+          @max_points = args[:max_points] if args.key?(:max_points)
+          @post_id = args[:post_id] if args.key?(:post_id)
+          @student_view_uri = args[:student_view_uri] if args.key?(:student_view_uri)
+          @student_work_review_uri = args[:student_work_review_uri] if args.key?(:student_work_review_uri)
+          @teacher_view_uri = args[:teacher_view_uri] if args.key?(:teacher_view_uri)
+          @title = args[:title] if args.key?(:title)
+        end
+      end
+      
+      # Payload for grade update requests.
+      class AddOnAttachmentStudentSubmission
+        include Google::Apis::Core::Hashable
+      
+        # Student grade on this attachment. If unset, no grade was set.
+        # Corresponds to the JSON property `pointsEarned`
+        # @return [Float]
+        attr_accessor :points_earned
+      
+        # Submission state of add-on attachment's parent post (i.e. assignment).
+        # Corresponds to the JSON property `postSubmissionState`
+        # @return [String]
+        attr_accessor :post_submission_state
+      
+        # Identifier for the student that owns this submission. This field is part of an
+        # experimental API change and is populated only if sufficient scopes are granted.
+        # Corresponds to the JSON property `userId`
+        # @return [String]
+        attr_accessor :user_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @points_earned = args[:points_earned] if args.key?(:points_earned)
+          @post_submission_state = args[:post_submission_state] if args.key?(:post_submission_state)
+          @user_id = args[:user_id] if args.key?(:user_id)
+        end
+      end
+      
+      # Attachment-relevant metadata for Classroom add-ons in the context of a
+      # specific post.
+      class AddOnContext
+        include Google::Apis::Core::Hashable
+      
+        # Immutable. Identifier of the course.
+        # Corresponds to the JSON property `courseId`
+        # @return [String]
+        attr_accessor :course_id
+      
+        # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial
+        # under which the attachment is attached.
+        # Corresponds to the JSON property `itemId`
+        # @return [String]
+        attr_accessor :item_id
+      
+        # Immutable. Deprecated, use item_id instead.
+        # Corresponds to the JSON property `postId`
+        # @return [String]
+        attr_accessor :post_id
+      
+        # Role-specific context if the requesting user is a student.
+        # Corresponds to the JSON property `studentContext`
+        # @return [Google::Apis::ClassroomV1::StudentContext]
+        attr_accessor :student_context
+      
+        # Optional. Whether the post allows the teacher to see student work and passback
+        # grades.
+        # Corresponds to the JSON property `supportsStudentWork`
+        # @return [Boolean]
+        attr_accessor :supports_student_work
+        alias_method :supports_student_work?, :supports_student_work
+      
+        # Role-specific context if the requesting user is a teacher.
+        # Corresponds to the JSON property `teacherContext`
+        # @return [Google::Apis::ClassroomV1::TeacherContext]
+        attr_accessor :teacher_context
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @course_id = args[:course_id] if args.key?(:course_id)
+          @item_id = args[:item_id] if args.key?(:item_id)
+          @post_id = args[:post_id] if args.key?(:post_id)
+          @student_context = args[:student_context] if args.key?(:student_context)
+          @supports_student_work = args[:supports_student_work] if args.key?(:supports_student_work)
+          @teacher_context = args[:teacher_context] if args.key?(:teacher_context)
+        end
+      end
+      
       # Announcement created by a teacher for students of the course
       class Announcement
         include Google::Apis::Core::Hashable
@@ -215,6 +402,44 @@ module Google
         end
       end
       
+      # Identifier of a previous copy of a given attachment.
+      class CopyHistory
+        include Google::Apis::Core::Hashable
+      
+        # Immutable. Identifier of the attachment.
+        # Corresponds to the JSON property `attachmentId`
+        # @return [String]
+        attr_accessor :attachment_id
+      
+        # Immutable. Identifier of the course.
+        # Corresponds to the JSON property `courseId`
+        # @return [String]
+        attr_accessor :course_id
+      
+        # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial
+        # under which the attachment is attached.
+        # Corresponds to the JSON property `itemId`
+        # @return [String]
+        attr_accessor :item_id
+      
+        # Immutable. Deprecated, use item_id instead.
+        # Corresponds to the JSON property `postId`
+        # @return [String]
+        attr_accessor :post_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @attachment_id = args[:attachment_id] if args.key?(:attachment_id)
+          @course_id = args[:course_id] if args.key?(:course_id)
+          @item_id = args[:item_id] if args.key?(:item_id)
+          @post_id = args[:post_id] if args.key?(:post_id)
+        end
+      end
+      
       # A Course in Classroom.
       class Course
         include Google::Apis::Core::Hashable
@@ -896,6 +1121,26 @@ module Google
         end
       end
       
+      # URI to be iframed after being populated with query parameters.
+      class EmbedUri
+        include Google::Apis::Core::Hashable
+      
+        # Required. URI to be iframed after being populated with query parameters. This
+        # must be a valid UTF-8 string containing between 1 and 1800 characters.
+        # Corresponds to the JSON property `uri`
+        # @return [String]
+        attr_accessor :uri
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @uri = args[:uri] if args.key?(:uri)
+        end
+      end
+      
       # A generic empty message that you can re-use to avoid defining duplicated empty
       # messages in your APIs. A typical example is to use it as the request or the
       # response type of an API method. For instance: service Foo ` rpc Bar(google.
@@ -1296,6 +1541,32 @@ module Google
         end
       end
       
+      # Response when listing add-on attachments.
+      class ListAddOnAttachmentsResponse
+        include Google::Apis::Core::Hashable
+      
+        # Attachments under the given post.
+        # Corresponds to the JSON property `addOnAttachments`
+        # @return [Array<Google::Apis::ClassroomV1::AddOnAttachment>]
+        attr_accessor :add_on_attachments
+      
+        # A token, which can be sent as `pageToken` to retrieve the next page. If this
+        # field is omitted, there are no subsequent pages.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @add_on_attachments = args[:add_on_attachments] if args.key?(:add_on_attachments)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # Response when listing course work.
       class ListAnnouncementsResponse
         include Google::Apis::Core::Hashable
@@ -2001,6 +2272,27 @@ module Google
         end
       end
       
+      # Role-specific context if the requesting user is a student.
+      class StudentContext
+        include Google::Apis::Core::Hashable
+      
+        # Requesting user's submission id to be used for grade passback and to identify
+        # the student when showing student work to the teacher. This is set exactly when
+        # `supportsStudentWork` is `true`.
+        # Corresponds to the JSON property `submissionId`
+        # @return [String]
+        attr_accessor :submission_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @submission_id = args[:submission_id] if args.key?(:submission_id)
+        end
+      end
+      
       # Student submission for course work. `StudentSubmission` items are generated
       # when a `CourseWork` item is created. Student submissions that have never been
       # accessed (i.e. with `state` = NEW) may not have a creation time or update time.
@@ -2189,6 +2481,19 @@ module Google
         end
       end
       
+      # Role-specific context if the requesting user is a teacher.
+      class TeacherContext
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Represents a time of day. The date and time zone are either not significant or
       # are specified elsewhere. An API may choose to allow leap seconds. Related
       # types are google.type.Date and `google.protobuf.Timestamp`.

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.31.0"
+      GEM_VERSION = "0.32.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.15.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20231121"
+      REVISION = "20240617"
     end
   end
 end

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

@@ -22,6 +22,24 @@ module Google
   module Apis
     module ClassroomV1
       
+      class AddOnAttachment
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AddOnAttachmentStudentSubmission
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AddOnContext
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Announcement
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -52,6 +70,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class CopyHistory
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Course
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -118,6 +142,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class EmbedUri
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Empty
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -190,6 +220,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ListAddOnAttachmentsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListAnnouncementsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -352,6 +388,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class StudentContext
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class StudentSubmission
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -370,6 +412,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class TeacherContext
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class TimeOfDay
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -400,6 +448,53 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class AddOnAttachment
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :copy_history, as: 'copyHistory', class: Google::Apis::ClassroomV1::CopyHistory, decorator: Google::Apis::ClassroomV1::CopyHistory::Representation
+      
+          property :course_id, as: 'courseId'
+          property :due_date, as: 'dueDate', class: Google::Apis::ClassroomV1::Date, decorator: Google::Apis::ClassroomV1::Date::Representation
+      
+          property :due_time, as: 'dueTime', class: Google::Apis::ClassroomV1::TimeOfDay, decorator: Google::Apis::ClassroomV1::TimeOfDay::Representation
+      
+          property :id, as: 'id'
+          property :item_id, as: 'itemId'
+          property :max_points, as: 'maxPoints'
+          property :post_id, as: 'postId'
+          property :student_view_uri, as: 'studentViewUri', class: Google::Apis::ClassroomV1::EmbedUri, decorator: Google::Apis::ClassroomV1::EmbedUri::Representation
+      
+          property :student_work_review_uri, as: 'studentWorkReviewUri', class: Google::Apis::ClassroomV1::EmbedUri, decorator: Google::Apis::ClassroomV1::EmbedUri::Representation
+      
+          property :teacher_view_uri, as: 'teacherViewUri', class: Google::Apis::ClassroomV1::EmbedUri, decorator: Google::Apis::ClassroomV1::EmbedUri::Representation
+      
+          property :title, as: 'title'
+        end
+      end
+      
+      class AddOnAttachmentStudentSubmission
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :points_earned, as: 'pointsEarned'
+          property :post_submission_state, as: 'postSubmissionState'
+          property :user_id, as: 'userId'
+        end
+      end
+      
+      class AddOnContext
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :course_id, as: 'courseId'
+          property :item_id, as: 'itemId'
+          property :post_id, as: 'postId'
+          property :student_context, as: 'studentContext', class: Google::Apis::ClassroomV1::StudentContext, decorator: Google::Apis::ClassroomV1::StudentContext::Representation
+      
+          property :supports_student_work, as: 'supportsStudentWork'
+          property :teacher_context, as: 'teacherContext', class: Google::Apis::ClassroomV1::TeacherContext, decorator: Google::Apis::ClassroomV1::TeacherContext::Representation
+      
+        end
+      end
+      
       class Announcement
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -457,6 +552,16 @@ module Google
         end
       end
       
+      class CopyHistory
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :attachment_id, as: 'attachmentId'
+          property :course_id, as: 'courseId'
+          property :item_id, as: 'itemId'
+          property :post_id, as: 'postId'
+        end
+      end
+      
       class Course
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -615,6 +720,13 @@ module Google
         end
       end
       
+      class EmbedUri
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :uri, as: 'uri'
+        end
+      end
+      
       class Empty
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -728,6 +840,15 @@ module Google
         end
       end
       
+      class ListAddOnAttachmentsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :add_on_attachments, as: 'addOnAttachments', class: Google::Apis::ClassroomV1::AddOnAttachment, decorator: Google::Apis::ClassroomV1::AddOnAttachment::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
       class ListAnnouncementsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -968,6 +1089,13 @@ module Google
         end
       end
       
+      class StudentContext
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :submission_id, as: 'submissionId'
+        end
+      end
+      
       class StudentSubmission
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1015,6 +1143,12 @@ module Google
         end
       end
       
+      class TeacherContext
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class TimeOfDay
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation