Udostępnij przez


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
Email 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: de, esenptitfrjanlpl. ru

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ść value_id:1394 i name:38.

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