Regenerate safebrowsing client (#7760)

Generated in GitHub action: https://togithub.com/googleapis/googleapis/google-api-php-client-services/actions/workflows/codegen.yaml

Author: yoshi-code-bot

src/Safebrowsing.php

@@ -43,6 +43,7 @@ class Safebrowsing extends \Google\Service
   public $hashList;
   public $hashLists;
   public $hashes;
+  public $urls;
   public $rootUrlTemplate;
 
   /**
@@ -160,6 +161,26 @@ public function __construct($clientOrConfig = [], $rootUrl = null)
           ]
         ]
     );
+    $this->urls = new Safebrowsing\Resource\Urls(
+        $this,
+        $this->serviceName,
+        'urls',
+        [
+          'methods' => [
+            'search' => [
+              'path' => 'v5/urls:search',
+              'httpMethod' => 'GET',
+              'parameters' => [
+                'urls' => [
+                  'location' => 'query',
+                  'type' => 'string',
+                  'repeated' => true,
+                ],
+              ],
+            ],
+          ]
+        ]
+    );
   }
 }
 

src/Safebrowsing/GoogleSecuritySafebrowsingV5SearchUrlsResponse.php

@@ -0,0 +1,92 @@
+<?php
+/*
+ * Copyright 2014 Google Inc.
+ *
+ * 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.
+ */
+
+namespace Google\Service\Safebrowsing;
+
+class GoogleSecuritySafebrowsingV5SearchUrlsResponse extends \Google\Collection
+{
+  protected $collection_key = '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.
+   *
+   * @var string
+   */
+  public $cacheDuration;
+  protected $threatsType = GoogleSecuritySafebrowsingV5ThreatUrl::class;
+  protected $threatsDataType = 'array';
+
+  /**
+   * 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 string $cacheDuration
+   */
+  public function setCacheDuration($cacheDuration)
+  {
+    $this->cacheDuration = $cacheDuration;
+  }
+  /**
+   * @return string
+   */
+  public function getCacheDuration()
+  {
+    return $this->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.
+   *
+   * @param GoogleSecuritySafebrowsingV5ThreatUrl[] $threats
+   */
+  public function setThreats($threats)
+  {
+    $this->threats = $threats;
+  }
+  /**
+   * @return GoogleSecuritySafebrowsingV5ThreatUrl[]
+   */
+  public function getThreats()
+  {
+    return $this->threats;
+  }
+}
+
+// Adding a class alias for backwards compatibility with the previous class name.
+class_alias(GoogleSecuritySafebrowsingV5SearchUrlsResponse::class, 'Google_Service_Safebrowsing_GoogleSecuritySafebrowsingV5SearchUrlsResponse');

src/Safebrowsing/GoogleSecuritySafebrowsingV5ThreatUrl.php

@@ -0,0 +1,71 @@
+<?php
+/*
+ * Copyright 2014 Google Inc.
+ *
+ * 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.
+ */
+
+namespace Google\Service\Safebrowsing;
+
+class GoogleSecuritySafebrowsingV5ThreatUrl extends \Google\Collection
+{
+  protected $collection_key = 'threatTypes';
+  /**
+   * Unordered list. The unordered list of threat that the URL is classified as.
+   *
+   * @var string[]
+   */
+  public $threatTypes;
+  /**
+   * The requested URL that was matched by one or more threats.
+   *
+   * @var string
+   */
+  public $url;
+
+  /**
+   * Unordered list. The unordered list of threat that the URL is classified as.
+   *
+   * @param string[] $threatTypes
+   */
+  public function setThreatTypes($threatTypes)
+  {
+    $this->threatTypes = $threatTypes;
+  }
+  /**
+   * @return string[]
+   */
+  public function getThreatTypes()
+  {
+    return $this->threatTypes;
+  }
+  /**
+   * The requested URL that was matched by one or more threats.
+   *
+   * @param string $url
+   */
+  public function setUrl($url)
+  {
+    $this->url = $url;
+  }
+  /**
+   * @return string
+   */
+  public function getUrl()
+  {
+    return $this->url;
+  }
+}
+
+// Adding a class alias for backwards compatibility with the previous class name.
+class_alias(GoogleSecuritySafebrowsingV5ThreatUrl::class, 'Google_Service_Safebrowsing_GoogleSecuritySafebrowsingV5ThreatUrl');

src/Safebrowsing/Resource/HashList.php

@@ -30,7 +30,7 @@
 class HashList extends \Google\Service\Resource
 {
   /**
-   * 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. (hashList.get)

src/Safebrowsing/Resource/HashLists.php

@@ -31,7 +31,7 @@
 class HashLists extends \Google\Service\Resource
 {
   /**
-   * Get multiple hash lists at once. It is very common for a client to need to
+   * 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.
@@ -70,11 +70,11 @@ public function batchGet($optParams = [])
     return $this->call('batchGet', [$params], GoogleSecuritySafebrowsingV5BatchGetHashListsResponse::class);
   }
   /**
-   * List 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.
-   * (hashLists.listHashLists)
+   * 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. (hashLists.listHashLists)
    *
    * @param array $optParams Optional parameters.
    *

src/Safebrowsing/Resource/Hashes.php

@@ -30,7 +30,7 @@
 class Hashes extends \Google\Service\Resource
 {
   /**
-   * 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).

src/Safebrowsing/Resource/Urls.php

@@ -0,0 +1,54 @@
+<?php
+/*
+ * Copyright 2014 Google Inc.
+ *
+ * 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.
+ */
+
+namespace Google\Service\Safebrowsing\Resource;
+
+use Google\Service\Safebrowsing\GoogleSecuritySafebrowsingV5SearchUrlsResponse;
+
+/**
+ * The "urls" collection of methods.
+ * Typical usage is:
+ *  <code>
+ *   $safebrowsingService = new Google\Service\Safebrowsing(...);
+ *   $urls = $safebrowsingService->urls;
+ *  </code>
+ */
+class Urls extends \Google\Service\Resource
+{
+  /**
+   * 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. (urls.search)
+   *
+   * @param array $optParams Optional parameters.
+   *
+   * @opt_param string urls Required. The URLs to be looked up. Clients MUST NOT
+   * send more than 50 URLs.
+   * @return GoogleSecuritySafebrowsingV5SearchUrlsResponse
+   * @throws \Google\Service\Exception
+   */
+  public function search($optParams = [])
+  {
+    $params = [];
+    $params = array_merge($params, $optParams);
+    return $this->call('search', [$params], GoogleSecuritySafebrowsingV5SearchUrlsResponse::class);
+  }
+}
+
+// Adding a class alias for backwards compatibility with the previous class name.
+class_alias(Urls::class, 'Google_Service_Safebrowsing_Resource_Urls');