feat: Add FileUploads service

docs: A comment for enum value `PRODUCTS` in enum `Channel` is changed

PiperOrigin-RevId: 678641097

Source-Link: googleapis/googleapis@9c4c174

Source-Link: googleapis/googleapis-gen@13cfe50
Copy-Tag: eyJwIjoiZ29vZ2xlLXNob3BwaW5nLW1lcmNoYW50LWRhdGFfc291cmNlcy8uT3dsQm90LnlhbWwiLCJoIjoiMTNjZmU1MDRhNmYwYWVkYzA0MTZjMjM4NTFmMjc4MTU3ODM0ZjkwNSJ9

owl-bot-staging/google-shopping-merchant-data_sources/.gitignore

@@ -0,0 +1,22 @@
+# Ignore bundler lockfiles
+Gemfile.lock
+gems.locked
+
+# Ignore documentation output
+doc/*
+.yardoc/*
+
+# Ignore test output
+coverage/*
+
+# Ignore build artifacts
+pkg/*
+
+# Ignore files commonly present in certain dev environments
+.vagrant
+.DS_STORE
+.idea
+*.iml
+
+# Ignore synth output
+__pycache__

owl-bot-staging/google-shopping-merchant-data_sources/.repo-metadata.json

@@ -0,0 +1,17 @@
+{
+ "api_id": "merchantapi.googleapis.com",
+ "api_shortname": "merchantapi",
+ "client_documentation": "https://rubydoc.info/gems/google-shopping-merchant-data_sources",
+ "distribution_name": "google-shopping-merchant-data_sources",
+ "is_cloud": false,
+ "language": "ruby",
+ "name": "merchantapi",
+ "name_pretty": "Merchant API",
+ "product_documentation": "https://developers.google.com/merchant/api",
+ "release_level": "unreleased",
+ "repo": "googleapis/google-cloud-ruby",
+ "requires_billing": true,
+ "ruby-cloud-description": "Merchant API consists of multiple Sub-APIs. Accounts Sub-API: Enables you to programmatically manage your accounts. Conversions Sub-API: Enables you to programmatically manage your conversion sources for a merchant account. Datasources Sub-API: Enables you to programmatically manage your datasources. Inventories Sub-API: This bundle enables you to programmatically manage your local and regional inventories. Local Feeds Partnerships Sub-API: This bundle enables LFP partners to submit local inventories for a merchant. Notifications Sub-API: This bundle enables you to programmatically manage your notification subscriptions. Products Sub-API: This bundle enables you to programmatically manage your products. Promotions Sub-API: This bundle enables you to programmatically manage your promotions for products. Quota Sub-API: This bundle enables you to list your quotas for all APIs you are using. Reports Sub-API: This bundle enables you to programmatically retrieve reports and insights about products, their performance and their competitive environment.",
+ "ruby-cloud-product-url": "https://developers.google.com/merchant/api",
+ "library_type": "GAPIC_AUTO"
+}

owl-bot-staging/google-shopping-merchant-data_sources/.rubocop.yml

@@ -0,0 +1,39 @@
+inherit_gem:
+ google-style: google-style.yml
+
+AllCops:
+ Exclude:
+ - "google-shopping-merchant-data_sources.gemspec"
+ - "Rakefile"
+ - "acceptance/**/*"
+ - "test/**/*"
+
+Bundler/OrderedGems:
+ Enabled: false
+Documentation:
+ Enabled: false
+Layout/LineLength:
+ Enabled: false
+Metrics/BlockLength:
+ Exclude:
+ - "samples/**/acceptance/*.rb"
+Metrics/AbcSize:
+ Enabled: false
+Metrics/ClassLength:
+ Enabled: false
+Metrics/CyclomaticComplexity:
+ Enabled: false
+Metrics/MethodLength:
+ Enabled: false
+Metrics/ModuleLength:
+ Enabled: false
+Metrics/PerceivedComplexity:
+ Enabled: false
+
+Naming/FileName:
+ Exclude:
+ - "lib/google-shopping-merchant-data_sources.rb"
+
+Style/BlockDelimiters:
+ Exclude:
+ - "samples/**/acceptance/*.rb"

owl-bot-staging/google-shopping-merchant-data_sources/.toys.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+# Copyright 2024 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
+#
+# https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+toys_version! ">= 0.15.3"
+
+if ENV["RUBY_COMMON_TOOLS"]
+ common_tools_dir = File.expand_path ENV["RUBY_COMMON_TOOLS"]
+ load File.join(common_tools_dir, "toys", "gapic")
+else
+ load_git remote: "https://github.com/googleapis/ruby-common-tools.git",
+ path: "toys/gapic",
+ update: true
+end

owl-bot-staging/google-shopping-merchant-data_sources/.yardopts

@@ -0,0 +1,11 @@
+--no-private
+--title="Merchant API"
+--exclude _pb\.rb$
+--markup markdown
+--markup-provider redcarpet
+
+./lib/**/*.rb
+-
+README.md
+AUTHENTICATION.md
+LICENSE.md

owl-bot-staging/google-shopping-merchant-data_sources/AUTHENTICATION.md

