Product Advertising API
Getting Started Guide (API Version 2011-08-01)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

Your Development Environment

This section helps you confirm that your development environment is set up correctly. Skip to the section that corresponds to the toolkit you downloaded:

[Note]Note

If you are viewing this document online, you can view the example code in only one programming language by clicking your preferred language in the Show Language list on the top-right corner of the page.

Java

You can implement Product Advertising API operations directly in Java. You can also generate and use the Product Advertising API Java Client Side library to simplify your Java implementations. This section explains how to generate the Product Advertising API Java Client Side Library. The next section shows you how to use it to create a request.

Generating the Stubs

You will use the wsimport utility in Java 6 to generate the stubs from the Product Advertising API WSDL, which is located at http://webservices.amazon.com/AWSECommerceService/AWSECommerceService.wsdl.

To generate the Product Advertising API Client Side Library stubs

  1. Go to the directory where you want to generate the stubs and create a "build" directory and a "src" directory.

    All of the generated source code will go under "src" folder.

  2. If you are using Eclipse 3.2, create a custom binding to disable "Wrapper Style" code generation.

    <jaxws:bindings wsdlLocation="http://webservices.amazon.com/AWSECommerceService/AWSECommerceService.wsdl" xmlns:jaxws="http://java.sun.com/xml/ns/jaxws">
      <jaxws:enableWrapperStyle>false</jaxws:enableWrapperStyle>
    </jaxws:bindings>

    This step is necessary because Eclipse 3.2 does not support wrapper style generated code. However, if you are an IDE that does support wrapper style generated code, such as NetBeans, this step is not required.

  3. Run the command:

    wsimport -d ./build -s ./src  -p com.ECS.client.jax http://webservices.amazon.com/AWSECommerceService/AWSECommerceService.wsdl -b jaxws-custom.xml . 

    You can find the generated stubs in the path, com.ECS.client.jax .

Generated File Types

Several file types are generated in the package, com.ECS.client.jax:

  • AWSECommerceService—This file identifies the Product Advertising API service.

  • AWSECommerceServicePortType—This file provides the port type that the client can listen on.

    This file also contains a list of all Product Advertising API operation signatures that can be used to build the client.

C#

Product Advertising API requires that you have successfully installed Microsoft Visual Studio.

To confirm the installation

  1. Open Visual Studio 2005 C# Express Edition.

  2. Click Help > About Microsoft Visual Studio.

    A dialog box opens.The dialog box should list Microsoft Visual Studio 2005 and version 2.0 of the .NET Framework.

Create the SOAP proxy in Visual Studio

In your application, you need to add a web reference to the Product Advertising API WSDL you want to use.

To add a web reference

  1. On the Project menu, click Add Web Reference.

  2. In the URL box, type http://webservices.amazon.com/AWSECommerceService/AWSECommerceService.wsdl, and then click Go.

  3. Click Add Reference.

A new Web References folder is added to the Solution Explorer.

You can now reference the SOAP proxy using your project namespaces. For example:

using GettingStartedGuideSample.com.amazonaws.ecs;

Perl

Run the following commands to verify that you have installed all of the necessary Perl modules:

perl -MDigest::HMAC_SHA1 -e 1
perl -MMIME::Base64 -e 1
perl -MLWP -e 1
perl -MXML::XPath -e 1
perl -MDate::Format -e 1

You should not receive any error messages.

PHP

To verify your PHP installation

  • Use a command-line interface to run the following command:

    php -version

    This command assumes you are either in your PHP installation directory or it is in your PATH system variable.

The response should be similar to the following:

PHP 5.1.2 (cli) (built: Jan 11 2006 16:40:00)
Copyright (c) 1997-2006 The PHP Group
Zend Engine v2.1.0, Copyright (c) 1998-2006 Zend Technologies