| quantity |
int |
The positive non-zero number of products available for purchase in the listing. Note: The listing quantity is the sum of available offering quantities. You can request the quantities for individual offerings from the ListingInventory resource using the getListingInventory endpoint. |
|
| title |
string |
The listing's title string. When creating or updating a listing, valid title strings contain only letters, numbers, punctuation marks, mathematical symbols, whitespace characters, ™, ©, and ®. (regex: /[^\\p{L}\\p{Nd}\\p{P}\\p{Sm}\\p{Zs}™©®]/u) You can only use the %, :, & and + characters once each. |
|
| description |
string |
A description string of the product for sale in the listing. |
|
| price |
float |
The positive non-zero price of the product. (Sold product listings are private) Note: The price is the minimum possible price. The `getListingInventory` method requests exact prices for available offerings. |
|
| who_made |
string |
An enumerated string indicating who made the product. Helps buyers locate the listing under the Handmade heading. Requires 'is_supply' and 'when_made'. |
|
| when_made |
string |
An enumerated string for the era in which the maker made the product in this listing. Helps buyers locate the listing under the Vintage heading. Requires 'is_supply' and 'who_made'. |
|
| taxonomy_id |
int |
The numerical taxonomy ID of the listing. See SellerTaxonomy and BuyerTaxonomy for more information. |
|
| shipping_profile_id |
int |
The numeric ID of the shipping profile associated with the listing. Required when listing type is `physical`. |
[optional] |
| return_policy_id |
int |
The numeric ID of the Return Policy. |
[optional] |
| materials |
string[] |
A list of material strings for materials used in the product. Valid materials strings contain only letters, numbers, and whitespace characters. (regex: /[^\\p{L}\\p{Nd}\\p{Zs}]/u) Default value is null. |
[optional] |
| shop_section_id |
int |
The numeric ID of the shop section for this listing. Default value is null. |
[optional] |
| processing_min |
int |
The minimum number of days required to process this listing. Default value is null. |
[optional] |
| processing_max |
int |
The maximum number of days required to process this listing. Default value is null. |
[optional] |
| tags |
string[] |
A comma-separated list of tag strings for the listing. When creating or updating a listing, valid tag strings contain only letters, numbers, whitespace characters, -, ', ™, ©, and ®. (regex: /[^\\p{L}\\p{Nd}\\p{Zs}\\-'™©®]/u) Default value is null. |
[optional] |
| styles |
string[] |
An array of style strings for this listing, each of which is free-form text string such as "Formal", or "Steampunk". When creating or updating a listing, the listing may have up to two styles. Valid style strings contain only letters, numbers, and whitespace characters. (regex: /[^\\p{L}\\p{Nd}\\p{Zs}]/u) Default value is null. |
[optional] |
| item_weight |
float |
The numeric weight of the product measured in units set in 'item_weight_unit'. Default value is null. If set, the value must be greater than 0. |
[optional] |
| item_length |
float |
The numeric length of the product measured in units set in 'item_dimensions_unit'. Default value is null. If set, the value must be greater than 0. |
[optional] |
| item_width |
float |
The numeric width of the product measured in units set in 'item_dimensions_unit'. Default value is null. If set, the value must be greater than 0. |
[optional] |
| item_height |
float |
The numeric height of the product measured in units set in 'item_dimensions_unit'. Default value is null. If set, the value must be greater than 0. |
[optional] |
| item_weight_unit |
string |
A string defining the units used to measure the weight of the product. Default value is null. |
[optional] |
| item_dimensions_unit |
string |
A string defining the units used to measure the dimensions of the product. Default value is null. |
[optional] |
| is_personalizable |
bool |
When true, this listing is personalizable. The default value is null. |
[optional] |
| personalization_is_required |
bool |
When true, this listing requires personalization. The default value is null. Will only change if is_personalizable is 'true'. |
[optional] |
| personalization_char_count_max |
int |
This is an integer value representing the maximum length for the personalization message entered by the buyer. Will only change if is_personalizable is 'true'. |
[optional] |
| personalization_instructions |
string |
A string representing instructions for the buyer to enter the personalization. Will only change if is_personalizable is 'true'. |
[optional] |
| production_partner_ids |
int[] |
An array of unique IDs of production partner ids. |
[optional] |
| image_ids |
int[] |
An array of numeric image IDs of the images in a listing, which can include up to 10 images. |
[optional] |
| is_supply |
bool |
When true, tags the listing as a supply product, else indicates that it's a finished product. Helps buyers locate the listing under the Supplies heading. Requires 'who_made' and 'when_made'. |
[optional] |
| is_customizable |
bool |
When true, a buyer may contact the seller for a customized order. The default value is true when a shop accepts custom orders. Does not apply to shops that do not accept custom orders. |
[optional] |
| should_auto_renew |
bool |
When true, renews a listing for four months upon expiration. |
[optional] |
| is_taxable |
bool |
When true, applicable shop tax rates apply to this listing at checkout. |
[optional] |
| type |
string |
An enumerated type string that indicates whether the listing is physical or a digital download. |
[optional] |