google-apis-safebrowsing_v5 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9c3d3f4749d1fafab33be737ca87f0c7ce2c4fa0b6129e112a99ef9f54e54955
-  data.tar.gz: ea42bab59507470c6a8541bc9f1a2de8c6200d6b0559da359ea5a6165a2407af
+  metadata.gz: dc5493c0b0c68deffa76a3bac649d6bc339d8d797fb5dea4fd4ad294555b8bd7
+  data.tar.gz: 826b05a941e0020f59e68034d649b91e0af82a3647d20a347d148424aac94872
 SHA512:
-  metadata.gz: 819ba445abd3aee5bc59800497950e0ddc050d4c70f492aed9d358a48f08c58d1f6f1ee06974e8c01f0052d4c16cf5b2dc70e432c89c9fcd200ed32196e20d92
-  data.tar.gz: 4c830394e974f62cb259839be2358ee32636671dc377e33525f993b2ed6098ce6d4d302cd7be279fd4c22a3d93714d52dec57056738d1fe724949a69988d084d
+  metadata.gz: d2c9f041e7007a42e60893c2808f42d6a525ed98a638e1356bddd72895eab8c6d3b697dfb19a684c879bc114c550b364dc9b6d9128618c85c3dc803b448148c5
+  data.tar.gz: 3dd82a9c381fbae2357ff101ce3567b6bf63afcc324945b7f100fc9964a1d5d3e546636ee712715a53d6f1de9613fd68dcdd269673fdf3bf43d84617409e1030

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-safebrowsing_v5
 
+### v0.9.0 (2025-12-21)
+
+* Regenerated from discovery document revision 20251214
+
 ### v0.8.0 (2025-05-25)
 
 * Regenerated from discovery document revision 20250518

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

@@ -550,6 +550,72 @@ module Google
           @full_hashes = args[:full_hashes] if args.key?(:full_hashes)
         end
       end
+      
+      # The response returned after searching threats matching the specified URLs. If
+      # nothing is found, the server will return an OK status (HTTP status code 200)
+      # with the `threats` field empty, rather than returning a NOT_FOUND status (HTTP
+      # status code 404).
+      class GoogleSecuritySafebrowsingV5SearchUrlsResponse
+        include Google::Apis::Core::Hashable
+      
+        # The client-side cache duration. The client MUST add this duration to the
+        # current time to determine the expiration time. The expiration time then
+        # applies to every URL queried by the client in the request, regardless of how
+        # many URLs are returned in the response. Even if the server returns no matches
+        # for a particular URL, this fact MUST also be cached by the client. If and only
+        # if the field `threats` is empty, the client MAY increase the `cache_duration`
+        # to determine a new expiration that is later than that specified by the server.
+        # In any case, the increased cache duration must not be longer than 24 hours.
+        # Important: the client MUST NOT assume that the server will return the same
+        # cache duration for all responses. The server MAY choose different cache
+        # durations for different responses depending on the situation.
+        # Corresponds to the JSON property `cacheDuration`
+        # @return [String]
+        attr_accessor :cache_duration
+      
+        # Unordered list. The unordered list of threat matches found. Each entry
+        # contains a URL and the threat types that were found matching that URL. The
+        # list size can be greater than the number of URLs in the request as the all
+        # expressions of the URL would've been considered.
+        # Corresponds to the JSON property `threats`
+        # @return [Array<Google::Apis::SafebrowsingV5::GoogleSecuritySafebrowsingV5ThreatUrl>]
+        attr_accessor :threats
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @cache_duration = args[:cache_duration] if args.key?(:cache_duration)
+          @threats = args[:threats] if args.key?(:threats)
+        end
+      end
+      
+      # A URL matching one or more threats.
+      class GoogleSecuritySafebrowsingV5ThreatUrl
+        include Google::Apis::Core::Hashable
+      
+        # Unordered list. The unordered list of threat that the URL is classified as.
+        # Corresponds to the JSON property `threatTypes`
+        # @return [Array<String>]
+        attr_accessor :threat_types
+      
+        # The requested URL that was matched by one or more threats.
+        # Corresponds to the JSON property `url`
+        # @return [String]
+        attr_accessor :url
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @threat_types = args[:threat_types] if args.key?(:threat_types)
+          @url = args[:url] if args.key?(:url)
+        end
+      end
     end
   end
 end

