1<?php
2/*
3 * Copyright 2014 Google Inc.
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
6 * use this file except in compliance with the License. You may obtain a copy of
7 * the License at
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
13 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
14 * License for the specific language governing permissions and limitations under
15 * the License.
16 */
17
18namespace Google\Service\VersionHistory\Resource;
19
20use Google\Service\VersionHistory\ListReleasesResponse;
21
22/**
23 * The "releases" collection of methods.
24 * Typical usage is:
25 *  <code>
26 *   $versionhistoryService = new Google\Service\VersionHistory(...);
27 *   $releases = $versionhistoryService->releases;
28 *  </code>
29 */
30class PlatformsChannelsVersionsReleases extends \Google\Service\Resource
31{
32  /**
33   * Returns list of releases of the given version.
34   * (releases.listPlatformsChannelsVersionsReleases)
35   *
36   * @param string $parent Required. The version, which owns this collection of
37   * releases. Format:
38   * {product}/platforms/{platform}/channels/{channel}/versions/{version}
39   * @param array $optParams Optional parameters.
40   *
41   * @opt_param string filter Optional. Filter string. Format is a comma separated
42   * list of All comma separated filter clauses are conjoined with a logical
43   * "and". Valid field_names are "version", "name", "platform", "channel",
44   * "fraction" "starttime", and "endtime". Valid operators are "<", "<=", "=",
45   * ">=", and ">". Channel comparison is done by distance from stable. must be a
46   * valid channel when filtering by channel. Ex) stable < beta, beta < dev,
47   * canary < canary_asan. Version comparison is done numerically. Ex) 1.0.0.8 <
48   * 1.0.0.10. If version is not entirely written, the version will be appended
49   * with 0 for the missing fields. Ex) version > 80 becoms version > 80.0.0.0
50   * When filtering by starttime or endtime, string must be in RFC 3339 date
51   * string format. Name and platform are filtered by string comparison. Ex)
52   * "...?filter=channel<=beta, version >= 80 Ex) "...?filter=version > 80,
53   * version < 81 Ex) "...?filter=starttime>2020-01-01T00:00:00Z
54   * @opt_param string orderBy Optional. Ordering string. Valid order_by strings
55   * are "version", "name", "starttime", "endtime", "platform", "channel", and
56   * "fraction". Optionally, you can append "desc" or "asc" to specify the sorting
57   * order. Multiple order_by strings can be used in a comma separated list.
58   * Ordering by channel will sort by distance from the stable channel (not
59   * alphabetically). A list of channels sorted in this order is: stable, beta,
60   * dev, canary, and canary_asan. Sorting by name may cause unexpected behaviour
61   * as it is a naive string sort. For example, 1.0.0.8 will be before 1.0.0.10 in
62   * descending order. If order_by is not specified the response will be sorted by
63   * starttime in descending order. Ex) "...?order_by=starttime asc" Ex)
64   * "...?order_by=platform desc, channel, startime desc"
65   * @opt_param int pageSize Optional. Optional limit on the number of releases to
66   * include in the response. If unspecified, the server will pick an appropriate
67   * default.
68   * @opt_param string pageToken Optional. A page token, received from a previous
69   * `ListReleases` call. Provide this to retrieve the subsequent page.
70   * @return ListReleasesResponse
71   */
72  public function listPlatformsChannelsVersionsReleases($parent, $optParams = [])
73  {
74    $params = ['parent' => $parent];
75    $params = array_merge($params, $optParams);
76    return $this->call('list', [$params], ListReleasesResponse::class);
77  }
78}
79
80// Adding a class alias for backwards compatibility with the previous class name.
81class_alias(PlatformsChannelsVersionsReleases::class, 'Google_Service_VersionHistory_Resource_PlatformsChannelsVersionsReleases');
82