feat: Automated regeneration of YouTube client (googleapis#12308)

Auto-created at 2024-10-12 13:18:18 +0000 using the toys pull request generator.

Author: yoshi-code-bot

clients/you_tube/README.md

@@ -11,7 +11,7 @@ Install this package from [Hex](https://hex.pm) by adding
 
 ```elixir
 def deps do
-  [{:google_api_you_tube, "~> 0.48"}]
+  [{:google_api_you_tube, "~> 0.49"}]
 end
 ```
 

clients/you_tube/lib/google_api/you_tube/v3/api/live_chat_messages.ex

@@ -168,7 +168,7 @@ defmodule GoogleApi.YouTube.V3.Api.LiveChatMessages do
       *   `: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").
       *   `:hl` (*type:* `String.t`) - Specifies the localization language in which the system messages should be returned.
-      *   `:maxResults` (*type:* `integer()`) - The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.
+      *   `:maxResults` (*type:* `integer()`) - The *maxResults* parameter specifies the maximum number of items that should be returned in the result set. Not used in the streaming RPC.
       *   `:pageToken` (*type:* `String.t`) - The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken property identify other pages that could be retrieved.
       *   `:profileImageSize` (*type:* `integer()`) - Specifies the size of the profile image that should be returned for each user.
   *   `opts` (*type:* `keyword()`) - Call options

clients/you_tube/lib/google_api/you_tube/v3/api/youtube.ex

@@ -85,4 +85,75 @@ defmodule GoogleApi.YouTube.V3.Api.Youtube do
     |> Connection.execute(request)
     |> Response.decode(opts ++ [struct: %GoogleApi.YouTube.V3.Model.CommentThread{}])
   end
+
+  @doc """
+  Allows a user to load live chat through a server-streamed RPC.
+
+  ## Parameters
+
+  *   `connection` (*type:* `GoogleApi.YouTube.V3.Connection.t`) - Connection to server
+  *   `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").
+      *   `:hl` (*type:* `String.t`) - Specifies the localization language in which the system messages should be returned.
+      *   `:liveChatId` (*type:* `String.t`) - The id of the live chat for which comments should be returned.
+      *   `:maxResults` (*type:* `integer()`) - The *maxResults* parameter specifies the maximum number of items that should be returned in the result set. Not used in the streaming RPC.
+      *   `:pageToken` (*type:* `String.t`) - The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken property identify other pages that could be retrieved.
+      *   `:part` (*type:* `list(String.t)`) - The *part* parameter specifies the liveChatComment resource parts that the API response will include. Supported values are id, snippet, and authorDetails.
+      *   `:profileImageSize` (*type:* `integer()`) - Specifies the size of the profile image that should be returned for each user.
+  *   `opts` (*type:* `keyword()`) - Call options
+
+  ## Returns
+
+  *   `{:ok, %GoogleApi.YouTube.V3.Model.LiveChatMessageListResponse{}}` on success
+  *   `{:error, info}` on failure
+  """
+  @spec youtube_youtube_v3_live_chat_messages_stream(Tesla.Env.client(), keyword(), keyword()) ::
+          {:ok, GoogleApi.YouTube.V3.Model.LiveChatMessageListResponse.t()}
+          | {:ok, Tesla.Env.t()}
+          | {:ok, list()}
+          | {:error, any()}
+  def youtube_youtube_v3_live_chat_messages_stream(connection, 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,
+      :hl => :query,
+      :liveChatId => :query,
+      :maxResults => :query,
+      :pageToken => :query,
+      :part => :query,
+      :profileImageSize => :query
+    }
+
+    request =
+      Request.new()
+      |> Request.method(:get)
+      |> Request.url("/youtube/v3/liveChat/messages/stream", %{})
+      |> Request.add_optional_params(optional_params_config, optional_params)
+      |> Request.library_version(@library_version)
+
+    connection
+    |> Connection.execute(request)
+    |> Response.decode(
+      opts ++ [struct: %GoogleApi.YouTube.V3.Model.LiveChatMessageListResponse{}]
+    )
+  end
 end

clients/you_tube/lib/google_api/you_tube/v3/metadata.ex

@@ -20,7 +20,7 @@ defmodule GoogleApi.YouTube.V3 do
   API client metadata for GoogleApi.YouTube.V3.
   """
 
-  @discovery_revision "20240926"
+  @discovery_revision "20241010"
 
   def discovery_revision(), do: @discovery_revision
 end

clients/you_tube/mix.exs

@@ -18,7 +18,7 @@
 defmodule GoogleApi.YouTube.Mixfile do
   use Mix.Project
 
-  @version "0.48.0"
+  @version "0.49.0"
 
   def project() do
     [