feat: Automated regeneration of Classroom client (#13291)

Auto-created at 2025-04-03 13:18:34 +0000 using the toys pull request generator.

Author: yoshi-code-bot

clients/classroom/lib/google_api/classroom/v1/api/courses.ex

@@ -204,6 +204,76 @@ defmodule GoogleApi.Classroom.V1.Api.Courses do
     |> Response.decode(opts ++ [struct: %GoogleApi.Classroom.V1.Model.Course{}])
   end
 
+  @doc """
+  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.
+
+  ## Parameters
+
+  *   `connection` (*type:* `GoogleApi.Classroom.V1.Connection.t`) - Connection to server
+  *   `course_id` (*type:* `String.t`) - Required. The identifier of the course.
+  *   `optional_params` (*type:* `keyword()`) - Optional parameters
+      *   `:"$.xgafv"` (*type:* `String.t`) - V1 error format.
+      *   `:access_token` (*type:* `String.t`) - OAuth access token.
+      *   `:alt` (*type:* `String.t`) - Data format for response.
+      *   `:callback` (*type:* `String.t`) - JSONP
+      *   `:fields` (*type:* `String.t`) - Selector specifying which fields to include in a partial response.
+      *   `:key` (*type:* `String.t`) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
+      *   `:oauth_token` (*type:* `String.t`) - OAuth 2.0 token for the current user.
+      *   `:prettyPrint` (*type:* `boolean()`) - Returns response with indentations and line breaks.
+      *   `:quotaUser` (*type:* `String.t`) - 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.
+      *   `:uploadType` (*type:* `String.t`) - Legacy upload protocol for media (e.g. "media", "multipart").
+      *   `:upload_protocol` (*type:* `String.t`) - Upload protocol for media (e.g. "raw", "multipart").
+  *   `opts` (*type:* `keyword()`) - Call options
+
+  ## Returns
+
+  *   `{:ok, %GoogleApi.Classroom.V1.Model.GradingPeriodSettings{}}` on success
+  *   `{:error, info}` on failure
+  """
+  @spec classroom_courses_get_grading_period_settings(
+          Tesla.Env.client(),
+          String.t(),
+          keyword(),
+          keyword()
+        ) ::
+          {:ok, GoogleApi.Classroom.V1.Model.GradingPeriodSettings.t()}
+          | {:ok, Tesla.Env.t()}
+          | {:ok, list()}
+          | {:error, any()}
+  def classroom_courses_get_grading_period_settings(
+        connection,
+        course_id,
+        optional_params \\ [],
+        opts \\ []
+      ) do
+    optional_params_config = %{
+      :"$.xgafv" => :query,
+      :access_token => :query,
+      :alt => :query,
+      :callback => :query,
+      :fields => :query,
+      :key => :query,
+      :oauth_token => :query,
+      :prettyPrint => :query,
+      :quotaUser => :query,
+      :uploadType => :query,
+      :upload_protocol => :query
+    }
+
+    request =
+      Request.new()
+      |> Request.method(:get)
+      |> Request.url("/v1/courses/{courseId}/gradingPeriodSettings", %{
+        "courseId" => URI.encode(course_id, &URI.char_unreserved?/1)
+      })
+      |> Request.add_optional_params(optional_params_config, optional_params)
+      |> Request.library_version(@library_version)
+
+    connection
+    |> Connection.execute(request)
+    |> Response.decode(opts ++ [struct: %GoogleApi.Classroom.V1.Model.GradingPeriodSettings{}])
+  end
+
   @doc """
   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.
 
@@ -397,6 +467,80 @@ defmodule GoogleApi.Classroom.V1.Api.Courses do
     |> Response.decode(opts ++ [struct: %GoogleApi.Classroom.V1.Model.Course{}])
   end
 
+  @doc """
+  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.
+
+  ## Parameters
+
+  *   `connection` (*type:* `GoogleApi.Classroom.V1.Connection.t`) - Connection to server
+  *   `course_id` (*type:* `String.t`) - Required. The identifier of the course.
+  *   `optional_params` (*type:* `keyword()`) - Optional parameters
+      *   `:"$.xgafv"` (*type:* `String.t`) - V1 error format.
+      *   `:access_token` (*type:* `String.t`) - OAuth access token.
+      *   `:alt` (*type:* `String.t`) - Data format for response.
+      *   `:callback` (*type:* `String.t`) - JSONP
+      *   `:fields` (*type:* `String.t`) - Selector specifying which fields to include in a partial response.
+      *   `:key` (*type:* `String.t`) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
+      *   `:oauth_token` (*type:* `String.t`) - OAuth 2.0 token for the current user.
+      *   `:prettyPrint` (*type:* `boolean()`) - Returns response with indentations and line breaks.
+      *   `:quotaUser` (*type:* `String.t`) - 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.
+      *   `:uploadType` (*type:* `String.t`) - Legacy upload protocol for media (e.g. "media", "multipart").
+      *   `:upload_protocol` (*type:* `String.t`) - Upload protocol for media (e.g. "raw", "multipart").
+      *   `:updateMask` (*type:* `String.t`) - 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`
+      *   `:body` (*type:* `GoogleApi.Classroom.V1.Model.GradingPeriodSettings.t`) - 
+  *   `opts` (*type:* `keyword()`) - Call options
+
+  ## Returns
+
+  *   `{:ok, %GoogleApi.Classroom.V1.Model.GradingPeriodSettings{}}` on success
+  *   `{:error, info}` on failure
+  """
+  @spec classroom_courses_update_grading_period_settings(
+          Tesla.Env.client(),
+          String.t(),
+          keyword(),
+          keyword()
+        ) ::
+          {:ok, GoogleApi.Classroom.V1.Model.GradingPeriodSettings.t()}
+          | {:ok, Tesla.Env.t()}
+          | {:ok, list()}
+          | {:error, any()}
+  def classroom_courses_update_grading_period_settings(
+        connection,
+        course_id,
+        optional_params \\ [],
+        opts \\ []
+      ) do
+    optional_params_config = %{
+      :"$.xgafv" => :query,
+      :access_token => :query,
+      :alt => :query,
+      :callback => :query,
+      :fields => :query,
+      :key => :query,
+      :oauth_token => :query,
+      :prettyPrint => :query,
+      :quotaUser => :query,
+      :uploadType => :query,
+      :upload_protocol => :query,
+      :updateMask => :query,
+      :body => :body
+    }
+
+    request =
+      Request.new()
+      |> Request.method(:patch)
+      |> Request.url("/v1/courses/{courseId}/gradingPeriodSettings", %{
+        "courseId" => URI.encode(course_id, &URI.char_unreserved?/1)
+      })
+      |> Request.add_optional_params(optional_params_config, optional_params)
+      |> Request.library_version(@library_version)
+
+    connection
+    |> Connection.execute(request)
+    |> Response.decode(opts ++ [struct: %GoogleApi.Classroom.V1.Model.GradingPeriodSettings{}])
+  end
+
   @doc """
   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. * `ALREADY_EXISTS` if the alias already exists. * `FAILED_PRECONDITION` if the alias requested does not make sense for the requesting user or course (for example, if a user not in a domain attempts to access a domain-scoped alias).
 
@@ -2002,7 +2146,7 @@ defmodule GoogleApi.Classroom.V1.Api.Courses do
       *   `:quotaUser` (*type:* `String.t`) - 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.
       *   `:uploadType` (*type:* `String.t`) - Legacy upload protocol for media (e.g. "media", "multipart").
       *   `:upload_protocol` (*type:* `String.t`) - Upload protocol for media (e.g. "raw", "multipart").
-      *   `:updateMask` (*type:* `String.t`) - Mask that identifies which fields on the course work to update. This field is required to do an update. The update fails if invalid fields are specified. If a field supports empty values, it can be cleared by specifying it in the update mask and not in the `CourseWork` object. If a field that does not support empty values is included in the update mask and not set in the `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.
+      *   `:updateMask` (*type:* `String.t`) - Mask that identifies which fields on the course work to update. This field is required to do an update. The update fails if invalid fields are specified. If a field supports empty values, it can be cleared by specifying it in the update mask and not in the `CourseWork` object. If a field that does not support empty values is included in the update mask and not set in the `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`
       *   `:body` (*type:* `GoogleApi.Classroom.V1.Model.CourseWork.t`) - 
   *   `opts` (*type:* `keyword()`) - Call options
 

clients/classroom/lib/google_api/classroom/v1/metadata.ex

@@ -20,7 +20,7 @@ defmodule GoogleApi.Classroom.V1 do
   API client metadata for GoogleApi.Classroom.V1.
   """
 
-  @discovery_revision "20250303"
+  @discovery_revision "20250331"
 
   def discovery_revision(), do: @discovery_revision
 end

clients/classroom/lib/google_api/classroom/v1/model/course_work.ex

@@ -32,6 +32,7 @@ defmodule GoogleApi.Classroom.V1.Model.CourseWork do
   *   `dueDate` (*type:* `GoogleApi.Classroom.V1.Model.Date.t`, *default:* `nil`) - Optional date, in UTC, that submissions for this course work are due. This must be specified if `due_time` is specified.
   *   `dueTime` (*type:* `GoogleApi.Classroom.V1.Model.TimeOfDay.t`, *default:* `nil`) - Optional time of day, in UTC, that submissions for this course work are due. This must be specified if `due_date` is specified.
   *   `gradeCategory` (*type:* `GoogleApi.Classroom.V1.Model.GradeCategory.t`, *default:* `nil`) - The category that this coursework's grade contributes to. Present only when a category has been chosen for the coursework. May be used in calculating the overall grade. Read-only.
+  *   `gradingPeriodId` (*type:* `String.t`, *default:* `nil`) - 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.
   *   `id` (*type:* `String.t`, *default:* `nil`) - Classroom-assigned identifier of this course work, unique per course. Read-only.
   *   `individualStudentsOptions` (*type:* `GoogleApi.Classroom.V1.Model.IndividualStudentsOptions.t`, *default:* `nil`) - Identifiers of students with access to the coursework. This field is set only if `assigneeMode` is `INDIVIDUAL_STUDENTS`. If the `assigneeMode` is `INDIVIDUAL_STUDENTS`, then only students specified in this field are assigned the coursework.
   *   `materials` (*type:* `list(GoogleApi.Classroom.V1.Model.Material.t)`, *default:* `nil`) - Additional materials. CourseWork must have no more than 20 material items.
@@ -60,6 +61,7 @@ defmodule GoogleApi.Classroom.V1.Model.CourseWork do
           :dueDate => GoogleApi.Classroom.V1.Model.Date.t() | nil,
           :dueTime => GoogleApi.Classroom.V1.Model.TimeOfDay.t() | nil,
           :gradeCategory => GoogleApi.Classroom.V1.Model.GradeCategory.t() | nil,
+          :gradingPeriodId => String.t() | nil,
           :id => String.t() | nil,
           :individualStudentsOptions =>
             GoogleApi.Classroom.V1.Model.IndividualStudentsOptions.t() | nil,
@@ -87,6 +89,7 @@ defmodule GoogleApi.Classroom.V1.Model.CourseWork do
   field(:dueDate, as: GoogleApi.Classroom.V1.Model.Date)
   field(:dueTime, as: GoogleApi.Classroom.V1.Model.TimeOfDay)
   field(:gradeCategory, as: GoogleApi.Classroom.V1.Model.GradeCategory)
+  field(:gradingPeriodId)
   field(:id)
   field(:individualStudentsOptions, as: GoogleApi.Classroom.V1.Model.IndividualStudentsOptions)
   field(:materials, as: GoogleApi.Classroom.V1.Model.Material, type: :list)

clients/classroom/lib/google_api/classroom/v1/model/grading_period.ex

@@ -0,0 +1,55 @@
+# Copyright 2019 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# NOTE: This file is auto generated by the elixir code generator program.
+# Do not edit this file manually.
+
+defmodule GoogleApi.Classroom.V1.Model.GradingPeriod do
+  @moduledoc """
+  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.
+
+  ## Attributes
+
+  *   `endDate` (*type:* `GoogleApi.Classroom.V1.Model.Date.t`, *default:* `nil`) - Required. End date, in UTC, of the grading period. Inclusive.
+  *   `id` (*type:* `String.t`, *default:* `nil`) - Output only. System generated grading period ID. Read-only.
+  *   `startDate` (*type:* `GoogleApi.Classroom.V1.Model.Date.t`, *default:* `nil`) - Required. Start date, in UTC, of the grading period. Inclusive.
+  *   `title` (*type:* `String.t`, *default:* `nil`) - Required. Title of the grading period. For example, “Semester 1”.
+  """
+
+  use GoogleApi.Gax.ModelBase
+
+  @type t :: %__MODULE__{
+          :endDate => GoogleApi.Classroom.V1.Model.Date.t() | nil,
+          :id => String.t() | nil,
+          :startDate => GoogleApi.Classroom.V1.Model.Date.t() | nil,
+          :title => String.t() | nil
+        }
+
+  field(:endDate, as: GoogleApi.Classroom.V1.Model.Date)
+  field(:id)
+  field(:startDate, as: GoogleApi.Classroom.V1.Model.Date)
+  field(:title)
+end
+
+defimpl Poison.Decoder, for: GoogleApi.Classroom.V1.Model.GradingPeriod do
+  def decode(value, options) do
+    GoogleApi.Classroom.V1.Model.GradingPeriod.decode(value, options)
+  end
+end
+
+defimpl Poison.Encoder, for: GoogleApi.Classroom.V1.Model.GradingPeriod do
+  def encode(value, options) do
+    GoogleApi.Gax.ModelBase.encode(value, options)
+  end
+end

clients/classroom/lib/google_api/classroom/v1/model/grading_period_settings.ex

@@ -0,0 +1,49 @@
+# Copyright 2019 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# NOTE: This file is auto generated by the elixir code generator program.
+# Do not edit this file manually.
+
+defmodule GoogleApi.Classroom.V1.Model.GradingPeriodSettings do
+  @moduledoc """
+  Grading period settings that include all the individual grading periods in a course.
+
+  ## Attributes
+
+  *   `applyToExistingCoursework` (*type:* `boolean()`, *default:* `nil`) - 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.
+  *   `gradingPeriods` (*type:* `list(GoogleApi.Classroom.V1.Model.GradingPeriod.t)`, *default:* `nil`) - 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.
+  """
+
+  use GoogleApi.Gax.ModelBase
+
+  @type t :: %__MODULE__{
+          :applyToExistingCoursework => boolean() | nil,
+          :gradingPeriods => list(GoogleApi.Classroom.V1.Model.GradingPeriod.t()) | nil
+        }
+
+  field(:applyToExistingCoursework)
+  field(:gradingPeriods, as: GoogleApi.Classroom.V1.Model.GradingPeriod, type: :list)
+end
+
+defimpl Poison.Decoder, for: GoogleApi.Classroom.V1.Model.GradingPeriodSettings do
+  def decode(value, options) do
+    GoogleApi.Classroom.V1.Model.GradingPeriodSettings.decode(value, options)
+  end
+end
+
+defimpl Poison.Encoder, for: GoogleApi.Classroom.V1.Model.GradingPeriodSettings do
+  def encode(value, options) do
+    GoogleApi.Gax.ModelBase.encode(value, options)
+  end
+end