google-apis-core 1.2.4 → 1.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e473e85fbf99d63f40efe7a2ad6a62aa63e2243098d0ca89de9913b0158f16ed
-  data.tar.gz: ac5ef1511631d8fe647c25891cf25ef8fd6c57fddcfdf6be86def2dd79eab50a
+  metadata.gz: b1c9da7b904255f5cfa7a7340b09680ad04e9b654cf0b9119a62d0d3f23785bb
+  data.tar.gz: dcb808f302b5a8432d7b71aac11d5eed7b57bbf84e27c759616e5f13bd3e65b8
 SHA512:
-  metadata.gz: 9043b70319aa23ec2bb0d902595124e47b81fa3d1bb523edc98533642e23a2835038e6fa2f6fe267f08eb721c2c26c37465aa5c97fb7d02b6878cb9a5702ef48
-  data.tar.gz: ea1b48cdcbb50d39686a19499bca54ef7dd8f60a8241917d8299858376d3d31441a0f6b2aa41cc0b8bfcec007a33a53f9fb6ec0dfdc53d1d784c2decc0dd9f7c
+  metadata.gz: 9c591df50fe928a6edb03dba868becf61a918e9fa07173b8d8e4cbef540129c5985ad460252ce35ce6910eb7ba53c819663d94d231c9fbc8e92a842664ca7009
+  data.tar.gz: 1b191c3c847f9bda6e522160f6c5ff58862c534eacac8be8f708f2337cba4f2792438947bf2d243b5cc9208daf327fdf1ee17317e090b9aa8308b5f646a983a1

data/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Release History
 
