Trading_VariationSpecificPictureSetType Class Reference
Inherits from | NSObject |
Conforms to | PicoBindable |
Declared in | Trading_VariationSpecificPictureSetType.h Trading_VariationSpecificPictureSetType.m |
Overview
Type defining the VariationSpecificPictureSet container, which is
used to specify the URL(s) where the picture(s) of the variation specific will be
hosted. If the Variations.Pictures container is used, at least one
VariationSpecificPictureSet container is required.
@ingroup EBayAPIInterface
Tasks
-
variationSpecificValue
A value that is associated with VariationSpecificName. For example,
property
suppose this set of pictures is showing blue shirts, and some of
the variations include Color=Blue in their variation specifics.
If VariationSpecificName is “Color”, then VariationSpecificValue would be “Blue”. -
pictureURL
The URL of a picture that is associated with the
property
VariationSpecificValue. A variation specific picture set can
consist of up to 12 images hosted by eBay Picture Services (EPS). However, only
one picture may be used if that picture is hosted outside of eBay. eBay Picture
Services and self-hosted images can never be combined into the same variation
specific picture set. To specify multiple eBay Picture Services images, use
multiple PictureURL fields, passing in a distinct URL in each
of those fields. If specified, this field cannot have an empty/null value.
The picture located at the URL specified in the first
PictureURL field is also used as the thumbnail image for
applicable variations. For example, if the picture set contains pictures of red
shirts (i.e., VariationSpecificName=Color and VariationSpecificValue=Red), the
first picture is used as the thumbnail image for all the red shirt variations.
You can use Item.PictureDetails to specify additional pictures.
For example, the item-level pictures could include a model wearing a
black shirt, as a typical example of the shirt style.
Note:
If a URI contains spaces, replace them with%20
.
For example,http://example.com/my image.jpg
must be
submitted ashttp://example.com/my%20image.jpg
to
replace the space in the image file name.
-
galleryURL
URL for the variation’s Gallery thumbnail, which eBay uses when
property
the variation is shown in My eBay. -
externalPictureURL
Returns the URL of a variation-specific picture that is hosted outside of eBay.
property
When you list, revise, or relist a variation, use VariationSpecificPictureSet.PictureURL (not ExternalPictureURL) to specify your self-hosted picture or EPS picture.
On sites with free gallery, if you use a self-hosted picture for a variation, eBay copies the picture and hosts it in eBay Picture Services (EPS). In eBay’s View Item page, the variation shows the EPS-hosted picture. GetItem returns the EPS picture in VariationSpecificPictureSet.PictureURL, and it returns the self-hosted picture in VariationSpecificPictureSet.ExternalPictureURL. (If the copying process fails, the original (self-hosted) picture is returned in both ExternalPictureURL and PictureURL.)
Only returned when the seller used a self-hosted picture for the variation. -
any
(public property)
property
Properties
any
(public property)
@property (nonatomic, retain) NSMutableArray *any
Discussion
(public property)
entry type : PicoAnyElement, wrapper for primitive anyelement
Declared In
Trading_VariationSpecificPictureSetType.h
externalPictureURL
Returns the URL of a variation-specific picture that is hosted outside of eBay.
When you list, revise, or relist a variation, use VariationSpecificPictureSet.PictureURL (not ExternalPictureURL) to specify your self-hosted picture or EPS picture.
On sites with free gallery, if you use a self-hosted picture for a variation, eBay copies the picture and hosts it in eBay Picture Services (EPS). In eBay’s View Item page, the variation shows the EPS-hosted picture. GetItem returns the EPS picture in VariationSpecificPictureSet.PictureURL, and it returns the self-hosted picture in VariationSpecificPictureSet.ExternalPictureURL. (If the copying process fails, the original (self-hosted) picture is returned in both ExternalPictureURL and PictureURL.)
Only returned when the seller used a self-hosted picture for the variation.
@property (nonatomic, retain) NSMutableArray *externalPictureURL
Discussion
Returns the URL of a variation-specific picture that is hosted outside of eBay.
When you list, revise, or relist a variation, use VariationSpecificPictureSet.PictureURL (not ExternalPictureURL) to specify your self-hosted picture or EPS picture.
On sites with free gallery, if you use a self-hosted picture for a variation, eBay copies the picture and hosts it in eBay Picture Services (EPS). In eBay’s View Item page, the variation shows the EPS-hosted picture. GetItem returns the EPS picture in VariationSpecificPictureSet.PictureURL, and it returns the self-hosted picture in VariationSpecificPictureSet.ExternalPictureURL. (If the copying process fails, the original (self-hosted) picture is returned in both ExternalPictureURL and PictureURL.)
Only returned when the seller used a self-hosted picture for the variation.
entry type : NSString, wrapper for primitive string
Declared In
Trading_VariationSpecificPictureSetType.h
galleryURL
URL for the variation’s Gallery thumbnail, which eBay uses when
the variation is shown in My eBay.
@property (nonatomic, retain) NSString *galleryURL
Discussion
URL for the variation’s Gallery thumbnail, which eBay uses when
the variation is shown in My eBay.
type : NSString, wrapper for primitive string
Declared In
Trading_VariationSpecificPictureSetType.h
pictureURL
The URL of a picture that is associated with the
VariationSpecificValue. A variation specific picture set can
consist of up to 12 images hosted by eBay Picture Services (EPS). However, only
one picture may be used if that picture is hosted outside of eBay. eBay Picture
Services and self-hosted images can never be combined into the same variation
specific picture set. To specify multiple eBay Picture Services images, use
multiple PictureURL fields, passing in a distinct URL in each
of those fields. If specified, this field cannot have an empty/null value.
The picture located at the URL specified in the first
PictureURL field is also used as the thumbnail image for
applicable variations. For example, if the picture set contains pictures of red
shirts (i.e., VariationSpecificName=Color and VariationSpecificValue=Red), the
first picture is used as the thumbnail image for all the red shirt variations.
You can use Item.PictureDetails to specify additional pictures.
For example, the item-level pictures could include a model wearing a
black shirt, as a typical example of the shirt style.
Note:
If a URI contains spaces, replace them with %20
.
For example, http://example.com/my image.jpg
must be
submitted as http://example.com/my%20image.jpg
to
replace the space in the image file name.
@property (nonatomic, retain) NSMutableArray *pictureURL
Discussion
The URL of a picture that is associated with the
VariationSpecificValue. A variation specific picture set can
consist of up to 12 images hosted by eBay Picture Services (EPS). However, only
one picture may be used if that picture is hosted outside of eBay. eBay Picture
Services and self-hosted images can never be combined into the same variation
specific picture set. To specify multiple eBay Picture Services images, use
multiple PictureURL fields, passing in a distinct URL in each
of those fields. If specified, this field cannot have an empty/null value.
The picture located at the URL specified in the first
PictureURL field is also used as the thumbnail image for
applicable variations. For example, if the picture set contains pictures of red
shirts (i.e., VariationSpecificName=Color and VariationSpecificValue=Red), the
first picture is used as the thumbnail image for all the red shirt variations.
You can use Item.PictureDetails to specify additional pictures.
For example, the item-level pictures could include a model wearing a
black shirt, as a typical example of the shirt style.
Note:
If a URI contains spaces, replace them with %20
.
For example, http://example.com/my image.jpg
must be
submitted as http://example.com/my%20image.jpg
to
replace the space in the image file name.
entry type : NSString, wrapper for primitive string
Declared In
Trading_VariationSpecificPictureSetType.h
variationSpecificValue
A value that is associated with VariationSpecificName. For example,
suppose this set of pictures is showing blue shirts, and some of
the variations include Color=Blue in their variation specifics.
If VariationSpecificName is “Color”, then VariationSpecificValue would be “Blue”.
@property (nonatomic, retain) NSString *variationSpecificValue
Discussion
A value that is associated with VariationSpecificName. For example,
suppose this set of pictures is showing blue shirts, and some of
the variations include Color=Blue in their variation specifics.
If VariationSpecificName is “Color”, then VariationSpecificValue would be “Blue”.
type : NSString, wrapper for primitive string
Declared In
Trading_VariationSpecificPictureSetType.h