data/lib/google/apis/safebrowsing_v5/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module SafebrowsingV5
       # Version of the google-apis-safebrowsing_v5 gem
-      GEM_VERSION = "0.8.0"
+      GEM_VERSION = "0.9.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.18.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20250518"
+      REVISION = "20251214"
     end
   end
 end

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

@@ -88,6 +88,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleSecuritySafebrowsingV5SearchUrlsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleSecuritySafebrowsingV5ThreatUrl
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleSecuritySafebrowsingV5BatchGetHashListsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -207,6 +219,23 @@ module Google
       
         end
       end
+      
+      class GoogleSecuritySafebrowsingV5SearchUrlsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :cache_duration, as: 'cacheDuration'
+          collection :threats, as: 'threats', class: Google::Apis::SafebrowsingV5::GoogleSecuritySafebrowsingV5ThreatUrl, decorator: Google::Apis::SafebrowsingV5::GoogleSecuritySafebrowsingV5ThreatUrl::Representation
+      
+        end
+      end
+      
+      class GoogleSecuritySafebrowsingV5ThreatUrl
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :threat_types, as: 'threatTypes'
+          property :url, as: 'url'
+        end
+      end
     end
   end
 end

data/lib/google/apis/safebrowsing_v5/service.rb

@@ -55,7 +55,7 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Get the latest contents of a hash list. A hash list may either by a threat
+        # Gets the latest contents of a hash list. A hash list may either by a threat
         # list or a non-threat list such as the Global Cache. This is a standard Get
         # method as defined by https://google.aip.dev/131 and the HTTP method is also
         # GET.
@@ -109,10 +109,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Get multiple hash lists at once. It is very common for a client to need to get
-        # multiple hash lists. Using this method is preferred over using the regular Get
-        # method multiple times. This is a standard batch Get method as defined by https:
-        # //google.aip.dev/231 and the HTTP method is also GET.
+        # Gets multiple hash lists at once. It is very common for a client to need to
+        # get multiple hash lists. Using this method is preferred over using the regular
+        # Get method multiple times. This is a standard batch Get method as defined by
+        # https://google.aip.dev/231 and the HTTP method is also GET.
         # @param [Array<String>, String] names
         #   Required. The names of the particular hash lists. The list MAY be a threat
         #   list, or it may be the Global Cache. The names MUST NOT contain duplicates; if
@@ -167,7 +167,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # List hash lists. In the V5 API, Google will never remove a hash list that has
+        # Lists hash lists. In the V5 API, Google will never remove a hash list that has
         # ever been returned by this method. This enables clients to skip using this
         # method and simply hard-code all hash lists they need. This is a standard List
         # method as defined by https://google.aip.dev/132 and the HTTP method is GET.
@@ -206,7 +206,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Search for full hashes matching the specified prefixes. This is a custom
+        # Searches for full hashes matching the specified prefixes. This is a custom
         # method as defined by https://google.aip.dev/136 (the custom method refers to
         # this method having a custom name within Google's general API development
         # nomenclature; it does not refer to using a custom HTTP method).
@@ -241,6 +241,39 @@ module Google
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
+        
+        # Searches for URLs matching known threats. Each URL and it's host-suffix and
+        # path-prefix expressions (up to a limited depth) are checked. This means that
+        # the response may contain URLs that were not included in the request, but are
+        # expressions of the requested URLs.
+        # @param [Array<String>, String] urls
+        #   Required. The URLs to be looked up. Clients MUST NOT send more than 50 URLs.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::SafebrowsingV5::GoogleSecuritySafebrowsingV5SearchUrlsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::SafebrowsingV5::GoogleSecuritySafebrowsingV5SearchUrlsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def search_urls(urls: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v5/urls:search', options)
+          command.response_representation = Google::Apis::SafebrowsingV5::GoogleSecuritySafebrowsingV5SearchUrlsResponse::Representation
+          command.response_class = Google::Apis::SafebrowsingV5::GoogleSecuritySafebrowsingV5SearchUrlsResponse
+          command.query['urls'] = urls unless urls.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
 
         protected
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-safebrowsing_v5
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Google LLC
@@ -57,7 +57,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/generated/google-apis-safebrowsing_v5/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-safebrowsing_v5/v0.8.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-safebrowsing_v5/v0.9.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-safebrowsing_v5
 rdoc_options: []
 require_paths: