Etsy (niezależny wydawca)
Ten łącznik używa klucza interfejsu API do uzyskiwania dostępu do różnych funkcji Etsy.com. Obsługuje ona akcje dotyczące zapasów, zamówień sprzedaży i zarządzania sklepami. Wszystkie akcje są oparte na interfejsie API Open Etsy w wersji 3, które mają punkty końcowe, które są nadal dostępne w wersji beta. Jeśli takie akcje używają interfejsu API beta, akcja z uwzględnij beta w tytule i zwróci kod odpowiedzi 501.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Troy Taylor |
| adres URL | https://www.hitachisolutions.com |
| ttaylor@hitachisolutions.com |
| Metadane łącznika | |
|---|---|
| Publisher | Troy Taylor, Firma Solutions |
| Witryna internetowa | https://www.etsy.com/ |
| Zasady ochrony prywatności | https://www.etsy.com/legal/privacy/ |
| Kategorie | Commerce |
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: Wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja Power App zostanie udostępniona innemu użytkownikowi, inny użytkownik zostanie poproszony o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| klucz interfejsu API | securestring | Klucz interfejsu API dla tego interfejsu API | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Aktualizowanie listy |
Aktualizuje listę, zidentyfikowaną przez identyfikator aukcji, dla określonego sklepu zidentyfikowanego przez identyfikator sklepu. |
| Aktualizowanie miejsca docelowego profilu wysyłki |
Aktualizuje istniejące miejsce docelowe wysyłki, które może ustawić lub ponownie przypisać koszt wysyłki, przewoźnik i klasę dla miejsca docelowego. |
| Aktualizowanie obrazów odmiany listy |
Tworzy obrazy odmian na liście. |
| Aktualizowanie profilu wysyłki |
Zmienia ustawienia w profilu wysyłki. |
| Aktualizowanie sklepu |
Zaktualizuj sklep. Przyjęto założenie, że wszystkie parametry ciągu są podane w języku podstawowym sklepu. |
| Aktualizowanie spisu listy |
Aktualizuje spis listy zidentyfikowanej przez identyfikator listy. Aktualizacja nie powiedzie się, jeśli podane wartości jednostki SKU produktu, ilości i/lub ceny są niezgodne z wartościami w polach właściwości. Podczas ustawiania ceny przypisz zmiennoprzecinkowy równy wartości podzielonej przez dzielnik, jak określono w zasobie pieniężnym. |
| Aktualizowanie tłumaczenia listy |
Aktualizuje tłumaczenie listy, wyświetlając listę identyfikatorów i języka. |
| Aktualizowanie uaktualnienia profilu wysyłkowego |
Aktualizuje uaktualnienie profilu wysyłki i aktualizuje wszystkie listy korzystające z profilu wysyłkowego. |
| Aktualizowanie właściwości listy |
Aktualizuje lub wypełnia listę właściwości definiującą oferty produktów dla oferty. Każda oferta wymaga zarówno wartości, jak i identyfikatora wartości, które są prawidłowe dla identyfikatora skalowania przypisanego do listy lub przypisanego do listy z tym żądaniem. |
| Ping |
Sprawdź, czy łączność z interfejsem API Etsy jest potwierdzana za pomocą aplikacji. |
| Pobieranie adresów użytkowników |
Pobieranie listy adresów użytkowników. |
| Pobieranie aktywnych list |
Lista wszystkich aktywnych list na stronie Etsy podzielonych na strony według daty utworzenia. Bez list kolejności sortowania będą domyślnie zwracane najnowsze listy. |
| Pobieranie list według identyfikatora |
Umożliwia wykonywanie zapytań dotyczących wielu identyfikatorów list jednocześnie. Ogranicz maksymalnie 100 identyfikatorów na zapytanie. |
| Pobieranie listy |
Pobiera rekord listy według identyfikatora listy. |
| Pobieranie listy płatności |
Pobiera listę płatności ze sklepu zidentyfikowanego przez identyfikator sklepu. Wyniki można również filtrować przy użyciu listy identyfikatorów płatności. |
| Pobieranie miejsc docelowych profilu według profilu wysyłkowego |
Pobiera listę obiektów docelowych wysyłki skojarzonych z profilem wysyłki. |
| Pobieranie obrazu listy |
Pobiera odwołania i metadane dla obrazu listy z określonym identyfikatorem obrazu. |
| Pobieranie obrazów listy |
Pobiera wszystkie zasoby obrazów z listą z określonym identyfikatorem listy. |
| Pobieranie obrazów odmian listy |
Pobiera wszystkie obrazy odmian na liście. |
| Pobieranie ofert według identyfikatora sekcji sklepu |
Pobiera wszystkie oferty z sekcji określonego sklepu. |
| Pobieranie ofert według paragonu sklepowego |
Pobiera wszystkie listy skojarzone z potwierdzeniem. |
| Pobieranie ofert według sklepu |
Zwraca listy należące do sklepu. Listy można filtrować przy użyciu parametru stanu. |
| Pobieranie oferty oferty |
Uzyskaj ofertę dla oferty. |
| Pobieranie pliku z listy |
Pobiera pojedynczy plik skojarzony z daną listą cyfrową. Żądanie pliku z listy fizycznej zwraca pusty wynik. |
| Pobieranie potwierdzeń |
Żąda paragonów sklepu z określonego sklepu, niefiltrowanego lub filtrowanego według zakresu identyfikatora paragonu lub przesunięcia, daty, płatności i/lub wysłanych zakupów. |
| Pobieranie produktu listy |
Pobierz produkt listy według identyfikatora. |
| Pobieranie profilu wysyłki |
Pobiera profil wysyłki, do których odwołuje się identyfikator profilu wysyłki. |
| Pobieranie profilów wysyłki |
Pobiera listę profilów wysyłkowych dostępnych w określonym sklepie Etsy zidentyfikowanym przez jego identyfikator sklepu. |
| Pobieranie przewoźników wysyłkowych |
Pobiera listę dostępnych przewoźników wysyłkowych i klasy poczty skojarzone z nimi dla danego kraju. |
| Pobieranie płatności z identyfikatora wpisu rejestru płatności |
Pobierz płatność z identyfikatora wpisu rejestru płatności, jeśli ma to zastosowanie. |
| Pobieranie płatności z określonego paragonu |
Pobiera płatność z określonego paragonu, zidentyfikowanego przez identyfikator paragonu, z określonego sklepu, zidentyfikowanego przez identyfikator sklepu. |
| Pobieranie sekcji sklepu |
Pobiera listę sekcji sklepu w określonym sklepie zidentyfikowanym przez identyfikator sklepu. |
| Pobieranie spisu listy |
Pobiera rekord spisu dla listy. Listy, które nie zostały edytowane przy użyciu narzędzi Etsy.com spisu, nie mają żadnych rekordów spisu. Ten punkt końcowy zwraca dane jednostki SKU, jeśli jesteś właścicielem pobieranych rekordów spisu. |
| Pobieranie transakcji |
Pobiera transakcję według identyfikatora transakcji. |
| Pobieranie transakcji listy |
Pobiera listę transakcji skojarzonych z listą. |
| Pobieranie transakcji paragonu |
Pobiera listę transakcji skojarzonych z określonym potwierdzeniem. |
| Pobieranie tłumaczenia listy |
Zwraca tłumaczenie listy w danym języku. |
| Pobieranie uaktualnień profilu wysyłkowego |
Pobiera listę uaktualnień profilu wysyłkowego przypisanych do określonego profilu wysyłkowego. |
| Pobieranie użytkownika |
Zwraca profil użytkownika zidentyfikowany przez identyfikator użytkownika. |
| Pobieranie wpisów rejestru konta płatności sklepu |
Pobierz wpisy rejestru konta płatniczego sklepu. |
| Pobieranie wszystkich plików listy |
Pobiera wszystkie pliki skojarzone z daną listą cyfrową. Żądanie plików z listy fizycznej zwraca pusty wynik. |
| Pobieranie węzłów taksonomii sprzedawcy |
Pobiera pełne drzewo hierarchii węzłów taksonomii sprzedawcy. |
| Pobieranie właściwości listy |
Zwraca listę właściwości listy. |
| Pobieranie właściwości listy (beta) |
Pobiera właściwość listy. Programowanie dla tego punktu końcowego jest w toku. Zostanie zwrócona tylko odpowiedź 501. |
| Pobieranie właściwości produktu według identyfikatora taksonomii |
Pobiera listę właściwości produktu z odpowiednimi skalami i wartościami obsługiwanymi dla określonego identyfikatora taksonomii sprzedawcy. |
| Pobierz sekcję sklepu |
Pobiera sekcję sklepu, do których odwołuje się identyfikator sekcji i identyfikator sklepu. |
| Przekazywanie obrazu listy |
Przekazuje lub przypisuje obraz do listy zidentyfikowanej przez identyfikator sklepu z identyfikatorem listy. Aby przekazać nowy obraz, ustaw plik obrazu jako wartość parametru obrazu. Wcześniej usunięty obraz można przypisać do listy przy użyciu identyfikatora obrazu usuniętego w parametrze identyfikatora obrazu listy. Gdy żądanie zawiera zarówno wartości parametrów obrazu, jak i identyfikator obrazu, punkt końcowy przekazuje obraz tylko w parametrze obrazu. |
| Przekazywanie pliku listy |
Przekazuje nowy plik do listy cyfrowej lub kojarzy istniejący plik z określoną listą. Musisz podać identyfikator pliku listy istniejącego pliku lub nazwę i dane pliku binarnego, które mają zostać przekazane. Skojarzenie istniejącego pliku z listą fizyczną konwertuje listę fizyczną na listę cyfrową, co powoduje usunięcie wszystkich kosztów wysyłki oraz wszystkich odmian produktów i zapasów. |
| Tworzenie listy wersji roboczej |
Tworzy fizyczny projekt produktu w sklepie w kanale Etsy. |
| Tworzenie miejsca docelowego profilu wysyłki |
Tworzy nowe miejsce docelowe wysyłki, które ustawia koszt wysyłki, przewoźnik i klasę dla miejsca docelowego w profilu wysyłki. Powoduje to przypisanie kosztów przy użyciu waluty skojarzonego sklepu. Ustaw lokalizację docelową przy użyciu docelowego kraju ISO lub regionu docelowego; docelowy kraj ISO i region docelowy wzajemnie się wykluczają — ustaw jeden lub drugi. Ustawianie obu wyzwalaczy błąd 400. Jeśli żądanie nie ustawi żadnego docelowego kraju ISO ani regionu docelowego, domyślne miejsce docelowe jest wszędzie. Musisz również przypisać zarówno identyfikator przewoźnika wysyłkowego, jak i klasę poczty, albo zarówno minimalną liczbę dni dostawy, jak i maksymalną liczbę dni dostawy. |
| Tworzenie potwierdzenia wysyłki |
Przesyła informacje dotyczące śledzenia paragonu sklepowego, który tworzy wpis do wysyłki paragonu sklepu dla danego identyfikatora paragonu. Za każdym razem, gdy pomyślnie prześlesz informacje o śledzeniu, Etsy wysyła do kupującego wiadomość e-mail z powiadomieniem. Po wysłaniu BCC jest prawdziwe, Etsy wysyła również powiadomienia wysyłkowe do sprzedawcy. Gdy kod śledzenia i nazwa przewoźnika nie są wysyłane, potwierdzenie jest oznaczone jako wysłane. |
| Tworzenie profilu wysyłki |
Tworzy nowy profil wysyłki. Podczas tworzenia profilu wysyłkowego można przekazać kod ISO kraju lub region, ale nie oba te elementy. Wymagany jest tylko jeden. Musisz przekazać identyfikator przewoźnika wysyłkowego i klasę poczty albo minimalną i maksymalną liczbę dni dostawy. |
| Tworzenie sekcji sklepu |
Tworzy nową sekcję w określonym sklepie. |
| Tworzenie tłumaczenia listy |
Tworzy tłumaczenie listy, wyświetlając listę identyfikatorów i języków. |
| Tworzenie uaktualnienia profilu wysyłki |
Tworzy nowe uaktualnienie profilu wysyłki, które może ustanowić cenę za opcję wysyłki, taką jak alternatywny przewoźnik lub szybsze dostarczanie. |
| Usuwanie listy |
Ta akcja powoduje usunięcie oferty sklepu. Listę można usunąć tylko wtedy, gdy stan jest jednym z następujących: SOLD_OUT, WERSJA ROBOCZA, WYGASŁA, NIEAKTYWNA, AKTYWNA i is_available aktywna lub aktywna i ma flagi sprzedawcy: SUPRESSED (zamrożone), URLOP, CUSTOM_SHOPS (wzorzec), SELL_ON_FACEBOOK |
| Usuwanie miejsca docelowego profilu wysyłki |
Usuwa miejsce docelowe wysyłki i usuwa opcję docelową z każdej listy, która używa skojarzonego profilu wysyłki. Profil wysyłki wymaga co najmniej jednego miejsca docelowego wysyłki, więc ten punkt końcowy nie może usunąć końcowego miejsca docelowego wysyłki dla żadnego profilu wysyłki. Aby usunąć końcowe miejsce docelowe wysyłki z profilu wysyłki, musisz usunąć cały profil wysyłki. |
| Usuwanie obrazu listy |
Usuwa obraz listy. Kopia pliku pozostaje na naszych serwerach, więc usunięty obraz może zostać ponownie skojarzony z listą bez ponownego przekazania oryginalnego obrazu. |
| Usuwanie pliku z listy |
Po usunięciu końcowego pliku listy cyfrowej lista jest konwertowana na listę fizyczną. Odpowiedź na żądanie usunięcia zwraca listę pozostałych rekordów plików skojarzonych z daną listą. |
| Usuwanie profilu wysyłki |
Usuwa profil wysyłki według danego identyfikatora. |
| Usuwanie uaktualnienia profilu wysyłkowego |
Usuwa uaktualnienie profilu wysyłkowego i usuwa opcję uaktualnienia z każdej listy, która używa skojarzonego profilu wysyłkowego. |
| Usuwanie właściwości listy |
Usuwa właściwość z listy. |
| Uzyskiwanie adresu użytkownika |
Pobiera adres użytkownika. Programowanie dla tego punktu końcowego jest w toku. Zostanie zwrócona tylko odpowiedź 501. |
| Uzyskiwanie aktywnych ofert według sklepu |
Pobiera listę wszystkich aktywnych ofert na Etsy w określonym sklepie, podzielonych na strony według daty utworzenia listy. |
| Uzyskiwanie polecanych ofert według sklepu |
Pobiera oferty skojarzone ze sklepem, które są polecane. |
| Uzyskiwanie potwierdzenia |
Pobiera potwierdzenie, zidentyfikowane przez identyfikator paragonu, ze sklepu Etsy. |
| Uzyskiwanie recenzji |
Pobiera recenzje ze sklepu, biorąc pod uwagę jego identyfikator. |
| Uzyskiwanie sklepu według identyfikatora właściciela |
Pobiera sklep zidentyfikowany przez identyfikator użytkownika właściciela sklepu. |
| Uzyskiwanie transakcji w sklepie |
Pobiera listę transakcji skojarzonych ze sklepem. |
| Wyszukaj sklepy |
Zwraca listę sklepów o pasującej nazwie. |
Aktualizowanie listy
Aktualizuje listę, zidentyfikowaną przez identyfikator aukcji, dla określonego sklepu zidentyfikowanego przez identyfikator sklepu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator listy
|
listing_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Ilość
|
quantity | integer |
Dodatnia liczba produktów innych niż zero dostępnych do zakupu na liście. |
|
|
Title
|
title | string |
Ciąg tytułu listy. Prawidłowe ciągi tytułu zawierają tylko litery, cyfry, znaki interpunkcyjne, symbole matematyczne, znaki odstępu, ™ , © i ® . (regex: /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) Można używać tylko %, :, i + znaków po każdym z nich. |
|
|
Description
|
description | string |
Ciąg opisu produktu do sprzedaży na liście. |
|
|
Cena
|
price | float |
Dodatnia cena niezerowa produktu. (Sprzedane oferty produktów są prywatne) Uwaga: Cena jest minimalną możliwą ceną. |
|
|
Kto się zrobił
|
who_made | string |
Ciąg inidcated, kto zrobił produkt. Pomaga kupującym zlokalizować ofertę pod nagłówkiem Handmade. Wymaga "is_supply" i "when_made". |
|
|
Po utworzeniu
|
when_made | string |
Ciąg epoki, w której producent wykonał produkt na tej liście. Pomaga kupującym zlokalizować ofertę pod nagłówkiem Vintage. Wymaga "is_supply" i "who_made". |
|
|
Identyfikator taksonomii
|
taxonomy_id | integer |
Numeryczny identyfikator taksonomii listy. Sprzedawca zarządza listą identyfikatorów taksonomii dla swojego sklepu. |
|
|
Identyfikator profilu wysyłki
|
shipping_profile_id | integer |
Numeryczny identyfikator profilu wysyłki skojarzonego z listą. |
|
|
Materials
|
materials | string |
Tablica ciągów materiałowych do materiałów używanych w produkcie. Prawidłowe ciągi materiałów zawierają tylko litery, cyfry i znaki odstępu. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u) |
|
|
Identyfikator sekcji sklepu
|
shop_section_id | integer |
Numeryczny identyfikator sekcji sklepu dla tej oferty. |
|
|
Minimalna liczba operacji przetwarzania
|
processing_min | integer |
Minimalna liczba dni wymaganych do przetworzenia tej listy. |
|
|
Maksymalna liczba operacji przetwarzania
|
processing_max | integer |
Maksymalna liczba dni wymaganych do przetworzenia tej listy. |
|
|
Etykiety
|
tags | string |
Tablica ciągów tagów dla listy. Prawidłowe ciągi tagów zawierają tylko litery, cyfry, znaki odstępu, -, ', ™ , © i ® . (regex: /[^\p{L}\p{Nd}\p{Zs}-'™©®]/u) |
|
|
Recipient
|
recipient | string |
Ciąg wskazujący osobę, dla której ten produkt byłby odpowiednim prezentem. |
|
|
Okazja
|
occasion | string |
Ciąg wskazujący okazję, dla której ten produkt będzie odpowiedni prezent. |
|
|
Style
|
styles | string |
Tablica ciągów stylów dla tej listy, z których każdy jest ciągiem tekstowym o dowolnej formie, takim jak Formal, lub Steampunk. Lista może mieć maksymalnie dwa style. Prawidłowe ciągi stylów zawierają tylko litery, cyfry i znaki odstępu. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u) |
|
|
Waga elementu
|
item_weight | float |
Waga liczbowa produktu mierzona w jednostkach ustawionych w jednostce wagi produktu. |
|
|
Długość elementu
|
item_length | integer |
Długość liczbowa produktu mierzona w jednostkach ustawionych w jednostce wymiarów elementu. |
|
|
Szerokość elementu
|
item_width | float |
Szerokość liczbowa produktu mierzona w jednostkach ustawionych w jednostce wymiarów elementu. |
|
|
Wysokość elementu
|
item_height | float |
Wysokość liczbowa produktu mierzona w jednostkach ustawionych w jednostce wymiarów elementu. |
|
|
Jednostka wagi elementu
|
item_weight_unit | string |
Ciąg definiujący jednostki używane do mierzenia wagi produktu. |
|
|
Jednostka wymiarów elementu
|
item_dimensions_unit | string |
Ciąg definiujący jednostki używane do mierzenia wymiarów produktu. |
|
|
Jest personalizowalny
|
is_personalizable | boolean |
Jeśli to prawda, ta lista jest personalizowalna. |
|
|
Identyfikatory obrazów
|
image_ids | string |
Tablica identyfikatorów obrazów liczbowych obrazów na liście, która może zawierać maksymalnie 10 obrazów. |
|
|
Jest dostarczana
|
is_supply | boolean |
Jeśli wartość true, oznacza listę jako produkt dostarczający, a także wskazuje, że jest to gotowy produkt. Pomaga kupującym zlokalizować ofertę pod nagłówkiem Zapasy. Wymaga "kto się zrobił" i "kiedy został". |
|
|
Jest konfigurowalny
|
is_customizable | boolean |
Jeśli to prawda, kupujący może skontaktować się z sprzedawcą w celu uzyskania dostosowanego zamówienia. Wartość domyślna ma wartość true, gdy sklep akceptuje zamówienia niestandardowe. Nie dotyczy sklepów, które nie akceptują zamówień niestandardowych. |
|
|
Jest podlegający opodatkowaniu
|
is_taxable | boolean |
Jeśli to prawda, obowiązujące stawki podatkowe sklepu mają zastosowanie do tej oferty w momencie wyewidencjonowania. |
|
|
Polecana ranga
|
featured_ rank | integer |
Pozytywna pozycja niezerowa w polecanych aukcjach sklepu z 1 listami, które pojawiają się na lewej najbardziej pozycji w polecanej liście na stronie głównej sklepu. |
|
|
Powinna zostać odnowiona automatycznie
|
should_auto_renew | boolean |
Jeśli to prawda, odnawia listę przez cztery miesiące po ekskrylacji. Jeśli ustawiono wartość true, gdy poprzednio wartość false, etsy.com odnowić listę przed jej wygaśnięciem, ale okres odnowienia rozpoczyna się zamiast przedłużać datę wygaśnięcia listy. Utracony jest dowolny nieużywany czas pozostały na liście. Odnowienia powodują naliczanie opłat za rachunek użytkownika. |
|
|
Typ
|
type | string |
Wskazuje, czy lista ma wartość fizyczną, czy cyfrową. |
|
|
Kanały
|
channels | string |
Tablica wyliczonych ciągów identyfikatora kanału. Kanał to miejsce dla sprzedawców, aby dotrzeć do kupujących, aby dokonać sprzedaży. |
Zwraca
Aukcja ze sklepu, która zawiera ilość produktu, tytuł, opis, cenę itp.
- Lista sklepów
- ShopListing
Aktualizowanie miejsca docelowego profilu wysyłki
Aktualizuje istniejące miejsce docelowe wysyłki, które może ustawić lub ponownie przypisać koszt wysyłki, przewoźnik i klasę dla miejsca docelowego.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator profilu wysyłki
|
shipping_profile_id | True | string |
Numeryczny identyfikator profilu wysyłki skojarzonego z listą. |
|
Identyfikator docelowy profilu wysyłki
|
shipping_profile_destination_id | True | string |
Numeryczny identyfikator miejsca docelowego profilu wysyłki skojarzony z listą. |
|
primary_cost
|
primary_cost | string |
primary_cost |
|
|
secondary_cost
|
secondary_cost | string |
secondary_cost |
|
|
destination_country_iso
|
destination_country_iso | string |
destination_country_iso |
|
|
destination_region
|
destination_region | string |
destination_region |
|
|
shipping_carrier_id
|
shipping_carrier_id | integer |
shipping_carrier_id |
|
|
mail_class
|
mail_class | string |
mail_class |
|
|
min_delivery_days
|
min_delivery_days | integer |
min_delivery_days |
|
|
max_delivery_days
|
max_delivery_days | integer |
max_delivery_days |
Zwraca
Reprezentuje miejsce docelowe wysyłki przypisane do profilu wysyłki.
- ShopShippingProfileDestination
- ShopShippingProfileDestination
Aktualizowanie obrazów odmiany listy
Tworzy obrazy odmian na liście.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator listy
|
listing_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Obrazy odmian
|
variation_images | True | string |
Tablica danych obrazu odmiany. |
Zwraca
Reprezentuje kilka obrazów odmian.
- ListingVariationImages
- ListingVariationImages
Aktualizowanie profilu wysyłki
Zmienia ustawienia w profilu wysyłki.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator profilu wysyłki
|
shipping_profile_id | True | integer |
Numeryczny identyfikator profilu wysyłki skojarzonego z listą. |
|
Title
|
title | string |
Ciąg nazwy tego profilu wysyłkowego. |
|
|
Iso kraju pochodzenia
|
origin_country_iso | string |
Kod ISO kraju, z którego jest dostarczany wykaz. |
|
|
Minimalny czas przetwarzania
|
min_processing_time | integer |
Minimalny czas wymagany do przetworzenia list wysyłkowych z tym profilem wysyłki. |
|
|
Maksymalny czas przetwarzania
|
max_processing_time | integer |
Maksymalny czas przetwarzania listy musi być dostarczony. |
|
|
Jednostka czasu przetwarzania
|
processing_time_unit | string |
Jednostka używana do reprezentowania czasu przetwarzania. Tydzień jest odpowiednikiem 5 dni roboczych. Jeśli żadna z nich nie zostanie podana, jednostka zostanie ustawiona na business_days. |
|
|
Kod pocztowy źródła
|
origin_postal_code | string |
Ciąg kodu pocztowego (niekoniecznie liczba) dla lokalizacji, z której jest wysyłana lista. |
Zwraca
Reprezentuje profil używany do ustawiania informacji o wysyłki listy. Pamiętaj, że nie można utworzyć obliczonych szablonów wysyłki za pośrednictwem interfejsu API. Można jednak skojarzyć obliczone profile wysyłkowe utworzone z poziomu Menedżera sklepów z listami przy użyciu interfejsu API.
- ShopShippingProfile
- ShopShippingProfile
Aktualizowanie sklepu
Zaktualizuj sklep. Przyjęto założenie, że wszystkie parametry ciągu są podane w języku podstawowym sklepu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Title
|
title | string |
Krótki ciąg nagłówka strony głównej sklepu. |
|
|
Ogłoszenie
|
announcement | string |
Ciąg ogłoszenia dla kupujących, którzy są wyświetlane na stronie głównej sklepu. |
|
|
Wiadomość sprzedaży
|
sale_message | string |
Ciąg wiadomości wysłany do użytkowników, którzy ukończyli zakup w tym sklepie. |
|
|
Wiadomość sprzedaży cyfrowej
|
digital_sale_message | string |
Ciąg wiadomości wysyłany do użytkowników, którzy kupują przedmiot cyfrowy w tym sklepie. |
Zwraca
Sklep utworzony przez użytkownika Etsy.
- Sklep
- Shop
Aktualizowanie spisu listy
Aktualizuje spis listy zidentyfikowanej przez identyfikator listy. Aktualizacja nie powiedzie się, jeśli podane wartości jednostki SKU produktu, ilości i/lub ceny są niezgodne z wartościami w polach właściwości. Podczas ustawiania ceny przypisz zmiennoprzecinkowy równy wartości podzielonej przez dzielnik, jak określono w zasobie pieniężnym.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator listy
|
listing_id | True | string |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Products
|
products | True | string |
Tablica JSON produktów dostępnych na liście, nawet jeśli tylko jeden produkt. Wszystkie nazwy pól w obiektach blob JSON są małymi literami. |
|
Cena na właściwość
|
price_on_property | string |
Tablica unikatowych liczb całkowitych identyfikatora właściwości listy dla właściwości, które zmieniają ceny produktów, jeśli istnieją. Jeśli na przykład pobierasz określone ceny dla różnych produktów o różnych rozmiarach na tej samej liście, ta tablica zawiera identyfikator właściwości dla rozmiaru. |
|
|
Ilość we właściwości
|
quantity_on_property | string |
Tablica unikatowych liczb całkowitych identyfikatora właściwości listy dla właściwości, które zmieniają ilość produktów, jeśli istnieją. Jeśli na przykład zaopatrzysz określone ilości różnych kolorowych produktów na tej samej liście, ta tablica zawiera identyfikator właściwości koloru. |
|
|
Jednostka SKU we właściwości
|
sku_on_property | string |
Tablica unikatowych liczb całkowitych identyfikatora właściwości listy dla właściwości, które zmieniają jednostkę SKU produktu, jeśli istnieje. Jeśli na przykład używasz określonych jednostek SKU dla różnych produktów kolorowych na tej samej liście, ta tablica zawiera identyfikator właściwości dla koloru. |
Zwraca
Reprezentacja rekordu spisu pojedynczej listy.
- ListingInventory
- ListingInventory
Aktualizowanie tłumaczenia listy
Aktualizuje tłumaczenie listy, wyświetlając listę identyfikatorów i języka.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator listy
|
listing_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Język
|
language | True | string |
Tag języka IETF dla języka tego tłumaczenia. Ex: de, en, es, fr, it, ja, nl, pl, pt, ru. |
|
Title
|
title | True | string |
Tytuł listy tego tłumaczenia. |
|
Description
|
description | True | string |
Opis listy tego tłumaczenia. |
|
Etykiety
|
tags | string |
Tagi listy tego tłumaczenia. |
Zwraca
Reprezentuje dane tłumaczenia dla listy.
- ListingTranslation
- ListingTranslation
Aktualizowanie uaktualnienia profilu wysyłkowego
Aktualizuje uaktualnienie profilu wysyłki i aktualizuje wszystkie listy korzystające z profilu wysyłkowego.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator profilu wysyłki
|
shipping_profile_id | True | integer |
Numeryczny identyfikator profilu wysyłki skojarzonego z listą. |
|
Identyfikator uaktualnienia
|
upgrade_id | True | integer |
Identyfikator liczbowy skojarzony z uaktualnieniem wysyłki |
|
Typ
|
type | string |
Typ uaktualnienia wysyłki. Krajowy (0) lub międzynarodowy (1). |
|
|
Nazwa uaktualnienia
|
upgrade_name | string |
Nazwa uaktualnienia wysyłkowego wyświetlanego kupującym podczas zakupu, np. PRIORYTET USPS. |
|
|
Cena
|
price | float |
Dodatkowy koszt dodawania uaktualnienia wysyłki. |
|
|
Cena pomocnicza
|
secondary_price | float |
Dodatkowy koszt dodawania uaktualnienia wysyłki dla każdego dodatkowego elementu. |
|
|
Identyfikator przewoźnika wysyłkowego
|
shipping_carrier_id | integer |
Unikatowy identyfikator obsługiwanego przewoźnika wysyłkowego, który służy do obliczania szacowanej daty dostawy. |
|
|
Klasa poczty
|
mail_class | string |
Unikatowy ciąg identyfikatora klasy poczty przewoźnika wysyłkowego, który służy do obliczania szacowanej daty dostawy. |
|
|
Minimalna liczba dni dostawy
|
min_delivery_days | integer |
min_delivery_days |
|
|
Maksymalna liczba dni dostawy
|
max_delivery_days | integer |
Maksymalna liczba dni roboczych, przez które kupujący może oczekiwać, że otrzyma zakupiony przedmiot po wysłaniu. |
Zwraca
Reprezentacja opcji uaktualnienia profilu wysyłkowego.
- ShopShippingProfileUpgrade
- ShopShippingProfileUpgrade
Aktualizowanie właściwości listy
Aktualizuje lub wypełnia listę właściwości definiującą oferty produktów dla oferty. Każda oferta wymaga zarówno wartości, jak i identyfikatora wartości, które są prawidłowe dla identyfikatora skalowania przypisanego do listy lub przypisanego do listy z tym żądaniem.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator listy
|
listing_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Identyfikator właściwości
|
property_id | True | integer |
Unikatowy identyfikator właściwości listy Etsy. |
|
Identyfikatory wartości
|
value_ids | True | integer |
Identyfikator liczbowy pojedynczej skali pomiaru Etsy.com. |
|
Wartości
|
values | True | string |
Tablica ciągów wartości dla wielu wartości właściwości etsy. |
|
Identyfikator skalowania
|
scale_id | integer |
Identyfikator liczbowy pojedynczej skali pomiaru Etsy.com. |
Zwraca
Reprezentacja wartości danych strukturalnych.
- ListingPropertyValue
- ListingPropertyValue
Ping
Sprawdź, czy łączność z interfejsem API Etsy jest potwierdzana za pomocą aplikacji.
Zwraca
Potwierdzenie, że bieżąca aplikacja ma dostęp do interfejsu Open API
- Odór
- Pong
Pobieranie adresów użytkowników
Pobieranie listy adresów użytkowników.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Ograniczenie
|
limit | integer |
Maksymalna liczba wyników do zwrócenia. |
|
|
Przesunięcie
|
offset | integer |
Liczba rekordów do pominięcia przed wybraniem pierwszego wyniku. |
Zwraca
Reprezentuje kilka rekordów UserAddress.
- UserAddresses
- UserAddresses
Pobieranie aktywnych list
Lista wszystkich aktywnych list na stronie Etsy podzielonych na strony według daty utworzenia. Bez list kolejności sortowania będą domyślnie zwracane najnowsze listy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Ograniczenie
|
limit | integer |
Maksymalna liczba wyników do zwrócenia. |
|
|
Przesunięcie
|
offset | integer |
Liczba rekordów do pominięcia przed wybraniem pierwszego wyniku. |
|
|
Includes
|
keywords | string |
Wyszukiwany termin lub fraza, która musi być wyświetlana we wszystkich wynikach. |
|
|
Sortuj według
|
sort_on | string |
Wartość do sortowania wyników wyszukiwania list. UWAGA: sortowanie przy użyciu opcji wyszukiwania działa tylko w połączeniu z jedną z opcji wyszukiwania (słowa kluczowe, region itp.). |
|
|
Kolejność sortowania
|
sort_order | string |
Kolejność rosnąco(w górę) lub malejąco(w dół) w celu sortowania list według. UWAGA: sort_order działa tylko w połączeniu z jedną z opcji wyszukiwania (słowa kluczowe, region itp.). |
|
|
Cena minimalna
|
min_price | float |
Minimalna cena ofert, które mają być zwracane przez wynik wyszukiwania. |
|
|
Maksymalna cena
|
max_price | float |
Maksymalna cena ofert, które mają być zwracane przez wynik wyszukiwania. |
|
|
Identyfikator taksonomii
|
taxonomy_id | integer |
Numeryczny identyfikator taksonomii listy. Sprzedawca zarządza listą identyfikatorów taksonomii dla swojego sklepu. |
|
|
Lokalizacja sklepu
|
shop_location | string |
Filtruje według lokalizacji sklepu. Jeśli nie można przeanalizować lokalizacji, etsy odpowiada z powodu błędu. |
Zwraca
Zestaw zasobów listy sklepów.
- ShopListings
- ShopListings
Pobieranie list według identyfikatora
Umożliwia wykonywanie zapytań dotyczących wielu identyfikatorów list jednocześnie. Ogranicz maksymalnie 100 identyfikatorów na zapytanie.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Wyświetlanie listy identyfikatorów
|
listing_ids | True | string |
Tablica identyfikatorów liczbowych dla ofert w określonym sklepie Etsy. |
|
Includes
|
includes | string |
Wyliczony ciąg, który dołącza prawidłowe skojarzenie. |
Zwraca
Zestaw sklepów z listami zasobów ze stowarzyszeniami.
- ShopListingsWithAssociations
- ShopListingsWithAssociations
Pobieranie listy
Pobiera rekord listy według identyfikatora listy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator listy
|
listing_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Includes
|
includes | string |
Wyliczony ciąg, który dołącza prawidłowe skojarzenie. Dopuszczalne dane wejściowe to "shop", "images" i "user". |
Pobieranie listy płatności
Pobiera listę płatności ze sklepu zidentyfikowanego przez identyfikator sklepu. Wyniki można również filtrować przy użyciu listy identyfikatorów płatności.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator płatności
|
payment-ids | True | string |
Rozdzielona przecinkami tablica numerów identyfikatorów płatności. |
Zwraca
Reprezentuje kilka płatności dokonanych za pomocą systemu Etsy Payments. Wszystkie kwoty pieniężne są w groszach USD, chyba że określono inaczej.
- Payments
- Payments
Pobieranie miejsc docelowych profilu według profilu wysyłkowego
Pobiera listę obiektów docelowych wysyłki skojarzonych z profilem wysyłki.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator profilu wysyłki
|
shipping_profile_id | True | integer |
Numeryczny identyfikator profilu wysyłki skojarzonego z listą. |
|
Ograniczenie
|
limit | integer |
Maksymalna liczba wyników do zwrócenia. |
|
|
Przesunięcie
|
offset | integer |
Liczba rekordów do pominięcia przed wybraniem pierwszego wyniku. |
Zwraca
Reprezentuje listę obiektów docelowych wysyłki.
- ShopShippingProfileDestinations
- ShopShippingProfileDestinations
Pobieranie obrazu listy
Pobiera odwołania i metadane dla obrazu listy z określonym identyfikatorem obrazu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator listy
|
listing_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Wyświetlanie identyfikatora obrazu
|
listing_image_id | True | integer |
Identyfikator liczbowy podstawowego obrazu listy dla tej transakcji. |
Zwraca
Odwołania do adresów URL i metadanych obrazu skojarzonego z określoną listą. Parametr url_fullxfull zawiera adres URL pliku obrazu binarnego o pełnym rozmiarze.
- ListingImage
- ListingImage
Pobieranie obrazów listy
Pobiera wszystkie zasoby obrazów z listą z określonym identyfikatorem listy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator listy
|
listing_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
Zwraca
Reprezentuje listę zasobów obrazu, z których każdy zawiera adresy URL odwołania i metadane dla obrazu.
- ListingImages
- ListingImages
Pobieranie obrazów odmian listy
Pobiera wszystkie obrazy odmian na liście.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator listy
|
listing_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
Zwraca
Reprezentuje kilka obrazów odmian.
- ListingVariationImages
- ListingVariationImages
Pobieranie ofert według identyfikatora sekcji sklepu
Pobiera wszystkie oferty z sekcji określonego sklepu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikatory sekcji sklepu
|
shop_section_ids | True | string |
Tablica identyfikatorów liczbowych dla wszystkich sekcji w określonym sklepie Etsy. |
|
Ograniczenie
|
limit | integer |
Maksymalna liczba wyników do zwrócenia. |
|
|
Przesunięcie
|
offset | integer |
Liczba rekordów do pominięcia przed wybraniem pierwszego wyniku. |
|
|
Sortuj według
|
sort_on | string |
Wartość do sortowania wyników wyszukiwania list. |
|
|
Kolejność sortowania
|
sort_order | string |
Kolejność rosnąco(w górę) lub malejąco(w dół) w celu sortowania list według. |
Zwraca
Zestaw zasobów listy sklepów.
- ShopListings
- ShopListings
Pobieranie ofert według paragonu sklepowego
Pobiera wszystkie listy skojarzone z potwierdzeniem.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Identyfikator liczbowy potwierdzenia skojarzonego z tą transakcją. |
|
Identyfikator potwierdzenia
|
receipt_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Ograniczenie
|
limit | integer |
Maksymalna liczba wyników do zwrócenia. |
|
|
Przesunięcie
|
offset | integer |
Liczba rekordów do pominięcia przed wybraniem pierwszego wyniku. |
Zwraca
Zestaw zasobów listy sklepów.
- ShopListings
- ShopListings
Pobieranie ofert według sklepu
Zwraca listy należące do sklepu. Listy można filtrować przy użyciu parametru stanu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
State
|
State | string |
Wyliczony ciąg z dowolnego z: aktywny lub nieaktywny. |
|
|
Ograniczenie
|
limit | integer |
Maksymalna liczba wyników do zwrócenia. |
|
|
Przesunięcie
|
offset | integer |
Liczba rekordów do pominięcia przed wybraniem pierwszego wyniku. |
|
|
Sortuj według
|
Sort On | string |
Wartość do sortowania wyników wyszukiwania list. |
|
|
Kolejność sortowania
|
Sort Order | string |
Kolejność rosnąco(w górę) lub malejąco(w dół) w celu sortowania list według. |
Zwraca
Zestaw zasobów listy sklepów.
- ShopListings
- ShopListings
Pobieranie oferty oferty
Uzyskaj ofertę dla oferty.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator listy
|
listing_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Identyfikator produktu
|
product_id | True | integer |
Identyfikator liczbowy produktu skojarzonego z tą transakcją. |
|
Identyfikator oferty produktu
|
product_offering_id | True | integer |
Identyfikator liczbowy oferty produktu skojarzonej z tą transakcją. |
Zwraca
Reprezentacja oferty dla oferty.
- ListingInventoryProductOffering
- ListingInventoryProductOffering
Pobieranie pliku z listy
Pobiera pojedynczy plik skojarzony z daną listą cyfrową. Żądanie pliku z listy fizycznej zwraca pusty wynik.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator listy
|
listing_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Wyświetlanie identyfikatora pliku
|
listing_file_id | True | integer |
Unikatowy identyfikator liczbowy pliku skojarzonego z listą cyfrową. |
Zwraca
Plik skojarzony z listą cyfrową.
- ShopListingFile
- ShopListingFile
Pobieranie potwierdzeń
Żąda paragonów sklepu z określonego sklepu, niefiltrowanego lub filtrowanego według zakresu identyfikatora paragonu lub przesunięcia, daty, płatności i/lub wysłanych zakupów.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Minimalna liczba utworzonych
|
min_created | integer |
Najwcześniejsza sygnatura czasowa systemu unix dla momentu utworzenia rekordu. |
|
|
Maksymalna liczba utworzonych
|
max_created | integer |
Najnowszy znacznik czasu systemu unix dla momentu utworzenia rekordu. |
|
|
Najwcześniejsza ostatnia modyfikacja
|
min_last_modified | integer |
Najwcześniejsza sygnatura czasowa systemu unix dla czasu ostatniej zmiany rekordu. |
|
|
Ostatnia modyfikacja
|
max_last_modified | integer |
Najnowszy znacznik czasu systemu UNIX dla czasu ostatniej zmiany rekordu. |
|
|
Ograniczenie
|
limit | integer |
Maksymalna liczba wyników do zwrócenia. |
|
|
Przesunięcie
|
offset | integer |
Liczba rekordów do pominięcia przed wybraniem pierwszego wyniku. |
|
|
Została opłacona
|
was_paid | boolean |
Jeśli to prawda, sprzedawca otrzymał płatność za produkty w tym paragonie. |
|
|
Został wysłany
|
was_shipped | boolean |
Jeśli to prawda, sprzedawca wysłał produkty w tym paragonie. |
Zwraca
Paragony dla konkretnego sklepu.
- ShopReceipts
- ShopReceipts
Pobieranie produktu listy
Pobierz produkt listy według identyfikatora.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator listy
|
listing_id | True | integer |
Lista zwracająca produkt z listą. |
|
Identyfikator produktu
|
product_id | True | integer |
Identyfikator liczbowy określonego produktu zakupionego na liście. |
Zwraca
Reprezentacja produktu na potrzeby oferty.
- ListingInventoryProduct
- ListingInventoryProduct
Pobieranie profilu wysyłki
Pobiera profil wysyłki, do których odwołuje się identyfikator profilu wysyłki.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator profilu wysyłki
|
shipping_profile_id | True | integer |
Numeryczny identyfikator profilu wysyłki skojarzonego z listą. |
Pobieranie profilów wysyłki
Pobiera listę profilów wysyłkowych dostępnych w określonym sklepie Etsy zidentyfikowanym przez jego identyfikator sklepu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
Zwraca
Reprezentuje profil używany do ustawiania informacji o wysyłki listy. Pamiętaj, że nie można utworzyć obliczonych szablonów wysyłki za pośrednictwem interfejsu API. Można jednak skojarzyć obliczone profile wysyłkowe utworzone z poziomu Menedżera sklepów z listami przy użyciu interfejsu API.
- ShopShippingProfile
- ShopShippingProfile
Pobieranie przewoźników wysyłkowych
Pobiera listę dostępnych przewoźników wysyłkowych i klasy poczty skojarzone z nimi dla danego kraju.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Iso kraju pochodzenia
|
origin_country_iso | True | string |
Kod ISO kraju, z którego jest dostarczany wykaz. |
Zwraca
Reprezentuje kilka elementów ShippingCarriers.
- ShippingCarriers
- ShippingCarriers
Pobieranie płatności z identyfikatora wpisu rejestru płatności
Pobierz płatność z identyfikatora wpisu rejestru płatności, jeśli ma to zastosowanie.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikatory wpisu rejestru
|
ledger_entry_ids | True | string |
Tablica liczb całkowitych. |
Zwraca
Reprezentuje kilka płatności dokonanych za pomocą systemu Etsy Payments. Wszystkie kwoty pieniężne są w groszach USD, chyba że określono inaczej.
- Payments
- Payments
Pobieranie płatności z określonego paragonu
Pobiera płatność z określonego paragonu, zidentyfikowanego przez identyfikator paragonu, z określonego sklepu, zidentyfikowanego przez identyfikator sklepu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator potwierdzenia
|
receipt_id | True | string |
Identyfikator liczbowy potwierdzenia skojarzonego z tą transakcją. |
Zwraca
Reprezentuje kilka płatności dokonanych za pomocą systemu Etsy Payments. Wszystkie kwoty pieniężne są w groszach USD, chyba że określono inaczej.
- Payments
- Payments
Pobieranie sekcji sklepu
Pobiera listę sekcji sklepu w określonym sklepie zidentyfikowanym przez identyfikator sklepu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
Zwraca
Wszystkie sekcje w sprecific Shop.
- ShopSections
- ShopSections
Pobieranie spisu listy
Pobiera rekord spisu dla listy. Listy, które nie zostały edytowane przy użyciu narzędzi Etsy.com spisu, nie mają żadnych rekordów spisu. Ten punkt końcowy zwraca dane jednostki SKU, jeśli jesteś właścicielem pobieranych rekordów spisu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator listy
|
listing_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Includes
|
includes | string |
Wyliczony ciąg, który dołącza prawidłowe skojarzenie. |
Zwraca
Reprezentacja rekordu spisu pojedynczej listy ze skojarzeniami
- ListingInventoryWithAssociations
- ListingInventoryWithAssociations
Pobieranie transakcji
Pobiera transakcję według identyfikatora transakcji.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator transakcji
|
transaction_id | True | integer |
Unikatowy identyfikator liczbowy transakcji. |
Zwraca
Obiekt transakcji skojarzony z potwierdzeniem sklepu. Etsy generuje jedną transakcję na aukcję kupioną zgodnie z zapisem w potwierdzeniu zamówienia.
- ShopReceiptTransaction
- ShopReceiptTransaction
Pobieranie transakcji listy
Pobiera listę transakcji skojarzonych z listą.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator listy
|
listing_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Ograniczenie
|
limit | integer |
Maksymalna liczba wyników do zwrócenia. |
|
|
Przesunięcie
|
offset | integer |
Liczba rekordów do pominięcia przed wybraniem pierwszego wyniku. |
Zwraca
Zestaw zasobów transakcji paragonu sklepu
- ShopReceiptTransactions
- ShopReceiptTransactions
Pobieranie transakcji paragonu
Pobiera listę transakcji skojarzonych z określonym potwierdzeniem.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator potwierdzenia
|
receipt_id | True | integer |
Identyfikator liczbowy potwierdzenia skojarzonego z tą transakcją. |
Zwraca
Zestaw zasobów transakcji paragonu sklepu
- ShopReceiptTransactions
- ShopReceiptTransactions
Pobieranie tłumaczenia listy
Zwraca tłumaczenie listy w danym języku.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator listy
|
listing_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Język
|
language | True | string |
Tag języka IETF dla języka tego tłumaczenia. Ex: de, en, es, fr, it, ja, nl, pl, pt, ru. |
Zwraca
Reprezentuje dane tłumaczenia dla listy.
- ListingTranslation
- ListingTranslation
Pobieranie uaktualnień profilu wysyłkowego
Pobiera listę uaktualnień profilu wysyłkowego przypisanych do określonego profilu wysyłkowego.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator profilu wysyłki
|
shipping_profile_id | True | integer |
Numeryczny identyfikator profilu wysyłki skojarzonego z listą. |
Zwraca
Lista opcji uaktualnienia wysyłki.
- ShopShippingProfileUpgrades
- ShopShippingProfileUpgrades
Pobieranie użytkownika
Zwraca profil użytkownika zidentyfikowany przez identyfikator użytkownika.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator użytkownika
|
user_id | True | integer |
Unikatowy dodatni identyfikator liczbowy niezerowy dla użytkownika. |
Zwraca
Reprezentuje pojedynczego użytkownika witryny
- User
- User
Pobieranie wpisów rejestru konta płatności sklepu
Pobierz wpisy rejestru konta płatniczego sklepu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Minimalna liczba utworzonych
|
min_created | True | integer |
Najwcześniejsza sygnatura czasowa systemu unix dla momentu utworzenia rekordu. |
|
Maksymalna liczba utworzonych
|
max_created | True | integer |
Najnowszy znacznik czasu systemu unix dla momentu utworzenia rekordu. |
|
Ograniczenie
|
limit | integer |
Maksymalna liczba wyników do zwrócenia. |
|
|
Przesunięcie
|
offset | integer |
Liczba rekordów do pominięcia przed wybraniem pierwszego wyniku. |
Zwraca
Zestaw zasobów wejściowych rejestru kont płatniczych
- PaymentAccountLedgerEntries
- PaymentAccountLedgerEntries
Pobieranie wszystkich plików listy
Pobiera wszystkie pliki skojarzone z daną listą cyfrową. Żądanie plików z listy fizycznej zwraca pusty wynik.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Identyfikator listy
|
listing_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
Zwraca
Reprezentuje kilka plików ShopListingFiles.
- ShopListingFiles
- ShopListingFiles
Pobieranie węzłów taksonomii sprzedawcy
Pobiera pełne drzewo hierarchii węzłów taksonomii sprzedawcy.
Zwraca
Lista węzłów taksonomii z drzewa taksonomii sprzedawcy.
- SellerTaxonomyNodes
- SellerTaxonomyNodes
Pobieranie właściwości listy
Zwraca listę właściwości listy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator listy
|
listing_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
Zwraca
Reprezentuje kilka wartości właściwości listy.
- ListingPropertyValues
- ListingPropertyValues
Pobieranie właściwości listy (beta)
Pobiera właściwość listy. Programowanie dla tego punktu końcowego jest w toku. Zostanie zwrócona tylko odpowiedź 501.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator listy
|
listing_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Identyfikator właściwości
|
property_id | True | integer |
Unikatowy identyfikator właściwości listy Etsy. |
Zwraca
Reprezentacja wartości danych strukturalnych.
- ListingPropertyValue
- ListingPropertyValue
Pobieranie właściwości produktu według identyfikatora taksonomii
Pobiera listę właściwości produktu z odpowiednimi skalami i wartościami obsługiwanymi dla określonego identyfikatora taksonomii sprzedawcy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator taksonomii
|
taxonomy_id | True | string |
Unikatowy identyfikator liczbowy węzła taksonomii Etsy, który jest kategorią metadanych dla ofert zorganizowanych w drzewie hierarchii taksonomii sprzedawcy. |
Zwraca
Lista definicji właściwości produktu.
- TaksonomiaNodeWłaściwości
- TaxonomyNodeProperties
Pobierz sekcję sklepu
Pobiera sekcję sklepu, do których odwołuje się identyfikator sekcji i identyfikator sklepu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator sekcji sklepu
|
shop_section_id | True | integer |
Numeryczny identyfikator sekcji w określonym sklepie Etsy. |
Zwraca
Sekcja w sklepie, w której użytkownik może sortować oferty.
- ShopSection
- ShopSection
Przekazywanie obrazu listy
Przekazuje lub przypisuje obraz do listy zidentyfikowanej przez identyfikator sklepu z identyfikatorem listy. Aby przekazać nowy obraz, ustaw plik obrazu jako wartość parametru obrazu. Wcześniej usunięty obraz można przypisać do listy przy użyciu identyfikatora obrazu usuniętego w parametrze identyfikatora obrazu listy. Gdy żądanie zawiera zarówno wartości parametrów obrazu, jak i identyfikator obrazu, punkt końcowy przekazuje obraz tylko w parametrze obrazu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator listy
|
listing_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
obraz
|
image | string |
Ciąg nazwy pliku do przekazania. |
|
|
Wyświetlanie identyfikatora obrazu
|
listing_image_id | integer |
Identyfikator liczbowy podstawowego obrazu listy dla tej transakcji. |
|
|
Ranga
|
rank | integer |
Dodatnia pozycja liczbowa niezerowa na obrazach wyświetlanych na liście, z 1 obrazami wyświetlanymi w pozycji najwięcej po lewej stronie na liście. |
|
|
Zastąpić
|
overwrite | boolean |
Jeśli to prawda, to żądanie zastępuje istniejący obraz w danej rangi. |
|
|
Jest znak wodny
|
is_watermarked | boolean |
Gdy wartość true, wskazuje, że przekazany obraz ma znak wodny. |
Zwraca
Odwołania do adresów URL i metadanych obrazu skojarzonego z określoną listą. Parametr url_fullxfull zawiera adres URL pliku obrazu binarnego o pełnym rozmiarze.
- ListingImage
- ListingImage
Przekazywanie pliku listy
Przekazuje nowy plik do listy cyfrowej lub kojarzy istniejący plik z określoną listą. Musisz podać identyfikator pliku listy istniejącego pliku lub nazwę i dane pliku binarnego, które mają zostać przekazane. Skojarzenie istniejącego pliku z listą fizyczną konwertuje listę fizyczną na listę cyfrową, co powoduje usunięcie wszystkich kosztów wysyłki oraz wszystkich odmian produktów i zapasów.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator listy
|
listing_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Wyświetlanie identyfikatora pliku
|
listing_file_id | integer |
Unikatowy identyfikator liczbowy pliku skojarzonego z listą cyfrową. |
|
|
File
|
file | True | string |
Plik binarny do przekazania. |
|
Name
|
name | string |
Ciąg nazwy pliku do przekazania |
|
|
Ranga
|
rank | integer |
Dodatnia pozycja liczbowa niezerowa na obrazach wyświetlanych na liście, z 1 obrazami wyświetlanymi w pozycji najwięcej po lewej stronie na liście. |
Zwraca
Plik skojarzony z listą cyfrową.
- ShopListingFile
- ShopListingFile
Tworzenie listy wersji roboczej
Tworzy fizyczny projekt produktu w sklepie w kanale Etsy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Ilość
|
quantity | True | integer |
Dodatnia liczba produktów innych niż zero dostępnych do zakupu na liście. |
|
Title
|
title | True | string |
Ciąg tytułu listy. Prawidłowe ciągi tytułu zawierają tylko litery, cyfry, znaki interpunkcyjne, symbole matematyczne, znaki odstępu, ™ , © i ® . (regex: /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) Można używać tylko %, :, i + znaków po każdym z nich. |
|
Description
|
description | True | string |
Ciąg opisu produktu do sprzedaży na liście. |
|
Cena
|
price | True | float |
Dodatnia cena niezerowa produktu. (Sprzedane oferty produktów są prywatne) Uwaga: Cena jest minimalną możliwą ceną. |
|
Kto się zrobił
|
who_made | True | string |
Ciąg inidcated, kto zrobił produkt. Pomaga kupującym zlokalizować ofertę pod nagłówkiem Handmade. Wymaga "is_supply" i "when_made". |
|
Po utworzeniu
|
when_made | string |
Ciąg epoki, w której producent wykonał produkt na tej liście. Pomaga kupującym zlokalizować ofertę pod nagłówkiem Vintage. Wymaga "is_supply" i "who_made". |
|
|
Identyfikator taksonomii
|
taxonomy_id | True | integer |
Numeryczny identyfikator taksonomii listy. Sprzedawca zarządza listą identyfikatorów taksonomii dla swojego sklepu. |
|
Identyfikator profilu wysyłki
|
shipping_profile_id | True | integer |
Numeryczny identyfikator profilu wysyłki skojarzonego z listą. |
|
Materials
|
materials | string |
Tablica ciągów materiałowych do materiałów używanych w produkcie. Prawidłowe ciągi materiałów zawierają tylko litery, cyfry i znaki odstępu. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u) |
|
|
Identyfikator sekcji sklepu
|
shop_section_id | integer |
Numeryczny identyfikator sekcji sklepu dla tej oferty. |
|
|
Minimalna liczba operacji przetwarzania
|
processing_min | integer |
Minimalna liczba dni wymaganych do przetworzenia tej listy. |
|
|
Maksymalna liczba operacji przetwarzania
|
processing_max | integer |
Maksymalna liczba dni wymaganych do przetworzenia tej listy. |
|
|
Etykiety
|
tags | string |
Tablica ciągów tagów dla listy. Prawidłowe ciągi tagów zawierają tylko litery, cyfry, znaki odstępu, -, ', ™ , © i ® . (regex: /[^\p{L}\p{Nd}\p{Zs}-'™©®]/u) |
|
|
Recipient
|
recipient | string |
Ciąg wskazujący osobę, dla której ten produkt byłby odpowiednim prezentem. |
|
|
Okazja
|
occasion | string |
Ciąg wskazujący okazję, dla której ten produkt będzie odpowiedni prezent. |
|
|
Style
|
styles | string |
Tablica ciągów stylów dla tej listy, z których każdy jest ciągiem tekstowym o dowolnej formie, takim jak Formal, lub Steampunk. Lista może mieć maksymalnie dwa style. Prawidłowe ciągi stylów zawierają tylko litery, cyfry i znaki odstępu. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u) |
|
|
Waga elementu
|
item_weight | float |
Waga liczbowa produktu mierzona w jednostkach ustawionych w jednostce wagi produktu. |
|
|
Długość elementu
|
item_length | integer |
Długość liczbowa produktu mierzona w jednostkach ustawionych w jednostce wymiarów elementu. |
|
|
Szerokość elementu
|
item_width | float |
Szerokość liczbowa produktu mierzona w jednostkach ustawionych w jednostce wymiarów elementu. |
|
|
Wysokość elementu
|
item_height | float |
Wysokość liczbowa produktu mierzona w jednostkach ustawionych w jednostce wymiarów elementu. |
|
|
Jednostka wagi elementu
|
item_weight_unit | string |
Ciąg definiujący jednostki używane do mierzenia wagi produktu. |
|
|
Jednostka wymiarów elementu
|
item_dimensions_unit | string |
Ciąg definiujący jednostki używane do mierzenia wymiarów produktu. |
|
|
Jest personalizowalny
|
is_personalizable | boolean |
Jeśli to prawda, ta lista jest personalizowalna. |
|
|
Identyfikatory obrazów
|
image_ids | string |
Tablica identyfikatorów obrazów liczbowych obrazów na liście, która może zawierać maksymalnie 10 obrazów. |
|
|
Jest dostarczana
|
is_supply | boolean |
Jeśli wartość true, oznacza listę jako produkt dostarczający, a także wskazuje, że jest to gotowy produkt. Pomaga kupującym zlokalizować ofertę pod nagłówkiem Zapasy. Wymaga "kto się zrobił" i "kiedy został". |
|
|
Jest konfigurowalny
|
is_customizable | boolean |
Jeśli to prawda, kupujący może skontaktować się z sprzedawcą w celu uzyskania dostosowanego zamówienia. Wartość domyślna ma wartość true, gdy sklep akceptuje zamówienia niestandardowe. Nie dotyczy sklepów, które nie akceptują zamówień niestandardowych. |
|
|
Jest podlegający opodatkowaniu
|
is_taxable | boolean |
Jeśli to prawda, obowiązujące stawki podatkowe sklepu mają zastosowanie do tej oferty w momencie wyewidencjonowania. |
Zwraca
Aukcja ze sklepu, która zawiera ilość produktu, tytuł, opis, cenę itp.
- Lista sklepów
- ShopListing
Tworzenie miejsca docelowego profilu wysyłki
Tworzy nowe miejsce docelowe wysyłki, które ustawia koszt wysyłki, przewoźnik i klasę dla miejsca docelowego w profilu wysyłki. Powoduje to przypisanie kosztów przy użyciu waluty skojarzonego sklepu. Ustaw lokalizację docelową przy użyciu docelowego kraju ISO lub regionu docelowego; docelowy kraj ISO i region docelowy wzajemnie się wykluczają — ustaw jeden lub drugi. Ustawianie obu wyzwalaczy błąd 400. Jeśli żądanie nie ustawi żadnego docelowego kraju ISO ani regionu docelowego, domyślne miejsce docelowe jest wszędzie. Musisz również przypisać zarówno identyfikator przewoźnika wysyłkowego, jak i klasę poczty, albo zarówno minimalną liczbę dni dostawy, jak i maksymalną liczbę dni dostawy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator profilu wysyłki
|
shipping_profile_id | True | integer |
Numeryczny identyfikator profilu wysyłki skojarzonego z listą. |
|
Koszt podstawowy
|
primary_cost | True | float |
Koszt wysyłki do tego kraju/regionu mierzony w domyślnej walucie sklepu. |
|
Koszt pomocniczy
|
secondary_cost | True | string |
Koszt wysyłki do tego kraju/regionu z innym elementem mierzonym w domyślnej walucie sklepu. |
|
destination_country_iso
|
destination_country_iso | string |
destination_country_iso |
|
|
destination_region
|
destination_region | string |
destination_region |
|
|
shipping_carrier_id
|
shipping_carrier_id | integer |
shipping_carrier_id |
|
|
mail_class
|
mail_class | string |
mail_class |
|
|
min_delivery_days
|
min_delivery_days | integer |
min_delivery_days |
|
|
max_delivery_days
|
max_delivery_days | integer |
max_delivery_days |
Zwraca
Reprezentuje miejsce docelowe wysyłki przypisane do profilu wysyłki.
- ShopShippingProfileDestination
- ShopShippingProfileDestination
Tworzenie potwierdzenia wysyłki
Przesyła informacje dotyczące śledzenia paragonu sklepowego, który tworzy wpis do wysyłki paragonu sklepu dla danego identyfikatora paragonu. Za każdym razem, gdy pomyślnie prześlesz informacje o śledzeniu, Etsy wysyła do kupującego wiadomość e-mail z powiadomieniem. Po wysłaniu BCC jest prawdziwe, Etsy wysyła również powiadomienia wysyłkowe do sprzedawcy. Gdy kod śledzenia i nazwa przewoźnika nie są wysyłane, potwierdzenie jest oznaczone jako wysłane.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator potwierdzenia
|
receipt_id | True | integer |
Potwierdzenie przesyłania śledzenia. |
|
Kod śledzenia
|
tracking_code | string |
Kod śledzenia tego potwierdzenia. |
|
|
Nazwa operatora
|
carrier_name | string |
Nazwa przewoźnika dla tego potwierdzenia. |
|
|
Wyślij protokół BCC
|
send_bcc | boolean |
Jeśli to prawda, powiadomienie o wysyłki zostanie również wysłane do sprzedawcy |
Zwraca
Zapis zakupu w sklepie. Paragony sklepowe wyświetlają wartości pieniężne przy użyciu waluty sklepu.
- ShopReceipt
- ShopReceipt
Tworzenie profilu wysyłki
Tworzy nowy profil wysyłki. Podczas tworzenia profilu wysyłkowego można przekazać kod ISO kraju lub region, ale nie oba te elementy. Wymagany jest tylko jeden. Musisz przekazać identyfikator przewoźnika wysyłkowego i klasę poczty albo minimalną i maksymalną liczbę dni dostawy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Title
|
title | True | string |
Ciąg nazwy tego profilu wysyłkowego. |
|
Iso kraju pochodzenia
|
origin_country_iso | True | string |
Kod ISO kraju, z którego jest dostarczany wykaz. |
|
Koszt podstawowy
|
primary_cost | True | float |
Koszt wysyłki do tego kraju/regionu mierzony w domyślnej walucie sklepu. |
|
Koszt pomocniczy
|
secondary_cost | True | float |
Koszt wysyłki do tego kraju/regionu z innym elementem mierzonym w domyślnej walucie sklepu. |
|
Minimalny czas przetwarzania
|
min_processing_time | True | integer |
Minimalny czas wymagany do przetworzenia list wysyłkowych z tym profilem wysyłki. |
|
Maksymalny czas przetwarzania
|
max_processing_time | True | integer |
Maksymalny czas przetwarzania listy musi być dostarczony. |
|
Jednostka czasu przetwarzania
|
processing_time_unit | string |
Jednostka używana do reprezentowania czasu przetwarzania. Tydzień jest odpowiednikiem 5 dni roboczych. |
|
|
Docelowy kraj ISO
|
destination_country_iso | string |
Kod ISO kraju, do którego jest wysyłana lista statków. Jeśli wartość null, żądanie ustawia lokalizację docelową na region docelowy. |
|
|
Region docelowy
|
destination_region | string |
Kod regionu, w którym lista jest dostarczana. Region reprezentuje zestaw krajów. Obsługiwane regiony to Unia Europejska i Unia Nieeuropejka (kraje w Europie, a nie w UE). Jeśli tak nie jest, żądanie ustawia lokalizację docelową na docelowy kraj ISO lub wszędzie, jeśli docelowy kraj ISO ma również wartość null. |
|
|
Kod pocztowy źródła
|
origin_postal_code | string |
Ciąg kodu pocztowego (niekoniecznie liczba) dla lokalizacji, z której jest wysyłana lista. |
|
|
Identyfikator przewoźnika wysyłkowego
|
shipping_carrier_id | integer |
Unikatowy identyfikator obsługiwanego przewoźnika wysyłkowego, który służy do obliczania szacowanej daty dostawy. |
|
|
Klasa poczty
|
mail_class | string |
Unikatowy ciąg identyfikatora klasy poczty przewoźnika wysyłkowego, który służy do obliczania szacowanej daty dostawy. |
|
|
Minimalna liczba dni dostawy
|
min_delivery_days | integer |
Minimalna liczba dni roboczych, przez które kupujący może oczekiwać, że otrzyma zakupiony przedmiot po wysłaniu. |
|
|
Maksymalna liczba dni dostawy
|
max_delivery_days | integer |
Maksymalna liczba dni roboczych, przez które kupujący może oczekiwać, że otrzyma zakupiony przedmiot po wysłaniu. |
Zwraca
Reprezentuje profil używany do ustawiania informacji o wysyłki listy. Pamiętaj, że nie można utworzyć obliczonych szablonów wysyłki za pośrednictwem interfejsu API. Można jednak skojarzyć obliczone profile wysyłkowe utworzone z poziomu Menedżera sklepów z listami przy użyciu interfejsu API.
- ShopShippingProfile
- ShopShippingProfile
Tworzenie sekcji sklepu
Tworzy nową sekcję w określonym sklepie.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Title
|
title | True | string |
Ciąg tytułu sekcji sklepu. |
Zwraca
Sekcja w sklepie, w której użytkownik może sortować oferty.
- ShopSection
- ShopSection
Tworzenie tłumaczenia listy
Tworzy tłumaczenie listy, wyświetlając listę identyfikatorów i języków.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator listy
|
listing_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Język
|
language | True | string |
Tag języka IETF dla języka tego tłumaczenia. Ex: de, en, es, fr, it, ja, nl, pl, pt, ru. |
|
Title
|
title | True | string |
Tytuł listy tego tłumaczenia. |
|
Description
|
description | True | string |
Opis listy tego tłumaczenia. |
|
Etykiety
|
tags | string |
Tagi listy tego tłumaczenia. |
Zwraca
Reprezentuje dane tłumaczenia dla listy.
- ListingTranslation
- ListingTranslation
Tworzenie uaktualnienia profilu wysyłki
Tworzy nowe uaktualnienie profilu wysyłki, które może ustanowić cenę za opcję wysyłki, taką jak alternatywny przewoźnik lub szybsze dostarczanie.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator profilu wysyłki
|
shipping_profile_id | True | integer |
Numeryczny identyfikator profilu wysyłki skojarzonego z listą. |
|
Typ
|
type | True | string |
Typ uaktualnienia wysyłki. Krajowy (0) lub międzynarodowy (1). |
|
Nazwa uaktualnienia
|
upgrade_name | True | string |
Nazwa uaktualnienia wysyłkowego wyświetlanego kupującym podczas zakupu, np. PRIORYTET USPS. |
|
Cena
|
price | True | float |
Dodatkowy koszt dodawania uaktualnienia wysyłki. |
|
Cena pomocnicza
|
secondary_price | True | float |
Dodatkowy koszt dodawania uaktualnienia wysyłki dla każdego dodatkowego elementu. |
|
Identyfikator przewoźnika wysyłkowego
|
shipping_carrier_id | integer |
Unikatowy identyfikator obsługiwanego przewoźnika wysyłkowego, który służy do obliczania szacowanej daty dostawy. |
|
|
Klasa poczty
|
mail_class | string |
Unikatowy ciąg identyfikatora klasy poczty przewoźnika wysyłkowego, który służy do obliczania szacowanej daty dostawy. |
|
|
Minimalna liczba dni dostawy
|
min_delivery_days | integer |
min_delivery_days |
|
|
Maksymalna liczba dni dostawy
|
max_delivery_days | integer |
Maksymalna liczba dni roboczych, przez które kupujący może oczekiwać, że otrzyma zakupiony przedmiot po wysłaniu. |
Zwraca
Reprezentacja opcji uaktualnienia profilu wysyłkowego.
- ShopShippingProfileUpgrade
- ShopShippingProfileUpgrade
Usuwanie listy
Ta akcja powoduje usunięcie oferty sklepu. Listę można usunąć tylko wtedy, gdy stan jest jednym z następujących: SOLD_OUT, WERSJA ROBOCZA, WYGASŁA, NIEAKTYWNA, AKTYWNA i is_available aktywna lub aktywna i ma flagi sprzedawcy: SUPRESSED (zamrożone), URLOP, CUSTOM_SHOPS (wzorzec), SELL_ON_FACEBOOK
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator listy
|
listing_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
Usuwanie miejsca docelowego profilu wysyłki
Usuwa miejsce docelowe wysyłki i usuwa opcję docelową z każdej listy, która używa skojarzonego profilu wysyłki. Profil wysyłki wymaga co najmniej jednego miejsca docelowego wysyłki, więc ten punkt końcowy nie może usunąć końcowego miejsca docelowego wysyłki dla żadnego profilu wysyłki. Aby usunąć końcowe miejsce docelowe wysyłki z profilu wysyłki, musisz usunąć cały profil wysyłki.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator profilu wysyłki
|
shipping_profile_id | True | integer |
Numeryczny identyfikator profilu wysyłki skojarzonego z listą. |
|
Identyfikator docelowy profilu wysyłki
|
shipping_profile_destination_id | True | integer |
Numeryczny identyfikator miejsca docelowego profilu wysyłki w profilu wysyłki skojarzonym z listą. |
Usuwanie obrazu listy
Usuwa obraz listy. Kopia pliku pozostaje na naszych serwerach, więc usunięty obraz może zostać ponownie skojarzony z listą bez ponownego przekazania oryginalnego obrazu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator listy
|
listing_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Wyświetlanie identyfikatora obrazu
|
listing_image_id | True | integer |
Identyfikator liczbowy podstawowego obrazu listy dla tej transakcji. |
Usuwanie pliku z listy
Po usunięciu końcowego pliku listy cyfrowej lista jest konwertowana na listę fizyczną. Odpowiedź na żądanie usunięcia zwraca listę pozostałych rekordów plików skojarzonych z daną listą.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator listy
|
listing_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Wyświetlanie identyfikatora pliku
|
listing_file_id | True | integer |
Unikatowy identyfikator liczbowy pliku skojarzonego z listą cyfrową. |
Usuwanie profilu wysyłki
Usuwa profil wysyłki według danego identyfikatora.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator profilu wysyłki
|
shipping_profile_id | True | integer |
Numeryczny identyfikator profilu wysyłki skojarzonego z listą. |
Zwraca
Reprezentuje profil używany do ustawiania informacji o wysyłki listy. Pamiętaj, że nie można utworzyć obliczonych szablonów wysyłki za pośrednictwem interfejsu API. Można jednak skojarzyć obliczone profile wysyłkowe utworzone z poziomu Menedżera sklepów z listami przy użyciu interfejsu API.
- ShopShippingProfile
- ShopShippingProfile
Usuwanie uaktualnienia profilu wysyłkowego
Usuwa uaktualnienie profilu wysyłkowego i usuwa opcję uaktualnienia z każdej listy, która używa skojarzonego profilu wysyłkowego.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator profilu wysyłki
|
shipping_profile_id | True | integer |
Numeryczny identyfikator profilu wysyłki. |
|
Identyfikator uaktualnienia
|
upgrade_id | True | integer |
Identyfikator liczbowy skojarzony z uaktualnieniem wysyłki |
Usuwanie właściwości listy
Usuwa właściwość z listy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator listy
|
listing_id | True | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Identyfikator właściwości
|
property_id | True | integer |
Unikatowy identyfikator właściwości listy Etsy. |
Uzyskiwanie adresu użytkownika
Pobiera adres użytkownika. Programowanie dla tego punktu końcowego jest w toku. Zostanie zwrócona tylko odpowiedź 501.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator adresu użytkownika
|
user_address_id | True | integer |
Numeryczny identyfikator adresu użytkownika. |
Zwraca
Reprezentuje adres użytkownika.
- UserAddress
- UserAddress
Uzyskiwanie aktywnych ofert według sklepu
Pobiera listę wszystkich aktywnych ofert na Etsy w określonym sklepie, podzielonych na strony według daty utworzenia listy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Ograniczenie
|
limit | integer |
Maksymalna liczba wyników do zwrócenia. |
|
|
Przesunięcie
|
offset | integer |
Liczba rekordów do pominięcia przed wybraniem pierwszego wyniku. |
|
|
Includes
|
keywords | string |
Wyszukiwany termin lub fraza, która musi być wyświetlana we wszystkich wynikach. |
Zwraca
Zestaw zasobów listy sklepów.
- ShopListings
- ShopListings
Uzyskiwanie polecanych ofert według sklepu
Pobiera oferty skojarzone ze sklepem, które są polecane.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Ograniczenie
|
limit | integer |
Maksymalna liczba wyników do zwrócenia. |
|
|
Przesunięcie
|
offset | integer |
Liczba rekordów do pominięcia przed wybraniem pierwszego wyniku. |
Zwraca
Zestaw zasobów listy sklepów.
- ShopListings
- ShopListings
Uzyskiwanie potwierdzenia
Pobiera potwierdzenie, zidentyfikowane przez identyfikator paragonu, ze sklepu Etsy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator potwierdzenia
|
receipt_id | True | integer |
Identyfikator liczbowy potwierdzenia skojarzonego z tą transakcją. |
Zwraca
Zapis zakupu w sklepie. Paragony sklepowe wyświetlają wartości pieniężne przy użyciu waluty sklepu.
- ShopReceipt
- ShopReceipt
Uzyskiwanie recenzji
Pobiera recenzje ze sklepu, biorąc pod uwagę jego identyfikator.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Ograniczenie
|
limit | integer |
Maksymalna liczba wyników do zwrócenia. |
|
|
Przesunięcie
|
offset | integer |
Liczba rekordów do pominięcia przed wybraniem pierwszego wyniku. |
Zwraca
Zestaw rekordów przeglądu transakcji pozostawionych przez użytkowników.
- TransactionReviews
- TransactionReviews
Uzyskiwanie sklepu według identyfikatora właściciela
Pobiera sklep zidentyfikowany przez identyfikator użytkownika właściciela sklepu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator użytkownika
|
user_id | True | string |
Numeryczny identyfikator użytkownika, który jest właścicielem tego sklepu. |
Zwraca
Sklep utworzony przez użytkownika Etsy.
- Sklep
- Shop
Uzyskiwanie transakcji w sklepie
Pobiera listę transakcji skojarzonych ze sklepem.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | True | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Ograniczenie
|
limit | integer |
Maksymalna liczba wyników do zwrócenia. |
|
|
Przesunięcie
|
offset | integer |
Liczba rekordów do pominięcia przed wybraniem pierwszego wyniku. |
Zwraca
Zestaw zasobów transakcji paragonu sklepu
- ShopReceiptTransactions
- ShopReceiptTransactions
Wyszukaj sklepy
Zwraca listę sklepów o pasującej nazwie.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa sklepu
|
shop_name | True | string |
Ciąg nazwy sklepu. |
|
Ograniczenie
|
limit | integer |
Maksymalna liczba wyników do zwrócenia. |
|
|
Przesunięcie
|
offset | integer |
Liczba rekordów do pominięcia przed wybraniem pierwszego wyniku. |
Zwraca
Zestaw rekordów sklepu.
- Sklepy
- Shops
Definicje
Lista sklepów
Aukcja ze sklepu, która zawiera ilość produktu, tytuł, opis, cenę itp.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator listy
|
listing_id | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Identyfikator użytkownika
|
user_id | integer |
Identyfikator liczbowy użytkownika publikujący listę. |
|
Identyfikator sklepu
|
shop_id | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Title
|
title | string |
Ciąg tytułu listy. Prawidłowe ciągi tytułu zawierają tylko litery, cyfry, znaki interpunkcyjne, symbole matematyczne, znaki odstępu, ™ , © i ® . (regex: /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) Można używać tylko %, :, i + znaków po każdym z nich. |
|
Description
|
description | string |
Ciąg opisu produktu do sprzedaży na liście. |
|
State
|
state | State |
Wyliczony ciąg z dowolnego z: aktywny lub nieaktywny. Uwaga: ustawienie listy roboczej aktywnej spowoduje również opublikowanie listy na etsy.com. |
|
Sygnatura czasowa utworzenia
|
creation_timestamp | integer |
Czas tworzenia listy w sekundach epoki. |
|
Znacznik czasu zakończenia
|
ending_timestamp | integer |
Czas wygaśnięcia listy w sekundach epoki. |
|
Oryginalna sygnatura czasowa tworzenia
|
original_creation_timestamp | integer |
Czas tworzenia listy w sekundach epoki. |
|
Znacznik czasu ostatniej modyfikacji
|
last_modified_timestamp | integer |
Czas ostatniej aktualizacji listy w sekundach epoki. |
|
Znacznik czasu ostatniej zmiany stanu
|
state_timestamp | integer |
Data i godzina ostatniej zmiany stanu tej listy. |
|
Ilość
|
quantity | integer |
Dodatnia liczba produktów innych niż zero dostępnych do zakupu na liście. Uwaga: Ilość ofert jest sumą dostępnych ilości ofert. Możesz zażądać ilości poszczególnych ofert z zasobu ListingInventory przy użyciu punktu końcowego pobierania spisu. |
|
Identyfikator sekcji sklepu
|
shop_section_id | integer |
Numeryczny identyfikator sekcji w określonym sklepie Etsy. |
|
Polecana ranga
|
featured_rank | integer |
Pozytywna pozycja niezerowa w polecanych aukcjach sklepu, z 1 listami, które pojawiają się na lewej najbardziej pozycji w polecanej liście na stronie głównej sklepu. |
|
adres URL
|
url | string |
Pełny adres URL strony listy na Etsy. |
|
Liczba faworystów
|
num_favorers | integer |
Liczba użytkowników, którzy oznaczyli tę listę jako ulubioną. |
|
Niepodpodatkowane
|
non_taxable | boolean |
Jeśli to prawda, odpowiednie stawki podatkowe sklepu nie mają zastosowania do tej oferty podczas wyewidencjonowania. |
|
Jest konfigurowalny
|
is_customizable | boolean |
Jeśli to prawda, kupujący może skontaktować się z sprzedawcą w celu uzyskania dostosowanego zamówienia. Wartość domyślna ma wartość true, gdy sklep akceptuje zamówienia niestandardowe. Nie dotyczy sklepów, które nie akceptują zamówień niestandardowych. |
|
Jest peronalizowalny
|
is_personalizable | boolean |
Jeśli to prawda, ta lista jest personalizowalna. Wartość domyślna to null. |
|
Personalizacja jest wymagana
|
personalization_is_required | boolean |
Jeśli to prawda, ta lista wymaga personalizacji. Wartość domyślna to null. |
|
Maksymalna liczba znaków personalizacji
|
personalization_char_count_max | integer |
Jest to wartość całkowita reprezentująca maksymalną długość wiadomości personalizacji wprowadzonej przez kupującego. |
|
Instrukcje personalizacji
|
personalization_instructions | string |
Jeśli to prawda, ta lista wymaga personalizacji. Wartość domyślna to null. |
|
Typ listy
|
listing_type | boolean |
Wyliczony ciąg typu wskazujący, czy lista jest fizyczna, czy cyfrowa. |
|
Etykiety
|
tags | array of string |
Lista ciągów tagów dla listy. Prawidłowe ciągi tagów zawierają tylko litery, cyfry, znaki odstępu, -, ', ™ , © i ® . (regex: /[^\p{L}\p{Nd}\p{Zs}\-'™©®]/u) Wartość domyślna to null. |
|
Materials
|
materials | array of string |
Lista ciągów materiałowych do materiałów używanych w produkcie. Prawidłowe ciągi materiałów zawierają tylko litery, cyfry i znaki odstępu. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u) Wartość domyślna to null. |
|
Identyfikator profilu wysyłki
|
shipping_profile_id | integer |
Numeryczny identyfikator profilu wysyłki skojarzonego z listą. |
|
Minimalna liczba dni przetwarzania
|
processing_min | integer |
Minimalna liczba dni wymaganych do przetworzenia tej listy. Wartość domyślna to null. |
|
Maksymalna liczba dni przetwarzania
|
processing_max | integer |
Maksymalna liczba dni wymaganych do przetworzenia tej listy. Wartość domyślna to null. |
|
WhoMade
|
who_made | WhoMade |
Wyliczony ciąg inidcated, który utworzył produkt. Pomaga kupującym zlokalizować ofertę pod nagłówkiem Handmade. Wymaga "is_supply" i "when_made". |
|
Kiedy to robione
|
when_made | WhenMade |
Wyliczony ciąg dla epoki, w której producent wykonał produkt na tej liście. Pomaga kupującym zlokalizować ofertę pod nagłówkiem Vintage. Wymaga "is_supply" i "who_made". |
|
Produkt dostarczający
|
is_supply | boolean |
Jeśli wartość true, oznacza listę jako produkt dostarczający, a także wskazuje, że jest to gotowy produkt. Pomaga kupującym zlokalizować ofertę pod nagłówkiem Zapasy. Wymaga "who_made" i "when_made". |
|
Waga elementu
|
item_weight | double |
Waga liczbowa produktu mierzona w jednostkach ustawionych w jednostce wagi produktu. Wartość domyślna to null. W przypadku ustawienia wartość musi być większa niż 0. |
|
ItemWeightUnit
|
item_weight_unit | ItemWeightUnit |
Ciąg definiujący jednostki używane do mierzenia wagi produktu. Wartość domyślna to null. |
|
Długość elementu
|
item_length | double |
Długość liczbowa produktu mierzona w jednostkach ustawionych w jednostce wymiarów elementu. Wartość domyślna to null. W przypadku ustawienia wartość musi być większa niż 0. |
|
Szerokość elementu
|
item_width | double |
Szerokość liczbowa produktu mierzona w jednostkach ustawionych w jednostce wymiarów elementu. Wartość domyślna to null. W przypadku ustawienia wartość musi być większa niż 0. |
|
Wysokość elementu
|
item_height | double |
Długość liczbowa produktu mierzona w jednostkach ustawionych w jednostce wymiarów elementu. Wartość domyślna to null. W przypadku ustawienia wartość musi być większa niż 0. |
|
ItemDimensionsUnit
|
item_dimensions_unit | ItemDimensionsUnit |
Ciąg definiujący jednostki używane do mierzenia wymiarów produktu. Wartość domyślna to null. |
|
Jest prywatny
|
is_private | boolean |
Jeśli to prawda, jest to prywatna lista zamierzana dla konkretnego nabywcy i ukryta przed widokiem sklepu. |
|
Recipient
|
recipient | Recipient |
Wyliczony ciąg wskazujący osobę, dla której ten produkt byłby odpowiednim prezentem. Wartość domyślna to null. |
|
Okazja
|
occasion | Occasion |
Wyliczony ciąg wskazujący okazję, dla której ten produkt będzie odpowiedni prezent. Wartość domyślna to null. |
|
Styl
|
style | array of string |
Tablica ciągów stylów dla tej listy, z których każdy jest ciągiem tekstowym o dowolnej formie, takim jak Formal, lub Steampunk. Lista może mieć maksymalnie dwa style. Prawidłowe ciągi stylów zawierają tylko litery, cyfry i znaki odstępu. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u) Wartość domyślna to null. |
|
Dane pliku
|
file_data | string |
Ciąg opisujący pliki dołączone do listy cyfrowej. |
|
Ma odmiany
|
has_variations | boolean |
Jeśli to prawda, lista zawiera odmiany. |
|
Powinna zostać odnowiona automatycznie
|
should_auto_renew | boolean |
Jeśli to prawda, odnawia listę przez cztery miesiące po ekskrylacji. Jeśli ustawiono wartość true, gdy poprzednio wartość false, etsy.com odnowić listę przed jej wygaśnięciem, ale okres odnowienia rozpoczyna się zamiast przedłużać datę wygaśnięcia listy. Utracony jest dowolny nieużywany czas pozostały na liście. Odnowienia powodują naliczanie opłat za rachunek użytkownika. |
|
Język
|
language | string |
Tag języka IETF dla domyślnego języka listy. Na przykład: |
|
Pieniądze
|
price | Money |
Reprezentacja kwoty pieniędzy. |
|
Identyfikator taksonomii
|
taxonomy_id | integer |
Numeryczny identyfikator taksonomii listy. Sprzedawca zarządza listą identyfikatorów taksonomii dla swojego sklepu. Aby uzyskać więcej informacji, zobacz taksonomię sprzedawcy. |
Pieniądze
Reprezentacja kwoty pieniędzy.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Kwota
|
amount | integer |
Ilość reprezentowana przez te dane. |
|
Dzielnik
|
divisor | integer |
Dzielnika do renderowania kwoty. |
|
Kod waluty
|
currency_code | string |
Kod waluty ISO dla tych danych. |
ShopListingFile
Plik skojarzony z listą cyfrową.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Wyświetlanie identyfikatora pliku
|
listing_file_id | integer |
Unikatowy identyfikator liczbowy pliku skojarzonego z listą cyfrową. |
|
Identyfikator listy
|
listing_id | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Ranga
|
rank | integer |
Indeks liczbowy pozycji kolejności wyświetlania tego pliku na liście, zaczynając od 1. |
|
Filename
|
filename | string |
Ciąg nazwy pliku skojarzony z listą cyfrową. |
|
Rozmiar pliku
|
filesize | string |
Ciąg rozmiaru formatu czytelnego dla człowieka dla rozmiaru pliku. |
|
Rozmiar w bajtach
|
size_bytes | integer |
Liczba wskazująca rozmiar pliku mierzony w bajtach. |
|
Typ pliku
|
filetype | string |
Ciąg typu wskazujący typ MIME pliku. |
|
Tworzenie znacznika czasu
|
create_timestamp | integer |
Unikatowy znacznik czasu liczbowy pliku skojarzonego z listą cyfrową. |
ShopListingFiles
Reprezentuje kilka plików ShopListingFiles.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Liczba
|
count | integer |
Liczba zwracanych plików ShopListingFiles. |
|
Results
|
results | array of ShopListingFile |
Tablica zasobów ShopListingFile. |
ShopListings
Zestaw zasobów listy sklepów.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Liczba
|
count | integer |
Liczba znalezionych zasobów w sklepie. |
|
Results
|
results | array of ShopListing |
Znaleziono zasoby w sklepie. |
User
Reprezentuje pojedynczego użytkownika witryny
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator użytkownika
|
user_id | integer |
Identyfikator liczbowy użytkownika. Ten numer jest również prawidłowym identyfikatorem sklepu dla sklepu użytkownika. |
|
Nazwa logowania
|
login_name | string |
Ciąg nazwy logowania użytkownika. |
|
Podstawowy adres e-mail
|
primary_email | string |
Ciąg adresu e-mail dla podstawowego adresu e-mail użytkownika. |
|
Imię
|
first_name | string |
Imię użytkownika. |
|
Nazwisko
|
last_name | string |
Nazwisko użytkownika. |
|
Utworzony znacznik czasu
|
create_timestamp | integer |
Data i godzina utworzenia konta przez użytkownika w sekundach epoki. |
|
Odwoływanych przez identyfikator użytkownika
|
referred_by_user_id | integer |
Numeryczny identyfikator użytkownika, który odniósł się do tego użytkownika. |
|
Korzystanie z nowych punktów końcowych spisu
|
use_new_inventory_endpoints | boolean |
Deprecated. Zawsze prawda. |
|
Jest sprzedawcą
|
is_seller | boolean |
Prawda, jeśli użytkownik jest sprzedawcą. |
|
Biografia
|
bio | string |
Biografia użytkownika. |
|
Gender
|
gender | string |
Płeć użytkownika. |
|
Miesiąc urodzenia
|
birth_month | string |
Miesiąc urodzenia użytkownika. |
|
Urodziny
|
birth_day | string |
Dzień urodzenia użytkownika. |
|
Kup liczbę transakcji
|
transaction_buy_count | integer |
Liczba transakcji, w których użytkownik kupił. |
|
Liczba sprzedanych transakcji
|
transaction_sold_count | integer |
Liczba transakcji, w których użytkownik sprzedał. |
Sklep
Sklep utworzony przez użytkownika Etsy.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator użytkownika
|
user_id | integer |
Numeryczny identyfikator użytkownika, który jest właścicielem tego sklepu. |
|
Nazwa sklepu
|
shop_name | string |
Ciąg nazwy sklepu. |
|
Data utworzenia
|
create_date | integer |
Data i godzina utworzenia tego sklepu w sekundach epoki. |
|
Title
|
title | string |
Krótki ciąg nagłówka strony głównej sklepu. |
|
Ogłoszenie
|
announcement | string |
Ciąg ogłoszenia dla kupujących, którzy są wyświetlane na stronie głównej sklepu. |
|
Kod waluty
|
currency_code | string |
Kod ISO (alfabetyczny) waluty sklepu. Sklep domyślnie wyświetla wszystkie ceny w tej walucie. |
|
Jest na wakacjach
|
is_vacation | boolean |
Jeśli to prawda, ten sklep nie akceptuje zakupów. |
|
Wiadomość urlopowa
|
vacation_message | string |
Ciąg komunikatu sklepu jest wyświetlany, gdy is_vacation ma wartość true. |
|
Wiadomość sprzedaży
|
sale_message | string |
Ciąg wiadomości wysłany do użytkowników, którzy ukończyli zakup w tym sklepie. |
|
Wiadomość sprzedaży cyfrowej
|
digital_sale_message | string |
Ciąg wiadomości wysyłany do użytkowników, którzy kupują przedmiot cyfrowy w tym sklepie. |
|
Data aktualizacji
|
update_date | integer |
Data i godzina ostatniej aktualizacji sklepu, w sekundach epoki. |
|
Liczba aktywnych list
|
listing_active_count | integer |
Liczba aktywnych ofert w sklepie. |
|
Liczba list cyfrowych
|
digital_listing_count | integer |
Liczba ofert cyfrowych w sklepie. |
|
Nazwa logowania
|
login_name | string |
Ciąg nazwy logowania właściciela sklepu. |
|
Akceptuje żądania niestandardowe
|
accepts_custom_requests | boolean |
Jeśli to prawda, sklep akceptuje żądania dostosowania. |
|
Zasady powitalne
|
policy_welcome | string |
Ciąg powitalny zasad sklepu (może być pusty). |
|
Zasady płatności
|
policy_payment | string |
Ciąg zasad płatności sklepu (może być pusty). |
|
Zasady wysyłki
|
policy_shipping | string |
Ciąg zasad wysyłki sklepu (może być pusty). |
|
Zasady zwrotu kosztów
|
policy_refunds | string |
Ciąg zasad zwrotu pieniędzy w sklepie (może być pusty). |
|
Dodatkowe zasady
|
policy_additional | string |
Dodatkowy ciąg zasad sklepu (może być pusty). |
|
Informacje o sprzedawcy
|
policy_seller_info | string |
Ciąg informacyjny sprzedawcy sklepu (może być pusty). |
|
Data aktualizacji zasad
|
policy_update_date | integer |
Data i godzina ostatniej aktualizacji zasad sklepu w sekundach. |
|
Ma zasady prywatnych paragonów
|
policy_has_private_receipt_info | boolean |
W przypadku wartości true paragony UE wyświetlają prywatne informacje. |
|
Ma zasady bez struktury
|
has_unstructured_policies | boolean |
W przypadku wartości true sklep wyświetla dodatkowe pola zasad bez struktury. |
|
Zasady zachowania poufności informacji
|
policy_privacy | string |
Ciąg polityki prywatności sklepu (może być pusty). |
|
Autoreply urlopów
|
vacation_autoreply | string |
Automatyczny ciąg odpowiedzi sklepu wyświetlany w nowych konwersacjach, gdy is_vacation jest prawdziwy. |
|
adres URL
|
url | string |
Ciąg adresu URL dla tego sklepu. |
|
Adres URL obrazu baneru
|
image_url_760x100 | string |
Ciąg adresu URL dla baneru tego sklepu. |
|
Liczba faworystów
|
num_favorers | integer |
Liczba użytkowników, którzy oznaczyli ten sklep jako ulubiony. |
|
Languages
|
languages | array of string |
Lista ciągów językowych dla języków zarejestrowanych w sklepie. |
|
Adres URL obrazu ikony
|
icon_url_fullxfull | string |
Ciąg adresu URL dla obrazu ikony tego sklepu. |
|
Używa zasad strukturalnych
|
is_using_structured_policies | boolean |
Jeśli to prawda, sklep zaakceptował zasady ustrukturyzowane. |
|
Ma dołączone zasady ustrukturyzowane
|
has_onboarded_structured_policies | boolean |
Jeśli to prawda, sklep zaakceptował lub odrzucił po wyświetleniu zasad strukturalnych dołączania. |
|
Dołącz łącze formularza sporu
|
include_dispute_form_link | boolean |
Jeśli to prawda, polityka tego sklepu zawiera link do formularza sporu online UE. |
|
Czy włączono bezpośrednie wyewidencjonowania
|
is_direct_checkout_onboarded | boolean |
Jeśli to prawda, sklep dołączył do Etsy Payments. |
|
Jest obliczana wysyłka kwalifikująca się
|
is_calculated_eligible | boolean |
Jeśli to prawda, sklep jestlegowalny dla obliczonych profilów wysyłki. (Dostępne tylko w Stanach Zjednoczonych i Kanadzie) |
|
Jest wyrażana zgodę na obietnicę nabywcy
|
is_opted_in_to_buyer_promise | boolean |
Jeśli to prawda, sklep zdecydował się na obietnicę nabywcy. |
|
Jest oparty na Stanach Zjednoczonych
|
is_shop_us_based | boolean |
Jeśli to prawda, sklep znajduje się w USA. |
|
Liczba transakcji sprzedaży
|
transaction_sold_count | integer |
Całkowita liczba transakcji sprzedaży dla tego sklepu |
|
Wysyłka z kraju ISO
|
shipping_from_country_iso | string |
Kraj iso sklep jest wysyłki z. |
|
Lokalizacja sklepu ISO
|
shop_location_country_iso | string |
Kraj iso, gdzie znajduje się sklep. |
|
Liczba recenzji
|
review_count | integer |
Liczba przeglądów ofert sklepów w ubiegłym roku. |
|
Przegląd średniej
|
review_average | double |
Średnia ocena oparta na recenzjach ofert w sklepie w ubiegłym roku. |
ListingImage
Odwołania do adresów URL i metadanych obrazu skojarzonego z określoną listą. Parametr url_fullxfull zawiera adres URL pliku obrazu binarnego o pełnym rozmiarze.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator listy
|
listing_id | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Wyświetlanie identyfikatora obrazu
|
listing_image_id | integer |
Identyfikator liczbowy podstawowego obrazu listy dla tej transakcji. |
|
Kod szesnastkowy
|
hex_code | string |
Ciąg webhex dla średniego koloru obrazu w notacji webhex. |
|
Czerwona wartość
|
red | integer |
Liczbowa czerwona wartość równa średniej wartości czerwonej obrazu z zakresu od 0 do 255 (kolor RGB). |
|
Zielona wartość
|
green | integer |
Liczbowa czerwona wartość równa średniej wartości czerwonej obrazu z zakresu od 0 do 255 (kolor RGB). |
|
Wartość niebieska
|
blue | integer |
Liczbowa czerwona wartość równa średniej wartości czerwonej obrazu z zakresu od 0 do 255 (kolor RGB). |
|
Wartość hue
|
hue | integer |
Odcień liczbowy jest równy średniemu odcieniu obrazu z zakresu od 0 do 360 (kolor HSV). |
|
Wartość nasycenia
|
saturation | integer |
Nasycenie liczbowe jest równe średniemu nasyceniu obrazu z zakresu od 0 do 100 (kolor HSV). |
|
Wartość jasności
|
brightness | integer |
Jasność liczbowa równa średniej jasności obrazu z zakresu od 0 do 100 (kolor HSV). |
|
Jest i biały
|
is_black_and_white | boolean |
Jeśli to prawda, obraz jest w kolorze czarnym i białym. |
|
Czas utworzenia
|
creation_tsz | integer |
Czas tworzenia obrazu listy w sekundach. |
|
Ranga
|
rank | integer |
Dodatnia pozycja liczbowa niezerowa na obrazach wyświetlanych na liście, z 1 obrazami wyświetlanymi w pozycji najwięcej po lewej stronie na liście. |
|
Adres URL obrazu 75x75
|
url_75x75 | string |
Ciąg adresu URL dla miniatury obrazu o rozmiarze 75x75 pikseli. |
|
Adres URL obrazu 170x135
|
url_170x135 | string |
Ciąg adresu URL dla miniatury obrazu o rozmiarze 170x135 pikseli. |
|
Adres URL obrazu 570xN
|
url_570xN | string |
Ciąg adresu URL miniatury obrazu, nie więcej niż 570 pikseli szerokości ze zmienną wysokością. |
|
Adres URL obrazu o pełnym rozmiarze
|
url_fullxfull | string |
Ciąg adresu URL dla obrazu o pełnym rozmiarze, do 3000 pikseli w każdym wymiarze. |
|
Wysokość obrazu o pełnym rozmiarze
|
full_height | integer |
Wysokość liczbowa mierzona w pikselach obrazu o pełnym rozmiarze, do których odwołuje się url_fullxfull. |
|
Szerokość obrazu o pełnym rozmiarze
|
full_width | integer |
Szerokość liczbowa mierzona w pikselach obrazu o pełnym rozmiarze, do których odwołuje się url_fullxfull. |
ListingImages
Reprezentuje listę zasobów obrazu, z których każdy zawiera adresy URL odwołania i metadane dla obrazu.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Liczba
|
count | integer |
Liczba wyników. |
|
Results
|
results | array of ListingImage |
Lista żądanych zasobów. |
ListingInventoryWithAssociations
Reprezentacja rekordu spisu pojedynczej listy ze skojarzeniami
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Products
|
products | array of ListingInventoryProduct |
Tablica JSON produktów dostępnych na liście, nawet jeśli tylko jeden produkt. Wszystkie nazwy pól w obiektach blob JSON są małymi literami. |
|
Cena we właściwościach
|
price_on_property | array of integer |
Tablica unikatowych liczb całkowitych identyfikatora właściwości listy dla właściwości, które zmieniają ceny produktów, jeśli istnieją. Jeśli na przykład pobierasz określone ceny dla różnych produktów o różnych rozmiarach na tej samej liście, ta tablica zawiera identyfikator właściwości dla rozmiaru. |
|
Ilość we właściwościach
|
quantity_on_property | array of integer |
Tablica unikatowych liczb całkowitych identyfikatora właściwości listy dla właściwości, które zmieniają ilość produktów, jeśli istnieją. Jeśli na przykład zaopatrzysz określone ilości różnych kolorowych produktów na tej samej liście, ta tablica zawiera identyfikator właściwości koloru. |
|
Jednostka SKU we właściwościach
|
sku_on_property | array of integer |
Tablica unikatowych liczb całkowitych identyfikatora właściwości listy dla właściwości, które zmieniają jednostkę SKU produktu, jeśli istnieje. Jeśli na przykład używasz określonych jednostek SKU dla różnych produktów kolorowych na tej samej liście, ta tablica zawiera identyfikator właściwości dla koloru. |
|
Lista sklepów
|
listing | ShopListing |
Aukcja ze sklepu, która zawiera ilość produktu, tytuł, opis, cenę itp. |
ListingInventoryProduct
Reprezentacja produktu na potrzeby oferty.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator produktu
|
product_id | integer |
Identyfikator liczbowy określonego produktu zakupionego na liście. |
|
SKU
|
sku | string |
Ciąg jednostki SKU produktu |
|
Jest usuwany
|
is_deleted | boolean |
Jeśli to prawda, ktoś usunął ten produkt. |
|
Offerings
|
offerings | array of ListingInventoryProductOffering |
Lista ofert produktów dla tego produktu. |
|
Wartości właściwości
|
property_values | array of ListingPropertyValue |
Lista wpisów wartości właściwości dla tego produktu. |
ListingInventoryProductOffering
Reprezentacja oferty dla oferty.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator oferty
|
offering_id | integer |
Identyfikator oferty produktu |
|
Ilość
|
quantity | integer |
Ilość oferowana przez produkt |
|
Jest włączona
|
is_enabled | boolean |
Niezależnie od tego, czy oferta może być pokazywana kupującym. |
|
Jest usuwany
|
is_deleted | boolean |
Czy oferta została usunięta. |
|
Pieniądze
|
price | Money |
Reprezentacja kwoty pieniędzy. |
ListingPropertyValue
Reprezentacja wartości danych strukturalnych.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator właściwości
|
property_id | integer |
Numeryczny identyfikator właściwości. |
|
Name
|
property_name | string |
Nazwa właściwości. |
|
Identyfikator skalowania
|
scale_id | integer |
Identyfikator liczbowy skali (jeśli istnieje). |
|
Nazwa skalowania
|
scale_name | string |
Etykieta używana do opisywania wybranej skali (jeśli istnieje). |
|
Identyfikatory wartości
|
value_ids | array of integer |
Identyfikatory liczbowe wartości właściwości |
|
Wartości
|
values | array of string |
Wartości właściwości |
ListingInventory
Reprezentacja rekordu spisu pojedynczej listy.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Products
|
products | array of ListingInventoryProduct |
Tablica JSON produktów dostępnych na liście, nawet jeśli tylko jeden produkt. Wszystkie nazwy pól w obiektach blob JSON są małymi literami. |
|
Cena we właściwościach
|
price_on_property | array of integer |
Tablica unikatowych liczb całkowitych identyfikatora właściwości listy dla właściwości, które zmieniają ceny produktów, jeśli istnieją. Jeśli na przykład pobierasz określone ceny dla różnych produktów o różnych rozmiarach na tej samej liście, ta tablica zawiera identyfikator właściwości dla rozmiaru. |
|
Ilość we właściwościach
|
quantity_on_property | array of integer |
Tablica unikatowych liczb całkowitych identyfikatora właściwości listy dla właściwości, które zmieniają ilość produktów, jeśli istnieją. Jeśli na przykład zaopatrzysz określone ilości różnych kolorowych produktów na tej samej liście, ta tablica zawiera identyfikator właściwości koloru. |
|
Jednostka SKU we właściwościach
|
sku_on_property | array of integer |
Tablica unikatowych liczb całkowitych identyfikatora właściwości listy dla właściwości, które zmieniają jednostkę SKU produktu, jeśli istnieje. Jeśli na przykład używasz określonych jednostek SKU dla różnych produktów kolorowych na tej samej liście, ta tablica zawiera identyfikator właściwości dla koloru. |
ShopListingsWithAssociations
Zestaw sklepów z listami zasobów ze stowarzyszeniami.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Liczba
|
count | integer |
Liczba znalezionych zasobów w sklepie. |
|
Results
|
results | array of ShopListing |
Znaleziono zasoby w sklepie. |
ListingPropertyValues
Reprezentuje kilka wartości właściwości listy.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Liczba
|
count | integer |
Liczba znalezionych zasobów w sklepie. |
|
Results
|
results | array of ListingPropertyValue |
Znaleziono zasoby w sklepie. |
ShopReceiptTransactions
Zestaw zasobów transakcji paragonu sklepu
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Liczba
|
count | integer |
Liczba znalezionych zasobów transakcji odbioru sklepu. |
|
Results
|
results | array of ShopReceiptTransaction |
Znaleziono zasoby transakcji paragonu sklepu. |
ShopReceiptTransaction
Obiekt transakcji skojarzony z potwierdzeniem sklepu. Etsy generuje jedną transakcję na aukcję kupioną zgodnie z zapisem w potwierdzeniu zamówienia.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator transakcji
|
transaction_id | integer |
Unikatowy identyfikator liczbowy transakcji. |
|
Title
|
title | string |
Ciąg tytułu listy zakupionej w tej transakcji. |
|
Description
|
description | string |
Ciąg opisu listy zakupionej w tej transakcji. |
|
Identyfikator użytkownika sprzedawcy
|
seller_user_id | integer |
Numeryczny identyfikator użytkownika sprzedawcy w tej transakcji. |
|
Identyfikator użytkownika kupującego
|
buyer_user_id | integer |
Numeryczny identyfikator użytkownika dla nabywcy w tej transakcji. |
|
Utworzony znacznik czasu
|
create_timestamp | integer |
Data i godzina utworzenia transakcji w sekundach epoki. |
|
Sygnatura czasowa płatna
|
paid_timestamp | integer |
Płatna data i godzina transakcji w sekundach. |
|
Sygnatura czasowa wysyłki
|
shipped_timestamp | integer |
Data i godzina wysyłki transakcji w sekundach epoki. |
|
Ilość
|
quantity | integer |
Liczba produktów zakupionych w tej transakcji. |
|
Wyświetlanie identyfikatora obrazu
|
listing_image_id | integer |
Identyfikator liczbowy podstawowego obrazu listy dla tej transakcji. |
|
Identyfikator potwierdzenia
|
receipt_id | integer |
Identyfikator liczbowy potwierdzenia skojarzonego z tą transakcją. |
|
Jest cyfrowy
|
is_digital | boolean |
W przypadku wartości true transakcja zarejestrowała zakup oferty cyfrowej. |
|
Dane pliku
|
file_data | string |
Ciąg opisujący pliki zakupione w tej transakcji. |
|
Identyfikator listy
|
listing_id | integer |
Identyfikator liczbowy listy skojarzonej z tą transakcją. |
|
Typ transakcji
|
transaction_type | string |
Ciąg typu transakcji, zwykle wyświetlając listę |
|
Identyfikator produktu
|
product_id | integer |
Identyfikator liczbowy określonego produktu zakupionego na liście. |
|
Pieniądze
|
price | Money |
Reprezentacja kwoty pieniędzy. |
|
Pieniądze
|
shipping_cost | Money |
Reprezentacja kwoty pieniędzy. |
ListingTranslation
Reprezentuje dane tłumaczenia dla listy.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator listy
|
listing_id | integer |
Identyfikator liczbowy listy. |
|
Język
|
language | string |
Tag języka IETF (np. "fr" dla języka tego tłumaczenia. |
|
Title
|
title | string |
Tytuł listy tego tłumaczenia. |
|
Description
|
description | string |
Opis listy tego tłumaczenia. |
|
Etykiety
|
tags | array of string |
Tagi listy tego tłumaczenia. |
ListingVariationImages
Reprezentuje kilka obrazów odmian.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Liczba
|
count | integer |
Liczba obrazów odmian. |
|
Results
|
results | array of ListingVariationImage |
Wyniki obrazów odmian. |
ListingVariationImage
Reprezentacja skojarzeń odmian i obrazów na liście.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator właściwości
|
property_id | integer |
Numeryczny identyfikator właściwości. |
|
Identyfikator wartości
|
value_id | integer |
Identyfikator liczbowy wartości. |
|
Identyfikator obrazu
|
image_id | integer |
Identyfikator liczbowy obrazu. |
PaymentAccountLedgerEntries
Zestaw zasobów wejściowych rejestru kont płatniczych
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Liczba
|
count | integer |
Znaleziono liczbę zasobów wpisu rejestru płatności. |
|
Results
|
results | array of PaymentAccountLedgerEntry |
Znaleziono zasoby wpisu rejestru płatności. |
PaymentAccountLedgerEntry
Reprezentuje wpis w rejestrze sklepu.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator wpisu
|
entry_id | integer |
Identyfikator liczbowy wpisu rejestru. |
|
Identyfikator rejestru
|
ledger_id | integer |
Identyfikator liczbowy rejestru. |
|
Numer sekwencji
|
sequence_number | integer |
Sekwencja umożliwia sortowanie wpisów rejestru chronologicznie. Im wyższa sekwencja, tym nowsza pozycja. |
|
Kwota
|
amount | integer |
Kwota pieniędzy wpłaconych do rejestru. |
|
Waluta
|
currency | string |
Waluta wpisu w rejestrze. |
|
Description
|
description | string |
Szczegółowe informacje na temat tego rodzaju wpisu rejestru: płatność, zwrot, odwrócenie nieudanego zwrotu, wypłata, zwrócone wypłaty, zwrot, zwrot, różne środki, różne debetowe lub płatność rachunku. |
|
Saldo
|
balance | integer |
Kwota pieniędzy w rejestrze sklepu chwilę po zastosowaniu tego wpisu. |
|
Data utworzenia
|
create_date | integer |
Data i godzina utworzenia wpisu rejestru w sekundach epoki. |
Payments
Reprezentuje kilka płatności dokonanych za pomocą systemu Etsy Payments. Wszystkie kwoty pieniężne są w groszach USD, chyba że określono inaczej.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Liczba
|
count | integer |
Liczba płatności w odpowiedzi. |
|
Results
|
results | array of Payment |
Lista płatności. |
Płatność
Reprezentuje płatność dokonaną za pomocą usługi Etsy Payment. Wszystkie kwoty pieniężne są w groszach USD, chyba że określono inaczej.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator płatności
|
payment_id | integer |
Unikatowy identyfikator liczbowy dla płatności do określonego sklepu Etsy. |
|
Identyfikator użytkownika kupującego
|
buyer_user_id | integer |
Identyfikator liczbowy użytkownika, który zapłacił zakup. |
|
Identyfikator sklepu
|
shop_id | integer |
Unikatowy dodatni niezerowy identyfikator liczbowy dla Sklepu Etsy. |
|
Identyfikator potwierdzenia
|
receipt_id | integer |
Identyfikator liczbowy potwierdzenia skojarzonego z tą transakcją. |
|
Pieniądze
|
amount_gross | Money |
Reprezentacja kwoty pieniędzy. |
|
Pieniądze
|
amount_fees | Money |
Reprezentacja kwoty pieniędzy. |
|
Pieniądze
|
amount_net | Money |
Reprezentacja kwoty pieniędzy. |
|
Pieniądze
|
posted_gross | Money |
Reprezentacja kwoty pieniędzy. |
|
Pieniądze
|
posted_fees | Money |
Reprezentacja kwoty pieniędzy. |
|
Pieniądze
|
posted_net | Money |
Reprezentacja kwoty pieniędzy. |
|
Pieniądze
|
adjusted_gross | Money |
Reprezentacja kwoty pieniędzy. |
|
Pieniądze
|
adjusted_fees | Money |
Reprezentacja kwoty pieniędzy. |
|
Pieniądze
|
adjusted_net | Money |
Reprezentacja kwoty pieniędzy. |
|
Waluta
|
currency | string |
Ciąg kodu ISO (alfabetyczny) dla waluty płatności. |
|
Waluta sklepu
|
shop_currency | string |
Kod ISO (alfabetyczny) waluty sklepu. Sklep domyślnie wyświetla wszystkie ceny w tej walucie. |
|
Waluta nabywcy
|
buyer_currency | string |
Ciąg waluty kupującego. |
|
Identyfikator wysyłki użytkownika
|
shipping_user_id | integer |
Numeryczny identyfikator użytkownika, do którego sprzedawca wysyła zamówienie. |
|
Identyfikator adresu wysyłki
|
shipping_address_id | integer |
Identyfikator liczbowy identyfikujący adres wysyłkowy. |
|
Identyfikator adresu rozliczeniowego
|
billing_address_id | integer |
Identyfikator liczbowy identyfikujący adres rozliczeniowy kupującego. |
|
Status
|
status | string |
Ciąg wskazujący bieżący stan płatności, najczęściej rozliczany lub uwierzytelniony. |
|
Sygnatura czasowa wysyłki
|
shipped_timestamp | integer |
Data i godzina wysyłki transakcji w sekundach epoki. |
|
Utworzony znacznik czasu
|
create_timestamp | integer |
Data i godzina utworzenia transakcji w sekundach epoki. |
|
Sygnatura czasowa aktualizacji
|
update_timestamp | integer |
Data i godzina ostatniej zmiany korekty płatności w sekundach epoki. |
|
Korekty płatności
|
payment_adjustments | array of PaymentAdjustment |
Lista obiektów zwrotu w transakcji Etsy Payments. Wszystkie kwoty pieniężne są w groszach USD, chyba że określono inaczej. |
PaymentAdjustment
Reprezentuje zwrot, który ma zastosowanie do wcześniejszej płatności Etsy. Wszystkie kwoty pieniężne są w groszach USD, chyba że określono inaczej.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator korekty płatności
|
payment_adjustment_id | integer |
Identyfikator liczbowy korekty płatności. |
|
Identyfikator płatności
|
payment_id | integer |
Unikatowy identyfikator liczbowy dla płatności do określonego sklepu Etsy. |
|
Status
|
status | string |
Ciąg stanu korekty płatności. |
|
Czy powodzenie
|
is_success | boolean |
Jeśli to prawda, korekta płatności była lub prawdopodobnie zakończy się pomyślnie. |
|
Identyfikator użytkownika
|
user_id | integer |
Identyfikator liczbowy użytkownika (sprzedawcy) spełniającego zakup. |
|
Kod przyczyny
|
reason_code | string |
Ciąg czytelny dla człowieka opisujący przyczynę zwrotu. |
|
Łączna kwota korekty
|
total_adjustment_amount | integer |
Łączna kwota zwrotu w walucie płatności. |
|
Łączna kwota korekty sklepu
|
shop_total_adjustment_amount | integer |
Liczbowa kwota zwrotu w walucie sklepu. |
|
Łączna kwota korekty
|
buyer_total_adjustment_amount | integer |
Liczbowa kwota zwrotu w walucie nabywcy. |
|
Łączna kwota korekty opłat
|
total_fee_adjustment_amount | integer |
Liczbowa kwota opłat za przetwarzanie kart związanych z korektą płatności. |
|
Utworzony znacznik czasu
|
create_timestamp | integer |
Data i godzina utworzenia transakcji w sekundach epoki. |
|
Sygnatura czasowa aktualizacji
|
update_timestamp | integer |
Data i godzina ostatniej zmiany korekty płatności w sekundach epoki. |
Odór
Potwierdzenie, że bieżąca aplikacja ma dostęp do interfejsu Open API
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator aplikacji
|
application_id | integer |
Identyfikator uwierzytelnionej aplikacji |
ShopReceipt
Zapis zakupu w sklepie. Paragony sklepowe wyświetlają wartości pieniężne przy użyciu waluty sklepu.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator potwierdzenia
|
receipt_id | integer |
Identyfikator liczbowy potwierdzenia skojarzonego z tą transakcją. |
|
Typ paragonu
|
receipt_type | integer |
Wartość liczbowa kanału Etsy, który obsługiwał zakup: 0 dla Etsy.com, 1 dla sklepu Pattern. |
|
Identyfikator użytkownika sprzedawcy
|
seller_user_id | integer |
Identyfikator liczbowy użytkownika (sprzedawcy) spełniającego zakup. |
|
Adres e-mail sprzedawcy
|
seller_email | string |
Ciąg adresu e-mail sprzedawcy oferty. |
|
Identyfikator użytkownika kupującego
|
buyer_user_id | integer |
Identyfikator liczbowy użytkownika dokonującego zakupu. |
|
Adres e-mail kupującego
|
buyer_email | string |
Ciąg adresu e-mail nabywcy oferty. |
|
Name
|
name | string |
Ciąg nazwy odbiorcy w adresie wysyłkowym. |
|
Pierwszy wiersz adresu
|
first_line | string |
Pierwszy ciąg wiersza adresu odbiorcy w adresie wysyłkowym. |
|
Drugi wiersz adresu
|
second_line | string |
Opcjonalny ciąg drugiego wiersza adresu odbiorcy w adresie wysyłkowym. |
|
Miejscowość
|
city | string |
Ciąg miasta odbiorcy w adresie wysyłkowym. |
|
State
|
state | string |
Ciąg stanu odbiorcy w adresie wysyłkowym. |
|
Kod pocztowy
|
zip | string |
Ciąg kodu pocztowego (niekoniecznie liczba) dla adresata w adresie wysyłkowym. |
|
Sformatowany adres
|
formatted_address | string |
Sformatowany ciąg adresu wysyłkowego odbiorcy w adresie wysyłkowym. |
|
Kod kraju ISO
|
country_iso | string |
Ciąg kodu kraju ISO-3166 alfa-2 odbiorcy w adresie wysyłkowym. |
|
Forma płatności
|
payment_method | string |
Ciąg formy płatności identyfikujący formę płatności nabywcy, które muszą być jednym z: "cc" (karta kredytowa), "PayPal", "check", "mo" (zamówienie pieniężne), "bt" (przelew bankowy), "other", "ideal", "sofort", "apple_pay", "google", "android_pay", "google_pay", "klarna", "k_pay_in_4" (klarna) lub "k_financing" (klarna). |
|
Adres e-mail płatności
|
payment_email | string |
Ciąg adresu e-mail dla adresu e-mail, do którego ma być wysyłane potwierdzenie płatności |
|
Wiadomość od sprzedawcy
|
message_from_seller | string |
Opcjonalny ciąg wiadomości od sprzedawcy. |
|
Wiadomość od Kupującego
|
message_from_buyer | string |
Opcjonalny ciąg wiadomości od kupującego. |
|
Komunikat z systemu płatności
|
message_from_payment | string |
Ciąg potwierdzenia wygenerowany przez maszynę z systemu płatności. |
|
Jest płatna
|
is_paid | boolean |
Jeśli to prawda, kupujący zapłacił za ten zakup. |
|
Jest dostarczany
|
is_shipped | boolean |
Jeśli to prawda, sprzedawca wysłał produkty. |
|
Utworzony znacznik czasu
|
create_timestamp | integer |
Czas utworzenia paragonu w sekundach epoki. |
|
Sygnatura czasowa aktualizacji
|
update_timestamp | integer |
Czas ostatniej aktualizacji paragonu w sekundach epoki. |
|
Wiadomość z prezentem
|
gift_message | string |
Ciąg komunikatu z prezentem, który kupujący zażąda dostarczenia z produktem. |
|
Pieniądze
|
grandtotal | Money |
Reprezentacja kwoty pieniędzy. |
|
Pieniądze
|
subtotal | Money |
Reprezentacja kwoty pieniędzy. |
|
Pieniądze
|
total_price | Money |
Reprezentacja kwoty pieniędzy. |
|
Pieniądze
|
total_shipping_cost | Money |
Reprezentacja kwoty pieniędzy. |
|
Pieniądze
|
total_tax_cost | Money |
Reprezentacja kwoty pieniędzy. |
|
Pieniądze
|
total_vat_cost | Money |
Reprezentacja kwoty pieniędzy. |
|
Pieniądze
|
discount_amt | Money |
Reprezentacja kwoty pieniędzy. |
|
Pieniądze
|
gift_wrap_price | Money |
Reprezentacja kwoty pieniędzy. |
|
Przesyłek
|
shipments | array of ShopReceiptShipment |
Lista oświadczeń wysyłki dla tego potwierdzenia. |
ShopReceiptShipment
Rekord jednego zdarzenia wysyłki dla ShopReceipt. Potwierdzenie może mieć wiele rekordów ShopReceiptShipment.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator wysyłki paragonu
|
receipt_shipping_id | integer |
Unikatowy identyfikator liczbowy rekordu Wysyłka paragonu sklepu. |
|
Sygnatura czasowa powiadomienia o wysyłki
|
shipment_notification_timestamp | integer |
Czas, w którym Etsy powiadomił nabywcę zdarzenia wysyłki w sekundach. |
|
Nazwa operatora
|
carrier_name | string |
Ciąg nazwy dla przewoźnika/firmy odpowiedzialnej za dostarczenie przesyłki. |
|
Kod śledzenia
|
tracking_code | string |
Ciąg kodu śledzenia dostarczony przez przewoźnika/firmę na potrzeby przesyłki. |
ShopReceipts
Paragony dla konkretnego sklepu.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Liczba
|
count | integer |
Liczba znalezionych paragonów w sklepie. |
|
Results
|
results | array of ShopReceipt |
Znaleziono listę znalezionych zasobów Potwierdzenia sklepu ze wszystkimi polami Paragony w sklepie dla każdego zasobu. |
TransactionReviews
Zestaw rekordów przeglądu transakcji pozostawionych przez użytkowników.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Liczba
|
count | integer |
Liczba znalezionych zasobów TransactionReview. |
|
Results
|
results | array of TransactionReview |
Znaleziono zasoby TransactionReview. |
TransactionReview
Rekord przeglądu transakcji pozostawiony przez użytkownika.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator sklepu
|
shop_id | integer |
Identyfikator liczbowy sklepu. |
|
Identyfikator listy
|
listing_id | integer |
Identyfikator oferty sklepu, do którego należy TransactionReview. |
|
Identyfikator użytkownika kupującego
|
buyer_user_id | integer |
Numeryczny identyfikator użytkownika, który był nabywcą w tej transakcji. Uwaga: to pole może być nieobecne w zależności od ustawień prywatności kupującego. |
|
Rating
|
rating | integer |
Wartość klasyfikacji na dużą skalę z zakresu od 1 do 5 |
|
Przejrzyj komunikat
|
review | string |
Komunikat pozostawiony przez autora, wyjaśniający opinię. |
|
Język
|
language | string |
Język elementu TransactionReview |
|
Adres URL obrazu fullsize
|
image_url_fullxfull | string |
Adres URL do zdjęcia dostarczonego z opinią, wymiary fullxfull. Uwaga: to pole może być nieobecne w zależności od ustawień prywatności kupującego. |
|
Utworzony znacznik czasu
|
create_timestamp | integer |
Data i godzina utworzenia elementu TransactionReview w sekundach epoki. |
|
Sygnatura czasowa aktualizacji
|
update_timestamp | integer |
Data i godzina aktualizacji TransactionReview w sekundach epoki. |
SellerTaxonomyNodes
Lista węzłów taksonomii z drzewa taksonomii sprzedawcy.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Liczba
|
count | integer |
Liczba wyników. |
|
Results
|
results | array of SellerTaxonomyNode |
Lista żądanych zasobów. |
SellerTaxonomyNode
Węzeł taksonomii w drzewie taksonomii sprzedawcy.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
identyfikator
|
id | integer |
Unikatowy identyfikator liczbowy węzła taksonomii Etsy, który jest kategorią metadanych dla ofert zorganizowanych w drzewie hierarchii taksonomii sprzedawcy. Na przykład węzeł taksonomii butów (identyfikator: 1429, poziom: 1) jest wyższy w hierarchii niż buty dziewcząt (identyfikator: 1440, poziom: 2). Węzły taksonomii przypisane do listy obsługują dostęp do określonych ustandaryzowanych skalowania i właściwości produktów. Na przykład listy przypisane węzły taksonomii buty lub buty dziewcząt obsługują dostęp do skali rozmiaru buta UE ze skojarzonymi nazwami właściwości i identyfikatorami dla rozmiarów butów UE, takich jak właściwość |
|
Level
|
level | integer |
Głębokość całkowita tego węzła taksonomii w drzewie taksonomii sprzedawcy z korzeniami na poziomie 0. |
|
Name
|
name | string |
Ciąg nazwy dla tego węzła taksonomii. |
|
Identyfikator nadrzędny
|
parent_id | integer |
Numeryczny identyfikator taksonomii elementu nadrzędnego tego węzła. |
|
Elementy podrzędne
|
children | array of SellerTaxonomyNode |
Tablica węzłów taksonomii dla wszystkich bezpośrednich elementów podrzędnych tego węzła taksonomii w drzewie taksonomii sprzedawcy. |
|
Identyfikatory ścieżek taksonomii
|
full_path_taxonomy_ids | array of integer |
Tablica identyfikatorów taksonomii, w tym tego węzła i wszystkich jego bezpośrednich elementów nadrzędnych w drzewie taksonomii sprzedawcy do węzła głównego. Są one wymienione w kolejności od korzenia do liścia. |
TaksonomiaNodeWłaściwości
Lista definicji właściwości produktu.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Liczba
|
count | integer |
Liczba wyników. |
|
Results
|
results | array of TaxonomyNodeProperty |
Lista żądanych zasobów. |
TaksonomiaNodeProperty
Definicja właściwości produktu.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator właściwości
|
property_id | integer |
Unikatowy identyfikator liczbowy tej właściwości produktu. |
|
Name
|
name | string |
Ciąg nazwy dla tego węzła taksonomii. |
|
Wyświetlana nazwa
|
display_name | string |
Ciąg nazwy właściwości produktu czytelny dla człowieka. |
|
Waga
|
scales | array of TaxonomyPropertyScale |
Lista dostępnych skalowania. |
|
Jest wymagane
|
is_required | boolean |
Jeśli to prawda, listy przypisanych kwalifikujących się identyfikatorów taksonomii wymagają tej właściwości. |
|
Obsługuje atrybuty
|
supports_attributes | boolean |
W przypadku wartości true można użyć tej właściwości w wyświetlaniu listy atrybutów. |
|
Obsługuje odmiany
|
supports_variations | boolean |
W przypadku wartości true można użyć tej właściwości w wyświetlaniu listy odmian. |
|
Jest wielowartościowy
|
is_multivalued | boolean |
W przypadku wartości true można przypisać wiele wartości właściwości do tej właściwości |
|
Możliwe wartości
|
possible_values | array of TaxonomyPropertyValue |
Lista obsługiwanych ciągów wartości właściwości dla tej właściwości. |
|
Wybrane wartości
|
selected_values | array of TaxonomyPropertyValue |
Lista ciągów wartości właściwości automatycznie i zawsze wybierana dla danej właściwości. |
TaksonomiaPropertyScale
Skala defnining możliwych do przypisania przyrostów dla wartości właściwości dostępnych dla określonych właściwości produktu.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator skalowania
|
scale_id | integer |
Unikatowy identyfikator liczbowy skali. |
|
Wyświetlana nazwa
|
display_name | string |
Ciąg nazwy dla skali. |
|
Description
|
description | string |
Ciąg opisu skali. |
TaksonomiaPropertyValue
Wartość właściwości dla określonej właściwości produktu, która może również stosować określoną skalę.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator wartości
|
value_id | integer |
Identyfikator liczbowy tej wartości właściwości. |
|
Name
|
name | string |
Ciąg nazwy tej wartości właściwości. |
|
Identyfikator skalowania
|
scale_id | integer |
Identyfikator skali liczbowej skali, do której należy ta wartość właściwości. |
|
Równe
|
equal_to | array of integer |
Lista identyfikatorów wartości właściwości liczbowej ta wartość właściwości jest równa (jeśli istnieje). |
ShippingCarriers
Reprezentuje kilka elementów ShippingCarriers.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
count
|
count | integer | |
|
results
|
results | array of ShippingCarrier |
ShippingCarrier
Obsługiwany przewoźnik wysyłkowy, który służy do obliczania szacowanej daty dostawy.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator przewoźnika wysyłkowego
|
shipping_carrier_id | integer |
Numeryczny identyfikator tego przewoźnika wysyłkowego. |
|
Name
|
name | string |
Nazwa tego przewoźnika wysyłkowego. |
|
Klasy krajowe
|
domestic_classes | array of ShippingCarrierMailClass |
Zestaw krajowych klas poczty tego przewoźnika wysyłkowego. |
|
Klasy międzynarodowe
|
international_classes | array of ShippingCarrierMailClass |
Zestaw międzynarodowych klas poczty tego przewoźnika wysyłkowego. |
ShippingCarrierMailClass
Klasa poczty przewoźnika wysyłkowego, która służy do obliczania szacowanej daty dostawy.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator klasy poczty
|
mail_class_key | string |
Unikatowy identyfikator tej klasy poczty. |
|
Name
|
name | string |
Nazwa tej klasy poczty. |
Sklepy
Zestaw rekordów sklepu.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Liczba
|
count | integer |
Całkowita liczba sklepów |
|
Results
|
results | array of Shop |
Zasoby sklepu. |
ShopSection
Sekcja w sklepie, w której użytkownik może sortować oferty.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator sekcji sklepu
|
shop_section_id | integer |
Numeryczny identyfikator sekcji w określonym sklepie Etsy. |
|
Title
|
title | string |
Ciąg tytułu sekcji sklepu. |
|
Ranga
|
rank | integer |
Dodatnie niezerowe położenie liczbowe tej sekcji w kolejności wyświetlania sekcji dla sklepu, z 1 sekcjami wyświetlanymi jako pierwsze. |
|
Identyfikator użytkownika
|
user_id | integer |
Identyfikator liczbowy użytkownika, który jest właścicielem tej sekcji sklepu. |
|
Liczba aktywnych list
|
active_listing_count | integer |
Liczba aktywnych ofert w jednej sekcji konkretnego sklepu Etsy. |
ShopSections
Wszystkie sekcje w sprecific Shop.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Liczba
|
count | integer |
Liczba wyników. |
|
Results
|
results | array of ShopSection |
Lista żądanych zasobów. |
ShopShippingProfile
Reprezentuje profil używany do ustawiania informacji o wysyłki listy. Pamiętaj, że nie można utworzyć obliczonych szablonów wysyłki za pośrednictwem interfejsu API. Można jednak skojarzyć obliczone profile wysyłkowe utworzone z poziomu Menedżera sklepów z listami przy użyciu interfejsu API.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator profilu wysyłki
|
shipping_profile_id | integer |
Numeryczny identyfikator profilu wysyłki. |
|
Title
|
title | string |
Ciąg nazwy tego profilu wysyłkowego. |
|
Identyfikator użytkownika
|
user_id | integer |
Identyfikator liczbowy użytkownika, który jest właścicielem profilu wysyłki. |
|
Minimalna liczba dni przetwarzania
|
min_processing_days | integer |
Minimalna liczba dni przetwarzania listy. |
|
Maksymalna liczba dni przetwarzania
|
max_processing_days | integer |
Maksymalna liczba dni przetwarzania listy. |
|
Etykieta dni przetwarzania
|
processing_days_display_label | string |
Przetłumaczony ciąg etykiety wyświetlania dla dni przetwarzania. |
|
Iso kraju pochodzenia
|
origin_country_iso | string |
Kod ISO kraju, z którego jest dostarczany wykaz. |
|
Jest usuwany
|
is_deleted | boolean |
Jeśli to prawda, ktoś usunął ten profil wysyłkowy. |
|
Miejsca docelowe profilu wysyłki
|
shipping_profile_destinations | array of ShopShippingProfileDestination |
Lista miejsc docelowych profilów wysyłkowych dostępnych dla tego profilu wysyłkowego. |
|
Uaktualnienia profilu wysyłkowego
|
shipping_profile_upgrades | array of ShopShippingProfileUpgrade |
Lista uaktualnień profilu wysyłkowego dostępnych dla tego profilu wysyłkowego. |
|
Kod pocztowy źródła
|
origin_postal_code | string |
Ciąg kodu pocztowego (niekoniecznie liczba) dla lokalizacji, z której jest wysyłana lista. |
|
Typ profilu
|
profile_type | ProfileType |
ShopShippingProfileDestination
Reprezentuje miejsce docelowe wysyłki przypisane do profilu wysyłki.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator docelowy profilu wysyłki
|
shipping_profile_destination_id | integer |
Numeryczny identyfikator miejsca docelowego profilu wysyłki w profilu wysyłki skojarzonym z listą. |
|
Identyfikator profilu wysyłki
|
shipping_profile_id | integer |
Numeryczny identyfikator profilu wysyłki. |
|
Iso kraju pochodzenia
|
origin_country_iso | string |
Kod ISO kraju, z którego jest dostarczany wykaz. |
|
Docelowy kraj ISO
|
destination_country_iso | string |
Kod ISO kraju, do którego jest wysyłana lista statków. Jeśli wartość null, żądanie ustawia lokalizację docelową na destination_region |
|
Region docelowy
|
destination_region | DestinationRegion |
Kod regionu, w którym lista jest dostarczana. Region reprezentuje zestaw krajów. Obsługiwane regiony to Unia Europejska i Unia Nieeuropejka (kraje w Europie, a nie w UE). Jeśli brak, żądanie ustawia lokalizację docelową na destination_country_iso lub wszędzie, jeśli destination_country_iso ma również wartość null |
|
Pieniądze
|
primary_cost | Money |
Reprezentacja kwoty pieniędzy. |
|
Pieniądze
|
secondary_cost | Money |
Reprezentacja kwoty pieniędzy. |
|
Identyfikator przewoźnika wysyłkowego
|
shipping_carrier_id | integer |
Unikatowy identyfikator obsługiwanego przewoźnika wysyłkowego, który służy do obliczania szacowanej daty dostawy. |
|
Klasa poczty
|
mail_class | string |
Unikatowy ciąg identyfikatora klasy poczty przewoźnika wysyłkowego, który służy do obliczania szacowanej daty dostawy. |
|
Minimalna liczba dni dostawy
|
min_delivery_days | integer |
Minimalna liczba dni roboczych, przez które kupujący może oczekiwać, że otrzyma zakupiony przedmiot po wysłaniu. |
|
Maksymalna liczba dni dostawy
|
max_delivery_days | integer |
Maksymalna liczba dni roboczych, przez które kupujący może oczekiwać, że otrzyma zakupiony przedmiot po wysłaniu. |
ShopShippingProfileUpgrade
Reprezentacja opcji uaktualnienia profilu wysyłkowego.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator profilu wysyłki
|
shipping_profile_id | integer |
Numeryczny identyfikator podstawowego profilu wysyłki. |
|
Identyfikator uaktualnienia
|
upgrade_id | integer |
Identyfikator liczbowy skojarzony z uaktualnieniem wysyłki |
|
Nazwa uaktualnienia
|
upgrade_name | string |
Nazwa uaktualnienia wysyłkowego wyświetlanego kupującym podczas zakupu, np. PRIORYTET USPS. |
|
Typ
|
type | Type |
Typ uaktualnienia wysyłki. Krajowy (0) lub międzynarodowy (1). |
|
Ranga
|
rank | integer |
Dodatnia pozycja liczbowa niezerowa na obrazach wyświetlanych na liście, z 1 obrazami wyświetlanymi w pozycji najwięcej po lewej stronie na liście. |
|
Język
|
language | string |
Tag języka IETF dla języka profilu wysyłki. Ex: de, en, es, fr, it, ja, nl, pl, pt, ru. |
|
Pieniądze
|
price | Money |
Reprezentacja kwoty pieniędzy. |
|
Pieniądze
|
secondary_price | Money |
Reprezentacja kwoty pieniędzy. |
|
Identyfikator przewoźnika wysyłkowego
|
shipping_carrier_id | integer |
Unikatowy identyfikator obsługiwanego przewoźnika wysyłkowego, który służy do obliczania szacowanej daty dostawy. |
|
Klasa poczty
|
mail_class | string |
Unikatowy ciąg identyfikatora klasy poczty przewoźnika wysyłkowego, który służy do obliczania szacowanej daty dostawy. |
|
Minimalna liczba dni dostawy
|
min_delivery_days | integer |
Minimalna liczba dni roboczych, przez które kupujący może oczekiwać, że otrzyma zakupiony przedmiot po wysłaniu. |
|
Maksymalna liczba dni dostawy
|
max_delivery_days | integer |
Maksymalna liczba dni roboczych, przez które kupujący może oczekiwać, że otrzyma zakupiony przedmiot po wysłaniu. |
ShopShippingProfileDestinations
Reprezentuje listę obiektów docelowych wysyłki.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Liczba
|
count | integer |
Liczba wyników. |
|
Results
|
results | array of ShopShippingProfileDestination |
Lista żądanych zasobów. |
ShopShippingProfileUpgrades
Lista opcji uaktualnienia wysyłki.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Liczba
|
count | integer |
Liczba wyników. |
|
Results
|
results | array of ShopShippingProfileUpgrade |
Lista żądanych zasobów. |
UserAddress
Reprezentuje adres użytkownika.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator adresu użytkownika
|
user_address_id | integer |
Numeryczny identyfikator adresu użytkownika. |
|
Identyfikator użytkownika
|
user_id | integer |
Identyfikator liczbowy użytkownika. |
|
Name
|
name | string |
Nazwa użytkownika dla tego adresu. |
|
Pierwszy wiersz adresu
|
first_line | string |
Pierwszy wiersz adresu użytkownika. |
|
Drugi wiersz adresu
|
second_line | string |
Drugi wiersz adresu użytkownika. |
|
Miejscowość
|
city | string |
Pole miasta adresu użytkownika. |
|
State
|
state | string |
Pole stanu adresu użytkownika. |
|
Kod pocztowy
|
zip | string |
Pole kodu pocztowego adresu użytkownika. |
|
Kod kraju ISO
|
iso_country_code | string |
Kod ISO kraju w tym adresie. |
|
Country
|
country_name | string |
Nazwa kraju użytkownika. |
|
Jest domyślnym adresem wysyłki
|
is_default_shipping_address | boolean |
Czy jest to domyślny adres wysyłkowy użytkownika. |
UserAddresses
Reprezentuje kilka rekordów UserAddress.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Liczba
|
count | integer |
Liczba zwracanych rekordów UserAddress. |
|
Results
|
results | array of UserAddress |
Tablica zasobów UserAddress. |
Region docelowy
Kod regionu, w którym lista jest dostarczana. Region reprezentuje zestaw krajów. Obsługiwane regiony to Unia Europejska i Unia Nieeuropejka (kraje w Europie, a nie w UE). Jeśli brak, żądanie ustawia lokalizację docelową na destination_country_iso lub wszędzie, jeśli destination_country_iso ma również wartość null
Kod regionu, w którym lista jest dostarczana. Region reprezentuje zestaw krajów. Obsługiwane regiony to Unia Europejska i Unia Nieeuropejka (kraje w Europie, a nie w UE). Jeśli brak, żądanie ustawia lokalizację docelową na destination_country_iso lub wszędzie, jeśli destination_country_iso ma również wartość null
- Region docelowy
- string
ItemDimensionsUnit
Ciąg definiujący jednostki używane do mierzenia wymiarów produktu. Wartość domyślna to null.
Ciąg definiujący jednostki używane do mierzenia wymiarów produktu. Wartość domyślna to null.
- ItemDimensionsUnit
- string
ItemWeightUnit
Ciąg definiujący jednostki używane do mierzenia wagi produktu. Wartość domyślna to null.
Ciąg definiujący jednostki używane do mierzenia wagi produktu. Wartość domyślna to null.
- ItemWeightUnit
- string
Okazja
Wyliczony ciąg wskazujący okazję, dla której ten produkt będzie odpowiedni prezent. Wartość domyślna to null.
Wyliczony ciąg wskazujący okazję, dla której ten produkt będzie odpowiedni prezent. Wartość domyślna to null.
- Okazja
- string
Typ profilu
- Typ profilu
- string
Recipient
Wyliczony ciąg wskazujący osobę, dla której ten produkt byłby odpowiednim prezentem. Wartość domyślna to null.
Wyliczony ciąg wskazujący osobę, dla której ten produkt byłby odpowiednim prezentem. Wartość domyślna to null.
- Recipient
- string
State
Wyliczony ciąg z dowolnego z: aktywny lub nieaktywny. Uwaga: ustawienie listy roboczej aktywnej spowoduje również opublikowanie listy na etsy.com.
Wyliczony ciąg z dowolnego z: aktywny lub nieaktywny. Uwaga: ustawienie listy roboczej aktywnej spowoduje również opublikowanie listy na etsy.com.
- State
- integer
Typ
Typ uaktualnienia wysyłki. Krajowy (0) lub międzynarodowy (1).
Typ uaktualnienia wysyłki. Krajowy (0) lub międzynarodowy (1).
- Typ
- integer
Kiedy to robione
Wyliczony ciąg dla epoki, w której producent wykonał produkt na tej liście. Pomaga kupującym zlokalizować ofertę pod nagłówkiem Vintage. Wymaga "is_supply" i "who_made".
Wyliczony ciąg dla epoki, w której producent wykonał produkt na tej liście. Pomaga kupującym zlokalizować ofertę pod nagłówkiem Vintage. Wymaga "is_supply" i "who_made".
- Kiedy to robione
- string
WhoMade
Wyliczony ciąg inidcated, który utworzył produkt. Pomaga kupującym zlokalizować ofertę pod nagłówkiem Handmade. Wymaga "is_supply" i "when_made".
Wyliczony ciąg inidcated, który utworzył produkt. Pomaga kupującym zlokalizować ofertę pod nagłówkiem Handmade. Wymaga "is_supply" i "when_made".
- WhoMade
- string