line |
stmt |
bran |
cond |
sub |
pod |
time |
code |
1
|
|
|
|
|
|
|
#!/usr/bin/perl |
2
|
|
|
|
|
|
|
|
3
|
|
|
|
|
|
|
package eBay::API::XML::Call::GetCategoryFeatures; |
4
|
|
|
|
|
|
|
|
5
|
1
|
|
|
1
|
|
2315
|
use strict; |
|
1
|
|
|
|
|
2
|
|
|
1
|
|
|
|
|
27
|
|
6
|
1
|
|
|
1
|
|
4
|
use warnings; |
|
1
|
|
|
|
|
2
|
|
|
1
|
|
|
|
|
26
|
|
7
|
|
|
|
|
|
|
|
8
|
|
|
|
|
|
|
########################################################################## |
9
|
|
|
|
|
|
|
# |
10
|
|
|
|
|
|
|
# Module: ............... eBay/API/XML |
11
|
|
|
|
|
|
|
# File: ................. GetCategoryFeatures.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::GetCategoryFeatures |
21
|
|
|
|
|
|
|
|
22
|
|
|
|
|
|
|
=head1 DESCRIPTION |
23
|
|
|
|
|
|
|
|
24
|
|
|
|
|
|
|
|
25
|
|
|
|
|
|
|
|
26
|
|
|
|
|
|
|
=head1 SYNOPSIS |
27
|
|
|
|
|
|
|
|
28
|
|
|
|
|
|
|
=cut |
29
|
|
|
|
|
|
|
|
30
|
|
|
|
|
|
|
|
31
|
|
|
|
|
|
|
=head1 INHERITANCE |
32
|
|
|
|
|
|
|
|
33
|
|
|
|
|
|
|
eBay::API::XML::Call::GetCategoryFeatures 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::GetCategoryFeatures::GetCategoryFeaturesRequestType; |
41
|
|
|
|
|
|
|
use eBay::API::XML::Call::GetCategoryFeatures::GetCategoryFeaturesResponseType; |
42
|
|
|
|
|
|
|
|
43
|
|
|
|
|
|
|
|
44
|
|
|
|
|
|
|
=head1 Subroutines: |
45
|
|
|
|
|
|
|
|
46
|
|
|
|
|
|
|
=cut |
47
|
|
|
|
|
|
|
|
48
|
|
|
|
|
|
|
sub getApiCallName { |
49
|
|
|
|
|
|
|
return 'GetCategoryFeatures'; |
50
|
|
|
|
|
|
|
} |
51
|
|
|
|
|
|
|
sub getRequestDataTypeFullPackage { |
52
|
|
|
|
|
|
|
return 'eBay::API::XML::Call::GetCategoryFeatures::GetCategoryFeaturesRequestType'; |
53
|
|
|
|
|
|
|
} |
54
|
|
|
|
|
|
|
sub getResponseDataTypeFullPackage { |
55
|
|
|
|
|
|
|
return 'eBay::API::XML::Call::GetCategoryFeatures::GetCategoryFeaturesResponseType'; |
56
|
|
|
|
|
|
|
} |
57
|
|
|
|
|
|
|
|
58
|
|
|
|
|
|
|
# |
59
|
|
|
|
|
|
|
# input properties |
60
|
|
|
|
|
|
|
# |
61
|
|
|
|
|
|
|
|
62
|
|
|
|
|
|
|
=head2 setCategoryID() |
63
|
|
|
|
|
|
|
|
64
|
|
|
|
|
|
|
Defines one category for which you want feature settings. |
65
|
|
|
|
|
|
|
If not specified, returns feature settings for all |
66
|
|
|
|
|
|
|
categories on the site (assuming you set the DetailLevel |
67
|
|
|
|
|
|
|
to ReturnAll and ViewAllNodes to true). |
68
|
|
|
|
|
|
|
|
69
|
|
|
|
|
|
|
MaxLength: 10 |
70
|
|
|
|
|
|
|
|
71
|
|
|
|
|
|
|
RequiredInput: No |
72
|
|
|
|
|
|
|
# Argument: 'xs:string' |
73
|
|
|
|
|
|
|
|
74
|
|
|
|
|
|
|
=cut |
75
|
|
|
|
|
|
|
|
76
|
|
|
|
|
|
|
sub setCategoryID { |
77
|
|
|
|
|
|
|
my $self = shift; |
78
|
|
|
|
|
|
|
my $sCategoryID = shift; |
79
|
|
|
|
|
|
|
$self->getRequestDataType()->setCategoryID($sCategoryID); |
80
|
|
|
|
|
|
|
} |
81
|
|
|
|
|
|
|
|
82
|
|
|
|
|
|
|
=head2 setFeatureID() |
83
|
|
|
|
|
|
|
|
84
|
|
|
|
|
|
|
Retrieves data related to the specified feature setting only. |
85
|
|
|
|
|
|
|
If no feature IDs are specified, the call retrieves data for all |
86
|
|
|
|
|
|
|
feature settings. |
87
|
|
|
|
|
|
|
|
88
|
|
|
|
|
|
|
RequiredInput: No |
89
|
|
|
|
|
|
|
# Argument: reference to an array |
90
|
|
|
|
|
|
|
of 'ns:FeatureIDCodeType' |
91
|
|
|
|
|
|
|
|
92
|
|
|
|
|
|
|
=cut |
93
|
|
|
|
|
|
|
|
94
|
|
|
|
|
|
|
sub setFeatureID { |
95
|
|
|
|
|
|
|
my $self = shift; |
96
|
|
|
|
|
|
|
my $sFeatureID = shift; |
97
|
|
|
|
|
|
|
$self->getRequestDataType()->setFeatureID($sFeatureID); |
98
|
|
|
|
|
|
|
} |
99
|
|
|
|
|
|
|
|
100
|
|
|
|
|
|
|
=head2 setLevelLimit() |
101
|
|
|
|
|
|
|
|
102
|
|
|
|
|
|
|
A level of depth in the category hierarchy. |
103
|
|
|
|
|
|
|
Retrieves all category nodes with a CategoryLevel less |
104
|
|
|
|
|
|
|
than or equal to the LevelLimit value. |
105
|
|
|
|
|
|
|
|
106
|
|
|
|
|
|
|
RequiredInput: No |
107
|
|
|
|
|
|
|
# Argument: 'xs:int' |
108
|
|
|
|
|
|
|
|
109
|
|
|
|
|
|
|
=cut |
110
|
|
|
|
|
|
|
|
111
|
|
|
|
|
|
|
sub setLevelLimit { |
112
|
|
|
|
|
|
|
my $self = shift; |
113
|
|
|
|
|
|
|
my $sLevelLimit = shift; |
114
|
|
|
|
|
|
|
$self->getRequestDataType()->setLevelLimit($sLevelLimit); |
115
|
|
|
|
|
|
|
} |
116
|
|
|
|
|
|
|
|
117
|
|
|
|
|
|
|
=head2 setViewAllNodes() |
118
|
|
|
|
|
|
|
|
119
|
|
|
|
|
|
|
Set this value to true to retrieve useful results. |
120
|
|
|
|
|
|
|
If true, retrieves all categories that override the |
121
|
|
|
|
|
|
|
site default settings. |
122
|
|
|
|
|
|
|
(If false or not specified, only retrieves data about |
123
|
|
|
|
|
|
|
leaf categories. If the details about overridden settings |
124
|
|
|
|
|
|
|
are only defined on a category's ancestor, the call does |
125
|
|
|
|
|
|
|
not return those settings if you only retrieve leaf categories.) |
126
|
|
|
|
|
|
|
|
127
|
|
|
|
|
|
|
RequiredInput: Conditionally |
128
|
|
|
|
|
|
|
Default: false |
129
|
|
|
|
|
|
|
# Argument: 'xs:boolean' |
130
|
|
|
|
|
|
|
|
131
|
|
|
|
|
|
|
=cut |
132
|
|
|
|
|
|
|
|
133
|
|
|
|
|
|
|
sub setViewAllNodes { |
134
|
|
|
|
|
|
|
my $self = shift; |
135
|
|
|
|
|
|
|
my $sViewAllNodes = shift; |
136
|
|
|
|
|
|
|
$self->getRequestDataType()->setViewAllNodes($sViewAllNodes); |
137
|
|
|
|
|
|
|
} |
138
|
|
|
|
|
|
|
|
139
|
|
|
|
|
|
|
|
140
|
|
|
|
|
|
|
|
141
|
|
|
|
|
|
|
# |
142
|
|
|
|
|
|
|
# output properties |
143
|
|
|
|
|
|
|
# |
144
|
|
|
|
|
|
|
|
145
|
|
|
|
|
|
|
=head2 getCategory() |
146
|
|
|
|
|
|
|
|
147
|
|
|
|
|
|
|
A category whose feature settings are different from the settings of its parent category.
|
148
|
|
|
|
|
|
|
|
149
|
|
|
|
|
|
|
For example, suppose there is a branch of the category tree with 5 category levels |
150
|
|
|
|
|
|
|
(L1, L2, L3, L4, and L5). Suppose the feature settings for SiteDefaults, L1, L4, and L5 |
151
|
|
|
|
|
|
|
are all "A", and the settings for L2 and L3 are "B". In this case:
|
152
|
|
|
|
|
|
|
L1's settings (A) match the site default, so L1 is not returned.
|
153
|
|
|
|
|
|
|
L2's settings (B) are different from L1's, so L2 is returned.
|
154
|
|
|
|
|
|
|
L3's settings (B) are the same as L2's, so L3 is not returned
|
155
|
|
|
|
|
|
|
L4's settings (A) are different from L3's, so L4 is returned
|
156
|
|
|
|
|
|
|
L5's settings (A) are the same as L4's, so L5 is not returned.
|
157
|
|
|
|
|
|
|
|
158
|
|
|
|
|
|
|
If you specified a particular FeatureID in the request, this field |
159
|
|
|
|
|
|
|
only returns feature settings for that feature. |
160
|
|
|
|
|
|
|
Only returned when the category is different from its parent. |
161
|
|
|
|
|
|
|
If the category has children and they aren't returned, |
162
|
|
|
|
|
|
|
it means the children inherit the category's feature settings. |
163
|
|
|
|
|
|
|
|
164
|
|
|
|
|
|
|
Returned: Conditionally |
165
|
|
|
|
|
|
|
Details: DetailLevel: ReturnAll |
166
|
|
|
|
|
|
|
# Returns: reference to an array |
167
|
|
|
|
|
|
|
of 'ns:CategoryFeatureType' |
168
|
|
|
|
|
|
|
|
169
|
|
|
|
|
|
|
=cut |
170
|
|
|
|
|
|
|
|
171
|
|
|
|
|
|
|
sub getCategory { |
172
|
|
|
|
|
|
|
my $self = shift; |
173
|
|
|
|
|
|
|
return $self->getResponseDataType()->getCategory(); |
174
|
|
|
|
|
|
|
} |
175
|
|
|
|
|
|
|
|
176
|
|
|
|
|
|
|
=head2 getCategoryVersion() |
177
|
|
|
|
|
|
|
|
178
|
|
|
|
|
|
|
Returns the current version of the set of feature meta-data. |
179
|
|
|
|
|
|
|
Compare this value to the version of the last version you |
180
|
|
|
|
|
|
|
downloaded to determine whether the data may have changed. |
181
|
|
|
|
|
|
|
|
182
|
|
|
|
|
|
|
Returned: Always |
183
|
|
|
|
|
|
|
Details: DetailLevel: none, ReturnSummary, ReturnAll |
184
|
|
|
|
|
|
|
# Returns: 'xs:string' |
185
|
|
|
|
|
|
|
|
186
|
|
|
|
|
|
|
=cut |
187
|
|
|
|
|
|
|
|
188
|
|
|
|
|
|
|
sub getCategoryVersion { |
189
|
|
|
|
|
|
|
my $self = shift; |
190
|
|
|
|
|
|
|
return $self->getResponseDataType()->getCategoryVersion(); |
191
|
|
|
|
|
|
|
} |
192
|
|
|
|
|
|
|
|
193
|
|
|
|
|
|
|
=head2 getFeatureDefinitions() |
194
|
|
|
|
|
|
|
|
195
|
|
|
|
|
|
|
Returns definitions of the various features on the site, |
196
|
|
|
|
|
|
|
or the features you requested in FeatureID (if any). |
197
|
|
|
|
|
|
|
Each feature has a node within FeatureDefinitions. |
198
|
|
|
|
|
|
|
|
199
|
|
|
|
|
|
|
Returned: Always |
200
|
|
|
|
|
|
|
Details: DetailLevel: none, ReturnSummary, ReturnAll |
201
|
|
|
|
|
|
|
# Returns: 'ns:FeatureDefinitionsType' |
202
|
|
|
|
|
|
|
|
203
|
|
|
|
|
|
|
=cut |
204
|
|
|
|
|
|
|
|
205
|
|
|
|
|
|
|
sub getFeatureDefinitions { |
206
|
|
|
|
|
|
|
my $self = shift; |
207
|
|
|
|
|
|
|
return $self->getResponseDataType()->getFeatureDefinitions(); |
208
|
|
|
|
|
|
|
} |
209
|
|
|
|
|
|
|
|
210
|
|
|
|
|
|
|
=head2 getSiteDefaults() |
211
|
|
|
|
|
|
|
|
212
|
|
|
|
|
|
|
Returns the feature settings defined for most categories on the site. |
213
|
|
|
|
|
|
|
Most categories share these settings. However, some categories can |
214
|
|
|
|
|
|
|
override some settings, as indicated in the Category nodes |
215
|
|
|
|
|
|
|
(if any). |
216
|
|
|
|
|
|
|
|
217
|
|
|
|
|
|
|
Returned: Always |
218
|
|
|
|
|
|
|
Details: DetailLevel: ReturnAll |
219
|
|
|
|
|
|
|
# Returns: 'ns:SiteDefaultsType' |
220
|
|
|
|
|
|
|
|
221
|
|
|
|
|
|
|
=cut |
222
|
|
|
|
|
|
|
|
223
|
|
|
|
|
|
|
sub getSiteDefaults { |
224
|
|
|
|
|
|
|
my $self = shift; |
225
|
|
|
|
|
|
|
return $self->getResponseDataType()->getSiteDefaults(); |
226
|
|
|
|
|
|
|
} |
227
|
|
|
|
|
|
|
|
228
|
|
|
|
|
|
|
=head2 getUpdateTime() |
229
|
|
|
|
|
|
|
|
230
|
|
|
|
|
|
|
Gives the time in GMT that the feature flags for the |
231
|
|
|
|
|
|
|
category hierarchy were last updated. |
232
|
|
|
|
|
|
|
|
233
|
|
|
|
|
|
|
Returned: Always |
234
|
|
|
|
|
|
|
Details: DetailLevel: none, ReturnSummary, ReturnAll |
235
|
|
|
|
|
|
|
# Returns: 'xs:dateTime' |
236
|
|
|
|
|
|
|
|
237
|
|
|
|
|
|
|
=cut |
238
|
|
|
|
|
|
|
|
239
|
|
|
|
|
|
|
sub getUpdateTime { |
240
|
|
|
|
|
|
|
my $self = shift; |
241
|
|
|
|
|
|
|
return $self->getResponseDataType()->getUpdateTime(); |
242
|
|
|
|
|
|
|
} |
243
|
|
|
|
|
|
|
|
244
|
|
|
|
|
|
|
|
245
|
|
|
|
|
|
|
|
246
|
|
|
|
|
|
|
|
247
|
|
|
|
|
|
|
|
248
|
|
|
|
|
|
|
1; |