feat: Add SOCIAL_ENGINEERING_EXTENDED_COVERAGE threat type (#238)

* feat: Add SOCIAL_ENGINEERING_EXTENDED_COVERAGE threat type

PiperOrigin-RevId: 481130618

Source-Link: googleapis/googleapis@9fba835

Source-Link: https://github.com/googleapis/googleapis-gen/commit/5d66ac0724952fa725ccf940fbbec9fb509ddde3
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNWQ2NmFjMDcyNDk1MmZhNzI1Y2NmOTQwZmJiZWM5ZmI1MDlkZGRlMyJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

google/cloud/webrisk_v1/services/web_risk_service/async_client.py

@@ -241,7 +241,7 @@ async def sample_compute_threat_list_diff():
 
                 # Initialize request argument(s)
                 request = webrisk_v1.ComputeThreatListDiffRequest(
-                    threat_type="UNWANTED_SOFTWARE",
+                    threat_type="SOCIAL_ENGINEERING_EXTENDED_COVERAGE",
                 )
 
                 # Make the request
@@ -256,7 +256,9 @@ async def sample_compute_threat_list_diff():
             threat_type (:class:`google.cloud.webrisk_v1.types.ThreatType`):
                 Required. The threat list to update.
                 Only a single ThreatType should be
-                specified.
+                specified per request. If you want to
+                handle multiple ThreatTypes, you must
+                make one request per ThreatType.
 
                 This corresponds to the ``threat_type`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -377,7 +379,7 @@ async def sample_search_uris():
                 # Initialize request argument(s)
                 request = webrisk_v1.SearchUrisRequest(
                     uri="uri_value",
-                    threat_types="UNWANTED_SOFTWARE",
+                    threat_types="SOCIAL_ENGINEERING_EXTENDED_COVERAGE",
                 )
 
                 # Make the request
@@ -497,7 +499,7 @@ async def sample_search_hashes():
 
                 # Initialize request argument(s)
                 request = webrisk_v1.SearchHashesRequest(
-                    threat_types="UNWANTED_SOFTWARE",
+                    threat_types="SOCIAL_ENGINEERING_EXTENDED_COVERAGE",
                 )
 
                 # Make the request
@@ -514,7 +516,10 @@ async def sample_search_hashes():
                 A hash prefix, consisting of the most
                 significant 4-32 bytes of a SHA256 hash.
                 For JSON requests, this field is
-                base64-encoded.
+                base64-encoded. Note that if this
+                parameter is provided by a URI, it must
+                be encoded using the web safe base64
+                variant (RFC 4648).
 
                 This corresponds to the ``hash_prefix`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -601,8 +606,9 @@ async def create_submission(
         `Google's Social Engineering
         lists <https://support.google.com/webmasters/answer/6350487/>`__
         in order to protect users that could get exposed to this threat
-        in the future. Only projects with CREATE_SUBMISSION_USERS
-        visibility can use this method.
+        in the future. Only allowlisted projects can use this method
+        during Early Access. Please reach out to Sales or your customer
+        engineer to obtain access.
 
         .. code-block:: python
 
@@ -663,7 +669,7 @@ async def sample_create_submission():
         Returns:
             google.cloud.webrisk_v1.types.Submission:
                 Wraps a URI that might be displaying
-                phishing content.
+                malicious content.
 
         """
         # Create or coerce a protobuf request object.
@@ -689,7 +695,7 @@ async def sample_create_submission():
         # and friendly error handling.
         rpc = gapic_v1.method_async.wrap_method(
             self._client._transport.create_submission,
-            default_timeout=60.0,
+            default_timeout=600.0,
             client_info=DEFAULT_CLIENT_INFO,
         )
 

google/cloud/webrisk_v1/services/web_risk_service/client.py

@@ -446,7 +446,7 @@ def sample_compute_threat_list_diff():
 
                 # Initialize request argument(s)
                 request = webrisk_v1.ComputeThreatListDiffRequest(
-                    threat_type="UNWANTED_SOFTWARE",
+                    threat_type="SOCIAL_ENGINEERING_EXTENDED_COVERAGE",
                 )
 
                 # Make the request
@@ -461,7 +461,9 @@ def sample_compute_threat_list_diff():
             threat_type (google.cloud.webrisk_v1.types.ThreatType):
                 Required. The threat list to update.
                 Only a single ThreatType should be
-                specified.
+                specified per request. If you want to
+                handle multiple ThreatTypes, you must
+                make one request per ThreatType.
 
                 This corresponds to the ``threat_type`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -572,7 +574,7 @@ def sample_search_uris():
                 # Initialize request argument(s)
                 request = webrisk_v1.SearchUrisRequest(
                     uri="uri_value",
-                    threat_types="UNWANTED_SOFTWARE",
+                    threat_types="SOCIAL_ENGINEERING_EXTENDED_COVERAGE",
                 )
 
                 # Make the request
@@ -682,7 +684,7 @@ def sample_search_hashes():
 
                 # Initialize request argument(s)
                 request = webrisk_v1.SearchHashesRequest(
-                    threat_types="UNWANTED_SOFTWARE",
+                    threat_types="SOCIAL_ENGINEERING_EXTENDED_COVERAGE",
                 )
 
                 # Make the request
@@ -699,7 +701,10 @@ def sample_search_hashes():
                 A hash prefix, consisting of the most
                 significant 4-32 bytes of a SHA256 hash.
                 For JSON requests, this field is
-                base64-encoded.
+                base64-encoded. Note that if this
+                parameter is provided by a URI, it must
+                be encoded using the web safe base64
+                variant (RFC 4648).
 
                 This corresponds to the ``hash_prefix`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -776,8 +781,9 @@ def create_submission(
         `Google's Social Engineering
         lists <https://support.google.com/webmasters/answer/6350487/>`__
         in order to protect users that could get exposed to this threat
-        in the future. Only projects with CREATE_SUBMISSION_USERS
-        visibility can use this method.
+        in the future. Only allowlisted projects can use this method
+        during Early Access. Please reach out to Sales or your customer
+        engineer to obtain access.
 
         .. code-block:: python
 
@@ -838,7 +844,7 @@ def sample_create_submission():
         Returns:
             google.cloud.webrisk_v1.types.Submission:
                 Wraps a URI that might be displaying
-                phishing content.
+                malicious content.
 
         """
         # Create or coerce a protobuf request object.

google/cloud/webrisk_v1/services/web_risk_service/transports/base.py

@@ -174,7 +174,7 @@ def _prep_wrapped_messages(self, client_info):
             ),
             self.create_submission: gapic_v1.method.wrap_method(
                 self.create_submission,
-                default_timeout=60.0,
+                default_timeout=600.0,
                 client_info=client_info,
             ),
         }

