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\ReturnShippingLabel;
21
22/**
23 * The "labels" collection of methods.
24 * Typical usage is:
25 *  <code>
26 *   $contentService = new Google\Service\ShoppingContent(...);
27 *   $labels = $contentService->labels;
28 *  </code>
29 */
30class OrderreturnsLabels extends \Google\Service\Resource
31{
32  /**
33   * Links a return shipping label to a return id. You can only create one return
34   * label per return id. Since the label is sent to the buyer, the linked return
35   * label cannot be updated or deleted. If you try to create multiple return
36   * shipping labels for a single return id, every create request except the first
37   * will fail. (labels.create)
38   *
39   * @param string $merchantId Required. The merchant the Return Shipping Label
40   * belongs to.
41   * @param string $returnId Required. Provide the Google-generated merchant order
42   * return ID.
43   * @param ReturnShippingLabel $postBody
44   * @param array $optParams Optional parameters.
45   * @return ReturnShippingLabel
46   */
47  public function create($merchantId, $returnId, ReturnShippingLabel $postBody, $optParams = [])
48  {
49    $params = ['merchantId' => $merchantId, 'returnId' => $returnId, 'postBody' => $postBody];
50    $params = array_merge($params, $optParams);
51    return $this->call('create', [$params], ReturnShippingLabel::class);
52  }
53}
54
55// Adding a class alias for backwards compatibility with the previous class name.
56class_alias(OrderreturnsLabels::class, 'Google_Service_ShoppingContent_Resource_OrderreturnsLabels');
57