line |
stmt |
bran |
cond |
sub |
pod |
time |
code |
1
|
|
|
|
|
|
|
#!/usr/bin/perl |
2
|
|
|
|
|
|
|
|
3
|
|
|
|
|
|
|
package eBay::API::XML::Call::GetCategorySpecifics; |
4
|
|
|
|
|
|
|
|
5
|
1
|
|
|
1
|
|
2367
|
use strict; |
|
1
|
|
|
|
|
3
|
|
|
1
|
|
|
|
|
33
|
|
6
|
1
|
|
|
1
|
|
5
|
use warnings; |
|
1
|
|
|
|
|
2
|
|
|
1
|
|
|
|
|
42
|
|
7
|
|
|
|
|
|
|
|
8
|
|
|
|
|
|
|
########################################################################## |
9
|
|
|
|
|
|
|
# |
10
|
|
|
|
|
|
|
# Module: ............... eBay/API/XML |
11
|
|
|
|
|
|
|
# File: ................. GetCategorySpecifics.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::GetCategorySpecifics |
21
|
|
|
|
|
|
|
|
22
|
|
|
|
|
|
|
=head1 DESCRIPTION |
23
|
|
|
|
|
|
|
|
24
|
|
|
|
|
|
|
|
25
|
|
|
|
|
|
|
|
26
|
|
|
|
|
|
|
=head1 SYNOPSIS |
27
|
|
|
|
|
|
|
|
28
|
|
|
|
|
|
|
=cut |
29
|
|
|
|
|
|
|
|
30
|
|
|
|
|
|
|
|
31
|
|
|
|
|
|
|
=head1 INHERITANCE |
32
|
|
|
|
|
|
|
|
33
|
|
|
|
|
|
|
eBay::API::XML::Call::GetCategorySpecifics inherits from the L class |
34
|
|
|
|
|
|
|
|
35
|
|
|
|
|
|
|
=cut |
36
|
|
|
|
|
|
|
|
37
|
1
|
|
|
1
|
|
34
|
use eBay::API::XML::BaseCall; |
|
0
|
|
|
|
|
|
|
|
0
|
|
|
|
|
|
|
38
|
|
|
|
|
|
|
our @ISA = ("eBay::API::XML::BaseCall"); |
39
|
|
|
|
|
|
|
|
40
|
|
|
|
|
|
|
use eBay::API::XML::Call::GetCategorySpecifics::GetCategorySpecificsRequestType; |
41
|
|
|
|
|
|
|
use eBay::API::XML::Call::GetCategorySpecifics::GetCategorySpecificsResponseType; |
42
|
|
|
|
|
|
|
|
43
|
|
|
|
|
|
|
|
44
|
|
|
|
|
|
|
=head1 Subroutines: |
45
|
|
|
|
|
|
|
|
46
|
|
|
|
|
|
|
=cut |
47
|
|
|
|
|
|
|
|
48
|
|
|
|
|
|
|
sub getApiCallName { |
49
|
|
|
|
|
|
|
return 'GetCategorySpecifics'; |
50
|
|
|
|
|
|
|
} |
51
|
|
|
|
|
|
|
sub getRequestDataTypeFullPackage { |
52
|
|
|
|
|
|
|
return 'eBay::API::XML::Call::GetCategorySpecifics::GetCategorySpecificsRequestType'; |
53
|
|
|
|
|
|
|
} |
54
|
|
|
|
|
|
|
sub getResponseDataTypeFullPackage { |
55
|
|
|
|
|
|
|
return 'eBay::API::XML::Call::GetCategorySpecifics::GetCategorySpecificsResponseType'; |
56
|
|
|
|
|
|
|
} |
57
|
|
|
|
|
|
|
|
58
|
|
|
|
|
|
|
# |
59
|
|
|
|
|
|
|
# input properties |
60
|
|
|
|
|
|
|
# |
61
|
|
|
|
|
|
|
|
62
|
|
|
|
|
|
|
=head2 setCategoryID() |
63
|
|
|
|
|
|
|
|
64
|
|
|
|
|
|
|
A leaf category to retrieve recommended Item Specifics for. |
65
|
|
|
|
|
|
|
(This call returns no results for a parent category.) |
66
|
|
|
|
|
|
|
To determine which leaf categories support custom Item Specifics, |
67
|
|
|
|
|
|
|
use GetCategoryFeatures and GetCategories. |
68
|
|
|
|
|
|
|
You can specify multiple leaf categories (but more categories |
69
|
|
|
|
|
|
|
can result in longer response times). If you specify the same |
70
|
|
|
|
|
|
|
ID twice, we use the first instance. |
71
|
|
|
|
|
|
|
|
72
|
|
|
|
|
|
|
RequiredInput: Yes |
73
|
|
|
|
|
|
|
# Argument: reference to an array |
74
|
|
|
|
|
|
|
of 'xs:string' |
75
|
|
|
|
|
|
|
|
76
|
|
|
|
|
|
|
=cut |
77
|
|
|
|
|
|
|
|
78
|
|
|
|
|
|
|
sub setCategoryID { |
79
|
|
|
|
|
|
|
my $self = shift; |
80
|
|
|
|
|
|
|
my $sCategoryID = shift; |
81
|
|
|
|
|
|
|
$self->getRequestDataType()->setCategoryID($sCategoryID); |
82
|
|
|
|
|
|
|
} |
83
|
|
|
|
|
|
|
|
84
|
|
|
|
|
|
|
=head2 setLastUpdateTime() |
85
|
|
|
|
|
|
|
|
86
|
|
|
|
|
|
|
Causes the recommendation engine to check whether the list of |
87
|
|
|
|
|
|
|
popular Item Specifics for each specified category has changed |
88
|
|
|
|
|
|
|
since this date and time. If specified, this call returns no |
89
|
|
|
|
|
|
|
Item Specifics; it only returns whether the data has changed |
90
|
|
|
|
|
|
|
for any of the requested categories. |
91
|
|
|
|
|
|
|
|
92
|
|
|
|
|
|
|
Typically, you pass in the Timestamp that was |
93
|
|
|
|
|
|
|
returned the last time you refreshed the list of names and values |
94
|
|
|
|
|
|
|
for the same categories. If the Updated flag returns true for any |
95
|
|
|
|
|
|
|
categories in the response, call GetCategorySpecifics again |
96
|
|
|
|
|
|
|
for those categories to get the latest names and values. |
97
|
|
|
|
|
|
|
(As downloading all the data may affect your application's |
98
|
|
|
|
|
|
|
performance, it may help to only download Item Specifics |
99
|
|
|
|
|
|
|
for a category if they have changed since you last checked.) |
100
|
|
|
|
|
|
|
|
101
|
|
|
|
|
|
|
RequiredInput: No |
102
|
|
|
|
|
|
|
# Argument: 'xs:dateTime' |
103
|
|
|
|
|
|
|
|
104
|
|
|
|
|
|
|
=cut |
105
|
|
|
|
|
|
|
|
106
|
|
|
|
|
|
|
sub setLastUpdateTime { |
107
|
|
|
|
|
|
|
my $self = shift; |
108
|
|
|
|
|
|
|
my $sLastUpdateTime = shift; |
109
|
|
|
|
|
|
|
$self->getRequestDataType()->setLastUpdateTime($sLastUpdateTime); |
110
|
|
|
|
|
|
|
} |
111
|
|
|
|
|
|
|
|
112
|
|
|
|
|
|
|
=head2 setMaxNames() |
113
|
|
|
|
|
|
|
|
114
|
|
|
|
|
|
|
Maximum number of Item Specifics to return |
115
|
|
|
|
|
|
|
per category (where each Item Specific is identified |
116
|
|
|
|
|
|
|
by a unique name within the category). |
117
|
|
|
|
|
|
|
Use this to retrieve fewer results per category. |
118
|
|
|
|
|
|
|
For example, if you only want up to 2 per category |
119
|
|
|
|
|
|
|
(the top 2 most popular names), specify 2. |
120
|
|
|
|
|
|
|
|
121
|
|
|
|
|
|
|
Max: 15 (see GeteBayDetails) |
122
|
|
|
|
|
|
|
Default: 15 |
123
|
|
|
|
|
|
|
Min: 1 |
124
|
|
|
|
|
|
|
|
125
|
|
|
|
|
|
|
RequiredInput: No |
126
|
|
|
|
|
|
|
# Argument: 'xs:int' |
127
|
|
|
|
|
|
|
|
128
|
|
|
|
|
|
|
=cut |
129
|
|
|
|
|
|
|
|
130
|
|
|
|
|
|
|
sub setMaxNames { |
131
|
|
|
|
|
|
|
my $self = shift; |
132
|
|
|
|
|
|
|
my $sMaxNames = shift; |
133
|
|
|
|
|
|
|
$self->getRequestDataType()->setMaxNames($sMaxNames); |
134
|
|
|
|
|
|
|
} |
135
|
|
|
|
|
|
|
|
136
|
|
|
|
|
|
|
=head2 setMaxValuesPerName() |
137
|
|
|
|
|
|
|
|
138
|
|
|
|
|
|
|
Maximum number of values to retrieve per Item Specific. |
139
|
|
|
|
|
|
|
Use this to retrieve fewer values per name. |
140
|
|
|
|
|
|
|
For example, if you only want the most popular value, |
141
|
|
|
|
|
|
|
specify 1. |
142
|
|
|
|
|
|
|
|
143
|
|
|
|
|
|
|
Max: 10 (see GeteBayDetails) |
144
|
|
|
|
|
|
|
Default: 10 |
145
|
|
|
|
|
|
|
Min: 1 |
146
|
|
|
|
|
|
|
|
147
|
|
|
|
|
|
|
RequiredInput: No |
148
|
|
|
|
|
|
|
# Argument: 'xs:int' |
149
|
|
|
|
|
|
|
|
150
|
|
|
|
|
|
|
=cut |
151
|
|
|
|
|
|
|
|
152
|
|
|
|
|
|
|
sub setMaxValuesPerName { |
153
|
|
|
|
|
|
|
my $self = shift; |
154
|
|
|
|
|
|
|
my $sMaxValuesPerName = shift; |
155
|
|
|
|
|
|
|
$self->getRequestDataType()->setMaxValuesPerName($sMaxValuesPerName); |
156
|
|
|
|
|
|
|
} |
157
|
|
|
|
|
|
|
|
158
|
|
|
|
|
|
|
=head2 setName() |
159
|
|
|
|
|
|
|
|
160
|
|
|
|
|
|
|
The name of one Item Specific name to find values for. |
161
|
|
|
|
|
|
|
Use this if you want to find out whether a name |
162
|
|
|
|
|
|
|
that the seller provided has recommended values. |
163
|
|
|
|
|
|
|
If you specify multiple leaf categories in the request, |
164
|
|
|
|
|
|
|
the recommendation engine returns all matching |
165
|
|
|
|
|
|
|
names and values it finds for each of those categories. |
166
|
|
|
|
|
|
|
At the time of this writing, this value is case-sensitive. |
167
|
|
|
|
|
|
|
(Wildcards are not supported.) |
168
|
|
|
|
|
|
|
|
169
|
|
|
|
|
|
|
MaxLength: 30 (see GeteBayDetails) |
170
|
|
|
|
|
|
|
|
171
|
|
|
|
|
|
|
RequiredInput: No |
172
|
|
|
|
|
|
|
# Argument: 'xs:string' |
173
|
|
|
|
|
|
|
|
174
|
|
|
|
|
|
|
=cut |
175
|
|
|
|
|
|
|
|
176
|
|
|
|
|
|
|
sub setName { |
177
|
|
|
|
|
|
|
my $self = shift; |
178
|
|
|
|
|
|
|
my $sName = shift; |
179
|
|
|
|
|
|
|
$self->getRequestDataType()->setName($sName); |
180
|
|
|
|
|
|
|
} |
181
|
|
|
|
|
|
|
|
182
|
|
|
|
|
|
|
|
183
|
|
|
|
|
|
|
|
184
|
|
|
|
|
|
|
# |
185
|
|
|
|
|
|
|
# output properties |
186
|
|
|
|
|
|
|
# |
187
|
|
|
|
|
|
|
|
188
|
|
|
|
|
|
|
=head2 getCategoryItemSpecifics() |
189
|
|
|
|
|
|
|
|
190
|
|
|
|
|
|
|
Contains the most popular Item Specifics, if any, for a category |
191
|
|
|
|
|
|
|
specified in the request, or contains information about whether |
192
|
|
|
|
|
|
|
the recommendations have changed for that category since |
193
|
|
|
|
|
|
|
the LastUpdateTime you requested. |
194
|
|
|
|
|
|
|
|
195
|
|
|
|
|
|
|
The most relevant Item Specifics are returned first. If a name |
196
|
|
|
|
|
|
|
has multiple values, the first value is more popular. |
197
|
|
|
|
|
|
|
|
198
|
|
|
|
|
|
|
This node returns empty (or it's not returned) for a category if |
199
|
|
|
|
|
|
|
there is no applicable data (such as when you request a parent category, a category that has no popular Item Specifics yet, |
200
|
|
|
|
|
|
|
or a duplicate category that was already returned). |
201
|
|
|
|
|
|
|
If you pass in the CategoryID and Name fields together, but no |
202
|
|
|
|
|
|
|
matching values are found for the name, eBay returns the name |
203
|
|
|
|
|
|
|
with no values (even if the name is not recommended). |
204
|
|
|
|
|
|
|
|
205
|
|
|
|
|
|
|
If custom Item Specifics are enabled for a leaf category you |
206
|
|
|
|
|
|
|
requested, but GetCategorySpecifics doesn't return any |
207
|
|
|
|
|
|
|
recommendations for that category, the seller can still |
208
|
|
|
|
|
|
|
specify their own custom Item Specifics for listings in that category. |
209
|
|
|
|
|
|
|
|
210
|
|
|
|
|
|
|
Returned: Conditionally |
211
|
|
|
|
|
|
|
# Returns: reference to an array |
212
|
|
|
|
|
|
|
of 'ns:CategoryItemSpecificsType' |
213
|
|
|
|
|
|
|
|
214
|
|
|
|
|
|
|
=cut |
215
|
|
|
|
|
|
|
|
216
|
|
|
|
|
|
|
sub getCategoryItemSpecifics { |
217
|
|
|
|
|
|
|
my $self = shift; |
218
|
|
|
|
|
|
|
return $self->getResponseDataType()->getCategoryItemSpecifics(); |
219
|
|
|
|
|
|
|
} |
220
|
|
|
|
|
|
|
|
221
|
|
|
|
|
|
|
|
222
|
|
|
|
|
|
|
|
223
|
|
|
|
|
|
|
|
224
|
|
|
|
|
|
|
|
225
|
|
|
|
|
|
|
1; |