@@ -0,0 +1,122 @@
+# Authentication
+
+The recommended way to authenticate to the google-shopping-merchant-data_sources library is to use
+[Application Default Credentials (ADC)](https://cloud.google.com/docs/authentication/application-default-credentials).
+To review all of your authentication options, see [Credentials lookup](#credential-lookup).
+
+## Quickstart
+
+The following example shows how to set up authentication for a local development
+environment with your user credentials. 
+
+**NOTE:** This method is _not_ recommended for running in production. User credentials
+should be used only during development.
+
+1. [Download and install the Google Cloud CLI](https://cloud.google.com/sdk).
+2. Set up a local ADC file with your user credentials:
+
+```sh
+gcloud auth application-default login
+```
+
+3. Write code as if already authenticated.
+
+For more information about setting up authentication for a local development environment, see
+[Set up Application Default Credentials](https://cloud.google.com/docs/authentication/provide-credentials-adc#local-dev).
+
+## Credential Lookup
+
+The google-shopping-merchant-data_sources library provides several mechanisms to configure your system.
+Generally, using Application Default Credentials to facilitate automatic 
+credentials discovery is the easist method. But if you need to explicitly specify
+credentials, there are several methods available to you.
+
+Credentials are accepted in the following ways, in the following order or precedence:
+
+1. Credentials specified in method arguments
+2. Credentials specified in configuration
+3. Credentials pointed to or included in environment variables
+4. Credentials found in local ADC file
+5. Credentials returned by the metadata server for the attached service account (GCP)
+
+### Configuration
+
+You can configure a path to a JSON credentials file, either for an individual client object or
+globally, for all client objects. The JSON file can contain credentials created for
+[workload identity federation](https://cloud.google.com/iam/docs/workload-identity-federation),
+[workforce identity federation](https://cloud.google.com/iam/docs/workforce-identity-federation), or a
+[service account key](https://cloud.google.com/docs/authentication/provide-credentials-adc#local-key).
+
+Note: Service account keys are a security risk if not managed correctly. You should
+[choose a more secure alternative to service account keys](https://cloud.google.com/docs/authentication#auth-decision-tree)
+whenever possible.
+
+To configure a credentials file for an individual client initialization:
+
+```ruby
+require "google/shopping/merchant/data_sources"
+
+client = Google::Shopping::Merchant::DataSources.data_sources_service do |config|
+ config.credentials = "path/to/credentialfile.json"
+end
+```
+
+To configure a credentials file globally for all clients:
+
+```ruby
+require "google/shopping/merchant/data_sources"
+
+Google::Shopping::Merchant::DataSources.configure do |config|
+ config.credentials = "path/to/credentialfile.json"
+end
+
+client = Google::Shopping::Merchant::DataSources.data_sources_service
+```
+
+### Environment Variables
+
+You can also use an environment variable to provide a JSON credentials file.
+The environment variable can contain a path to the credentials file or, for
+environments such as Docker containers where writing files is not encouraged,
+you can include the credentials file itself.
+
+The JSON file can contain credentials created for
+[workload identity federation](https://cloud.google.com/iam/docs/workload-identity-federation),
+[workforce identity federation](https://cloud.google.com/iam/docs/workforce-identity-federation), or a
+[service account key](https://cloud.google.com/docs/authentication/provide-credentials-adc#local-key).
+
+Note: Service account keys are a security risk if not managed correctly. You should
+[choose a more secure alternative to service account keys](https://cloud.google.com/docs/authentication#auth-decision-tree)
+whenever possible.
+
+The environment variables that google-shopping-merchant-data_sources
+checks for credentials are:
+
+* `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
+* `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
+
+```ruby
+require "google/shopping/merchant/data_sources"
+
+ENV["GOOGLE_APPLICATION_CREDENTIALS"] = "path/to/credentialfile.json"
+
+client = Google::Shopping::Merchant::DataSources.data_sources_service
+```
+
+### Local ADC file
+
+You can set up a local ADC file with your user credentials for authentication during
+development. If credentials are not provided in code or in environment variables,
+then the local ADC credentials are discovered.
+
+Follow the steps in [Quickstart](#quickstart) to set up a local ADC file.
+
+### Google Cloud Platform environments
+
+When running on Google Cloud Platform (GCP), including Google Compute Engine
+(GCE), Google Kubernetes Engine (GKE), Google App Engine (GAE), Google Cloud
+Functions (GCF) and Cloud Run, credentials are retrieved from the attached
+service account automatically. Code should be written as if already authenticated.
+
+For more information, see
+[Set up ADC for Google Cloud services](https://cloud.google.com/docs/authentication/provide-credentials-adc#attached-sa).

owl-bot-staging/google-shopping-merchant-data_sources/CHANGELOG.md

@@ -0,0 +1,2 @@
+# Release History
+

owl-bot-staging/google-shopping-merchant-data_sources/Gemfile

@@ -0,0 +1,13 @@
+source "https://rubygems.org"
+
+gemspec
+
+gem "google-shopping-merchant-data_sources-v1beta", path: "../google-shopping-merchant-data_sources-v1beta"
+
+gem "google-style", "~> 1.27.1"
+gem "minitest", "~> 5.22"
+gem "minitest-focus", "~> 1.4"
+gem "minitest-rg", "~> 5.3"
+gem "rake", ">= 13.0"
+gem "redcarpet", "~> 3.6"
+gem "yard", "~> 0.9"