class Peddler::API::AplusContent20201101
Selling Partner API
for A+ Content Management
With the A+ Content API
, you can build applications that help selling partners add rich marketing content to their Amazon product detail pages. A+ content helps selling partners share their brand and product story, which helps buyers make informed purchasing decisions. Selling partners assemble content by choosing from content modules and adding images and text.
Public Instance Methods
Creates a new A+ Content document.
@param marketplace_id [String] The identifier for the marketplace where the A+ Content is published. @param post_content_document_request [Hash] The content document request details. @param rate_limit [Float] Requests per second @return [Hash] The API
response
# File lib/peddler/api/aplus_content_2020_11_01.rb, line 50 def create_content_document(marketplace_id, post_content_document_request, rate_limit: 10.0) cannot_sandbox! path = "/aplus/2020-11-01/contentDocuments" body = post_content_document_request params = { "marketplaceId" => marketplace_id, }.compact meter(rate_limit).post(path, body:, params:) end
Returns an A+ Content document, if available.
@param content_reference_key [String] The unique reference key for the A+ Content document. A content reference
key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match any A+ Content identifier.
@param marketplace_id [String] The identifier for the marketplace where the A+ Content is published. @param included_data_set [Array<String>] The set of A+ Content data types to include in the response. @param rate_limit [Float] Requests per second @return [Hash] The API
response
# File lib/peddler/api/aplus_content_2020_11_01.rb, line 71 def get_content_document(content_reference_key, marketplace_id, included_data_set, rate_limit: 10.0) cannot_sandbox! path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}" params = { "marketplaceId" => marketplace_id, "includedDataSet" => included_data_set, }.compact meter(rate_limit).get(path, params:) end
Returns a list of ASINs related to the specified A+ Content document, if available. If you do not include the asinSet parameter, the operation returns all ASINs related to the content document.
@param content_reference_key [String] The unique reference key for the A+ Content document. A content reference
key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match any A+ Content identifier.
@param marketplace_id [String] The identifier for the marketplace where the A+ Content is published. @param included_data_set [Array<String>] The set of A+ Content data types to include in the response. If you do
not include this parameter, the operation returns the related ASINs without metadata.
@param asin_set [Array<String>] The set of ASINs. @param page_token [String] A page token from the nextPageToken response element returned by your previous call
to this operation. nextPageToken is returned when the results of a call exceed the page size. To get the next page of results, call the operation and include pageToken as the only parameter. Specifying pageToken with any other parameter will cause the request to fail. When no nextPageToken value is returned there are no more pages to return. A pageToken value is not usable across different operations.
@param rate_limit [Float] Requests per second @return [Hash] The API
response
# File lib/peddler/api/aplus_content_2020_11_01.rb, line 122 def list_content_document_asin_relations(content_reference_key, marketplace_id, included_data_set: nil, asin_set: nil, page_token: nil, rate_limit: 10.0) cannot_sandbox! path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}/asins" params = { "marketplaceId" => marketplace_id, "includedDataSet" => included_data_set, "asinSet" => asin_set, "pageToken" => page_token, }.compact meter(rate_limit).get(path, params:) end
Submits an A+ Content document for review, approval, and publishing.
@param content_reference_key [String] The unique reference key for the A+ Content document. A content reference
key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match any A+ content identifier.
@param marketplace_id [String] The identifier for the marketplace where the A+ Content is published. @param rate_limit [Float] Requests per second @return [Hash] The API
response
# File lib/peddler/api/aplus_content_2020_11_01.rb, line 214 def post_content_document_approval_submission(content_reference_key, marketplace_id, rate_limit: 10.0) cannot_sandbox! path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}/approvalSubmissions" params = { "marketplaceId" => marketplace_id, }.compact meter(rate_limit).post(path, params:) end
Replaces all ASINs related to the specified A+ Content document, if available. This may add or remove ASINs, depending on the current set of related ASINs. Removing an ASIN has the side effect of suspending the content document from that ASIN.
@param content_reference_key [String] The unique reference key for the A+ Content document. A content reference
key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match any A+ content identifier.
@param marketplace_id [String] The identifier for the marketplace where the A+ Content is published. @param post_content_document_asin_relations_request [Hash] The content document ASIN relations request details. @param rate_limit [Float] Requests per second @return [Hash] The API
response
# File lib/peddler/api/aplus_content_2020_11_01.rb, line 148 def post_content_document_asin_relations(content_reference_key, marketplace_id, post_content_document_asin_relations_request, rate_limit: 10.0) cannot_sandbox! path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}/asins" body = post_content_document_asin_relations_request params = { "marketplaceId" => marketplace_id, }.compact meter(rate_limit).post(path, body:, params:) end
Submits a request to suspend visible A+ Content. This neither deletes the content document nor the ASIN relations.
@param content_reference_key [String] The unique reference key for the A+ Content document. A content reference
key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match any A+ content identifier.
@param marketplace_id [String] The identifier for the marketplace where the A+ Content is published. @param rate_limit [Float] Requests per second @return [Hash] The API
response
# File lib/peddler/api/aplus_content_2020_11_01.rb, line 234 def post_content_document_suspend_submission(content_reference_key, marketplace_id, rate_limit: 10.0) cannot_sandbox! path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}/suspendSubmissions" params = { "marketplaceId" => marketplace_id, }.compact meter(rate_limit).post(path, params:) end
Returns a list of all A+ Content documents assigned to a selling partner. This operation returns only the metadata of the A+ Content documents. Call the getContentDocument operation to get the actual contents of the A+ Content documents.
@param marketplace_id [String] The identifier for the marketplace where the A+ Content is published. @param page_token [String] A page token from the nextPageToken response element returned by your previous call
to this operation. nextPageToken is returned when the results of a call exceed the page size. To get the next page of results, call the operation and include pageToken as the only parameter. Specifying pageToken with any other parameter will cause the request to fail. When no nextPageToken value is returned there are no more pages to return. A pageToken value is not usable across different operations.
@param rate_limit [Float] Requests per second @return [Hash] The API
response
# File lib/peddler/api/aplus_content_2020_11_01.rb, line 32 def search_content_documents(marketplace_id, page_token: nil, rate_limit: 10.0) cannot_sandbox! path = "/aplus/2020-11-01/contentDocuments" params = { "marketplaceId" => marketplace_id, "pageToken" => page_token, }.compact meter(rate_limit).get(path, params:) end
Searches for A+ Content publishing records, if available.
@param marketplace_id [String] The identifier for the marketplace where the A+ Content is published. @param asin [String] The Amazon Standard Identification Number (ASIN). @param page_token [String] A page token from the nextPageToken response element returned by your previous call
to this operation. nextPageToken is returned when the results of a call exceed the page size. To get the next page of results, call the operation and include pageToken as the only parameter. Specifying pageToken with any other parameter will cause the request to fail. When no nextPageToken value is returned there are no more pages to return. A pageToken value is not usable across different operations.
@param rate_limit [Float] Requests per second @return [Hash] The API
response
# File lib/peddler/api/aplus_content_2020_11_01.rb, line 193 def search_content_publish_records(marketplace_id, asin, page_token: nil, rate_limit: 10.0) cannot_sandbox! path = "/aplus/2020-11-01/contentPublishRecords" params = { "marketplaceId" => marketplace_id, "asin" => asin, "pageToken" => page_token, }.compact meter(rate_limit).get(path, params:) end
Updates an existing A+ Content document.
@param content_reference_key [String] The unique reference key for the A+ Content document. A content reference
key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match any A+ Content identifier.
@param marketplace_id [String] The identifier for the marketplace where the A+ Content is published. @param post_content_document_request [Hash] The content document request details. @param rate_limit [Float] Requests per second @return [Hash] The API
response
# File lib/peddler/api/aplus_content_2020_11_01.rb, line 92 def update_content_document(content_reference_key, marketplace_id, post_content_document_request, rate_limit: 10.0) cannot_sandbox! path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}" body = post_content_document_request params = { "marketplaceId" => marketplace_id, }.compact meter(rate_limit).post(path, body:, params:) end
Checks if the A+ Content document is valid for use on a set of ASINs.
@param marketplace_id [String] The identifier for the marketplace where the A+ Content is published. @param asin_set [Array<String>] The set of ASINs. @param post_content_document_request [Hash] The content document request details. @param rate_limit [Float] Requests per second @return [Hash] The API
response
# File lib/peddler/api/aplus_content_2020_11_01.rb, line 168 def validate_content_document_asin_relations(marketplace_id, post_content_document_request, asin_set: nil, rate_limit: 10.0) cannot_sandbox! path = "/aplus/2020-11-01/contentAsinValidations" body = post_content_document_request params = { "marketplaceId" => marketplace_id, "asinSet" => asin_set, }.compact meter(rate_limit).post(path, body:, params:) end