+### 1.4.1 (2026-11-01)
+
+#### Bug Fixes
+
+* bump dependencies representable to ~> 3.3, >= 3.3.1 and multi_json to ~> 1.21, >= 1.21.2 ([#28003](https://github.com/googleapis/google-api-ruby-client/issues/28003)) ([6e0759d](https://github.com/googleapis/google-api-ruby-client/commit/6e0759d7ccbc753ea04793cb991486d7b99faccd)), refs [#26611](https://github.com/googleapis/google-api-ruby-client/issues/26611)
+
+### 1.4.0 (2026-10-22)
+
+#### Features
+
+* allow setting the faraday adapter to use ([#27337](https://github.com/googleapis/google-api-ruby-client/issues/27337)) ([370d8ae](https://github.com/googleapis/google-api-ruby-client/commit/370d8ae750e125066f3c1204b3ceb561d3aca1dd)), refs [#27339](https://github.com/googleapis/google-api-ruby-client/issues/27339)
+
+#### Documentation
+
+* document ClientOptions#adapter requirements and caveats ([#28298](https://github.com/googleapis/google-api-ruby-client/issues/28298)) ([96bd38f](https://github.com/googleapis/google-api-ruby-client/commit/96bd38fcceccfe20f0713545611911604d673f94)), refs [#27337](https://github.com/googleapis/google-api-ruby-client/issues/27337)
+
+### 1.3.2 (2026-10-15)
+
+#### Bug Fixes
+
+* correct ClientSecrets JSON.dump constant ([#28074](https://github.com/googleapis/google-api-ruby-client/issues/28074)) 
+
+### 1.3.1 (2026-10-11)
+
+#### Bug Fixes
+
+* honor max for singular items in PagedResults#each ([#28073](https://github.com/googleapis/google-api-ruby-client/issues/28073)) 
+
+### 1.3.0 (2026-10-04)
+
+#### Features
+
+* implement path validation and traversal checks in HttpCommand ([#27476](https://github.com/googleapis/google-api-ruby-client/issues/27476)) 
+
+### 1.2.5 (2026-07-20)
+
+#### Bug Fixes
+
+* ignore non-2xx status codes in streaming downloads ([#27256](https://github.com/googleapis/google-api-ruby-client/issues/27256)) 
+
 ### 1.2.4 (2026-06-28)
 
 #### Bug Fixes

data/OVERVIEW.md

@@ -22,6 +22,14 @@ should pin `google-apis-core` to a 0.x version in your Gemfile. For example:
 
     gem "google-apis-core", "~> 0.18"
 
+google-apis-core uses Faraday's default adapter, which wraps [net-http](https://github.com/ruby/net-http), and is tested only against it. You can change the adapter by setting the `:adapter` client option:
+
+```ruby
+Google::Apis::ClientOptions.default.adapter = :net_http_persistent # or :httpx, or...
+```
+
+There's a caveat, though: downloading media requires a `faraday` adapter which [implements the `on_data` streaming API](https://lostisland.github.io/faraday/#/advanced/streaming-responses?id=streaming-responses). See {Google::Apis::ClientOptions#adapter} for the full requirements.
+
 ## Documentation
 
 More detailed descriptions of the Google legacy REST clients are available in two documents.

data/lib/google/api_client/client_secrets.rb

@@ -119,7 +119,7 @@ module Google
       # @return [String]
       #   JSON
       def to_json
-        return Json.dump(to_hash)
+        return JSON.dump(to_hash)
       end
 
       def to_hash

data/lib/google/apis/core/base_service.rb

@@ -80,6 +80,8 @@ module Google
               end
             elsif items
               # yield singular non-nil items (for genomics API)
+              item_count = item_count + 1
+              break if @max && item_count > @max
               yield items
             end
             break if @max && item_count >= @max
@@ -565,6 +567,7 @@ module Google
           Faraday.new options do |faraday|
             faraday.response :logger, Google::Apis.logger if client_options.log_http_requests
             faraday.response :follow_redirects_google_apis_core, limit: 5
+            faraday.adapter client_options.adapter if client_options.adapter
           end
         end
 

data/lib/google/apis/core/download.rb

@@ -81,11 +81,12 @@ module Google
 
           http_res = client.get(url.to_s, query, request_header) do |request|
             request.options.on_data = proc do |chunk, _size, res|
-              # The on_data callback is only invoked on a successful response.
               # Some Faraday adapters (e.g. Typhoeus) may not provide a response
               # object in the callback, so we default to a 200 OK status.
+              # Note: Ignore non-2xx responses (redirects and 4xx/5xx error payloads)
+              # so error messages are not written to the download stream.
               status = res ? res.status.to_i : 200
-              next if chunk.nil? || (status >= 300 && status < 400)
+              next if chunk.nil? || !(200..299).include?(status)
 
               # HTTP 206 is Partial Content
               download_offset ||= (status == 206 ? @offset : 0)

data/lib/google/apis/core/http_command.rb

@@ -31,7 +31,7 @@ module Google
         RETRIABLE_ERRORS = [Google::Apis::ServerError,
                             Google::Apis::RateLimitError,
                             Google::Apis::TransmissionError,
-                            Google::Apis::RequestTimeOutError]
+                            Google::Apis::RequestTimeOutError].freeze
 
         begin
           require 'opencensus'
@@ -83,15 +83,15 @@ module Google
           self.url = url
           self.url = Addressable::Template.new(url) if url.is_a?(String)
           self.method = method
-          self.header = Hash.new
+          self.header = {}
           self.body = body
           self.query = {}
           self.params = {}
           @opencensus_span = nil
           if OPENCENSUS_AVAILABLE
             logger.warn  'OpenCensus support is now deprecated. ' +
-                         'Please refer https://github.com/googleapis/google-api-ruby-client#tracing for migrating to use OpenTelemetry.' 
-            
+                         'Please refer https://github.com/googleapis/google-api-ruby-client#tracing for migrating to use OpenTelemetry.'
+
           end
         end
 
@@ -114,34 +114,30 @@ module Google
           release!
         end
 
-        def do_retry func, client
-          begin
-            Retriable.retriable tries: options.retries + 1,
-                                max_elapsed_time: options.max_elapsed_time,
-                                base_interval: options.base_interval,
-                                max_interval: options.max_interval,
-                                multiplier: options.multiplier,
-                                on: RETRIABLE_ERRORS do |try|
-              # This 2nd level retriable only catches auth errors, and supports 1 retry, which allows
-              # auth to be re-attempted without having to retry all sorts of other failures like
-              # NotFound, etc
-              auth_tries = (try == 1 && authorization_refreshable? ? 2 : 1)
-              Retriable.retriable tries: auth_tries,
-                                  on: [Google::Apis::AuthorizationError, Signet::AuthorizationError, Signet::RemoteServerError, Signet::UnexpectedStatusError],
-                                  on_retry: proc { |*| refresh_authorization } do
-                send(func, client).tap do |result|
-                  if block_given?
-                    yield result, nil
-                  end
-                end
+        def do_retry(func, client)
+          Retriable.retriable tries: options.retries + 1,
+                              max_elapsed_time: options.max_elapsed_time,
+                              base_interval: options.base_interval,
+                              max_interval: options.max_interval,
+                              multiplier: options.multiplier,
+                              on: RETRIABLE_ERRORS do |try|
+            # This 2nd level retriable only catches auth errors, and supports 1 retry, which allows
+            # auth to be re-attempted without having to retry all sorts of other failures like
+            # NotFound, etc
+            auth_tries = (try == 1 && authorization_refreshable? ? 2 : 1)
+            Retriable.retriable tries: auth_tries,
+                                on: [Google::Apis::AuthorizationError, Signet::AuthorizationError, Signet::RemoteServerError, Signet::UnexpectedStatusError],
+                                on_retry: proc { |*| refresh_authorization } do
+              send(func, client).tap do |result|
+                yield result, nil if block_given?
               end
             end
-          rescue => e
-            if block_given?
-              yield nil, e
-            else
-              raise e
-            end
+          end
+        rescue StandardError => e
+          if block_given?
+            yield nil, e
+          else
+            raise e
           end
         end
 
@@ -164,6 +160,7 @@ module Google
         #
         # @private
         # @return [void]
+        # @raise [Google::Apis::ClientError] If path parameter validation fails.
         def prepare!
           normalize_unicode = true
           if options
@@ -171,7 +168,10 @@ module Google
             query.update(options.query) if options.query
             normalize_unicode = options.normalize_unicode
           end
-          self.url = url.expand(params, nil, normalize_unicode) if url.is_a?(Addressable::Template)
+          if url.is_a?(Addressable::Template)
+            validate_path_parameters!
+            self.url = encode_reserved_parameters(url, normalize_unicode).expand(params, nil, normalize_unicode)
+          end
           url.query_values = normalize_query_values(query).merge(url.query_values || {})
 
           if allow_form_encoding?
@@ -182,17 +182,16 @@ module Google
             @form_encoded = false
           end
 
-          self.body = '' if self.body.nil? && [:post, :put, :patch].include?(method)
+          self.body = '' if self.body.nil? && %i[post put patch].include?(method)
           if defined?(::Google::Apis::Core::CompositeIO) && body.is_a?(::Google::Apis::Core::CompositeIO)
-            header["Content-Length"] ||= body.size.to_s
+            header['Content-Length'] ||= body.size.to_s
           end
         end
 
         # Release any resources used by this command
         # @private
         # @return [void]
-        def release!
-        end
+        def release!; end
 
         # Check the response and either decode body or raise error
         #
@@ -298,7 +297,7 @@ module Google
             err = Google::Apis::TransmissionError.new(err)
           end
           block.call(nil, err) if block_given?
-          fail err if rethrow || block.nil?
+          raise err if rethrow || block.nil?
         end
 
         # Execute the command once.
@@ -323,7 +322,7 @@ module Google
             logger.debug { safe_single_line_representation @http_res }
             response = process_response(@http_res.status.to_i, @http_res.headers, @http_res.body)
             success(response)
-          rescue => e
+          rescue StandardError => e
             logger.debug { sprintf('Caught error %s', e) }
             error(e, rethrow: true)
           end
@@ -343,28 +342,33 @@ module Google
         end
 
         def allow_form_encoding?
-          [:post, :put].include?(method) && body.nil?
+          %i[post put].include?(method) && body.nil?
         end
 
         # Set the API version header for the service if not empty.
         # @return [void]
-        def set_api_version_header api_version
+        def set_api_version_header(api_version)
           self.header['X-Goog-Api-Version'] = api_version unless api_version.empty?
         end
 
         private
 
         UNSAFE_CLASS_NAMES = [
-          "Google::Apis::CloudkmsV1::DecryptResponse",
-          "Google::Apis::SecretmanagerV1::SecretPayload",
-          "Google::Apis::SecretmanagerV1beta1::SecretPayload"
-        ]
+          'Google::Apis::CloudkmsV1::DecryptResponse',
+          'Google::Apis::SecretmanagerV1::SecretPayload',
+          'Google::Apis::SecretmanagerV1beta1::SecretPayload'
+        ].freeze
+
+        # Matches the two URI template expressions Discovery documents use: simple ({var})
+        # and reserved ({+var}). Group 1 is '+' for reserved expansion, group 2 the name.
+        TEMPLATE_VAR_PATTERN = /\{(\+?)(\w+)\}/.freeze
 
         module RedactingPPMethods
-          def pp_object obj
+          def pp_object(obj)
             return super unless UNSAFE_CLASS_NAMES.include? obj.class.name
+
             object_address_group obj do
-              text "(fields redacted)"
+              text '(fields redacted)'
             end
           end
         end
@@ -377,16 +381,16 @@ module Google
           include RedactingPPMethods
         end
 
-        def safe_pretty_representation obj
-          out = +""
+        def safe_pretty_representation(obj)
+          out = +''
           printer = RedactingPP.new out, 79
           printer.guard_inspect_key { printer.pp obj }
           printer.flush
           out << "\n"
         end
 
-        def safe_single_line_representation obj
-          out = +""
+        def safe_single_line_representation(obj)
+          out = +''
           printer = RedactingSingleLine.new out
           printer.guard_inspect_key { printer.pp obj }
           printer.flush
@@ -400,9 +404,9 @@ module Google
 
           @opencensus_span = OpenCensus::Trace.start_span url.path.to_s
           @opencensus_span.kind = OpenCensus::Trace::SpanBuilder::CLIENT
-          @opencensus_span.put_attribute "http.host", url.host.to_s
-          @opencensus_span.put_attribute "http.method", method.to_s.upcase
-          @opencensus_span.put_attribute "http.path", url.path.to_s
+          @opencensus_span.put_attribute 'http.host', url.host.to_s
+          @opencensus_span.put_attribute 'http.method', method.to_s.upcase
+          @opencensus_span.put_attribute 'http.path', url.path.to_s
           sent_size =
             if body.respond_to? :bytesize
               body.bytesize
@@ -436,7 +440,7 @@ module Google
             status = @http_res.status.to_i
             if status > 0
               @opencensus_span.set_status map_http_status status
-              @opencensus_span.put_attribute "http.status_code", status
+              @opencensus_span.put_attribute 'http.status_code', status
             end
           end
 
@@ -452,7 +456,7 @@ module Google
           @form_encoded
         end
 
-        def map_http_status http_status
+        def map_http_status(http_status)
           case http_status
           when 200..399 then 0 # OK
           when 400 then 3 # INVALID_ARGUMENT
@@ -468,9 +472,8 @@ module Google
         end
 
         def normalize_query_values(input)
-          input.inject({}) do |h, (k, v)|
+          input.each_with_object({}) do |(k, v), h|
             h[k] = normalize_query_value(v)
-            h
           end
         end
 
@@ -484,6 +487,96 @@ module Google
             v.to_s
           end
         end
+
+        # Validates user-supplied path parameter values against the URL template specification
+        # to prevent directory traversal and parameter injection exploits.
+        #
+        # Validation rejects only dot segments. Other characters are percent-encoded instead.
+        #
+        # Validation Mechanism:
+        # 1. For simple variables ({var}, standard single-wildcard behavior):
+        #    - Rejects if the value is exactly '.' or '..'.
+        #    - Reserved characters such as '/', '?' and '#' are percent-encoded by Addressable.
+        # 2. For reserved variables ({+var}, double-wildcard behavior):
+        #    - Splits the value by slash ('/') and rejects any segment that is exactly '.' or '..'.
+        #    - Every character except '/' and unreserved characters is percent-encoded by
+        #      #encode_reserved_parameters.
+        #
+        # @raise [Google::Apis::ClientError] If any validation check fails.
+        def validate_path_parameters!
+          template_pattern = url.pattern
+
+          variables = template_pattern.scan(TEMPLATE_VAR_PATTERN).map do |operator, var_name|
+            { name: var_name, reserved: operator == '+' }
+          end
+
+          variables.each do |v|
+            var_name = v[:name]
+            var_key = params.key?(var_name) ? var_name : var_name.to_sym
+            next unless params.key?(var_key)
+
+            value = params[var_key].to_s
+
+            if v[:reserved]
+              value.split('/').each do |seg|
+                if ['.', '..'].include?(seg)
+                  raise Google::Apis::ClientError,
+                        "Value for #{var_name} must not contain segments that are exactly '#{seg}'."
+                end
+              end
+            elsif ['.', '..'].include?(value)
+              raise Google::Apis::ClientError,
+                    "Invalid value for #{var_name} '#{value}'."
+            end
+          end
+        end
+
+        # Substitutes percent-encoded values for reserved ({+var}) variables in the template.
+        #
+        # Addressable leaves reserved characters such as '+', ':', '?' and '#' literal in a
+        # reserved expansion, so they would reach the server unencoded. Only '/' and unreserved
+        # characters should stay literal, so these values are encoded here and written into the
+        # template's literal text, which Addressable passes through untouched when it expands
+        # the rest.
+        #
+        # @param [Addressable::Template] template
+        #   The URL template.
+        # @param [Boolean] normalize_unicode
+        #   Whether to apply Unicode NFC normalization to the values.
+        # @return [Addressable::Template]
+        #   A template with reserved variables replaced by their encoded values.
+        def encode_reserved_parameters(template, normalize_unicode)
+          pattern = template.pattern.dup
+          template.pattern.scan(TEMPLATE_VAR_PATTERN).each do |operator, var_name|
+            next unless operator == '+'
+
+            var_key = params.key?(var_name) ? var_name : var_name.to_sym
+            next unless params.key?(var_key)
+
+            # The encoded value contains no braces, so the new pattern parses cleanly and the
+            # value cannot introduce a template expression of its own.
+            pattern = pattern.gsub("{+#{var_name}}", encode_reserved_value(params[var_key], normalize_unicode))
+          end
+          Addressable::Template.new(pattern)
+        end
+
+        # Percent-encodes every character except '/' and unreserved characters.
+        #
+        # @param [Object] value
+        #   The parameter value.
+        # @param [Boolean] normalize_unicode
+        #   Whether to apply Unicode NFC normalization to the value.
+        # @return [String]
+        #   The encoded value.
+        def encode_reserved_value(value, normalize_unicode)
+          value = value.to_s
+          # Addressable only normalizes values left in the mapping, so normalize here to match.
+          value = value.unicode_normalize(:nfc) if normalize_unicode
+          # Split on '/' and keep empty segments (-1), so slashes stay literal.
+          # Each segment is then fully encoded, including '%' itself (as '%25').
+          unreserved = Addressable::URI::CharacterClasses::UNRESERVED
+          value.split('/', -1).map { |segment| Addressable::URI.encode_component(segment, unreserved) }.join('/')
+        end
       end
     end
   end

data/lib/google/apis/core/storage_download.rb

@@ -48,11 +48,12 @@ module Google
 
           http_res = client.get(url.to_s, query, request_header) do |request|
             request.options.on_data = proc do |chunk, _size, res|
-              # The on_data callback is only invoked on a successful response.
               # Some Faraday adapters (e.g. Typhoeus) may not provide a response
               # object in the callback, so we default to a 200 OK status.
+              # Note: Ignore non-2xx responses (redirects and 4xx/5xx error payloads)
+              # so error messages are not written to the download stream.
               status = res ? res.status.to_i : 200
-              next if chunk.nil? || (status >= 300 && status < 400)
+              next if chunk.nil? || !(200..299).include?(status)
 
               download_offset ||= (status == 206 ? @offset : 0)
               download_offset  += chunk.bytesize

data/lib/google/apis/core/version.rb

@@ -16,7 +16,7 @@ module Google
   module Apis
     module Core
       # Core version
-      VERSION = "1.2.4".freeze
+      VERSION = "1.4.1".freeze
     end
   end
 end

data/lib/google/apis/options.rb

@@ -23,7 +23,8 @@ module Google
       :read_timeout_sec,
       :send_timeout_sec,
       :log_http_requests,
-      :transparent_gzip_decompression)
+      :transparent_gzip_decompression,
+      :adapter)
 
     RequestOptions = Struct.new(
       :authorization,
@@ -50,6 +51,30 @@ module Google
       #   @return [String] Name of the application, for identification in the User-Agent header
       # @!attribute [rw] application_version
       #   @return [String] Version of the application, for identification in the User-Agent header
+      # @!attribute [rw] adapter
+      #   @return [Symbol, Class, nil] The Faraday adapter for HTTP connections, either a registered
+      #     adapter name ([Faraday adapters](https://lostisland.github.io/faraday/#/adapters/index?id=adapters),
+      #     for example `:net_http_persistent`) or an adapter class. If `nil` (the
+      #     default), Faraday uses `Faraday.default_adapter`, which is `:net_http` unless changed.
+      #
+      #     Only the default `:net_http` adapter is tested with google-apis-core. Any other adapter
+      #     is used at your own risk. It must:
+      #
+      #     * support response streaming with `on_data`, which media downloads require;
+      #     * honor the `open_timeout_sec`, `read_timeout_sec`, `send_timeout_sec` and `proxy_url`
+      #       settings;
+      #     * raise `Faraday::Error` subclasses for network failures, so that requests are retried;
+      #     * be safe to use from several threads at once, because each service shares a single
+      #       connection.
+      #
+      #     If the adapter keeps connections open, don't reuse them across `fork`. Create services
+      #     in each process after forking.
+      #
+      #     Load the adapter (for example `require "faraday/net_http_persistent"`) before the
+      #     connection is created. An unregistered name raises `Faraday::Error` at that point.
+      #     A service creates its connection once, on first use, so set this option before then.
+      #     Each service copies `ClientOptions.default` when it's created, so changing the default
+      #     only affects services created afterwards.
       # @!attribute [rw] proxy_url
       #   @return [String] URL of a proxy server
       # @!attribute [rw] log_http_requests
@@ -82,7 +107,7 @@ module Google
       # @!attribute [rw] max_interval
       #   @return [Integer] The maximum interval in seconds that any individual retry can reach.
       # @!attribute [rw] multiplier
-      #   @return [Numeric] Each successive interval grows by this factor. A multipler of 1.5 means the next interval 
+      #   @return [Numeric] Each successive interval grows by this factor. A multipler of 1.5 means the next interval
       #              will be 1.5x the current interval.
       # @!attribute [rw] header
       #   @return [Hash<String,String>] Additional HTTP headers to include in requests.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-core
 version: !ruby/object:Gem::Version
-  version: 1.2.4
+  version: 1.4.1
 platform: ruby
 authors:
 - Google LLC
@@ -85,28 +85,40 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: '1.21'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.21.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: '1.21'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.21.2
 - !ruby/object:Gem::Dependency
   name: representable
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.3.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.3.1
 - !ruby/object:Gem::Dependency
   name: retriable
   requirement: !ruby/object:Gem::Requirement
@@ -167,7 +179,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/google-apis-core/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-core/v1.2.4
+  documentation_uri: https://googleapis.dev/ruby/google-apis-core/v1.4.1
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/google-apis-core
 rdoc_options: []
 require_paths: