google-apis-content_v2_1 0.31.0 → 0.33.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -32,6 +32,8 @@ module Google
32
32
  #
33
33
  # @see https://developers.google.com/shopping-content/v2/
34
34
  class ShoppingContentService < Google::Apis::Core::BaseService
35
+ DEFAULT_ENDPOINT_TEMPLATE = "https://shoppingcontent.$UNIVERSE_DOMAIN$/"
36
+
35
37
  # @return [String]
36
38
  # API key. Your API key identifies your project and provides you with API access,
37
39
  # quota, and reports. Required unless you provide an OAuth 2.0 token.
@@ -43,7 +45,7 @@ module Google
43
45
  attr_accessor :quota_user
44
46
 
45
47
  def initialize
46
- super('https://shoppingcontent.googleapis.com/', 'content/v2.1/',
48
+ super(DEFAULT_ENDPOINT_TEMPLATE, 'content/v2.1/',
47
49
  client_name: 'google-apis-content_v2_1',
48
50
  client_version: Google::Apis::ContentV2_1::GEM_VERSION)
49
51
  @batch_path = 'batch'
@@ -76,7 +78,8 @@ module Google
76
78
  execute_or_queue_command(command, &block)
77
79
  end
78
80
 
79
- # Claims the website of a Merchant Center sub-account.
81
+ # Claims the website of a Merchant Center sub-account. Merchant accounts with
82
+ # approved third-party CSSs aren't required to claim a website.
80
83
  # @param [Fixnum] merchant_id
81
84
  # The ID of the managing account. If this parameter is not the same as accountId,
82
85
  # then this account must be a multi-client account and `accountId` must be the
@@ -85,7 +88,7 @@ module Google
85
88
  # The ID of the account whose website is claimed.
86
89
  # @param [Boolean] overwrite
87
90
  # Only available to selected merchants, for example multi-client accounts (MCAs)
88
- # and their sub-accounts. When set to `True`, this flag removes any existing
91
+ # and their sub-accounts. When set to `True`, this option removes any existing
89
92
  # claim on the requested website and replaces it with a claim from the account
90
93
  # that makes the request.
91
94
  # @param [String] fields
@@ -155,7 +158,7 @@ module Google
155
158
  # @param [Fixnum] account_id
156
159
  # The ID of the account.
157
160
  # @param [Boolean] force
158
- # Flag to delete sub-accounts with products. The default value is false.
161
+ # Option to delete sub-accounts with products. The default value is false.
159
162
  # @param [String] fields
160
163
  # Selector specifying which fields to include in a partial response.
161
164
  # @param [String] quota_user
@@ -1104,8 +1107,8 @@ module Google
1104
1107
  end
1105
1108
 
1106
1109
  # Reactivates the BoG program in your Merchant Center account. Moves the program
1107
- # to the active state when allowed, e.g. when paused. Important: This method is
1108
- # only whitelisted for selected merchants.
1110
+ # to the active state when allowed, for example, when paused. This method is
1111
+ # only available to selected merchants.
1109
1112
  # @param [Fixnum] merchant_id
1110
1113
  # Required. The ID of the account.
1111
1114
  # @param [String] region_code
@@ -1256,8 +1259,8 @@ module Google
1256
1259
  execute_or_queue_command(command, &block)
1257
1260
  end
1258
1261
 
1259
- # Pauses the BoG program in your Merchant Center account. Important: This method
1260
- # is only whitelisted for selected merchants.
1262
+ # Pauses the BoG program in your Merchant Center account. This method is only
1263
+ # available to selected merchants.
1261
1264
  # @param [Fixnum] merchant_id
1262
1265
  # Required. The ID of the account.
1263
1266
  # @param [String] region_code
@@ -1294,7 +1297,7 @@ module Google
1294
1297
 
1295
1298
  # Requests review and then activates the BoG program in your Merchant Center
1296
1299
  # account for the first time. Moves the program to the REVIEW_PENDING state.
1297
- # Important: This method is only whitelisted for selected merchants.
1300
+ # This method is only available to selected merchants.
1298
1301
  # @param [Fixnum] merchant_id
1299
1302
  # Required. The ID of the account.
1300
1303
  # @param [String] region_code
@@ -1548,6 +1551,220 @@ module Google
1548
1551
  execute_or_queue_command(command, &block)
1549
1552
  end
1550
1553
 
1554
+ # Creates a new conversion source.
1555
+ # @param [Fixnum] merchant_id
1556
+ # Required. The ID of the account that owns the new conversion source.
1557
+ # @param [Google::Apis::ContentV2_1::ConversionSource] conversion_source_object
1558
+ # @param [String] fields
1559
+ # Selector specifying which fields to include in a partial response.
1560
+ # @param [String] quota_user
1561
+ # Available to use for quota purposes for server-side applications. Can be any
1562
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1563
+ # @param [Google::Apis::RequestOptions] options
1564
+ # Request-specific options
1565
+ #
1566
+ # @yield [result, err] Result & error if block supplied
1567
+ # @yieldparam result [Google::Apis::ContentV2_1::ConversionSource] parsed result object
1568
+ # @yieldparam err [StandardError] error object if request failed
1569
+ #
1570
+ # @return [Google::Apis::ContentV2_1::ConversionSource]
1571
+ #
1572
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1573
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1574
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1575
+ def create_conversionsource(merchant_id, conversion_source_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1576
+ command = make_simple_command(:post, '{merchantId}/conversionsources', options)
1577
+ command.request_representation = Google::Apis::ContentV2_1::ConversionSource::Representation
1578
+ command.request_object = conversion_source_object
1579
+ command.response_representation = Google::Apis::ContentV2_1::ConversionSource::Representation
1580
+ command.response_class = Google::Apis::ContentV2_1::ConversionSource
1581
+ command.params['merchantId'] = merchant_id unless merchant_id.nil?
1582
+ command.query['fields'] = fields unless fields.nil?
1583
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1584
+ execute_or_queue_command(command, &block)
1585
+ end
1586
+
1587
+ # Archives an existing conversion source. It will be recoverable for 30 days.
1588
+ # This archiving behavior is not typical in the Content API and unique to this
1589
+ # service.
1590
+ # @param [Fixnum] merchant_id
1591
+ # Required. The ID of the account that owns the new conversion source.
1592
+ # @param [String] conversion_source_id
1593
+ # Required. The ID of the conversion source to be deleted.
1594
+ # @param [String] fields
1595
+ # Selector specifying which fields to include in a partial response.
1596
+ # @param [String] quota_user
1597
+ # Available to use for quota purposes for server-side applications. Can be any
1598
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1599
+ # @param [Google::Apis::RequestOptions] options
1600
+ # Request-specific options
1601
+ #
1602
+ # @yield [result, err] Result & error if block supplied
1603
+ # @yieldparam result [NilClass] No result returned for this method
1604
+ # @yieldparam err [StandardError] error object if request failed
1605
+ #
1606
+ # @return [void]
1607
+ #
1608
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1609
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1610
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1611
+ def delete_conversionsource(merchant_id, conversion_source_id, fields: nil, quota_user: nil, options: nil, &block)
1612
+ command = make_simple_command(:delete, '{merchantId}/conversionsources/{conversionSourceId}', options)
1613
+ command.params['merchantId'] = merchant_id unless merchant_id.nil?
1614
+ command.params['conversionSourceId'] = conversion_source_id unless conversion_source_id.nil?
1615
+ command.query['fields'] = fields unless fields.nil?
1616
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1617
+ execute_or_queue_command(command, &block)
1618
+ end
1619
+
1620
+ # Fetches a conversion source.
1621
+ # @param [Fixnum] merchant_id
1622
+ # Required. The ID of the account that owns the new conversion source.
1623
+ # @param [String] conversion_source_id
1624
+ # Required. The REST ID of the collection.
1625
+ # @param [String] fields
1626
+ # Selector specifying which fields to include in a partial response.
1627
+ # @param [String] quota_user
1628
+ # Available to use for quota purposes for server-side applications. Can be any
1629
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1630
+ # @param [Google::Apis::RequestOptions] options
1631
+ # Request-specific options
1632
+ #
1633
+ # @yield [result, err] Result & error if block supplied
1634
+ # @yieldparam result [Google::Apis::ContentV2_1::ConversionSource] parsed result object
1635
+ # @yieldparam err [StandardError] error object if request failed
1636
+ #
1637
+ # @return [Google::Apis::ContentV2_1::ConversionSource]
1638
+ #
1639
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1640
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1641
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1642
+ def get_conversionsource(merchant_id, conversion_source_id, fields: nil, quota_user: nil, options: nil, &block)
1643
+ command = make_simple_command(:get, '{merchantId}/conversionsources/{conversionSourceId}', options)
1644
+ command.response_representation = Google::Apis::ContentV2_1::ConversionSource::Representation
1645
+ command.response_class = Google::Apis::ContentV2_1::ConversionSource
1646
+ command.params['merchantId'] = merchant_id unless merchant_id.nil?
1647
+ command.params['conversionSourceId'] = conversion_source_id unless conversion_source_id.nil?
1648
+ command.query['fields'] = fields unless fields.nil?
1649
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1650
+ execute_or_queue_command(command, &block)
1651
+ end
1652
+
1653
+ # Retrieves the list of conversion sources the caller has access to.
1654
+ # @param [Fixnum] merchant_id
1655
+ # Required. The ID of the account that owns the new conversion source.
1656
+ # @param [Fixnum] page_size
1657
+ # The maximum number of conversion sources to return in a page. If no `page_size`
1658
+ # is specified, `100` is used as the default value. The maximum value is `200`.
1659
+ # Values above `200` will be coerced to `200`. Regardless of pagination, at most
1660
+ # `200` conversion sources are returned in total.
1661
+ # @param [String] page_token
1662
+ # Page token.
1663
+ # @param [Boolean] show_deleted
1664
+ # If true, also returns archived conversion sources.
1665
+ # @param [String] fields
1666
+ # Selector specifying which fields to include in a partial response.
1667
+ # @param [String] quota_user
1668
+ # Available to use for quota purposes for server-side applications. Can be any
1669
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1670
+ # @param [Google::Apis::RequestOptions] options
1671
+ # Request-specific options
1672
+ #
1673
+ # @yield [result, err] Result & error if block supplied
1674
+ # @yieldparam result [Google::Apis::ContentV2_1::ListConversionSourcesResponse] parsed result object
1675
+ # @yieldparam err [StandardError] error object if request failed
1676
+ #
1677
+ # @return [Google::Apis::ContentV2_1::ListConversionSourcesResponse]
1678
+ #
1679
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1680
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1681
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1682
+ def list_conversionsources(merchant_id, page_size: nil, page_token: nil, show_deleted: nil, fields: nil, quota_user: nil, options: nil, &block)
1683
+ command = make_simple_command(:get, '{merchantId}/conversionsources', options)
1684
+ command.response_representation = Google::Apis::ContentV2_1::ListConversionSourcesResponse::Representation
1685
+ command.response_class = Google::Apis::ContentV2_1::ListConversionSourcesResponse
1686
+ command.params['merchantId'] = merchant_id unless merchant_id.nil?
1687
+ command.query['pageSize'] = page_size unless page_size.nil?
1688
+ command.query['pageToken'] = page_token unless page_token.nil?
1689
+ command.query['showDeleted'] = show_deleted unless show_deleted.nil?
1690
+ command.query['fields'] = fields unless fields.nil?
1691
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1692
+ execute_or_queue_command(command, &block)
1693
+ end
1694
+
1695
+ # Updates information of an existing conversion source.
1696
+ # @param [Fixnum] merchant_id
1697
+ # Required. The ID of the account that owns the new conversion source.
1698
+ # @param [String] conversion_source_id
1699
+ # Required. The ID of the conversion source to be updated.
1700
+ # @param [Google::Apis::ContentV2_1::ConversionSource] conversion_source_object
1701
+ # @param [String] update_mask
1702
+ # Required. List of fields being updated.
1703
+ # @param [String] fields
1704
+ # Selector specifying which fields to include in a partial response.
1705
+ # @param [String] quota_user
1706
+ # Available to use for quota purposes for server-side applications. Can be any
1707
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1708
+ # @param [Google::Apis::RequestOptions] options
1709
+ # Request-specific options
1710
+ #
1711
+ # @yield [result, err] Result & error if block supplied
1712
+ # @yieldparam result [Google::Apis::ContentV2_1::ConversionSource] parsed result object
1713
+ # @yieldparam err [StandardError] error object if request failed
1714
+ #
1715
+ # @return [Google::Apis::ContentV2_1::ConversionSource]
1716
+ #
1717
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1718
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1719
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1720
+ def patch_conversionsource(merchant_id, conversion_source_id, conversion_source_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1721
+ command = make_simple_command(:patch, '{merchantId}/conversionsources/{conversionSourceId}', options)
1722
+ command.request_representation = Google::Apis::ContentV2_1::ConversionSource::Representation
1723
+ command.request_object = conversion_source_object
1724
+ command.response_representation = Google::Apis::ContentV2_1::ConversionSource::Representation
1725
+ command.response_class = Google::Apis::ContentV2_1::ConversionSource
1726
+ command.params['merchantId'] = merchant_id unless merchant_id.nil?
1727
+ command.params['conversionSourceId'] = conversion_source_id unless conversion_source_id.nil?
1728
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1729
+ command.query['fields'] = fields unless fields.nil?
1730
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1731
+ execute_or_queue_command(command, &block)
1732
+ end
1733
+
1734
+ # Re-enables an archived conversion source.
1735
+ # @param [Fixnum] merchant_id
1736
+ # Required. The ID of the account that owns the new conversion source.
1737
+ # @param [String] conversion_source_id
1738
+ # Required. The ID of the conversion source to be undeleted.
1739
+ # @param [Google::Apis::ContentV2_1::UndeleteConversionSourceRequest] undelete_conversion_source_request_object
1740
+ # @param [String] fields
1741
+ # Selector specifying which fields to include in a partial response.
1742
+ # @param [String] quota_user
1743
+ # Available to use for quota purposes for server-side applications. Can be any
1744
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1745
+ # @param [Google::Apis::RequestOptions] options
1746
+ # Request-specific options
1747
+ #
1748
+ # @yield [result, err] Result & error if block supplied
1749
+ # @yieldparam result [NilClass] No result returned for this method
1750
+ # @yieldparam err [StandardError] error object if request failed
1751
+ #
1752
+ # @return [void]
1753
+ #
1754
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1755
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1756
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1757
+ def undelete_conversionsource_conversion_source(merchant_id, conversion_source_id, undelete_conversion_source_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1758
+ command = make_simple_command(:post, '{merchantId}/conversionsources/{conversionSourceId}:undelete', options)
1759
+ command.request_representation = Google::Apis::ContentV2_1::UndeleteConversionSourceRequest::Representation
1760
+ command.request_object = undelete_conversion_source_request_object
1761
+ command.params['merchantId'] = merchant_id unless merchant_id.nil?
1762
+ command.params['conversionSourceId'] = conversion_source_id unless conversion_source_id.nil?
1763
+ command.query['fields'] = fields unless fields.nil?
1764
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1765
+ execute_or_queue_command(command, &block)
1766
+ end
1767
+
1551
1768
  # Retrieves a single CSS domain by ID.
1552
1769
  # @param [Fixnum] css_group_id
1553
1770
  # Required. The ID of the managing account. If this parameter is not the same as
@@ -1723,8 +1940,9 @@ module Google
1723
1940
  end
1724
1941
 
1725
1942
  # Invokes a fetch for the datafeed in your Merchant Center account. If you need
1726
- # to call this method more than once per day, we recommend you use the Products
1727
- # service to update your product data.
1943
+ # to call this method more than once per day, we recommend you use the [Products
1944
+ # service](https://developers.google.com/shopping-content/reference/rest/v2.1/
1945
+ # products) to update your product data.
1728
1946
  # @param [Fixnum] merchant_id
1729
1947
  # The ID of the account that manages the datafeed. This account cannot be a
1730
1948
  # multi-client account.
@@ -1938,15 +2156,20 @@ module Google
1938
2156
  # @param [Fixnum] datafeed_id
1939
2157
  # The ID of the datafeed.
1940
2158
  # @param [String] country
1941
- # The country for which to get the datafeed status. If this parameter is
1942
- # provided then language must also be provided. Note that this parameter is
1943
- # required for feeds targeting multiple countries and languages, since a feed
1944
- # may have a different status for each target.
2159
+ # Deprecated. Use `feedLabel` instead. The country to get the datafeed status
2160
+ # for. If this parameter is provided then `language` must also be provided. Note
2161
+ # that this parameter is required for feeds targeting multiple countries and
2162
+ # languages, since a feed may have a different status for each target.
2163
+ # @param [String] feed_label
2164
+ # The feed label to get the datafeed status for. If this parameter is provided
2165
+ # then `language` must also be provided. Note that this parameter is required
2166
+ # for feeds targeting multiple countries and languages, since a feed may have a
2167
+ # different status for each target.
1945
2168
  # @param [String] language
1946
- # The language for which to get the datafeed status. If this parameter is
1947
- # provided then country must also be provided. Note that this parameter is
1948
- # required for feeds targeting multiple countries and languages, since a feed
1949
- # may have a different status for each target.
2169
+ # The language to get the datafeed status for. If this parameter is provided
2170
+ # then `country` must also be provided. Note that this parameter is required for
2171
+ # feeds targeting multiple countries and languages, since a feed may have a
2172
+ # different status for each target.
1950
2173
  # @param [String] fields
1951
2174
  # Selector specifying which fields to include in a partial response.
1952
2175
  # @param [String] quota_user
@@ -1964,13 +2187,14 @@ module Google
1964
2187
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1965
2188
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1966
2189
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1967
- def get_datafeedstatus(merchant_id, datafeed_id, country: nil, language: nil, fields: nil, quota_user: nil, options: nil, &block)
2190
+ def get_datafeedstatus(merchant_id, datafeed_id, country: nil, feed_label: nil, language: nil, fields: nil, quota_user: nil, options: nil, &block)
1968
2191
  command = make_simple_command(:get, '{merchantId}/datafeedstatuses/{datafeedId}', options)
1969
2192
  command.response_representation = Google::Apis::ContentV2_1::DatafeedStatus::Representation
1970
2193
  command.response_class = Google::Apis::ContentV2_1::DatafeedStatus
1971
2194
  command.params['merchantId'] = merchant_id unless merchant_id.nil?
1972
2195
  command.params['datafeedId'] = datafeed_id unless datafeed_id.nil?
1973
2196
  command.query['country'] = country unless country.nil?
2197
+ command.query['feedLabel'] = feed_label unless feed_label.nil?
1974
2198
  command.query['language'] = language unless language.nil?
1975
2199
  command.query['fields'] = fields unless fields.nil?
1976
2200
  command.query['quotaUser'] = quota_user unless quota_user.nil?
@@ -2015,6 +2239,9 @@ module Google
2015
2239
  end
2016
2240
 
2017
2241
  # Retrieves the status and review eligibility for the free listing program.
2242
+ # Returns errors and warnings if they require action to resolve, will become
2243
+ # disapprovals, or impact impressions. Use `accountstatuses` to view all issues
2244
+ # for an account.
2018
2245
  # @param [Fixnum] merchant_id
2019
2246
  # Required. The ID of the account.
2020
2247
  # @param [String] fields
@@ -2044,8 +2271,9 @@ module Google
2044
2271
  execute_or_queue_command(command, &block)
2045
2272
  end
2046
2273
 
2047
- # Requests a review for Free Listings program in the provided region. Important:
2048
- # This method is only whitelisted for selected merchants.
2274
+ # Requests a review of free listings in a specific region. This method
2275
+ # deprecated. Use the `MerchantSupportService` to view product and account
2276
+ # issues and request a review.
2049
2277
  # @param [Fixnum] merchant_id
2050
2278
  # Required. The ID of the account.
2051
2279
  # @param [Google::Apis::ContentV2_1::RequestReviewFreeListingsRequest] request_review_free_listings_request_object
@@ -2076,6 +2304,98 @@ module Google
2076
2304
  execute_or_queue_command(command, &block)
2077
2305
  end
2078
2306
 
2307
+ # Deletes `Checkout` settings and unenrolls merchant from `Checkout` program.
2308
+ # @param [Fixnum] merchant_id
2309
+ # Required. The ID of the account.
2310
+ # @param [String] fields
2311
+ # Selector specifying which fields to include in a partial response.
2312
+ # @param [String] quota_user
2313
+ # Available to use for quota purposes for server-side applications. Can be any
2314
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2315
+ # @param [Google::Apis::RequestOptions] options
2316
+ # Request-specific options
2317
+ #
2318
+ # @yield [result, err] Result & error if block supplied
2319
+ # @yieldparam result [NilClass] No result returned for this method
2320
+ # @yieldparam err [StandardError] error object if request failed
2321
+ #
2322
+ # @return [void]
2323
+ #
2324
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2325
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2326
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2327
+ def delete_freelistingsprogram_checkoutsetting(merchant_id, fields: nil, quota_user: nil, options: nil, &block)
2328
+ command = make_simple_command(:delete, '{merchantId}/freelistingsprogram/checkoutsettings', options)
2329
+ command.params['merchantId'] = merchant_id unless merchant_id.nil?
2330
+ command.query['fields'] = fields unless fields.nil?
2331
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2332
+ execute_or_queue_command(command, &block)
2333
+ end
2334
+
2335
+ # Gets Checkout settings for the given merchant. This includes information about
2336
+ # review state, enrollment state and URL settings.
2337
+ # @param [Fixnum] merchant_id
2338
+ # Required. The ID of the account.
2339
+ # @param [String] fields
2340
+ # Selector specifying which fields to include in a partial response.
2341
+ # @param [String] quota_user
2342
+ # Available to use for quota purposes for server-side applications. Can be any
2343
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2344
+ # @param [Google::Apis::RequestOptions] options
2345
+ # Request-specific options
2346
+ #
2347
+ # @yield [result, err] Result & error if block supplied
2348
+ # @yieldparam result [Google::Apis::ContentV2_1::CheckoutSettings] parsed result object
2349
+ # @yieldparam err [StandardError] error object if request failed
2350
+ #
2351
+ # @return [Google::Apis::ContentV2_1::CheckoutSettings]
2352
+ #
2353
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2354
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2355
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2356
+ def get_freelistingsprogram_checkoutsetting(merchant_id, fields: nil, quota_user: nil, options: nil, &block)
2357
+ command = make_simple_command(:get, '{merchantId}/freelistingsprogram/checkoutsettings', options)
2358
+ command.response_representation = Google::Apis::ContentV2_1::CheckoutSettings::Representation
2359
+ command.response_class = Google::Apis::ContentV2_1::CheckoutSettings
2360
+ command.params['merchantId'] = merchant_id unless merchant_id.nil?
2361
+ command.query['fields'] = fields unless fields.nil?
2362
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2363
+ execute_or_queue_command(command, &block)
2364
+ end
2365
+
2366
+ # Enrolls merchant in `Checkout` program.
2367
+ # @param [Fixnum] merchant_id
2368
+ # Required. The ID of the account.
2369
+ # @param [Google::Apis::ContentV2_1::InsertCheckoutSettingsRequest] insert_checkout_settings_request_object
2370
+ # @param [String] fields
2371
+ # Selector specifying which fields to include in a partial response.
2372
+ # @param [String] quota_user
2373
+ # Available to use for quota purposes for server-side applications. Can be any
2374
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2375
+ # @param [Google::Apis::RequestOptions] options
2376
+ # Request-specific options
2377
+ #
2378
+ # @yield [result, err] Result & error if block supplied
2379
+ # @yieldparam result [Google::Apis::ContentV2_1::CheckoutSettings] parsed result object
2380
+ # @yieldparam err [StandardError] error object if request failed
2381
+ #
2382
+ # @return [Google::Apis::ContentV2_1::CheckoutSettings]
2383
+ #
2384
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2385
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2386
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2387
+ def insert_checkoutsetting_checkout_settings(merchant_id, insert_checkout_settings_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2388
+ command = make_simple_command(:post, '{merchantId}/freelistingsprogram/checkoutsettings', options)
2389
+ command.request_representation = Google::Apis::ContentV2_1::InsertCheckoutSettingsRequest::Representation
2390
+ command.request_object = insert_checkout_settings_request_object
2391
+ command.response_representation = Google::Apis::ContentV2_1::CheckoutSettings::Representation
2392
+ command.response_class = Google::Apis::ContentV2_1::CheckoutSettings
2393
+ command.params['merchantId'] = merchant_id unless merchant_id.nil?
2394
+ command.query['fields'] = fields unless fields.nil?
2395
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2396
+ execute_or_queue_command(command, &block)
2397
+ end
2398
+
2079
2399
  # Retrieves and/or updates the LIA settings of multiple accounts in a single
2080
2400
  # request.
2081
2401
  # @param [Google::Apis::ContentV2_1::LiasettingsCustomBatchRequest] liasettings_custom_batch_request_object
@@ -2366,6 +2686,59 @@ module Google
2366
2686
  execute_or_queue_command(command, &block)
2367
2687
  end
2368
2688
 
2689
+ # Sets the omnichannel experience for the specified country. Only supported for
2690
+ # merchants whose POS data provider is trusted to enable the corresponding
2691
+ # experience. For more context, see these help articles [about LFP](https://
2692
+ # support.google.com/merchants/answer/7676652) and [how to get started](https://
2693
+ # support.google.com/merchants/answer/7676578) with it.
2694
+ # @param [Fixnum] merchant_id
2695
+ # The ID of the managing account. If this parameter is not the same as accountId,
2696
+ # then this account must be a multi-client account and `accountId` must be the
2697
+ # ID of a sub-account of this account.
2698
+ # @param [Fixnum] account_id
2699
+ # The ID of the account for which to retrieve accessible Business Profiles.
2700
+ # @param [String] country
2701
+ # The CLDR country code (for example, "US") for which the omnichannel experience
2702
+ # is selected.
2703
+ # @param [String] lsf_type
2704
+ # The Local Store Front (LSF) type for this country. Acceptable values are: - "`
2705
+ # ghlsf`" (Google-Hosted Local Store Front) - "`mhlsfBasic`" (Merchant-Hosted
2706
+ # Local Store Front Basic) - "`mhlsfFull`" (Merchant-Hosted Local Store Front
2707
+ # Full) More details about these types can be found here.
2708
+ # @param [Array<String>, String] pickup_types
2709
+ # The Pickup types for this country. Acceptable values are: - "`pickupToday`" - "
2710
+ # `pickupLater`"
2711
+ # @param [String] fields
2712
+ # Selector specifying which fields to include in a partial response.
2713
+ # @param [String] quota_user
2714
+ # Available to use for quota purposes for server-side applications. Can be any
2715
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2716
+ # @param [Google::Apis::RequestOptions] options
2717
+ # Request-specific options
2718
+ #
2719
+ # @yield [result, err] Result & error if block supplied
2720
+ # @yieldparam result [Google::Apis::ContentV2_1::LiaOmnichannelExperience] parsed result object
2721
+ # @yieldparam err [StandardError] error object if request failed
2722
+ #
2723
+ # @return [Google::Apis::ContentV2_1::LiaOmnichannelExperience]
2724
+ #
2725
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2726
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2727
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2728
+ def setomnichannelexperience_liasetting(merchant_id, account_id, country: nil, lsf_type: nil, pickup_types: nil, fields: nil, quota_user: nil, options: nil, &block)
2729
+ command = make_simple_command(:post, '{merchantId}/liasettings/{accountId}/setomnichannelexperience', options)
2730
+ command.response_representation = Google::Apis::ContentV2_1::LiaOmnichannelExperience::Representation
2731
+ command.response_class = Google::Apis::ContentV2_1::LiaOmnichannelExperience
2732
+ command.params['merchantId'] = merchant_id unless merchant_id.nil?
2733
+ command.params['accountId'] = account_id unless account_id.nil?
2734
+ command.query['country'] = country unless country.nil?
2735
+ command.query['lsfType'] = lsf_type unless lsf_type.nil?
2736
+ command.query['pickupTypes'] = pickup_types unless pickup_types.nil?
2737
+ command.query['fields'] = fields unless fields.nil?
2738
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2739
+ execute_or_queue_command(command, &block)
2740
+ end
2741
+
2369
2742
  # Sets the POS data provider for the specified country.
2370
2743
  # @param [Fixnum] merchant_id
2371
2744
  # The ID of the managing account. If this parameter is not the same as accountId,
@@ -2516,14 +2889,20 @@ module Google
2516
2889
  execute_or_queue_command(command, &block)
2517
2890
  end
2518
2891
 
2519
- # Creates a charge invoice for a shipment group, and triggers a charge capture
2520
- # for orderinvoice enabled orders.
2892
+ # Provide a list of merchant's issues with a support content and available
2893
+ # actions. This content and actions are meant to be rendered and shown in third-
2894
+ # party applications.
2521
2895
  # @param [Fixnum] merchant_id
2522
- # The ID of the account that manages the order. This cannot be a multi-client
2523
- # account.
2524
- # @param [String] order_id
2525
- # The ID of the order.
2526
- # @param [Google::Apis::ContentV2_1::OrderinvoicesCreateChargeInvoiceRequest] orderinvoices_create_charge_invoice_request_object
2896
+ # Required. The ID of the account to fetch issues for.
2897
+ # @param [Google::Apis::ContentV2_1::RenderAccountIssuesRequestPayload] render_account_issues_request_payload_object
2898
+ # @param [String] language_code
2899
+ # Optional. The [IETF BCP-47](https://tools.ietf.org/html/bcp47) language code
2900
+ # used to localize support content. If not set, the result will be in default
2901
+ # language `en-US`.
2902
+ # @param [String] time_zone
2903
+ # Optional. The [IANA](https://www.iana.org/time-zones) timezone used to
2904
+ # localize times in support content. For example 'America/Los_Angeles'. If not
2905
+ # set, results will use as a default UTC.
2527
2906
  # @param [String] fields
2528
2907
  # Selector specifying which fields to include in a partial response.
2529
2908
  # @param [String] quota_user
@@ -2533,15 +2912,149 @@ module Google
2533
2912
  # Request-specific options
2534
2913
  #
2535
2914
  # @yield [result, err] Result & error if block supplied
2536
- # @yieldparam result [Google::Apis::ContentV2_1::OrderinvoicesCreateChargeInvoiceResponse] parsed result object
2915
+ # @yieldparam result [Google::Apis::ContentV2_1::RenderAccountIssuesResponse] parsed result object
2537
2916
  # @yieldparam err [StandardError] error object if request failed
2538
2917
  #
2539
- # @return [Google::Apis::ContentV2_1::OrderinvoicesCreateChargeInvoiceResponse]
2918
+ # @return [Google::Apis::ContentV2_1::RenderAccountIssuesResponse]
2540
2919
  #
2541
2920
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2542
2921
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2543
2922
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2544
- def createchargeinvoice_orderinvoice(merchant_id, order_id, orderinvoices_create_charge_invoice_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2923
+ def renderaccountissues_merchantsupport(merchant_id, render_account_issues_request_payload_object = nil, language_code: nil, time_zone: nil, fields: nil, quota_user: nil, options: nil, &block)
2924
+ command = make_simple_command(:post, '{merchantId}/merchantsupport/renderaccountissues', options)
2925
+ command.request_representation = Google::Apis::ContentV2_1::RenderAccountIssuesRequestPayload::Representation
2926
+ command.request_object = render_account_issues_request_payload_object
2927
+ command.response_representation = Google::Apis::ContentV2_1::RenderAccountIssuesResponse::Representation
2928
+ command.response_class = Google::Apis::ContentV2_1::RenderAccountIssuesResponse
2929
+ command.params['merchantId'] = merchant_id unless merchant_id.nil?
2930
+ command.query['languageCode'] = language_code unless language_code.nil?
2931
+ command.query['timeZone'] = time_zone unless time_zone.nil?
2932
+ command.query['fields'] = fields unless fields.nil?
2933
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2934
+ execute_or_queue_command(command, &block)
2935
+ end
2936
+
2937
+ # Provide a list of issues for merchant's product with a support content and
2938
+ # available actions. This content and actions are meant to be rendered and shown
2939
+ # in third-party applications.
2940
+ # @param [Fixnum] merchant_id
2941
+ # Required. The ID of the account that contains the product.
2942
+ # @param [String] product_id
2943
+ # Required. The [REST_ID](https://developers.google.com/shopping-content/
2944
+ # reference/rest/v2.1/products#Product.FIELDS.id) of the product to fetch issues
2945
+ # for.
2946
+ # @param [Google::Apis::ContentV2_1::RenderProductIssuesRequestPayload] render_product_issues_request_payload_object
2947
+ # @param [String] language_code
2948
+ # Optional. The [IETF BCP-47](https://tools.ietf.org/html/bcp47) language code
2949
+ # used to localize support content. If not set, the result will be in default
2950
+ # language `en-US`.
2951
+ # @param [String] time_zone
2952
+ # Optional. The [IANA](https://www.iana.org/time-zones) timezone used to
2953
+ # localize times in support content. For example 'America/Los_Angeles'. If not
2954
+ # set, results will use as a default UTC.
2955
+ # @param [String] fields
2956
+ # Selector specifying which fields to include in a partial response.
2957
+ # @param [String] quota_user
2958
+ # Available to use for quota purposes for server-side applications. Can be any
2959
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2960
+ # @param [Google::Apis::RequestOptions] options
2961
+ # Request-specific options
2962
+ #
2963
+ # @yield [result, err] Result & error if block supplied
2964
+ # @yieldparam result [Google::Apis::ContentV2_1::RenderProductIssuesResponse] parsed result object
2965
+ # @yieldparam err [StandardError] error object if request failed
2966
+ #
2967
+ # @return [Google::Apis::ContentV2_1::RenderProductIssuesResponse]
2968
+ #
2969
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2970
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2971
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2972
+ def renderproductissues_merchantsupport(merchant_id, product_id, render_product_issues_request_payload_object = nil, language_code: nil, time_zone: nil, fields: nil, quota_user: nil, options: nil, &block)
2973
+ command = make_simple_command(:post, '{merchantId}/merchantsupport/renderproductissues/{productId}', options)
2974
+ command.request_representation = Google::Apis::ContentV2_1::RenderProductIssuesRequestPayload::Representation
2975
+ command.request_object = render_product_issues_request_payload_object
2976
+ command.response_representation = Google::Apis::ContentV2_1::RenderProductIssuesResponse::Representation
2977
+ command.response_class = Google::Apis::ContentV2_1::RenderProductIssuesResponse
2978
+ command.params['merchantId'] = merchant_id unless merchant_id.nil?
2979
+ command.params['productId'] = product_id unless product_id.nil?
2980
+ command.query['languageCode'] = language_code unless language_code.nil?
2981
+ command.query['timeZone'] = time_zone unless time_zone.nil?
2982
+ command.query['fields'] = fields unless fields.nil?
2983
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2984
+ execute_or_queue_command(command, &block)
2985
+ end
2986
+
2987
+ # Start an action. The action can be requested by merchants in third-party
2988
+ # application. Before merchants can request the action, the third-party
2989
+ # application needs to show them action specific content and display a user
2990
+ # input form. The action can be successfully started only once all `required`
2991
+ # inputs are provided. If any `required` input is missing, or invalid value was
2992
+ # provided, the service will return 400 error. Validation errors will contain
2993
+ # Ids for all problematic field together with translated, human readable error
2994
+ # messages that can be shown to the user.
2995
+ # @param [Fixnum] merchant_id
2996
+ # Required. The ID of the merchant's account.
2997
+ # @param [Google::Apis::ContentV2_1::TriggerActionPayload] trigger_action_payload_object
2998
+ # @param [String] language_code
2999
+ # Optional. Language code [IETF BCP 47 syntax](https://tools.ietf.org/html/bcp47)
3000
+ # used to localize the response. If not set, the result will be in default
3001
+ # language `en-US`.
3002
+ # @param [String] fields
3003
+ # Selector specifying which fields to include in a partial response.
3004
+ # @param [String] quota_user
3005
+ # Available to use for quota purposes for server-side applications. Can be any
3006
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3007
+ # @param [Google::Apis::RequestOptions] options
3008
+ # Request-specific options
3009
+ #
3010
+ # @yield [result, err] Result & error if block supplied
3011
+ # @yieldparam result [Google::Apis::ContentV2_1::TriggerActionResponse] parsed result object
3012
+ # @yieldparam err [StandardError] error object if request failed
3013
+ #
3014
+ # @return [Google::Apis::ContentV2_1::TriggerActionResponse]
3015
+ #
3016
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3017
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3018
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3019
+ def triggeraction_merchantsupport(merchant_id, trigger_action_payload_object = nil, language_code: nil, fields: nil, quota_user: nil, options: nil, &block)
3020
+ command = make_simple_command(:post, '{merchantId}/merchantsupport/triggeraction', options)
3021
+ command.request_representation = Google::Apis::ContentV2_1::TriggerActionPayload::Representation
3022
+ command.request_object = trigger_action_payload_object
3023
+ command.response_representation = Google::Apis::ContentV2_1::TriggerActionResponse::Representation
3024
+ command.response_class = Google::Apis::ContentV2_1::TriggerActionResponse
3025
+ command.params['merchantId'] = merchant_id unless merchant_id.nil?
3026
+ command.query['languageCode'] = language_code unless language_code.nil?
3027
+ command.query['fields'] = fields unless fields.nil?
3028
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3029
+ execute_or_queue_command(command, &block)
3030
+ end
3031
+
3032
+ # Creates a charge invoice for a shipment group, and triggers a charge capture
3033
+ # for orderinvoice enabled orders.
3034
+ # @param [Fixnum] merchant_id
3035
+ # The ID of the account that manages the order. This cannot be a multi-client
3036
+ # account.
3037
+ # @param [String] order_id
3038
+ # The ID of the order.
3039
+ # @param [Google::Apis::ContentV2_1::OrderinvoicesCreateChargeInvoiceRequest] orderinvoices_create_charge_invoice_request_object
3040
+ # @param [String] fields
3041
+ # Selector specifying which fields to include in a partial response.
3042
+ # @param [String] quota_user
3043
+ # Available to use for quota purposes for server-side applications. Can be any
3044
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3045
+ # @param [Google::Apis::RequestOptions] options
3046
+ # Request-specific options
3047
+ #
3048
+ # @yield [result, err] Result & error if block supplied
3049
+ # @yieldparam result [Google::Apis::ContentV2_1::OrderinvoicesCreateChargeInvoiceResponse] parsed result object
3050
+ # @yieldparam err [StandardError] error object if request failed
3051
+ #
3052
+ # @return [Google::Apis::ContentV2_1::OrderinvoicesCreateChargeInvoiceResponse]
3053
+ #
3054
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3055
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3056
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3057
+ def createchargeinvoice_orderinvoice(merchant_id, order_id, orderinvoices_create_charge_invoice_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2545
3058
  command = make_simple_command(:post, '{merchantId}/orderinvoices/{orderId}/createChargeInvoice', options)
2546
3059
  command.request_representation = Google::Apis::ContentV2_1::OrderinvoicesCreateChargeInvoiceRequest::Representation
2547
3060
  command.request_object = orderinvoices_create_charge_invoice_request_object
@@ -3335,7 +3848,7 @@ module Google
3335
3848
  # @param [String] template_name
3336
3849
  # The name of the template to retrieve.
3337
3850
  # @param [String] country
3338
- # The country of the template to retrieve. Defaults to `US`.
3851
+ # The country of the template to retrieve. Defaults to "`US`".
3339
3852
  # @param [String] fields
3340
3853
  # Selector specifying which fields to include in a partial response.
3341
3854
  # @param [String] quota_user
@@ -3366,13 +3879,13 @@ module Google
3366
3879
  end
3367
3880
 
3368
3881
  # Deprecated. Notifies that item return and refund was handled directly by
3369
- # merchant outside of Google payments processing (e.g. cash refund done in store)
3370
- # . Note: We recommend calling the returnrefundlineitem method to refund in-
3371
- # store returns. We will issue the refund directly to the customer. This helps
3372
- # to prevent possible differences arising between merchant and Google
3882
+ # merchant outside of Google payments processing (for example, cash refund done
3883
+ # in store). Note: We recommend calling the returnrefundlineitem method to
3884
+ # refund in-store returns. We will issue the refund directly to the customer.
3885
+ # This helps to prevent possible differences arising between merchant and Google
3373
3886
  # transaction records. We also recommend having the point of sale system
3374
3887
  # communicate with Google to ensure that customers do not receive a double
3375
- # refund by first refunding via Google then via an in-store return.
3888
+ # refund by first refunding through Google then through an in-store return.
3376
3889
  # @param [Fixnum] merchant_id
3377
3890
  # The ID of the account that manages the order. This cannot be a multi-client
3378
3891
  # account.
@@ -3433,10 +3946,10 @@ module Google
3433
3946
  # @param [String] placed_date_start
3434
3947
  # Obtains orders placed after this date (inclusively), in ISO 8601 format.
3435
3948
  # @param [Array<String>, String] statuses
3436
- # Obtains orders that match any of the specified statuses. Please note that `
3437
- # active` is a shortcut for `pendingShipment` and `partiallyShipped`, and `
3438
- # completed` is a shortcut for `shipped`, `partiallyDelivered`, `delivered`, `
3439
- # partiallyReturned`, `returned`, and `canceled`.
3949
+ # Obtains orders that match any of the specified statuses. Note that `active` is
3950
+ # a shortcut for `pendingShipment` and `partiallyShipped`, and `completed` is a
3951
+ # shortcut for `shipped`, `partiallyDelivered`, `delivered`, `partiallyReturned`,
3952
+ # `returned`, and `canceled`.
3440
3953
  # @param [String] fields
3441
3954
  # Selector specifying which fields to include in a partial response.
3442
3955
  # @param [String] quota_user
@@ -3583,11 +4096,11 @@ module Google
3583
4096
  end
3584
4097
 
3585
4098
  # Returns and refunds a line item. Note that this method can only be called on
3586
- # fully shipped orders. Please also note that the Orderreturns API is the
3587
- # preferred way to handle returns after you receive a return from a customer.
3588
- # You can use Orderreturns.list or Orderreturns.get to search for the return,
3589
- # and then use Orderreturns.processreturn to issue the refund. If the return
3590
- # cannot be found, then we recommend using this API to issue a refund.
4099
+ # fully shipped orders. The Orderreturns API is the preferred way to handle
4100
+ # returns after you receive a return from a customer. You can use Orderreturns.
4101
+ # list or Orderreturns.get to search for the return, and then use Orderreturns.
4102
+ # processreturn to issue the refund. If the return cannot be found, then we
4103
+ # recommend using this API to issue a refund.
3591
4104
  # @param [Fixnum] merchant_id
3592
4105
  # The ID of the account that manages the order. This cannot be a multi-client
3593
4106
  # account.
@@ -3627,8 +4140,8 @@ module Google
3627
4140
  # Sets (or overrides if it already exists) merchant provided annotations in the
3628
4141
  # form of key-value pairs. A common use case would be to supply us with
3629
4142
  # additional structured information about a line item that cannot be provided
3630
- # via other methods. Submitted key-value pairs can be retrieved as part of the
3631
- # orders resource.
4143
+ # through other methods. Submitted key-value pairs can be retrieved as part of
4144
+ # the orders resource.
3632
4145
  # @param [Fixnum] merchant_id
3633
4146
  # The ID of the account that manages the order. This cannot be a multi-client
3634
4147
  # account.
@@ -4087,6 +4600,108 @@ module Google
4087
4600
  execute_or_queue_command(command, &block)
4088
4601
  end
4089
4602
 
4603
+ # Creates or updates the delivery time of a product.
4604
+ # @param [Fixnum] merchant_id
4605
+ # The Google merchant ID of the account that contains the product. This account
4606
+ # cannot be a multi-client account.
4607
+ # @param [Google::Apis::ContentV2_1::ProductDeliveryTime] product_delivery_time_object
4608
+ # @param [String] fields
4609
+ # Selector specifying which fields to include in a partial response.
4610
+ # @param [String] quota_user
4611
+ # Available to use for quota purposes for server-side applications. Can be any
4612
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4613
+ # @param [Google::Apis::RequestOptions] options
4614
+ # Request-specific options
4615
+ #
4616
+ # @yield [result, err] Result & error if block supplied
4617
+ # @yieldparam result [Google::Apis::ContentV2_1::ProductDeliveryTime] parsed result object
4618
+ # @yieldparam err [StandardError] error object if request failed
4619
+ #
4620
+ # @return [Google::Apis::ContentV2_1::ProductDeliveryTime]
4621
+ #
4622
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4623
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4624
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4625
+ def create_productdeliverytime(merchant_id, product_delivery_time_object = nil, fields: nil, quota_user: nil, options: nil, &block)
4626
+ command = make_simple_command(:post, '{merchantId}/productdeliverytime', options)
4627
+ command.request_representation = Google::Apis::ContentV2_1::ProductDeliveryTime::Representation
4628
+ command.request_object = product_delivery_time_object
4629
+ command.response_representation = Google::Apis::ContentV2_1::ProductDeliveryTime::Representation
4630
+ command.response_class = Google::Apis::ContentV2_1::ProductDeliveryTime
4631
+ command.params['merchantId'] = merchant_id unless merchant_id.nil?
4632
+ command.query['fields'] = fields unless fields.nil?
4633
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4634
+ execute_or_queue_command(command, &block)
4635
+ end
4636
+
4637
+ # Deletes the delivery time of a product.
4638
+ # @param [Fixnum] merchant_id
4639
+ # Required. The Google merchant ID of the account that contains the product.
4640
+ # This account cannot be a multi-client account.
4641
+ # @param [String] product_id
4642
+ # Required. The Content API ID of the product, in the form `channel:
4643
+ # contentLanguage:targetCountry:offerId`.
4644
+ # @param [String] fields
4645
+ # Selector specifying which fields to include in a partial response.
4646
+ # @param [String] quota_user
4647
+ # Available to use for quota purposes for server-side applications. Can be any
4648
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4649
+ # @param [Google::Apis::RequestOptions] options
4650
+ # Request-specific options
4651
+ #
4652
+ # @yield [result, err] Result & error if block supplied
4653
+ # @yieldparam result [NilClass] No result returned for this method
4654
+ # @yieldparam err [StandardError] error object if request failed
4655
+ #
4656
+ # @return [void]
4657
+ #
4658
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4659
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4660
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4661
+ def delete_productdeliverytime(merchant_id, product_id, fields: nil, quota_user: nil, options: nil, &block)
4662
+ command = make_simple_command(:delete, '{merchantId}/productdeliverytime/{productId}', options)
4663
+ command.params['merchantId'] = merchant_id unless merchant_id.nil?
4664
+ command.params['productId'] = product_id unless product_id.nil?
4665
+ command.query['fields'] = fields unless fields.nil?
4666
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4667
+ execute_or_queue_command(command, &block)
4668
+ end
4669
+
4670
+ # Gets `productDeliveryTime` by `productId`.
4671
+ # @param [Fixnum] merchant_id
4672
+ # Required. The Google merchant ID of the account that contains the product.
4673
+ # This account cannot be a multi-client account.
4674
+ # @param [String] product_id
4675
+ # Required. The Content API ID of the product, in the form `channel:
4676
+ # contentLanguage:targetCountry:offerId`.
4677
+ # @param [String] fields
4678
+ # Selector specifying which fields to include in a partial response.
4679
+ # @param [String] quota_user
4680
+ # Available to use for quota purposes for server-side applications. Can be any
4681
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4682
+ # @param [Google::Apis::RequestOptions] options
4683
+ # Request-specific options
4684
+ #
4685
+ # @yield [result, err] Result & error if block supplied
4686
+ # @yieldparam result [Google::Apis::ContentV2_1::ProductDeliveryTime] parsed result object
4687
+ # @yieldparam err [StandardError] error object if request failed
4688
+ #
4689
+ # @return [Google::Apis::ContentV2_1::ProductDeliveryTime]
4690
+ #
4691
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4692
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4693
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4694
+ def get_productdeliverytime(merchant_id, product_id, fields: nil, quota_user: nil, options: nil, &block)
4695
+ command = make_simple_command(:get, '{merchantId}/productdeliverytime/{productId}', options)
4696
+ command.response_representation = Google::Apis::ContentV2_1::ProductDeliveryTime::Representation
4697
+ command.response_class = Google::Apis::ContentV2_1::ProductDeliveryTime
4698
+ command.params['merchantId'] = merchant_id unless merchant_id.nil?
4699
+ command.params['productId'] = product_id unless product_id.nil?
4700
+ command.query['fields'] = fields unless fields.nil?
4701
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4702
+ execute_or_queue_command(command, &block)
4703
+ end
4704
+
4090
4705
  # Retrieves, inserts, and deletes multiple products in a single request.
4091
4706
  # @param [Google::Apis::ContentV2_1::ProductsCustomBatchRequest] products_custom_batch_request_object
4092
4707
  # @param [String] fields
@@ -4234,7 +4849,8 @@ module Google
4234
4849
  # The ID of the account that contains the products. This account cannot be a
4235
4850
  # multi-client account.
4236
4851
  # @param [Fixnum] max_results
4237
- # The maximum number of products to return in the response, used for paging.
4852
+ # The maximum number of products to return in the response, used for paging. The
4853
+ # default value is 25. The maximum value is 250.
4238
4854
  # @param [String] page_token
4239
4855
  # The token returned by the previous request.
4240
4856
  # @param [String] fields
@@ -4277,9 +4893,10 @@ module Google
4277
4893
  # @param [String] update_mask
4278
4894
  # The comma-separated list of product attributes to be updated. Example: `"title,
4279
4895
  # salePrice"`. Attributes specified in the update mask without a value specified
4280
- # in the body will be deleted from the product. Only top-level product
4281
- # attributes can be updated. If not defined, product attributes with set values
4282
- # will be updated and other attributes will stay unchanged.
4896
+ # in the body will be deleted from the product. *You must specify the update
4897
+ # mask to delete attributes.* Only top-level product attributes can be updated.
4898
+ # If not defined, product attributes with set values will be updated and other
4899
+ # attributes will stay unchanged.
4283
4900
  # @param [String] fields
4284
4901
  # Selector specifying which fields to include in a partial response.
4285
4902
  # @param [String] quota_user
@@ -4388,7 +5005,7 @@ module Google
4388
5005
  # only issues for the Shopping destination.
4389
5006
  # @param [Fixnum] max_results
4390
5007
  # The maximum number of product statuses to return in the response, used for
4391
- # paging.
5008
+ # paging. The default value is 25. The maximum value is 250.
4392
5009
  # @param [String] page_token
4393
5010
  # The token returned by the previous request.
4394
5011
  # @param [String] fields
@@ -4421,34 +5038,14 @@ module Google
4421
5038
  execute_or_queue_command(command, &block)
4422
5039
  end
4423
5040
 
4424
- # Lists the metrics report for a given Repricing product.
5041
+ # Inserts a promotion for your Merchant Center account. If the promotion already
5042
+ # exists, then it updates the promotion instead. To [end or delete] (https://
5043
+ # developers.google.com/shopping-content/guides/promotions#end_a_promotion) a
5044
+ # promotion update the time period of the promotion to a time that has already
5045
+ # passed.
4425
5046
  # @param [Fixnum] merchant_id
4426
- # Required. Id of the merchant who owns the Repricing rule.
4427
- # @param [String] product_id
4428
- # Required. Id of the Repricing product. Also known as the [REST_ID](https://
4429
- # developers.google.com/shopping-content/reference/rest/v2.1/products#Product.
4430
- # FIELDS.id)
4431
- # @param [String] end_date
4432
- # Gets Repricing reports on and before this date in the merchant's timezone. You
4433
- # can only retrieve data up to 7 days ago (default) or earlier. Format is YYYY-
4434
- # MM-DD.
4435
- # @param [Fixnum] page_size
4436
- # Maximum number of days of reports to return. There can be more than one rule
4437
- # report returned per day. For example, if 3 rule types got applied to the same
4438
- # product within a 24-hour period, then a page_size of 1 will return 3 rule
4439
- # reports. The page size defaults to 50 and values above 1000 are coerced to
4440
- # 1000. This service may return fewer days of reports than this value, for
4441
- # example, if the time between your start and end date is less than the page
4442
- # size.
4443
- # @param [String] page_token
4444
- # Token (if provided) to retrieve the subsequent page. All other parameters must
4445
- # match the original call that provided the page token.
4446
- # @param [String] rule_id
4447
- # Id of the Repricing rule. If specified, only gets this rule's reports.
4448
- # @param [String] start_date
4449
- # Gets Repricing reports on and after this date in the merchant's timezone, up
4450
- # to one year ago. Do not use a start date later than 7 days ago (default).
4451
- # Format is YYYY-MM-DD.
5047
+ # Required. The ID of the account that contains the collection.
5048
+ # @param [Google::Apis::ContentV2_1::Promotion] promotion_object
4452
5049
  # @param [String] fields
4453
5050
  # Selector specifying which fields to include in a partial response.
4454
5051
  # @param [String] quota_user
@@ -4458,35 +5055,31 @@ module Google
4458
5055
  # Request-specific options
4459
5056
  #
4460
5057
  # @yield [result, err] Result & error if block supplied
4461
- # @yieldparam result [Google::Apis::ContentV2_1::ListRepricingProductReportsResponse] parsed result object
5058
+ # @yieldparam result [Google::Apis::ContentV2_1::Promotion] parsed result object
4462
5059
  # @yieldparam err [StandardError] error object if request failed
4463
5060
  #
4464
- # @return [Google::Apis::ContentV2_1::ListRepricingProductReportsResponse]
5061
+ # @return [Google::Apis::ContentV2_1::Promotion]
4465
5062
  #
4466
5063
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4467
5064
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4468
5065
  # @raise [Google::Apis::AuthorizationError] Authorization is required
4469
- def list_productstatus_repricingreports(merchant_id, product_id, end_date: nil, page_size: nil, page_token: nil, rule_id: nil, start_date: nil, fields: nil, quota_user: nil, options: nil, &block)
4470
- command = make_simple_command(:get, '{merchantId}/productstatuses/{productId}/repricingreports', options)
4471
- command.response_representation = Google::Apis::ContentV2_1::ListRepricingProductReportsResponse::Representation
4472
- command.response_class = Google::Apis::ContentV2_1::ListRepricingProductReportsResponse
5066
+ def create_promotion(merchant_id, promotion_object = nil, fields: nil, quota_user: nil, options: nil, &block)
5067
+ command = make_simple_command(:post, '{merchantId}/promotions', options)
5068
+ command.request_representation = Google::Apis::ContentV2_1::Promotion::Representation
5069
+ command.request_object = promotion_object
5070
+ command.response_representation = Google::Apis::ContentV2_1::Promotion::Representation
5071
+ command.response_class = Google::Apis::ContentV2_1::Promotion
4473
5072
  command.params['merchantId'] = merchant_id unless merchant_id.nil?
4474
- command.params['productId'] = product_id unless product_id.nil?
4475
- command.query['endDate'] = end_date unless end_date.nil?
4476
- command.query['pageSize'] = page_size unless page_size.nil?
4477
- command.query['pageToken'] = page_token unless page_token.nil?
4478
- command.query['ruleId'] = rule_id unless rule_id.nil?
4479
- command.query['startDate'] = start_date unless start_date.nil?
4480
5073
  command.query['fields'] = fields unless fields.nil?
4481
5074
  command.query['quotaUser'] = quota_user unless quota_user.nil?
4482
5075
  execute_or_queue_command(command, &block)
4483
5076
  end
4484
5077
 
4485
- # Inserts a promotion for your Merchant Center account. If the promotion already
4486
- # exists, then it will update the promotion instead.
5078
+ # Retrieves a promotion from your Merchant Center account.
4487
5079
  # @param [Fixnum] merchant_id
4488
5080
  # Required. The ID of the account that contains the collection.
4489
- # @param [Google::Apis::ContentV2_1::Promotion] promotion_object
5081
+ # @param [String] id
5082
+ # Required. REST ID of the promotion to retrieve.
4490
5083
  # @param [String] fields
4491
5084
  # Selector specifying which fields to include in a partial response.
4492
5085
  # @param [String] quota_user
@@ -4504,23 +5097,34 @@ module Google
4504
5097
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4505
5098
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4506
5099
  # @raise [Google::Apis::AuthorizationError] Authorization is required
4507
- def create_promotion(merchant_id, promotion_object = nil, fields: nil, quota_user: nil, options: nil, &block)
4508
- command = make_simple_command(:post, '{merchantId}/promotions', options)
4509
- command.request_representation = Google::Apis::ContentV2_1::Promotion::Representation
4510
- command.request_object = promotion_object
5100
+ def get_promotion(merchant_id, id, fields: nil, quota_user: nil, options: nil, &block)
5101
+ command = make_simple_command(:get, '{merchantId}/promotions/{id}', options)
4511
5102
  command.response_representation = Google::Apis::ContentV2_1::Promotion::Representation
4512
5103
  command.response_class = Google::Apis::ContentV2_1::Promotion
4513
5104
  command.params['merchantId'] = merchant_id unless merchant_id.nil?
5105
+ command.params['id'] = id unless id.nil?
4514
5106
  command.query['fields'] = fields unless fields.nil?
4515
5107
  command.query['quotaUser'] = quota_user unless quota_user.nil?
4516
5108
  execute_or_queue_command(command, &block)
4517
5109
  end
4518
5110
 
4519
- # Retrieves a promotion from your Merchant Center account.
5111
+ # List all promotions from your Merchant Center account.
4520
5112
  # @param [Fixnum] merchant_id
4521
5113
  # Required. The ID of the account that contains the collection.
4522
- # @param [String] id
4523
- # Required. REST ID of the promotion to retrieve.
5114
+ # @param [String] country_code
5115
+ # [CLDR country code](http://www.unicode.org/repos/cldr/tags/latest/common/main/
5116
+ # en.xml) (for example, "US"), used as a filter on promotions target country.
5117
+ # @param [String] language_code
5118
+ # The two-letter ISO 639-1 language code associated with the promotions, used as
5119
+ # a filter.
5120
+ # @param [Fixnum] page_size
5121
+ # The maximum number of promotions to return. The service may return fewer than
5122
+ # this value. If unspecified, at most 50 labels will be returned. The maximum
5123
+ # value is 1000; values above 1000 will be coerced to 1000.
5124
+ # @param [String] page_token
5125
+ # A page token, received from a previous `ListPromotion` call. Provide this to
5126
+ # retrieve the subsequent page. When paginating, all other parameters provided
5127
+ # to `ListPromotion` must match the call that provided the page token.
4524
5128
  # @param [String] fields
4525
5129
  # Selector specifying which fields to include in a partial response.
4526
5130
  # @param [String] quota_user
@@ -4530,20 +5134,23 @@ module Google
4530
5134
  # Request-specific options
4531
5135
  #
4532
5136
  # @yield [result, err] Result & error if block supplied
4533
- # @yieldparam result [Google::Apis::ContentV2_1::Promotion] parsed result object
5137
+ # @yieldparam result [Google::Apis::ContentV2_1::ListPromotionResponse] parsed result object
4534
5138
  # @yieldparam err [StandardError] error object if request failed
4535
5139
  #
4536
- # @return [Google::Apis::ContentV2_1::Promotion]
5140
+ # @return [Google::Apis::ContentV2_1::ListPromotionResponse]
4537
5141
  #
4538
5142
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4539
5143
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4540
5144
  # @raise [Google::Apis::AuthorizationError] Authorization is required
4541
- def get_promotion(merchant_id, id, fields: nil, quota_user: nil, options: nil, &block)
4542
- command = make_simple_command(:get, '{merchantId}/promotions/{id}', options)
4543
- command.response_representation = Google::Apis::ContentV2_1::Promotion::Representation
4544
- command.response_class = Google::Apis::ContentV2_1::Promotion
5145
+ def list_promotions(merchant_id, country_code: nil, language_code: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
5146
+ command = make_simple_command(:get, '{merchantId}/promotions', options)
5147
+ command.response_representation = Google::Apis::ContentV2_1::ListPromotionResponse::Representation
5148
+ command.response_class = Google::Apis::ContentV2_1::ListPromotionResponse
4545
5149
  command.params['merchantId'] = merchant_id unless merchant_id.nil?
4546
- command.params['id'] = id unless id.nil?
5150
+ command.query['countryCode'] = country_code unless country_code.nil?
5151
+ command.query['languageCode'] = language_code unless language_code.nil?
5152
+ command.query['pageSize'] = page_size unless page_size.nil?
5153
+ command.query['pageToken'] = page_token unless page_token.nil?
4547
5154
  command.query['fields'] = fields unless fields.nil?
4548
5155
  command.query['quotaUser'] = quota_user unless quota_user.nil?
4549
5156
  execute_or_queue_command(command, &block)
@@ -4580,7 +5187,7 @@ module Google
4580
5187
  end
4581
5188
 
4582
5189
  # Register a Merchant Center account for pubsub notifications. Note that cloud
4583
- # topic name should not be provided as part of the request.
5190
+ # topic name shouldn't be provided as part of the request.
4584
5191
  # @param [Fixnum] merchant_id
4585
5192
  # The ID of the account.
4586
5193
  # @param [Google::Apis::ContentV2_1::PubsubNotificationSettings] pubsub_notification_settings_object
@@ -4613,6 +5220,119 @@ module Google
4613
5220
  execute_or_queue_command(command, &block)
4614
5221
  end
4615
5222
 
5223
+ # Lists the daily call quota and usage per method for your Merchant Center
5224
+ # account.
5225
+ # @param [Fixnum] merchant_id
5226
+ # Required. The ID of the account that has quota. This account must be an admin.
5227
+ # @param [Fixnum] page_size
5228
+ # The maximum number of quotas to return in the response, used for paging.
5229
+ # Defaults to 500; values above 1000 will be coerced to 1000.
5230
+ # @param [String] page_token
5231
+ # Token (if provided) to retrieve the subsequent page. All other parameters must
5232
+ # match the original call that provided the page token.
5233
+ # @param [String] fields
5234
+ # Selector specifying which fields to include in a partial response.
5235
+ # @param [String] quota_user
5236
+ # Available to use for quota purposes for server-side applications. Can be any
5237
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5238
+ # @param [Google::Apis::RequestOptions] options
5239
+ # Request-specific options
5240
+ #
5241
+ # @yield [result, err] Result & error if block supplied
5242
+ # @yieldparam result [Google::Apis::ContentV2_1::ListMethodQuotasResponse] parsed result object
5243
+ # @yieldparam err [StandardError] error object if request failed
5244
+ #
5245
+ # @return [Google::Apis::ContentV2_1::ListMethodQuotasResponse]
5246
+ #
5247
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5248
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5249
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5250
+ def list_quotas(merchant_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
5251
+ command = make_simple_command(:get, '{merchantId}/quotas', options)
5252
+ command.response_representation = Google::Apis::ContentV2_1::ListMethodQuotasResponse::Representation
5253
+ command.response_class = Google::Apis::ContentV2_1::ListMethodQuotasResponse
5254
+ command.params['merchantId'] = merchant_id unless merchant_id.nil?
5255
+ command.query['pageSize'] = page_size unless page_size.nil?
5256
+ command.query['pageToken'] = page_token unless page_token.nil?
5257
+ command.query['fields'] = fields unless fields.nil?
5258
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5259
+ execute_or_queue_command(command, &block)
5260
+ end
5261
+
5262
+ # Generates recommendations for a merchant.
5263
+ # @param [Fixnum] merchant_id
5264
+ # Required. The ID of the account to fetch recommendations for.
5265
+ # @param [Array<String>, String] allowed_tag
5266
+ # Optional. List of allowed tags. Tags are a set of predefined strings that
5267
+ # describe the category that individual recommendation types belong to. User can
5268
+ # specify zero or more tags in this field to indicate what categories of
5269
+ # recommendations they want to receive. Current list of supported tags: - TREND
5270
+ # @param [String] language_code
5271
+ # Optional. Language code of the client. If not set, the result will be in
5272
+ # default language (English). This language code affects all fields prefixed
5273
+ # with "localized". This should be set to ISO 639-1 country code. List of
5274
+ # currently verified supported language code: en, fr, cs, da, de, es, it, nl, no,
5275
+ # pl, pt, pt, fi, sv, vi, tr, th, ko, zh-CN, zh-TW, ja, id, hi
5276
+ # @param [String] fields
5277
+ # Selector specifying which fields to include in a partial response.
5278
+ # @param [String] quota_user
5279
+ # Available to use for quota purposes for server-side applications. Can be any
5280
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5281
+ # @param [Google::Apis::RequestOptions] options
5282
+ # Request-specific options
5283
+ #
5284
+ # @yield [result, err] Result & error if block supplied
5285
+ # @yieldparam result [Google::Apis::ContentV2_1::GenerateRecommendationsResponse] parsed result object
5286
+ # @yieldparam err [StandardError] error object if request failed
5287
+ #
5288
+ # @return [Google::Apis::ContentV2_1::GenerateRecommendationsResponse]
5289
+ #
5290
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5291
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5292
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5293
+ def generate_recommendation(merchant_id, allowed_tag: nil, language_code: nil, fields: nil, quota_user: nil, options: nil, &block)
5294
+ command = make_simple_command(:get, '{merchantId}/recommendations/generate', options)
5295
+ command.response_representation = Google::Apis::ContentV2_1::GenerateRecommendationsResponse::Representation
5296
+ command.response_class = Google::Apis::ContentV2_1::GenerateRecommendationsResponse
5297
+ command.params['merchantId'] = merchant_id unless merchant_id.nil?
5298
+ command.query['allowedTag'] = allowed_tag unless allowed_tag.nil?
5299
+ command.query['languageCode'] = language_code unless language_code.nil?
5300
+ command.query['fields'] = fields unless fields.nil?
5301
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5302
+ execute_or_queue_command(command, &block)
5303
+ end
5304
+
5305
+ # Reports an interaction on a recommendation for a merchant.
5306
+ # @param [Fixnum] merchant_id
5307
+ # Required. The ID of the account that wants to report an interaction.
5308
+ # @param [Google::Apis::ContentV2_1::ReportInteractionRequest] report_interaction_request_object
5309
+ # @param [String] fields
5310
+ # Selector specifying which fields to include in a partial response.
5311
+ # @param [String] quota_user
5312
+ # Available to use for quota purposes for server-side applications. Can be any
5313
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5314
+ # @param [Google::Apis::RequestOptions] options
5315
+ # Request-specific options
5316
+ #
5317
+ # @yield [result, err] Result & error if block supplied
5318
+ # @yieldparam result [NilClass] No result returned for this method
5319
+ # @yieldparam err [StandardError] error object if request failed
5320
+ #
5321
+ # @return [void]
5322
+ #
5323
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5324
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5325
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5326
+ def report_recommendation_interaction(merchant_id, report_interaction_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
5327
+ command = make_simple_command(:post, '{merchantId}/recommendations/reportInteraction', options)
5328
+ command.request_representation = Google::Apis::ContentV2_1::ReportInteractionRequest::Representation
5329
+ command.request_object = report_interaction_request_object
5330
+ command.params['merchantId'] = merchant_id unless merchant_id.nil?
5331
+ command.query['fields'] = fields unless fields.nil?
5332
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5333
+ execute_or_queue_command(command, &block)
5334
+ end
5335
+
4616
5336
  # Updates regional inventory for multiple products or regions in a single
4617
5337
  # request.
4618
5338
  # @param [Google::Apis::ContentV2_1::RegionalinventoryCustomBatchRequest] regionalinventory_custom_batch_request_object
@@ -4644,8 +5364,8 @@ module Google
4644
5364
  execute_or_queue_command(command, &block)
4645
5365
  end
4646
5366
 
4647
- # Update the regional inventory of a product in your Merchant Center account. If
4648
- # a regional inventory with the same region ID already exists, this method
5367
+ # Updates the regional inventory of a product in your Merchant Center account.
5368
+ # If a regional inventory with the same region ID already exists, this method
4649
5369
  # updates that entry.
4650
5370
  # @param [Fixnum] merchant_id
4651
5371
  # The ID of the account that contains the product. This account cannot be a
@@ -4863,7 +5583,7 @@ module Google
4863
5583
  execute_or_queue_command(command, &block)
4864
5584
  end
4865
5585
 
4866
- # Retrieves merchant performance mertrics matching the search query and
5586
+ # Retrieves merchant performance metrics matching the search query and
4867
5587
  # optionally segmented by selected dimensions.
4868
5588
  # @param [Fixnum] merchant_id
4869
5589
  # Required. Id of the merchant making the call. Must be a standalone account or
@@ -4898,248 +5618,6 @@ module Google
4898
5618
  execute_or_queue_command(command, &block)
4899
5619
  end
4900
5620
 
4901
- # Creates a repricing rule for your Merchant Center account.
4902
- # @param [Fixnum] merchant_id
4903
- # Required. The id of the merchant who owns the repricing rule.
4904
- # @param [Google::Apis::ContentV2_1::RepricingRule] repricing_rule_object
4905
- # @param [String] rule_id
4906
- # Required. The id of the rule to create.
4907
- # @param [String] fields
4908
- # Selector specifying which fields to include in a partial response.
4909
- # @param [String] quota_user
4910
- # Available to use for quota purposes for server-side applications. Can be any
4911
- # arbitrary string assigned to a user, but should not exceed 40 characters.
4912
- # @param [Google::Apis::RequestOptions] options
4913
- # Request-specific options
4914
- #
4915
- # @yield [result, err] Result & error if block supplied
4916
- # @yieldparam result [Google::Apis::ContentV2_1::RepricingRule] parsed result object
4917
- # @yieldparam err [StandardError] error object if request failed
4918
- #
4919
- # @return [Google::Apis::ContentV2_1::RepricingRule]
4920
- #
4921
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4922
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4923
- # @raise [Google::Apis::AuthorizationError] Authorization is required
4924
- def create_repricingrule(merchant_id, repricing_rule_object = nil, rule_id: nil, fields: nil, quota_user: nil, options: nil, &block)
4925
- command = make_simple_command(:post, '{merchantId}/repricingrules', options)
4926
- command.request_representation = Google::Apis::ContentV2_1::RepricingRule::Representation
4927
- command.request_object = repricing_rule_object
4928
- command.response_representation = Google::Apis::ContentV2_1::RepricingRule::Representation
4929
- command.response_class = Google::Apis::ContentV2_1::RepricingRule
4930
- command.params['merchantId'] = merchant_id unless merchant_id.nil?
4931
- command.query['ruleId'] = rule_id unless rule_id.nil?
4932
- command.query['fields'] = fields unless fields.nil?
4933
- command.query['quotaUser'] = quota_user unless quota_user.nil?
4934
- execute_or_queue_command(command, &block)
4935
- end
4936
-
4937
- # Deletes a repricing rule in your Merchant Center account.
4938
- # @param [Fixnum] merchant_id
4939
- # Required. The id of the merchant who owns the repricing rule.
4940
- # @param [String] rule_id
4941
- # Required. The id of the rule to Delete.
4942
- # @param [String] fields
4943
- # Selector specifying which fields to include in a partial response.
4944
- # @param [String] quota_user
4945
- # Available to use for quota purposes for server-side applications. Can be any
4946
- # arbitrary string assigned to a user, but should not exceed 40 characters.
4947
- # @param [Google::Apis::RequestOptions] options
4948
- # Request-specific options
4949
- #
4950
- # @yield [result, err] Result & error if block supplied
4951
- # @yieldparam result [NilClass] No result returned for this method
4952
- # @yieldparam err [StandardError] error object if request failed
4953
- #
4954
- # @return [void]
4955
- #
4956
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4957
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4958
- # @raise [Google::Apis::AuthorizationError] Authorization is required
4959
- def delete_repricingrule(merchant_id, rule_id, fields: nil, quota_user: nil, options: nil, &block)
4960
- command = make_simple_command(:delete, '{merchantId}/repricingrules/{ruleId}', options)
4961
- command.params['merchantId'] = merchant_id unless merchant_id.nil?
4962
- command.params['ruleId'] = rule_id unless rule_id.nil?
4963
- command.query['fields'] = fields unless fields.nil?
4964
- command.query['quotaUser'] = quota_user unless quota_user.nil?
4965
- execute_or_queue_command(command, &block)
4966
- end
4967
-
4968
- # Retrieves a repricing rule from your Merchant Center account.
4969
- # @param [Fixnum] merchant_id
4970
- # Required. The id of the merchant who owns the repricing rule.
4971
- # @param [String] rule_id
4972
- # Required. The id of the rule to retrieve.
4973
- # @param [String] fields
4974
- # Selector specifying which fields to include in a partial response.
4975
- # @param [String] quota_user
4976
- # Available to use for quota purposes for server-side applications. Can be any
4977
- # arbitrary string assigned to a user, but should not exceed 40 characters.
4978
- # @param [Google::Apis::RequestOptions] options
4979
- # Request-specific options
4980
- #
4981
- # @yield [result, err] Result & error if block supplied
4982
- # @yieldparam result [Google::Apis::ContentV2_1::RepricingRule] parsed result object
4983
- # @yieldparam err [StandardError] error object if request failed
4984
- #
4985
- # @return [Google::Apis::ContentV2_1::RepricingRule]
4986
- #
4987
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4988
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4989
- # @raise [Google::Apis::AuthorizationError] Authorization is required
4990
- def get_repricingrule(merchant_id, rule_id, fields: nil, quota_user: nil, options: nil, &block)
4991
- command = make_simple_command(:get, '{merchantId}/repricingrules/{ruleId}', options)
4992
- command.response_representation = Google::Apis::ContentV2_1::RepricingRule::Representation
4993
- command.response_class = Google::Apis::ContentV2_1::RepricingRule
4994
- command.params['merchantId'] = merchant_id unless merchant_id.nil?
4995
- command.params['ruleId'] = rule_id unless rule_id.nil?
4996
- command.query['fields'] = fields unless fields.nil?
4997
- command.query['quotaUser'] = quota_user unless quota_user.nil?
4998
- execute_or_queue_command(command, &block)
4999
- end
5000
-
5001
- # Lists the repricing rules in your Merchant Center account.
5002
- # @param [Fixnum] merchant_id
5003
- # Required. The id of the merchant who owns the repricing rule.
5004
- # @param [String] country_code
5005
- # [CLDR country code](http://www.unicode.org/repos/cldr/tags/latest/common/main/
5006
- # en.xml) (e.g. "US"), used as a filter on repricing rules.
5007
- # @param [String] language_code
5008
- # The two-letter ISO 639-1 language code associated with the repricing rule,
5009
- # used as a filter.
5010
- # @param [Fixnum] page_size
5011
- # The maximum number of repricing rules to return. The service may return fewer
5012
- # than this value. If unspecified, at most 50 rules will be returned. The
5013
- # maximum value is 1000; values above 1000 will be coerced to 1000.
5014
- # @param [String] page_token
5015
- # A page token, received from a previous `ListRepricingRules` call. Provide this
5016
- # to retrieve the subsequent page. When paginating, all other parameters
5017
- # provided to `ListRepricingRules` must match the call that provided the page
5018
- # token.
5019
- # @param [String] fields
5020
- # Selector specifying which fields to include in a partial response.
5021
- # @param [String] quota_user
5022
- # Available to use for quota purposes for server-side applications. Can be any
5023
- # arbitrary string assigned to a user, but should not exceed 40 characters.
5024
- # @param [Google::Apis::RequestOptions] options
5025
- # Request-specific options
5026
- #
5027
- # @yield [result, err] Result & error if block supplied
5028
- # @yieldparam result [Google::Apis::ContentV2_1::ListRepricingRulesResponse] parsed result object
5029
- # @yieldparam err [StandardError] error object if request failed
5030
- #
5031
- # @return [Google::Apis::ContentV2_1::ListRepricingRulesResponse]
5032
- #
5033
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5034
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5035
- # @raise [Google::Apis::AuthorizationError] Authorization is required
5036
- def list_repricingrules(merchant_id, country_code: nil, language_code: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
5037
- command = make_simple_command(:get, '{merchantId}/repricingrules', options)
5038
- command.response_representation = Google::Apis::ContentV2_1::ListRepricingRulesResponse::Representation
5039
- command.response_class = Google::Apis::ContentV2_1::ListRepricingRulesResponse
5040
- command.params['merchantId'] = merchant_id unless merchant_id.nil?
5041
- command.query['countryCode'] = country_code unless country_code.nil?
5042
- command.query['languageCode'] = language_code unless language_code.nil?
5043
- command.query['pageSize'] = page_size unless page_size.nil?
5044
- command.query['pageToken'] = page_token unless page_token.nil?
5045
- command.query['fields'] = fields unless fields.nil?
5046
- command.query['quotaUser'] = quota_user unless quota_user.nil?
5047
- execute_or_queue_command(command, &block)
5048
- end
5049
-
5050
- # Updates a repricing rule in your Merchant Center account. All mutable fields
5051
- # will be overwritten in each update request. In each update, you must provide
5052
- # all required mutable fields, or an error will be thrown. If you do not provide
5053
- # an optional field in the update request, if that field currently exists, it
5054
- # will be deleted from the rule.
5055
- # @param [Fixnum] merchant_id
5056
- # Required. The id of the merchant who owns the repricing rule.
5057
- # @param [String] rule_id
5058
- # Required. The id of the rule to update.
5059
- # @param [Google::Apis::ContentV2_1::RepricingRule] repricing_rule_object
5060
- # @param [String] fields
5061
- # Selector specifying which fields to include in a partial response.
5062
- # @param [String] quota_user
5063
- # Available to use for quota purposes for server-side applications. Can be any
5064
- # arbitrary string assigned to a user, but should not exceed 40 characters.
5065
- # @param [Google::Apis::RequestOptions] options
5066
- # Request-specific options
5067
- #
5068
- # @yield [result, err] Result & error if block supplied
5069
- # @yieldparam result [Google::Apis::ContentV2_1::RepricingRule] parsed result object
5070
- # @yieldparam err [StandardError] error object if request failed
5071
- #
5072
- # @return [Google::Apis::ContentV2_1::RepricingRule]
5073
- #
5074
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5075
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5076
- # @raise [Google::Apis::AuthorizationError] Authorization is required
5077
- def patch_repricingrule(merchant_id, rule_id, repricing_rule_object = nil, fields: nil, quota_user: nil, options: nil, &block)
5078
- command = make_simple_command(:patch, '{merchantId}/repricingrules/{ruleId}', options)
5079
- command.request_representation = Google::Apis::ContentV2_1::RepricingRule::Representation
5080
- command.request_object = repricing_rule_object
5081
- command.response_representation = Google::Apis::ContentV2_1::RepricingRule::Representation
5082
- command.response_class = Google::Apis::ContentV2_1::RepricingRule
5083
- command.params['merchantId'] = merchant_id unless merchant_id.nil?
5084
- command.params['ruleId'] = rule_id unless rule_id.nil?
5085
- command.query['fields'] = fields unless fields.nil?
5086
- command.query['quotaUser'] = quota_user unless quota_user.nil?
5087
- execute_or_queue_command(command, &block)
5088
- end
5089
-
5090
- # Lists the metrics report for a given Repricing rule.
5091
- # @param [Fixnum] merchant_id
5092
- # Required. Id of the merchant who owns the Repricing rule.
5093
- # @param [String] rule_id
5094
- # Required. Id of the Repricing rule.
5095
- # @param [String] end_date
5096
- # Gets Repricing reports on and before this date in the merchant's timezone. You
5097
- # can only retrieve data up to 7 days ago (default) or earlier. Format: YYYY-MM-
5098
- # DD.
5099
- # @param [Fixnum] page_size
5100
- # Maximum number of daily reports to return. Each report includes data from a
5101
- # single 24-hour period. The page size defaults to 50 and values above 1000 are
5102
- # coerced to 1000. This service may return fewer days than this value, for
5103
- # example, if the time between your start and end date is less than page size.
5104
- # @param [String] page_token
5105
- # Token (if provided) to retrieve the subsequent page. All other parameters must
5106
- # match the original call that provided the page token.
5107
- # @param [String] start_date
5108
- # Gets Repricing reports on and after this date in the merchant's timezone, up
5109
- # to one year ago. Do not use a start date later than 7 days ago (default).
5110
- # Format: YYYY-MM-DD.
5111
- # @param [String] fields
5112
- # Selector specifying which fields to include in a partial response.
5113
- # @param [String] quota_user
5114
- # Available to use for quota purposes for server-side applications. Can be any
5115
- # arbitrary string assigned to a user, but should not exceed 40 characters.
5116
- # @param [Google::Apis::RequestOptions] options
5117
- # Request-specific options
5118
- #
5119
- # @yield [result, err] Result & error if block supplied
5120
- # @yieldparam result [Google::Apis::ContentV2_1::ListRepricingRuleReportsResponse] parsed result object
5121
- # @yieldparam err [StandardError] error object if request failed
5122
- #
5123
- # @return [Google::Apis::ContentV2_1::ListRepricingRuleReportsResponse]
5124
- #
5125
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5126
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5127
- # @raise [Google::Apis::AuthorizationError] Authorization is required
5128
- def list_repricingrule_repricingreports(merchant_id, rule_id, end_date: nil, page_size: nil, page_token: nil, start_date: nil, fields: nil, quota_user: nil, options: nil, &block)
5129
- command = make_simple_command(:get, '{merchantId}/repricingrules/{ruleId}/repricingreports', options)
5130
- command.response_representation = Google::Apis::ContentV2_1::ListRepricingRuleReportsResponse::Representation
5131
- command.response_class = Google::Apis::ContentV2_1::ListRepricingRuleReportsResponse
5132
- command.params['merchantId'] = merchant_id unless merchant_id.nil?
5133
- command.params['ruleId'] = rule_id unless rule_id.nil?
5134
- command.query['endDate'] = end_date unless end_date.nil?
5135
- command.query['pageSize'] = page_size unless page_size.nil?
5136
- command.query['pageToken'] = page_token unless page_token.nil?
5137
- command.query['startDate'] = start_date unless start_date.nil?
5138
- command.query['fields'] = fields unless fields.nil?
5139
- command.query['quotaUser'] = quota_user unless quota_user.nil?
5140
- execute_or_queue_command(command, &block)
5141
- end
5142
-
5143
5621
  # Batches multiple return address related calls in a single request.
5144
5622
  # @param [Google::Apis::ContentV2_1::ReturnaddressCustomBatchRequest] returnaddress_custom_batch_request_object
5145
5623
  # @param [String] fields
@@ -5990,6 +6468,9 @@ module Google
5990
6468
  end
5991
6469
 
5992
6470
  # Retrieves the status and review eligibility for the Shopping Ads program.
6471
+ # Returns errors and warnings if they require action to resolve, will become
6472
+ # disapprovals, or impact impressions. Use `accountstatuses` to view all issues
6473
+ # for an account.
5993
6474
  # @param [Fixnum] merchant_id
5994
6475
  # Required. The ID of the account.
5995
6476
  # @param [String] fields
@@ -6019,7 +6500,9 @@ module Google
6019
6500
  execute_or_queue_command(command, &block)
6020
6501
  end
6021
6502
 
6022
- # Requests a review for Shopping Ads program in the provided country.
6503
+ # Requests a review of Shopping ads in a specific region. This method deprecated.
6504
+ # Use the `MerchantSupportService` to view product and account issues and
6505
+ # request a review.
6023
6506
  # @param [Fixnum] merchant_id
6024
6507
  # Required. The ID of the account.
6025
6508
  # @param [Google::Apis::ContentV2_1::RequestReviewShoppingAdsRequest] request_review_shopping_ads_request_object