diff --git a/clients/google-api-services-safebrowsing/v5/2.0.0/README.md b/clients/google-api-services-safebrowsing/v5/2.0.0/README.md index adfe437c0c9..72bc82dd556 100644 --- a/clients/google-api-services-safebrowsing/v5/2.0.0/README.md +++ b/clients/google-api-services-safebrowsing/v5/2.0.0/README.md @@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file: com.google.apis google-api-services-safebrowsing - v5-rev20250518-2.0.0 + v5-rev20251214-2.0.0 @@ -35,7 +35,7 @@ repositories { mavenCentral() } dependencies { - implementation 'com.google.apis:google-api-services-safebrowsing:v5-rev20250518-2.0.0' + implementation 'com.google.apis:google-api-services-safebrowsing:v5-rev20251214-2.0.0' } ``` diff --git a/clients/google-api-services-safebrowsing/v5/2.0.0/com/google/api/services/safebrowsing/v5/Safebrowsing.java b/clients/google-api-services-safebrowsing/v5/2.0.0/com/google/api/services/safebrowsing/v5/Safebrowsing.java index a8483041a6a..3103d12472f 100644 --- a/clients/google-api-services-safebrowsing/v5/2.0.0/com/google/api/services/safebrowsing/v5/Safebrowsing.java +++ b/clients/google-api-services-safebrowsing/v5/2.0.0/com/google/api/services/safebrowsing/v5/Safebrowsing.java @@ -154,7 +154,7 @@ public HashList hashList() { public class HashList { /** - * Get the latest contents of a hash list. A hash list may either by a threat list or a non-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. * @@ -178,8 +178,8 @@ public class Get extends SafebrowsingRequestThe typical use is:

+ * 
+   *   {@code Safebrowsing safebrowsing = new Safebrowsing(...);}
+   *   {@code Safebrowsing.Urls.List request = safebrowsing.urls().list(parameters ...)}
+   *
+ * + * @return the resource collection + */ + public Urls urls() { + return new Urls(); + } + + /** + * The "urls" collection of methods. + */ + public class Urls { + + /** + * 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. + * + * Create a request for the method "urls.search". + * + * This request holds the parameters needed by the safebrowsing server. After setting any optional + * parameters, call the {@link Search#execute()} method to invoke the remote operation. + * + * @return the request + */ + public Search search() throws java.io.IOException { + Search result = new Search(); + initialize(result); + return result; + } + + public class Search extends SafebrowsingRequest { + + private static final String REST_PATH = "v5/urls:search"; + + /** + * 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. + * + * Create a request for the method "urls.search". + * + * This request holds the parameters needed by the the safebrowsing server. After setting any + * optional parameters, call the {@link Search#execute()} method to invoke the remote operation. + *

{@link + * Search#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must + * be called to initialize this instance immediately after invoking the constructor.

+ * + * @since 1.13 + */ + protected Search() { + super(Safebrowsing.this, "GET", REST_PATH, null, com.google.api.services.safebrowsing.v5.model.GoogleSecuritySafebrowsingV5SearchUrlsResponse.class); + } + + @Override + public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException { + return super.executeUsingHead(); + } + + @Override + public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException { + return super.buildHttpRequestUsingHead(); + } + + @Override + public Search set$Xgafv(java.lang.String $Xgafv) { + return (Search) super.set$Xgafv($Xgafv); + } + + @Override + public Search setAccessToken(java.lang.String accessToken) { + return (Search) super.setAccessToken(accessToken); + } + + @Override + public Search setAlt(java.lang.String alt) { + return (Search) super.setAlt(alt); + } + + @Override + public Search setCallback(java.lang.String callback) { + return (Search) super.setCallback(callback); + } + + @Override + public Search setFields(java.lang.String fields) { + return (Search) super.setFields(fields); + } + + @Override + public Search setKey(java.lang.String key) { + return (Search) super.setKey(key); + } + + @Override + public Search setOauthToken(java.lang.String oauthToken) { + return (Search) super.setOauthToken(oauthToken); + } + + @Override + public Search setPrettyPrint(java.lang.Boolean prettyPrint) { + return (Search) super.setPrettyPrint(prettyPrint); + } + + @Override + public Search setQuotaUser(java.lang.String quotaUser) { + return (Search) super.setQuotaUser(quotaUser); + } + + @Override + public Search setUploadType(java.lang.String uploadType) { + return (Search) super.setUploadType(uploadType); + } + + @Override + public Search setUploadProtocol(java.lang.String uploadProtocol) { + return (Search) super.setUploadProtocol(uploadProtocol); + } + + /** Required. The URLs to be looked up. Clients MUST NOT send more than 50 URLs. */ + @com.google.api.client.util.Key + private java.util.List urls; + + /** Required. The URLs to be looked up. Clients MUST NOT send more than 50 URLs. + */ + public java.util.List getUrls() { + return urls; + } + + /** Required. The URLs to be looked up. Clients MUST NOT send more than 50 URLs. */ + public Search setUrls(java.util.List urls) { + this.urls = urls; + return this; + } + + @Override + public Search set(String parameterName, Object value) { + return (Search) super.set(parameterName, value); + } + } + + } + /** * Builder for {@link Safebrowsing}. * diff --git a/clients/google-api-services-safebrowsing/v5/2.0.0/com/google/api/services/safebrowsing/v5/model/GoogleSecuritySafebrowsingV5SearchUrlsResponse.java b/clients/google-api-services-safebrowsing/v5/2.0.0/com/google/api/services/safebrowsing/v5/model/GoogleSecuritySafebrowsingV5SearchUrlsResponse.java new file mode 100644 index 00000000000..7d19cdf5ee8 --- /dev/null +++ b/clients/google-api-services-safebrowsing/v5/2.0.0/com/google/api/services/safebrowsing/v5/model/GoogleSecuritySafebrowsingV5SearchUrlsResponse.java @@ -0,0 +1,122 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except + * in compliance with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software distributed under the License + * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express + * or implied. See the License for the specific language governing permissions and limitations under + * the License. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.safebrowsing.v5.model; + +/** + * 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). + * + *

This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Safe Browsing API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

+ * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class GoogleSecuritySafebrowsingV5SearchUrlsResponse extends com.google.api.client.json.GenericJson { + + /** + * 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. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private String cacheDuration; + + /** + * 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. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.List threats; + + /** + * 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. + * @return value or {@code null} for none + */ + public String getCacheDuration() { + return cacheDuration; + } + + /** + * 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. + * @param cacheDuration cacheDuration or {@code null} for none + */ + public GoogleSecuritySafebrowsingV5SearchUrlsResponse setCacheDuration(String cacheDuration) { + this.cacheDuration = cacheDuration; + return this; + } + + /** + * 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. + * @return value or {@code null} for none + */ + public java.util.List getThreats() { + return threats; + } + + /** + * 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. + * @param threats threats or {@code null} for none + */ + public GoogleSecuritySafebrowsingV5SearchUrlsResponse setThreats(java.util.List threats) { + this.threats = threats; + return this; + } + + @Override + public GoogleSecuritySafebrowsingV5SearchUrlsResponse set(String fieldName, Object value) { + return (GoogleSecuritySafebrowsingV5SearchUrlsResponse) super.set(fieldName, value); + } + + @Override + public GoogleSecuritySafebrowsingV5SearchUrlsResponse clone() { + return (GoogleSecuritySafebrowsingV5SearchUrlsResponse) super.clone(); + } + +} diff --git a/clients/google-api-services-safebrowsing/v5/2.0.0/com/google/api/services/safebrowsing/v5/model/GoogleSecuritySafebrowsingV5ThreatUrl.java b/clients/google-api-services-safebrowsing/v5/2.0.0/com/google/api/services/safebrowsing/v5/model/GoogleSecuritySafebrowsingV5ThreatUrl.java new file mode 100644 index 00000000000..dbfbd6dcbaa --- /dev/null +++ b/clients/google-api-services-safebrowsing/v5/2.0.0/com/google/api/services/safebrowsing/v5/model/GoogleSecuritySafebrowsingV5ThreatUrl.java @@ -0,0 +1,90 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except + * in compliance with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software distributed under the License + * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express + * or implied. See the License for the specific language governing permissions and limitations under + * the License. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.safebrowsing.v5.model; + +/** + * A URL matching one or more threats. + * + *

This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Safe Browsing API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

+ * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class GoogleSecuritySafebrowsingV5ThreatUrl extends com.google.api.client.json.GenericJson { + + /** + * Unordered list. The unordered list of threat that the URL is classified as. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.List threatTypes; + + /** + * The requested URL that was matched by one or more threats. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String url; + + /** + * Unordered list. The unordered list of threat that the URL is classified as. + * @return value or {@code null} for none + */ + public java.util.List getThreatTypes() { + return threatTypes; + } + + /** + * Unordered list. The unordered list of threat that the URL is classified as. + * @param threatTypes threatTypes or {@code null} for none + */ + public GoogleSecuritySafebrowsingV5ThreatUrl setThreatTypes(java.util.List threatTypes) { + this.threatTypes = threatTypes; + return this; + } + + /** + * The requested URL that was matched by one or more threats. + * @return value or {@code null} for none + */ + public java.lang.String getUrl() { + return url; + } + + /** + * The requested URL that was matched by one or more threats. + * @param url url or {@code null} for none + */ + public GoogleSecuritySafebrowsingV5ThreatUrl setUrl(java.lang.String url) { + this.url = url; + return this; + } + + @Override + public GoogleSecuritySafebrowsingV5ThreatUrl set(String fieldName, Object value) { + return (GoogleSecuritySafebrowsingV5ThreatUrl) super.set(fieldName, value); + } + + @Override + public GoogleSecuritySafebrowsingV5ThreatUrl clone() { + return (GoogleSecuritySafebrowsingV5ThreatUrl) super.clone(); + } + +} diff --git a/clients/google-api-services-safebrowsing/v5/2.0.0/pom.xml b/clients/google-api-services-safebrowsing/v5/2.0.0/pom.xml index 424c6e270dd..116509a17cf 100644 --- a/clients/google-api-services-safebrowsing/v5/2.0.0/pom.xml +++ b/clients/google-api-services-safebrowsing/v5/2.0.0/pom.xml @@ -8,8 +8,8 @@ com.google.apis google-api-services-safebrowsing - v5-rev20250518-2.0.0 - Safe Browsing API v5-rev20250518-2.0.0 + v5-rev20251214-2.0.0 + Safe Browsing API v5-rev20251214-2.0.0 jar 2011 diff --git a/clients/google-api-services-safebrowsing/v5/README.md b/clients/google-api-services-safebrowsing/v5/README.md index adfe437c0c9..72bc82dd556 100644 --- a/clients/google-api-services-safebrowsing/v5/README.md +++ b/clients/google-api-services-safebrowsing/v5/README.md @@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file: com.google.apis google-api-services-safebrowsing - v5-rev20250518-2.0.0 + v5-rev20251214-2.0.0 @@ -35,7 +35,7 @@ repositories { mavenCentral() } dependencies { - implementation 'com.google.apis:google-api-services-safebrowsing:v5-rev20250518-2.0.0' + implementation 'com.google.apis:google-api-services-safebrowsing:v5-rev20251214-2.0.0' } ```