Class: Peddler::APIs::CustomerFeedback20240601

Inherits:
Peddler::API
  • Object
show all
Defined in:
lib/peddler/apis/customer_feedback_2024_06_01.rb

Overview

The Selling Partner API for CustomerFeedback

The Selling Partner API for Customer Feedback (Customer Feedback API) provides information about customer reviews and returns at both the item and browse node level.

See Also:

Instance Attribute Summary

Attributes inherited from Peddler::API

#access_token, #endpoint, #retries

Instance Method Summary collapse

Methods inherited from Peddler::API

#endpoint_uri, #http, #initialize, #meter, #retriable, #sandbox, #sandbox?, #typed, #typed?, #use, #via

Constructor Details

This class inherits a constructor from Peddler::API

Instance Method Details

#get_browse_node_return_topics(browse_node_id, marketplace_id) ⇒ Peddler::Response

Note:

This operation can make a static sandbox call.

Retrieve the topics that customers mention when they return items in a browse node.

Parameters:

  • browse_node_id (String) —

    A browse node ID is a unique identifier for a browse node. A browse node is a named location in a browse tree that is used for navigation, product classification, and website content.

  • marketplace_id (String) —

    The MarketplaceId is the globally unique identifier of a marketplace, you can refer to the marketplaceId here : developer-docs.amazon.com/sp-api/docs/marketplace-ids.

Returns:



118
119
120
121
122
123
124
125
 
# File 'lib/peddler/apis/customer_feedback_2024_06_01.rb', line 118

def get_browse_node_return_topics(browse_node_id, marketplace_id)
  path = "/customerFeedback/2024-06-01/browseNodes/#{percent_encode(browse_node_id)}/returns/topics"
  params = {
    "marketplaceId" => marketplace_id,
  }.compact
  parser = Peddler::Types::CustomerFeedback20240601::BrowseNodeReturnTopicsResponse if typed?
  get(path, params:, parser:)
end

#get_browse_node_return_trends(browse_node_id, marketplace_id) ⇒ Peddler::Response

Note:

This operation can make a static sandbox call.

Retrieve the trends of topics that customers mention when they return items in a browse node.

Parameters:

  • browse_node_id (String) —

    A browse node ID is a unique identifier of a browse node. A browse node is a named location in a browse tree that is used for navigation, product classification, and website content.

  • marketplace_id (String) —

    The MarketplaceId is the globally unique identifier of a marketplace, you can refer to the marketplaceId here : developer-docs.amazon.com/sp-api/docs/marketplace-ids.

Returns:



135
136
137
138
139
140
141
142
 
# File 'lib/peddler/apis/customer_feedback_2024_06_01.rb', line 135

def get_browse_node_return_trends(browse_node_id, marketplace_id)
  path = "/customerFeedback/2024-06-01/browseNodes/#{percent_encode(browse_node_id)}/returns/trends"
  params = {
    "marketplaceId" => marketplace_id,
  }.compact
  parser = Peddler::Types::CustomerFeedback20240601::BrowseNodeReturnTrendsResponse if typed?
  get(path, params:, parser:)
end

#get_browse_node_review_topics(browse_node_id, marketplace_id, sort_by) ⇒ Peddler::Response

Note:

This operation can make a static sandbox call.

Retrieve a browse node’s ten most positive and ten most negative review topics.

Parameters:

  • browse_node_id (String) —

    The ID of a browse node. A browse node is a named location in a browse tree that is used for navigation, product classification, and website content.

  • marketplace_id (String) —

    The MarketplaceId is the globally unique identifier of a marketplace, you can refer to the marketplaceId here : developer-docs.amazon.com/sp-api/docs/marketplace-ids.

  • sort_by (String) —

    The metric by which to sort the data in the response.

Returns:



66
67
68
69
70
71
72
73
74
 
# File 'lib/peddler/apis/customer_feedback_2024_06_01.rb', line 66

def get_browse_node_review_topics(browse_node_id, marketplace_id, sort_by)
  path = "/customerFeedback/2024-06-01/browseNodes/#{percent_encode(browse_node_id)}/reviews/topics"
  params = {
    "marketplaceId" => marketplace_id,
    "sortBy" => sort_by,
  }.compact
  parser = Peddler::Types::CustomerFeedback20240601::BrowseNodeReviewTopicsResponse if typed?
  get(path, params:, parser:)
end

#get_browse_node_review_trends(browse_node_id, marketplace_id) ⇒ Peddler::Response

Note:

