File Coverage

lib/eBay/API/XML/Call/GetProductSearchPage/GetProductSearchPageRequestType.pm
Criterion Covered Total %
statement 7 9 77.7
branch n/a
condition n/a
subroutine 3 3 100.0
pod n/a
total 10 12 83.3


line stmt bran cond sub pod time code
1             #!/usr/bin/perl
2              
3             package eBay::API::XML::Call::GetProductSearchPage::GetProductSearchPageRequestType;
4              
5 1     1   1411 use strict;
  1         2  
  1         26  
6 1     1   4 use warnings;
  1         2  
  1         28  
7              
8             ##########################################################################
9             #
10             # Module: ............... eBay/API/XML
11             # File: ................. GetProductSearchPageRequestType.pm
12             # Generated by: ......... genEBayApiDataTypes.pl
13             # Last Generated: ....... 08/24/2008 16:44
14             # API Release Number: ... 579
15             #
16             ##########################################################################
17              
18             =head1 NAME
19              
20             eBay::API::XML::Call::GetProductSearchPage::GetProductSearchPageRequestType
21              
22             =head1 DESCRIPTION
23              
24             Retrieves the attributes a seller can use to form a query when
25             searching for Pre-filled Item Information to use in a listing for
26             a category that is catalog-enabled. This call is applicable for
27             use cases related to listing items with Pre-filled Item
28             Information. Specifically, it retrieves data
29             that you use to construct valid "single-attribute" queries. The
30             attributes describe search criteria (e.g., Author) and sorting
31             criteria (e.g., Publication Year), as appropriate for the
32             category. GetProductSearchPage does not conduct the actual
33             product search. It only returns data about what you can search
34             on. Use the data as input to GetProductSearchResults to conduct
35             the actual search for product information. To retrieve Product
36             Finder search criteria (querying against multiple attributes),
37             use GetProductFinder instead. See the eBay Web Services guide for
38             an overview of Pre-filled Item Information and details about
39             searching for catalog products.
40              
41              
42              
43             =head1 SYNOPSIS
44              
45             =cut
46              
47              
48             =head1 INHERITANCE
49              
50             eBay::API::XML::Call::GetProductSearchPage::GetProductSearchPageRequestType inherits from the L class
51              
52             =cut
53              
54 1     1   34 use eBay::API::XML::RequestDataType;
  0            
  0            
55             our @ISA = ("eBay::API::XML::RequestDataType");
56              
57              
58              
59             my @gaProperties = ( [ 'AttributeSetID', 'xs:int', '1', '', '' ]
60             , [ 'AttributeSystemVersion', 'xs:string', '', '', '' ]
61             );
62             push @gaProperties, @{eBay::API::XML::RequestDataType::getPropertiesList()};
63              
64             my @gaAttributes = (
65             );
66             push @gaAttributes, @{eBay::API::XML::RequestDataType::getAttributesList()};
67              
68             =head1 Subroutines:
69              
70             =cut
71              
72             sub new {
73             my $classname = shift;
74             my %args = @_;
75             my $self = $classname->SUPER::new(%args);
76             return $self;
77             }
78              
79             sub isScalar {
80             return 0;
81             }
82              
83              
84              
85             =head2 setAttributeSetID()
86              
87             A characteristic set ID that is associated with a
88             catalog-enabled category that supports product search pages.
89             You can pass an array of these IDs in the request.
90             Each characteristic set corresponds to a level in the
91             eBay category hierarchy at which all items share common characteristics.
92             Multiple categories can be mapped to the same characteristic set.
93             Each ID is used as a filter to limit the response content to fewer
94             characteristic sets. When IDs are specified, the call only returns
95             search page data for the corresponding characteristic sets.
96             When no IDs are specified, the call returns all the current
97             search page data in the system.
98              
99             RequiredInput: No
100             # Argument: reference to an array
101             of 'xs:int'
102              
103             =cut
104              
105             sub setAttributeSetID {
106             my $self = shift;
107             $self->{'AttributeSetID'} =
108             $self->convertArray_To_RefToArrayIfNeeded(@_);
109             }
110              
111             =head2 getAttributeSetID()
112              
113             # Returns: reference to an array
114             of 'xs:int'
115              
116             =cut
117              
118             sub getAttributeSetID {
119             my $self = shift;
120             return $self->_getDataTypeArray('AttributeSetID');
121             }
122              
123              
124             =head2 setAttributeSystemVersion()
125              
126             A version of the search page definitions for the site. Typically, an
127             application passes the version value that was returned the last time the
128             application executed this call. Filter that causes the call to return only
129             the search pages for which the attribute meta-data has changed since the
130             specified version. The latest version value is not necessarily greater
131             than the previous value that was returned. Therefore, when comparing
132             versions, only compare whether the value has changed.
133              
134             RequiredInput: No
135             # Argument: 'xs:string'
136              
137             =cut
138              
139             sub setAttributeSystemVersion {
140             my $self = shift;
141             $self->{'AttributeSystemVersion'} = shift
142             }
143              
144             =head2 getAttributeSystemVersion()
145              
146             # Returns: 'xs:string'
147              
148             =cut
149              
150             sub getAttributeSystemVersion {
151             my $self = shift;
152             return $self->{'AttributeSystemVersion'};
153             }
154              
155              
156              
157              
158              
159             ## Attribute and Property lists
160             sub getPropertiesList {
161             my $self = shift;
162             return \@gaProperties;
163             }
164              
165             sub getAttributesList {
166             my $self = shift;
167             return \@gaAttributes;
168             }
169              
170              
171              
172             1;