Sample ListingsItems

[IncredibleX]

Hi,
has anybody a sample for Listings Items?

[J-W-Chan]

Hello, you can refer to this linklistingitem

[TechyChap]

Getting or putting?
Putting is harder as you need to construct all of the attributes. I've done partial uploads but not got all the attributes sorted yet.

Getting you can do things like this:

        AmazonConnection amazonConnection = new AmazonConnection(new AmazonCredential()
        {
            //insert credentials here
        });

        ParameterGetListingsItem searchCriteria = new ParameterGetListingsItem();
        searchCriteria.sellerId = "mysellerid";
        searchCriteria.sku = SKU;
        searchCriteria.marketplaceIds = new string[] { MarketPlace.UnitedKingdom.ID };
        searchCriteria.includedData = new ListingsIncludedData[] { ListingsIncludedData.Attributes, ListingsIncludedData.Issues, ListingsIncludedData.Summaries, ListingsIncludedData.Offers };
        var listing = amazonConnection.ListingsItem.GetListingsItem(searchCriteria);

        foreach (var issue in listing.Issues)
        {
            Console.WriteLine(issue.Message);
        }

[TechyChap]

Putting is like this:

AmazonConnection amazonConnection = new AmazonConnection(new AmazonCredential()
        {
            //insert credentials here
        });
            //Started with example from https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2020-09-01-use-case-guide

            ParameterPutListingItem myListing = new ParameterPutListingItem()
            {
                sellerId = "mysellerid",
                marketplaceIds = new string[] { MarketPlace.UnitedKingdom.ID },
                sku = SKU,
                listingsItemPutRequest = new ListingsItemPutRequest()
                {
                    productType = "OUTERWEAR",
                    requirements = Requirements.LISTING_PRODUCT_ONLY,
                    attributes = new ParameterAttributes()
                    {
                        { "condition_type", new List<ParameterAttributeItem>()
                            {
                                new ParameterAttributeItem() {
                                    { "value" , "new_new" },
                                    { "marketplace_id", MarketPlace.UnitedKingdom.ID }
                                }
                            }
                        },
                        { "item_name", new List<ParameterAttributeItem>()
                            {
                                new ParameterAttributeItem()
                                {
                                    { "value", "My New Amazon Product" },
                                    { "marketplace_id", MarketPlace.UnitedKingdom.ID },
                                    { "language_tag", "en_US" }
                                }
                            }
                        }
                    }
                }
            };
            var response = amazonConnection.ListingsItem.PutListingsItem(myListing);

            Console.WriteLine(response.Status);

            foreach (var issue in response.Issues)
            {
                Console.WriteLine($"{issue.Severity} : {issue.Message}");
            }
        }

[TechyChap]

We are using a generic parameter attribute approach using a dictionary

public partial class ParameterAttributes : Dictionary<String, List<ParameterAttributeItem>>
        {
            /// <summary>
            /// Initializes a new instance of the <see cref="ItemAttributes" /> class.
            /// </summary>
            [JsonConstructorAttribute]
            public ParameterAttributes() : base()
            {
            }
        }
        
        
     public partial class ParameterAttributeItem : Dictionary<string, object>
        {
            /// <summary>
            /// Initializes a new instance of the <see cref="ItemAttributes" /> class.
            /// </summary>
            [JsonConstructorAttribute]
            public ParameterAttributeItem() : base()
            {
            }
        }       

[TechyChap]

To work out what attributes you need to upload you can download the schema for your kind of product.

var productType = "FOOTWEAR"

var amazonConnection = CreateAmazonUKConnection();

var definition = amazonConnection.ProductType.GetDefinitionsProductType(
           new FikaAmazonAPI.Parameter.ProductTypes.GetDefinitionsProductTypeParameter()
           {
               productType = productType,
               requirements = RequirementsEnum.LISTING,
               locale = FikaAmazonAPI.AmazonSpApiSDK.Models.ProductTypes.LocaleEnum.en_GB
           });

Dictionary<string,object> links = (Dictionary<string, object>)definition.Schema.Link;

var schemaURL = links["resource"].ToString();

var httpClient = new HttpClient();

using (var stream = await httpClient.GetStreamAsync(schemaURL))
{
    using (var fileStream = new FileStream($".\\{productType}schema.json", FileMode.Create))
    {
        await stream.CopyToAsync(fileStream);
    }
}