google/cloud/webrisk_v1/services/web_risk_service/transports/grpc.py

@@ -338,8 +338,9 @@ def create_submission(
         `Google's Social Engineering
         lists <https://support.google.com/webmasters/answer/6350487/>`__
         in order to protect users that could get exposed to this threat
-        in the future. Only projects with CREATE_SUBMISSION_USERS
-        visibility can use this method.
+        in the future. Only allowlisted projects can use this method
+        during Early Access. Please reach out to Sales or your customer
+        engineer to obtain access.
 
         Returns:
             Callable[[~.CreateSubmissionRequest],

google/cloud/webrisk_v1/services/web_risk_service/transports/grpc_asyncio.py

@@ -344,8 +344,9 @@ def create_submission(
         `Google's Social Engineering
         lists <https://support.google.com/webmasters/answer/6350487/>`__
         in order to protect users that could get exposed to this threat
-        in the future. Only projects with CREATE_SUBMISSION_USERS
-        visibility can use this method.
+        in the future. Only allowlisted projects can use this method
+        during Early Access. Please reach out to Sales or your customer
+        engineer to obtain access.
 
         Returns:
             Callable[[~.CreateSubmissionRequest],

google/cloud/webrisk_v1/types/webrisk.py

@@ -39,13 +39,14 @@
 
 
 class ThreatType(proto.Enum):
-    r"""The type of threat. This maps dirrectly to the threat list a
+    r"""The type of threat. This maps directly to the threat list a
     threat may belong to.
     """
     THREAT_TYPE_UNSPECIFIED = 0
     MALWARE = 1
     SOCIAL_ENGINEERING = 2
     UNWANTED_SOFTWARE = 3
+    SOCIAL_ENGINEERING_EXTENDED_COVERAGE = 4
 
 
 class CompressionType(proto.Enum):
@@ -61,7 +62,10 @@ class ComputeThreatListDiffRequest(proto.Message):
     Attributes:
         threat_type (google.cloud.webrisk_v1.types.ThreatType):
             Required. The threat list to update. Only a
-            single ThreatType should be specified.
+            single ThreatType should be specified per
+            request. If you want to handle multiple
+            ThreatTypes, you must make one request per
+            ThreatType.
         version_token (bytes):
             The current version token of the client for
             the requested list (the client version that was
@@ -238,8 +242,8 @@ class SearchUrisResponse(proto.Message):
 
     Attributes:
         threat (google.cloud.webrisk_v1.types.SearchUrisResponse.ThreatUri):
-            The threat list matches. This may be empty if
-            the URI is on no list.
+            The threat list matches. This might be empty
+            if the URI is on no list.
     """
 
     class ThreatUri(proto.Message):
@@ -281,6 +285,9 @@ class SearchHashesRequest(proto.Message):
             A hash prefix, consisting of the most
             significant 4-32 bytes of a SHA256 hash. For
             JSON requests, this field is base64-encoded.
+            Note that if this parameter is provided by a
+            URI, it must be encoded using the web safe
+            base64 variant (RFC 4648).
         threat_types (Sequence[google.cloud.webrisk_v1.types.ThreatType]):
             Required. The ThreatLists to search in.
             Multiple ThreatLists may be specified.
@@ -500,12 +507,12 @@ class RiceDeltaEncoding(proto.Message):
 
 
 class Submission(proto.Message):
-    r"""Wraps a URI that might be displaying phishing content.
+    r"""Wraps a URI that might be displaying malicious content.
 
     Attributes:
         uri (str):
             Required. The URI that is being reported for
-            phishing content to be analyzed.
+            malicious content to be analyzed.
     """
 
     uri = proto.Field(

samples/generated_samples/webrisk_v1_generated_web_risk_service_compute_threat_list_diff_async.py

@@ -40,7 +40,7 @@ async def sample_compute_threat_list_diff():
 
     # Initialize request argument(s)
     request = webrisk_v1.ComputeThreatListDiffRequest(
-        threat_type="UNWANTED_SOFTWARE",
+        threat_type="SOCIAL_ENGINEERING_EXTENDED_COVERAGE",
     )
 
     # Make the request

samples/generated_samples/webrisk_v1_generated_web_risk_service_compute_threat_list_diff_sync.py

@@ -40,7 +40,7 @@ def sample_compute_threat_list_diff():
 
     # Initialize request argument(s)
     request = webrisk_v1.ComputeThreatListDiffRequest(
-        threat_type="UNWANTED_SOFTWARE",
+        threat_type="SOCIAL_ENGINEERING_EXTENDED_COVERAGE",
     )
 
     # Make the request

samples/generated_samples/webrisk_v1_generated_web_risk_service_search_hashes_async.py

@@ -40,7 +40,7 @@ async def sample_search_hashes():
 
     # Initialize request argument(s)
     request = webrisk_v1.SearchHashesRequest(
-        threat_types="UNWANTED_SOFTWARE",
+        threat_types="SOCIAL_ENGINEERING_EXTENDED_COVERAGE",
     )
 
     # Make the request

samples/generated_samples/webrisk_v1_generated_web_risk_service_search_hashes_sync.py

@@ -40,7 +40,7 @@ def sample_search_hashes():
 
     # Initialize request argument(s)
     request = webrisk_v1.SearchHashesRequest(
-        threat_types="UNWANTED_SOFTWARE",
+        threat_types="SOCIAL_ENGINEERING_EXTENDED_COVERAGE",
     )
 
     # Make the request

samples/generated_samples/webrisk_v1_generated_web_risk_service_search_uris_async.py

@@ -41,7 +41,7 @@ async def sample_search_uris():
     # Initialize request argument(s)
     request = webrisk_v1.SearchUrisRequest(
         uri="uri_value",
-        threat_types="UNWANTED_SOFTWARE",
+        threat_types="SOCIAL_ENGINEERING_EXTENDED_COVERAGE",
     )
 
     # Make the request

samples/generated_samples/webrisk_v1_generated_web_risk_service_search_uris_sync.py

@@ -41,7 +41,7 @@ def sample_search_uris():
     # Initialize request argument(s)
     request = webrisk_v1.SearchUrisRequest(
         uri="uri_value",
-        threat_types="UNWANTED_SOFTWARE",
+        threat_types="SOCIAL_ENGINEERING_EXTENDED_COVERAGE",
     )
 
     # Make the request