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\ShoppingContent\Resource;
19
20use Google\Service\ShoppingContent\Promotion;
21
22/**
23 * The "promotions" collection of methods.
24 * Typical usage is:
25 *  <code>
26 *   $contentService = new Google\Service\ShoppingContent(...);
27 *   $promotions = $contentService->promotions;
28 *  </code>
29 */
30class Promotions extends \Google\Service\Resource
31{
32  /**
33   * Inserts a promotion for your Merchant Center account. If the promotion
34   * already exists, then it will update the promotion instead.
35   * (promotions.create)
36   *
37   * @param string $merchantId Required. The ID of the account that contains the
38   * collection.
39   * @param Promotion $postBody
40   * @param array $optParams Optional parameters.
41   * @return Promotion
42   */
43  public function create($merchantId, Promotion $postBody, $optParams = [])
44  {
45    $params = ['merchantId' => $merchantId, 'postBody' => $postBody];
46    $params = array_merge($params, $optParams);
47    return $this->call('create', [$params], Promotion::class);
48  }
49  /**
50   * Retrieves a promotion from your Merchant Center account. (promotions.get)
51   *
52   * @param string $merchantId Required. The ID of the account that contains the
53   * collection.
54   * @param string $id Required. REST ID of the promotion to retrieve.
55   * @param array $optParams Optional parameters.
56   * @return Promotion
57   */
58  public function get($merchantId, $id, $optParams = [])
59  {
60    $params = ['merchantId' => $merchantId, 'id' => $id];
61    $params = array_merge($params, $optParams);
62    return $this->call('get', [$params], Promotion::class);
63  }
64}
65
66// Adding a class alias for backwards compatibility with the previous class name.
67class_alias(Promotions::class, 'Google_Service_ShoppingContent_Resource_Promotions');
68