This operation can make a static sandbox call.

Retrieve the positive and negative review trends of items in a browse node for the past six months.

Parameters:

  • browse_node_id (String) —

    A browse node ID is a unique identifier of a browse node. A browse node is a named location in a browse tree that is used for navigation, product classification, and website content.

  • marketplace_id (String) —

    The marketplace ID is the globally unique identifier of a marketplace. For more information, refer to [Marketplace IDs](developer-docs.amazon.com/sp-api/docs/marketplace-ids).

Returns:



101
102
103
104
105
106
107
108
 
# File 'lib/peddler/apis/customer_feedback_2024_06_01.rb', line 101

def get_browse_node_review_trends(browse_node_id, marketplace_id)
  path = "/customerFeedback/2024-06-01/browseNodes/#{percent_encode(browse_node_id)}/reviews/trends"
  params = {
    "marketplaceId" => marketplace_id,
  }.compact
  parser = Peddler::Types::CustomerFeedback20240601::BrowseNodeReviewTrendsResponse if typed?
  get(path, params:, parser:)
end

#get_item_browse_node(asin, marketplace_id) ⇒ Peddler::Response

Note:

This operation can make a static sandbox call.

This API returns the associated browse node of the requested ASIN. A browse node is a location in a browse tree that is used for navigation, product classification, and website content on the Amazon retail website.

Parameters:

  • asin (String) —

    The Amazon Standard Identification Number (ASIN) is the unique identifier of a product within a marketplace.

  • marketplace_id (String) —

    The MarketplaceId is the globally unique identifier of a marketplace, you can refer to the marketplaceId here : developer-docs.amazon.com/sp-api/docs/marketplace-ids.

Returns:



48
49
50
51
52
53
54
55
 
# File 'lib/peddler/apis/customer_feedback_2024_06_01.rb', line 48

def get_item_browse_node(asin, marketplace_id)
  path = "/customerFeedback/2024-06-01/items/#{percent_encode(asin)}/browseNode"
  params = {
    "marketplaceId" => marketplace_id,
  }.compact
  parser = Peddler::Types::CustomerFeedback20240601::BrowseNodeResponse if typed?
  get(path, params:, parser:)
end

#get_item_review_topics(asin, marketplace_id, sort_by) ⇒ Peddler::Response

Note:

This operation can make a static sandbox call.

Retrieve an item’s ten most positive and ten most negative review topics.

Parameters:

  • asin (String) —

    The Amazon Standard Identification Number (ASIN) is the unique identifier of a product within a marketplace. The value must be a child ASIN.

  • marketplace_id (String) —

    The MarketplaceId is the globally unique identifier of a marketplace, you can refer to the marketplaceId here : developer-docs.amazon.com/sp-api/docs/marketplace-ids.

  • sort_by (String) —

    The metric by which to sort data in the response.

Returns:



29
30
31
32
33
34
35
36
37
 
# File 'lib/peddler/apis/customer_feedback_2024_06_01.rb', line 29

def get_item_review_topics(asin, marketplace_id, sort_by)
  path = "/customerFeedback/2024-06-01/items/#{percent_encode(asin)}/reviews/topics"
  params = {
    "marketplaceId" => marketplace_id,
    "sortBy" => sort_by,
  }.compact
  parser = Peddler::Types::CustomerFeedback20240601::ItemReviewTopicsResponse if typed?
  get(path, params:, parser:)
end

#get_item_review_trends(asin, marketplace_id) ⇒ Peddler::Response

Note:

This operation can make a static sandbox call.

Retrieve an item’s positive and negative review trends for the past six months.

Parameters:

  • asin (String) —

    The Amazon Standard Identification Number (ASIN) is the unique identifier of a product within a marketplace. This API takes child ASIN as an input.

  • marketplace_id (String) —

    The MarketplaceId is the globally unique identifier of a marketplace, you can refer to the marketplaceId here : developer-docs.amazon.com/sp-api/docs/marketplace-ids.

Returns:



84
85
86
87
88
89
90
91
 
# File 'lib/peddler/apis/customer_feedback_2024_06_01.rb', line 84

def get_item_review_trends(asin, marketplace_id)
  path = "/customerFeedback/2024-06-01/items/#{percent_encode(asin)}/reviews/trends"
  params = {
    "marketplaceId" => marketplace_id,
  }.compact
  parser = Peddler::Types::CustomerFeedback20240601::ItemReviewTrendsResponse if typed?
  get(path, params:, parser:)
end