google-apis-safebrowsing_v5 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eb2550ebc5a3e0739ca93cc8bd9288d41e8e98cec61cf6212c24ca5df887852d
-  data.tar.gz: d6425039d83f003412f926921b77a4f659bed4c07a061158006daa39974b18e2
+  metadata.gz: f1181116a9a437fb1c1f5a58fae6b36e91e2b8217ccf22d554675c0bcc911596
+  data.tar.gz: ff03770e5e035cca234f74b02e70c9b4bcdcf9cfa93bb1521f2411b1504d7499
 SHA512:
-  metadata.gz: e336ecbe62e8a1f2d4342c56ddca3651d688f6d98a3afa208756f3d32f333a692185110d20d57cadc13830670fe469f1c34e0d72d5a3a3f52fd8d96c67caa47c
-  data.tar.gz: 9af016e07da66935df5118e29465d79b5ff57b43d55861127fbd31e2a6642bd96a16ac393a200d1f23663242746299095b844f327bb7e25c0650123f8f16e443
+  metadata.gz: 3775677a46454eb8183eaa2dd438f97f9ad121f5cf4d4c4d5fc1735118f10a2116f0e26c649ce7cd63b8d30223ab6ac7b692acb855129e8d1a964cca8a86dca6
+  data.tar.gz: 7f2dcc3800848dc6d1a0a31b2b6ce7020b1ff972910bb4c33a972f99dd29aa0bbce7f0f8073ee8b2118f9a66559e6fba7f831b1d665e2177cc37bf2ba8a94f2d

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Release history for google-apis-safebrowsing_v5
 
+### v0.3.0 (2024-02-18)
+
+* Regenerated from discovery document revision 20240211
+* Regenerated using generator version 0.13.1
+
 ### v0.2.0 (2024-01-23)
 
 * Regenerated using generator version 0.13.0

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

@@ -54,12 +54,13 @@ module Google
       # compatibility: new threat types and threat attributes may be added by the
       # server at any time; those additions are considered minor version changes. It
       # is Google's policy not to expose minor version numbers in APIs (see https://
-      # cloud.google.com/apis/design/versioning), so clients MUST be prepared to
-      # receive FullHashDetail messages containing ThreatType enum values or
-      # ThreatAttribute enum values that are considered invalid by the client.
-      # Therefore, it is the client's responsibility to check for the validity of all
-      # ThreatType and ThreatAttribute enum values; if any value is considered invalid,
-      # the client MUST disregard the entire FullHashDetail message.
+      # cloud.google.com/apis/design/versioning for the versioning policy), so clients
+      # MUST be prepared to receive `FullHashDetail` messages containing `ThreatType`
+      # enum values or `ThreatAttribute` enum values that are considered invalid by
+      # the client. Therefore, it is the client's responsibility to check for the
+      # validity of all `ThreatType` and `ThreatAttribute` enum values; if any value
+      # is considered invalid, the client MUST disregard the entire `FullHashDetail`
+      # message.
       class GoogleSecuritySafebrowsingV5FullHashFullHashDetail
         include Google::Apis::Core::Hashable
       
@@ -85,20 +86,24 @@ module Google
         end
       end
       
-      # The response returned after searching threat hashes. Note that if nothing is
-      # found, the server will return an OK status (HTTP status code 200) with the `
-      # full_hashes` field empty, rather than returning a NOT_FOUND status (HTTP
-      # status code 404).
+      # The response returned after searching threat hashes. If nothing is found, the
+      # server will return an OK status (HTTP status code 200) with the `full_hashes`
+      # field empty, rather than returning a NOT_FOUND status (HTTP status code 404). *
+      # *What's new in V5**: There is a separation between FullHash and FullHashDetail.
+      # In the case when a hash represents a site having multiple threats (e.g. both
+      # MALWARE and SOCIAL_ENGINEERING), the full hash does not need to be sent twice
+      # as in V4. Furthermore, the cache duration has been simplified into a single `
+      # cache_duration` field.
       class GoogleSecuritySafebrowsingV5SearchHashesResponse
         include Google::Apis::Core::Hashable
       
-        # The client-side cache duration. The client shall add this duration to the
+        # 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 hash prefix queried by the client in the request, regardless
         # of how many full hashes are returned in the response. Even if the server
-        # returns no full hashes for a particular hash prefix, this fact should also be
-        # cached by the client. Important: the client must not assume that the server
-        # will return the same cache duration for all responses. The server may choose
+        # returns no full hashes for a particular hash prefix, this fact MUST also be
+        # cached by the client. 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]

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.2.0"
+      GEM_VERSION = "0.3.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.13.0"
+      GENERATOR_VERSION = "0.13.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230923"
+      REVISION = "20240211"
     end
   end
 end

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

@@ -56,9 +56,14 @@ module Google
         end
         
         # Search for full hashes matching the specified prefixes. This is a custom
-        # method as described by guidance at https://google.aip.dev/136
+        # 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).
         # @param [Array<String>, String] hash_prefixes
-        #   Required. The hash prefixes to be looked up.
+        #   Required. The hash prefixes to be looked up. Clients MUST NOT send more than
+        #   1000 hash prefixes. However, following the URL processing procedure, clients
+        #   SHOULD NOT need to send more than 30 hash prefixes. Currently each hash prefix
+        #   is required to be exactly 4 bytes long. This MAY be relaxed in the future.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-safebrowsing_v5
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-01-23 00:00:00.000000000 Z
+date: 2024-02-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,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.2.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-safebrowsing_v5/v0.3.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-safebrowsing_v5
 post_install_message: 
 rdoc_options: []