google-apis-safebrowsing_v5 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3820cb88e45315f06024049632f54d3cb17ad847b6b5532ced31eb20c2ff8248
-  data.tar.gz: 7992eaa27721421fea1f52be68c0810ec66bbfca0c7648cc63ba629c18fe4bb3
+  metadata.gz: f1181116a9a437fb1c1f5a58fae6b36e91e2b8217ccf22d554675c0bcc911596
+  data.tar.gz: ff03770e5e035cca234f74b02e70c9b4bcdcf9cfa93bb1521f2411b1504d7499
 SHA512:
-  metadata.gz: b8a1294a3417403234daf3fa2e9d2b6cdd14fb6e008f65b46defdd397b8abce758624931dd3d7db41999e128cffcfde5d6640851405eb3e3ee72c58afd9e35b1
-  data.tar.gz: 677e79d283d29d663d990f0a98b4c6b209344612cc823f8e98b050327afcfa012b812662af4925eceef13877d3e892e370aed977ba126858341dfe0577c3e0f4
+  metadata.gz: 3775677a46454eb8183eaa2dd438f97f9ad121f5cf4d4c4d5fc1735118f10a2116f0e26c649ce7cd63b8d30223ab6ac7b692acb855129e8d1a964cca8a86dca6
+  data.tar.gz: 7f2dcc3800848dc6d1a0a31b2b6ce7020b1ff972910bb4c33a972f99dd29aa0bbce7f0f8073ee8b2118f9a66559e6fba7f831b1d665e2177cc37bf2ba8a94f2d

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # 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
+
 ### v0.1.0 (2023-10-08)
 
 * Regenerated from discovery document revision 20230923

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.1.0"
+      GEM_VERSION = "0.3.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.12.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

@@ -36,6 +36,8 @@ module Google
       #
       # @see https://developers.google.com/safe-browsing/
       class SafebrowsingService < Google::Apis::Core::BaseService
+        DEFAULT_ENDPOINT_TEMPLATE = "https://safebrowsing.$UNIVERSE_DOMAIN$/"
+
         # @return [String]
         #  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.
@@ -47,16 +49,21 @@ module Google
         attr_accessor :quota_user
 
         def initialize
-          super('https://safebrowsing.googleapis.com/', '',
+          super(DEFAULT_ENDPOINT_TEMPLATE, '',
                 client_name: 'google-apis-safebrowsing_v5',
                 client_version: Google::Apis::SafebrowsingV5::GEM_VERSION)
           @batch_path = 'batch'
         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.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-10-08 00:00:00.000000000 Z
+date: 2024-02-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.11.0
+        version: 0.12.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.11.0
+        version: 0.12.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -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.1.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: []
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
+rubygems_version: 3.5.3
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Safe Browsing API V5