class AmzSpApi::CatalogItemsApiModel::CatalogApi
Attributes
Public Class Methods
# File lib/catalog-items-api-model/api/catalog_api.rb, line 16 def initialize(api_client = ApiClient.default) @api_client = api_client end
Public Instance Methods
Returns a specified item and its attributes. **Usage Plan:** | Rate (requests per second) | Burst | | —- | —- | | 1 | 1 | For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation. @param marketplace_id A marketplace identifier. Specifies the marketplace for the item. @param asin The Amazon Standard Identification Number (ASIN) of the item. @param [Hash] opts the optional parameters @return [GetCatalogItemResponse]
# File lib/catalog-items-api-model/api/catalog_api.rb, line 24 def get_catalog_item(marketplace_id, asin, opts = {}) data, _status_code, _headers = get_catalog_item_with_http_info(marketplace_id, asin, opts) data end
Returns a specified item and its attributes. **Usage Plan:** | Rate (requests per second) | Burst | | —- | —- | | 1 | 1 | For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation. @param marketplace_id A marketplace identifier. Specifies the marketplace for the item. @param asin The Amazon Standard Identification Number (ASIN) of the item. @param [Hash] opts the optional parameters @return [Array<(GetCatalogItemResponse
, Integer, Hash)>] GetCatalogItemResponse
data, response status code and response headers
# File lib/catalog-items-api-model/api/catalog_api.rb, line 34 def get_catalog_item_with_http_info(marketplace_id, asin, opts = {}) if @api_client.config.debugging @api_client.config.logger.debug 'Calling API: CatalogApi.get_catalog_item ...' end # verify the required parameter 'marketplace_id' is set if @api_client.config.client_side_validation && marketplace_id.nil? fail ArgumentError, "Missing the required parameter 'marketplace_id' when calling CatalogApi.get_catalog_item" end # verify the required parameter 'asin' is set if @api_client.config.client_side_validation && asin.nil? fail ArgumentError, "Missing the required parameter 'asin' when calling CatalogApi.get_catalog_item" end # resource path local_var_path = '/catalog/v0/items/{asin}'.sub('{' + 'asin' + '}', asin.to_s) # query parameters query_params = opts[:query_params] || {} query_params[:'MarketplaceId'] = marketplace_id # header parameters header_params = opts[:header_params] || {} # HTTP header 'Accept' (if needed) header_params['Accept'] = @api_client.select_header_accept(['application/json']) # form parameters form_params = opts[:form_params] || {} # http body (model) post_body = opts[:body] return_type = opts[:return_type] || 'GetCatalogItemResponse' auth_names = opts[:auth_names] || [] data, status_code, headers = @api_client.call_api(:GET, local_var_path, :header_params => header_params, :query_params => query_params, :form_params => form_params, :body => post_body, :auth_names => auth_names, :return_type => return_type) if @api_client.config.debugging @api_client.config.logger.debug "API called: CatalogApi#get_catalog_item\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}" end return data, status_code, headers end
Returns the parent categories to which an item belongs, based on the specified ASIN or SellerSKU. **Usage Plan:** | Rate (requests per second) | Burst | | —- | —- | | 1 | 1 | For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation. @param marketplace_id A marketplace identifier. Specifies the marketplace for the item. @param [Hash] opts the optional parameters @option opts [String] :asin The Amazon Standard Identification Number (ASIN) of the item. @option opts [String] :seller_sku Used to identify items in the given marketplace. SellerSKU is qualified by the seller's SellerId, which is included with every operation that you submit. @return [ListCatalogCategoriesResponse]
# File lib/catalog-items-api-model/api/catalog_api.rb, line 86 def list_catalog_categories(marketplace_id, opts = {}) data, _status_code, _headers = list_catalog_categories_with_http_info(marketplace_id, opts) data end
Returns the parent categories to which an item belongs, based on the specified ASIN or SellerSKU. **Usage Plan:** | Rate (requests per second) | Burst | | —- | —- | | 1 | 1 | For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation. @param marketplace_id A marketplace identifier. Specifies the marketplace for the item. @param [Hash] opts the optional parameters @option opts [String] :asin The Amazon Standard Identification Number (ASIN) of the item. @option opts [String] :seller_sku Used to identify items in the given marketplace. SellerSKU is qualified by the seller's SellerId, which is included with every operation that you submit. @return [Array<(ListCatalogCategoriesResponse
, Integer, Hash)>] ListCatalogCategoriesResponse
data, response status code and response headers
# File lib/catalog-items-api-model/api/catalog_api.rb, line 97 def list_catalog_categories_with_http_info(marketplace_id, opts = {}) if @api_client.config.debugging @api_client.config.logger.debug 'Calling API: CatalogApi.list_catalog_categories ...' end # verify the required parameter 'marketplace_id' is set if @api_client.config.client_side_validation && marketplace_id.nil? fail ArgumentError, "Missing the required parameter 'marketplace_id' when calling CatalogApi.list_catalog_categories" end # resource path local_var_path = '/catalog/v0/categories' # query parameters query_params = opts[:query_params] || {} query_params[:'MarketplaceId'] = marketplace_id query_params[:'ASIN'] = opts[:'asin'] if !opts[:'asin'].nil? query_params[:'SellerSKU'] = opts[:'seller_sku'] if !opts[:'seller_sku'].nil? # header parameters header_params = opts[:header_params] || {} # HTTP header 'Accept' (if needed) header_params['Accept'] = @api_client.select_header_accept(['application/json']) # form parameters form_params = opts[:form_params] || {} # http body (model) post_body = opts[:body] return_type = opts[:return_type] || 'ListCatalogCategoriesResponse' auth_names = opts[:auth_names] || [] data, status_code, headers = @api_client.call_api(:GET, local_var_path, :header_params => header_params, :query_params => query_params, :form_params => form_params, :body => post_body, :auth_names => auth_names, :return_type => return_type) if @api_client.config.debugging @api_client.config.logger.debug "API called: CatalogApi#list_catalog_categories\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}" end return data, status_code, headers end
Returns a list of items and their attributes, based on a search query or item identifiers that you specify. When based on a search query, provide the Query parameter and optionally, the QueryContextId parameter. When based on item identifiers, provide a single appropriate parameter based on the identifier type, and specify the associated item value. MarketplaceId is always required. **Usage Plan:** | Rate (requests per second) | Burst | | —- | —- | | 1 | 1 | For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation. @param marketplace_id A marketplace identifier. Specifies the marketplace for which items are returned. @param [Hash] opts the optional parameters @option opts [String] :query Keyword(s) to use to search for items in the catalog. Example: 'harry potter books'. @option opts [String] :query_context_id An identifier for the context within which the given search will be performed. A marketplace might provide mechanisms for constraining a search to a subset of potential items. For example, the retail marketplace allows queries to be constrained to a specific category. The QueryContextId parameter specifies such a subset. If it is omitted, the search will be performed using the default context for the marketplace, which will typically contain the largest set of items. @option opts [String] :seller_sku Used to identify an item in the given marketplace. SellerSKU is qualified by the seller's SellerId, which is included with every operation that you submit. @option opts [String] :upc A 12-digit bar code used for retail packaging. @option opts [String] :ean A European article number that uniquely identifies the catalog item, manufacturer, and its attributes. @option opts [String] :isbn The unique commercial book identifier used to identify books internationally. @option opts [String] :jan A Japanese article number that uniquely identifies the product, manufacturer, and its attributes. @return [ListCatalogItemsResponse]
# File lib/catalog-items-api-model/api/catalog_api.rb, line 152 def list_catalog_items(marketplace_id, opts = {}) data, _status_code, _headers = list_catalog_items_with_http_info(marketplace_id, opts) data end
Returns a list of items and their attributes, based on a search query or item identifiers that you specify. When based on a search query, provide the Query parameter and optionally, the QueryContextId parameter. When based on item identifiers, provide a single appropriate parameter based on the identifier type, and specify the associated item value. MarketplaceId is always required. **Usage Plan:** | Rate (requests per second) | Burst | | —- | —- | | 1 | 1 | For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation. @param marketplace_id A marketplace identifier. Specifies the marketplace for which items are returned. @param [Hash] opts the optional parameters @option opts [String] :query Keyword(s) to use to search for items in the catalog. Example: 'harry potter books'. @option opts [String] :query_context_id An identifier for the context within which the given search will be performed. A marketplace might provide mechanisms for constraining a search to a subset of potential items. For example, the retail marketplace allows queries to be constrained to a specific category. The QueryContextId parameter specifies such a subset. If it is omitted, the search will be performed using the default context for the marketplace, which will typically contain the largest set of items. @option opts [String] :seller_sku Used to identify an item in the given marketplace. SellerSKU is qualified by the seller's SellerId, which is included with every operation that you submit. @option opts [String] :upc A 12-digit bar code used for retail packaging. @option opts [String] :ean A European article number that uniquely identifies the catalog item, manufacturer, and its attributes. @option opts [String] :isbn The unique commercial book identifier used to identify books internationally. @option opts [String] :jan A Japanese article number that uniquely identifies the product, manufacturer, and its attributes. @return [Array<(ListCatalogItemsResponse
, Integer, Hash)>] ListCatalogItemsResponse
data, response status code and response headers
# File lib/catalog-items-api-model/api/catalog_api.rb, line 168 def list_catalog_items_with_http_info(marketplace_id, opts = {}) if @api_client.config.debugging @api_client.config.logger.debug 'Calling API: CatalogApi.list_catalog_items ...' end # verify the required parameter 'marketplace_id' is set if @api_client.config.client_side_validation && marketplace_id.nil? fail ArgumentError, "Missing the required parameter 'marketplace_id' when calling CatalogApi.list_catalog_items" end # resource path local_var_path = '/catalog/v0/items' # query parameters query_params = opts[:query_params] || {} query_params[:'MarketplaceId'] = marketplace_id query_params[:'Query'] = opts[:'query'] if !opts[:'query'].nil? query_params[:'QueryContextId'] = opts[:'query_context_id'] if !opts[:'query_context_id'].nil? query_params[:'SellerSKU'] = opts[:'seller_sku'] if !opts[:'seller_sku'].nil? query_params[:'UPC'] = opts[:'upc'] if !opts[:'upc'].nil? query_params[:'EAN'] = opts[:'ean'] if !opts[:'ean'].nil? query_params[:'ISBN'] = opts[:'isbn'] if !opts[:'isbn'].nil? query_params[:'JAN'] = opts[:'jan'] if !opts[:'jan'].nil? # header parameters header_params = opts[:header_params] || {} # HTTP header 'Accept' (if needed) header_params['Accept'] = @api_client.select_header_accept(['application/json']) # form parameters form_params = opts[:form_params] || {} # http body (model) post_body = opts[:body] return_type = opts[:return_type] || 'ListCatalogItemsResponse' auth_names = opts[:auth_names] || [] data, status_code, headers = @api_client.call_api(:GET, local_var_path, :header_params => header_params, :query_params => query_params, :form_params => form_params, :body => post_body, :auth_names => auth_names, :return_type => return_type) if @api_client.config.debugging @api_client.config.logger.debug "API called: CatalogApi#list_catalog_items\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}" end return data, status_code, headers end