Etsy(독립 게시자)
이 커넥터는 API 키를 사용하여 다양한 Etsy.com 기능에 액세스합니다. 재고, 판매 주문 및 상점 관리에 대한 작업을 지원합니다. 모든 작업은 베타에 있는 엔드포인트가 있는 Etsy Open API v3을 기반으로 합니다. 작업과 같이 베타 API를 사용하는 경우 타이틀에 베타가 포함된 작업은 501 응답 코드를 반환합니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | 트로이 테일러 |
| URL | https://www.hitachisolutions.com |
| 전자 메일 | ttaylor@hitachisolutions.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | 트로이 테일러, 히타치 솔루션 |
| 웹 사이트 | https://www.etsy.com/ |
| 개인 정보 보호 정책 | https://www.etsy.com/legal/privacy/ |
| 카테고리 | Commerce |
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| API 키 | 시큐어스트링 (보안 문자열) | 이 API의 API 키 | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| ID로 목록 가져오기 |
여러 목록 ID를 한 번에 쿼리할 수 있습니다. 쿼리당 최대 ID 100개 제한 |
| Ping |
애플리케이션을 사용하여 Etsy API에 대한 연결을 확인합니다. |
| 결제 계정 원장 항목 ID에서 결제 받기 |
해당하는 경우 결제 계정 원장 항목 ID에서 결제를 가져옵니다. |
| 결제 목록 가져오기 |
상점 ID로 식별된 상점에서 결제 목록을 검색합니다. 결제 ID 목록을 사용하여 결과를 필터링할 수도 있습니다. |
| 리뷰 가져오기 |
ID가 지정된 상점에서 리뷰를 검색합니다. |
| 모든 목록 파일 가져오기 |
지정된 디지털 목록과 연결된 모든 파일을 검색합니다. 실제 목록에서 파일을 요청하면 빈 결과가 반환됩니다. |
| 목록 가져오기 |
ID를 나열하여 목록 레코드를 검색합니다. |
| 목록 번역 만들기 |
ID 및 언어를 나열하여 목록 번역을 만듭니다. |
| 목록 번역 업데이트 |
ID 및 언어를 나열하여 목록 번역을 업데이트합니다. |
| 목록 삭제 |
이 작업은 상점 목록을 삭제합니다. 상태가 다음 중 하나인 경우에만 목록을 삭제할 수 있습니다. SOLD_OUT, 초안, 만료됨, 비활성, 활성 및 is_available 또는 ACTIVE 및 판매자 플래그가 있습니다. SUPRESSED(냉동), 휴가, CUSTOM_SHOPS(패턴), SELL_ON_FACEBOOK |
| 목록 속성 삭제 |
목록에서 속성을 삭제합니다. |
| 목록 속성 업데이트 |
목록의 제품 제품을 정의하는 속성 목록을 업데이트하거나 채웁니다. 각 제품에는 목록에 할당된 배율 ID에 유효하거나 이 요청을 사용하여 목록에 할당하는 값과 값 ID가 모두 필요합니다. |
| 목록 업데이트 |
상점 ID로 식별되는 특정 상점에 대해 목록 ID로 식별되는 목록을 업데이트합니다. |
| 목록 이미지 가져오기 |
특정 이미지 ID를 사용하여 목록 이미지에 대한 참조 및 메타데이터를 검색합니다. |
| 목록 이미지 삭제 |
목록 이미지를 삭제합니다. 파일의 복사본은 서버에 남아 있으므로 원본 이미지를 다시 업로드하지 않고 삭제된 이미지를 목록과 다시 연결할 수 있습니다. |
| 목록 이미지 업로드 |
목록 ID가 있는 상점 ID로 식별되는 목록에 이미지를 업로드하거나 할당합니다. 새 이미지를 업로드하려면 이미지 파일을 이미지 매개 변수의 값으로 설정합니다. 목록 이미지 ID 매개 변수에서 삭제된 이미지의 이미지 ID를 사용하여 이전에 삭제된 이미지를 목록에 할당할 수 있습니다. 요청에 이미지 및 목록 이미지 ID 매개 변수 값이 모두 포함된 경우 엔드포인트는 이미지 매개 변수에만 이미지를 업로드합니다. |
| 목록 제품 가져오기 |
목록에 대한 제품을 가져옵니다. |
| 목록 제품 가져오기 |
ID별로 목록 제품을 검색합니다. |
| 목록 파일 업로드 |
디지털 목록에 대한 새 파일을 업로드하거나 기존 파일을 특정 목록에 연결합니다. 기존 파일의 목록 파일 ID 또는 업로드할 파일의 이름 및 이진 파일 데이터를 제공해야 합니다. 기존 파일을 실제 목록에 연결하면 물리적 목록이 디지털 목록으로 변환되어 모든 배송 비용과 제품 및 재고 변형이 제거됩니다. |
| 목록에서 파일 가져오기 |
지정된 디지털 목록과 연결된 단일 파일을 검색합니다. 물리적 목록에서 파일을 요청하면 빈 결과가 반환됩니다. |
| 목록에서 파일 삭제 |
디지털 목록의 최종 파일을 삭제하면 목록이 실제 목록으로 변환됩니다. 삭제 요청에 대한 응답은 지정된 목록과 연결된 나머지 파일 레코드 목록을 반환합니다. |
| 목록의 번역 가져오기 |
지정된 언어로 된 목록의 번역을 반환합니다. |
| 목록의 변형 이미지 가져오기 |
목록의 모든 변형 이미지를 가져옵니다. |
| 목록의 변형 이미지 업데이트 |
목록에 변형 이미지를 만듭니다. |
| 목록의 속성 가져오기 |
목록의 속성 목록을 반환합니다. |
| 목록의 속성 가져오기(베타) |
목록의 속성을 검색합니다. 이 엔드포인트에 대한 개발이 진행 중입니다. 501 응답만 반환합니다. |
| 목록의 이미지 가져오기 |
특정 목록 ID를 사용하여 목록에 대한 모든 목록 이미지 리소스를 검색합니다. |
| 목록의 인벤토리 가져오기 |
목록의 인벤토리 레코드를 검색합니다. Etsy.com 인벤토리 도구를 사용하여 편집하지 않은 목록에는 인벤토리 레코드가 없습니다. 페치되는 인벤토리 레코드의 소유자인 경우 이 엔드포인트는 SKU 데이터를 반환합니다. |
| 목록의 인벤토리 업데이트 |
목록 ID로 식별되는 목록의 인벤토리를 업데이트합니다. 제품 SKU, 제품 수량 및/또는 가격에 대해 제공된 값이 속성 필드의 값과 호환되지 않으면 업데이트가 실패합니다. 가격을 설정할 때 금액 리소스에 지정된 대로 분할된 금액과 동일한 부동 소수 자릿수를 할당합니다. |
| 목록의 트랜잭션 검색 |
목록과 연결된 트랜잭션 목록을 검색합니다. |
| 배송 영수증 만들기 |
지정된 영수증 ID에 대한 상점 영수증 배송 항목을 만드는 상점 영수증에 대한 추적 정보를 제출합니다. 추적 정보를 성공적으로 제출할 때마다 Etsy는 구매자 사용자에게 알림 이메일을 보냅니다. BCC 보내기가 true이면 Etsy도 판매자에게 배송 알림을 보냅니다. 추적 코드 및 운송업체 이름이 전송되지 않으면 영수증은 배송된 것으로만 표시됩니다. |
| 배송 프로필 가져오기 |
배송 프로필 ID로 참조되는 배송 프로필을 검색합니다. |
| 배송 프로필 가져오기 |
상점 ID로 식별된 특정 Etsy 상점에서 사용할 수 있는 배송 프로필 목록을 검색합니다. |
| 배송 프로필 대상 만들기 |
배송 프로필의 대상에 대한 배송 비용, 운송업체 및 클래스를 설정하는 새 배송 대상을 만듭니다. 이렇게 하면 관련 상점의 통화를 사용하여 비용이 할당됩니다. 대상 국가 ISO 또는 대상 지역을 사용하여 대상을 설정합니다. 대상 국가 ISO 및 대상 지역은 상호 배타적입니다. 하나 또는 다른 지역을 설정합니다. 두 트리거를 모두 설정해도 오류 400이 발생합니다. 요청이 대상 국가 ISO 또는 대상 지역을 설정하지 않으면 기본 대상은 어디에나 있습니다. 또한 배송업체 ID와 메일 클래스를 모두 할당하거나 최소 배달일과 최대 배달일을 모두 할당해야 합니다. |
| 배송 프로필 대상 삭제 |
배송 대상을 삭제하고 연결된 배송 프로필을 사용하는 모든 목록에서 대상 옵션을 제거합니다. 배송 프로필에는 하나 이상의 배송 대상이 필요하므로 이 엔드포인트는 배송 프로필의 최종 배송 대상을 삭제할 수 없습니다. 배송 프로필에서 최종 배송 대상을 삭제하려면 전체 배송 프로필을 삭제해야 합니다. |
| 배송 프로필 대상 업데이트 |
대상에 대한 배송 비용, 운송업체 및 클래스를 설정하거나 다시 할당할 수 있는 기존 배송 대상을 업데이트합니다. |
| 배송 프로필 만들기 |
새 배송 프로필을 만듭니다. 배송 프로필을 만들 때 국가 ISO 코드 또는 지역을 전달할 수 있지만 둘 다 전달할 수는 없습니다. 하나만 필요합니다. 배송업체 ID와 메일 클래스 또는 최소 및 최대 배송일을 모두 전달해야 합니다. |
| 배송 프로필 삭제 |
지정된 ID로 배송 프로필을 삭제합니다. |
| 배송 프로필 업그레이드 가져오기 |
특정 배송 프로필에 할당된 배송 프로필 업그레이드 목록을 검색합니다. |
| 배송 프로필 업그레이드 만들기 |
대체 운송업체 또는 더 빠른 배송과 같은 배송 옵션에 대한 가격을 설정할 수 있는 새 배송 프로필 업그레이드를 만듭니다. |
| 배송 프로필 업그레이드 삭제 |
배송 프로필 업그레이드를 삭제하고 연결된 배송 프로필을 사용하는 모든 목록에서 업그레이드 옵션을 제거합니다. |
| 배송 프로필 업그레이드 업데이트 |
배송 프로필 업그레이드를 업데이트하고 배송 프로필을 사용하는 모든 목록을 업데이트합니다. |
| 배송 프로필 업데이트 |
배송 프로필의 설정을 변경합니다. |
| 배송 프로필로 프로필 대상 가져오기 |
배송 프로필과 연결된 배송 대상 개체 목록을 검색합니다. |
| 배송업체 가져오기 |
지정된 국가에 대해 사용 가능한 배송업체 및 해당 운송업체와 연결된 메일 클래스 목록을 검색합니다. |
| 분류 ID로 제품 속성 가져오기 |
특정 판매자 분류 ID에 대해 지원되는 해당 크기 조정 및 값을 사용하여 제품 속성 목록을 검색합니다. |
| 사용자 가져오기 |
사용자 ID로 식별된 사용자의 사용자 프로필을 반환합니다. |
| 사용자 주소 가져오기 |
사용자 주소 목록을 검색합니다. |
| 사용자의 주소 가져오기 |
사용자의 주소를 검색합니다. 이 엔드포인트에 대한 개발이 진행 중입니다. 501 응답만 반환합니다. |
| 상점 검색 |
일치하는 이름의 상점 목록을 반환합니다. |
| 상점 결제 계정 원장의 항목 가져오기 |
상점의 결제 계정 원장의 항목을 검색합니다. |
| 상점 섹션 ID로 목록 가져오기 |
특정 상점의 섹션에서 모든 목록을 검색합니다. |
| 상점 섹션 가져오기 |
섹션 ID 및 상점 ID로 참조되는 상점 섹션을 검색합니다. |
| 상점 섹션 가져오기 |
상점 ID로 식별된 특정 상점의 상점 섹션 목록을 검색합니다. |
| 상점 섹션 만들기 |
특정 상점에 새 섹션을 만듭니다. |
| 상점 업데이트 |
상점을 업데이트합니다. 모든 문자열 매개 변수가 상점의 기본 언어로 제공된다고 가정합니다. |
| 상점 영수증으로 목록 가져오기 |
영수증과 연결된 모든 목록을 가져옵니다. |
| 상점별 목록 가져오기 |
Shop에 속한 목록을 반환합니다. 상태 매개 변수를 사용하여 목록을 필터링할 수 있습니다. |
| 상점별 추천 목록 가져오기 |
추천 상점과 연결된 목록을 검색합니다. |
| 상점별 활성 목록 가져오기 |
생성 날짜를 나열하여 페이지를 매긴 특정 상점의 Etsy에 있는 모든 활성 목록 목록을 검색합니다. |
| 상점의 거래 가져오기 |
상점과 연결된 트랜잭션 목록을 검색합니다. |
| 소유자 ID로 상점 가져오기 |
상점 주인의 사용자 ID로 식별된 상점을 검색합니다. |
| 영수증 받기 |
Etsy 상점에서 영수증 ID로 식별되는 영수증을 검색합니다. |
| 영수증 받기 |
영수증 ID 범위 또는 오프셋, 날짜, 유료 및/또는 배송된 구매를 기준으로 필터링되거나 필터링된 특정 상점에서 상점 영수증을 요청합니다. |
| 영수증의 트랜잭션 가져오기 |
특정 영수증과 연결된 트랜잭션 목록을 검색합니다. |
| 초안 목록 만들기 |
Etsy 채널의 상점에서 실제 초안 목록 제품을 만듭니다. |
| 트랜잭션 가져오기 |
트랜잭션 ID로 트랜잭션을 검색합니다. |
| 특정 영수증에서 결제 받기 |
특정 상점의 영수증 ID로 식별되는 특정 영수증에서 상점 ID로 식별되는 결제를 검색합니다. |
| 판매자 분류 노드 가져오기 |
판매자 분류 노드의 전체 계층 트리를 검색합니다. |
| 활성 목록 가져오기 |
생성 날짜별로 페이지를 매긴 Etsy의 모든 활성 목록 목록입니다. 정렬 순서 목록이 없으면 기본적으로 최신 순서 목록이 반환됩니다. |
ID로 목록 가져오기
여러 목록 ID를 한 번에 쿼리할 수 있습니다. 쿼리당 최대 ID 100개 제한
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
ID 나열
|
listing_ids | True | string |
특정 Etsy 상점의 목록에 대한 숫자 ID의 배열입니다. |
|
Includes
|
includes | string |
유효한 연결을 연결하는 열거형 문자열입니다. |
반환
연결과 리소스를 나열하는 상점 집합입니다.
- ShopListingsWithAssociations
- ShopListingsWithAssociations
Ping
결제 계정 원장 항목 ID에서 결제 받기
해당하는 경우 결제 계정 원장 항목 ID에서 결제를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
원장 항목 ID
|
ledger_entry_ids | True | string |
정수 배열입니다. |
반환
Etsy Payments로 이루어진 여러 결제를 나타냅니다. 달리 지정하지 않는 한 모든 금액은 USD 동전으로 제공됩니다.
- 결제
- Payments
결제 목록 가져오기
상점 ID로 식별된 상점에서 결제 목록을 검색합니다. 결제 ID 목록을 사용하여 결과를 필터링할 수도 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
결제 아이디
|
payment-ids | True | string |
결제 ID 번호의 쉼표로 구분된 배열입니다. |
반환
Etsy Payments로 이루어진 여러 결제를 나타냅니다. 달리 지정하지 않는 한 모든 금액은 USD 동전으로 제공됩니다.
- 결제
- Payments
리뷰 가져오기
ID가 지정된 상점에서 리뷰를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
한계
|
limit | integer |
반환할 최대 결과 수입니다. |
|
|
상쇄
|
offset | integer |
첫 번째 결과를 선택하기 전에 건너뛸 레코드 수입니다. |
반환
사용자가 남긴 트랜잭션 검토 레코드 집합입니다.
- TransactionReviews
- TransactionReviews
모든 목록 파일 가져오기
지정된 디지털 목록과 연결된 모든 파일을 검색합니다. 실제 목록에서 파일을 요청하면 빈 결과가 반환됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
목록 ID
|
listing_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
반환
여러 ShopListingFile을 나타냅니다.
- ShopListingFiles
- ShopListingFiles
목록 가져오기
ID를 나열하여 목록 레코드를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
목록 ID
|
listing_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
Includes
|
includes | string |
유효한 연결을 연결하는 열거형 문자열입니다. 허용되는 입력은 'shop', 'images' 및 'user'입니다. |
목록 번역 만들기
ID 및 언어를 나열하여 목록 번역을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
목록 ID
|
listing_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
Language
|
language | True | string |
이 번역의 언어에 대한 IETF 언어 태그입니다. 예: de, en, es, fr, it, ja, nl, pl, pt, ru. |
|
제목
|
title | True | string |
이 번역 목록의 제목입니다. |
|
Description
|
description | True | string |
이 번역 목록에 대한 설명입니다. |
|
태그들
|
tags | string |
이 번역 목록의 태그입니다. |
반환
목록의 번역 데이터를 나타냅니다.
- ListingTranslation
- ListingTranslation
목록 번역 업데이트
ID 및 언어를 나열하여 목록 번역을 업데이트합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
목록 ID
|
listing_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
Language
|
language | True | string |
이 번역의 언어에 대한 IETF 언어 태그입니다. 예: de, en, es, fr, it, ja, nl, pl, pt, ru. |
|
제목
|
title | True | string |
이 번역 목록의 제목입니다. |
|
Description
|
description | True | string |
이 번역 목록에 대한 설명입니다. |
|
태그들
|
tags | string |
이 번역 목록의 태그입니다. |
반환
목록의 번역 데이터를 나타냅니다.
- ListingTranslation
- ListingTranslation
목록 삭제
이 작업은 상점 목록을 삭제합니다. 상태가 다음 중 하나인 경우에만 목록을 삭제할 수 있습니다. SOLD_OUT, 초안, 만료됨, 비활성, 활성 및 is_available 또는 ACTIVE 및 판매자 플래그가 있습니다. SUPRESSED(냉동), 휴가, CUSTOM_SHOPS(패턴), SELL_ON_FACEBOOK
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
목록 ID
|
listing_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
목록 속성 삭제
목록에서 속성을 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
목록 ID
|
listing_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
속성 ID
|
property_id | True | integer |
Etsy 목록 속성의 고유 ID입니다. |
목록 속성 업데이트
목록의 제품 제품을 정의하는 속성 목록을 업데이트하거나 채웁니다. 각 제품에는 목록에 할당된 배율 ID에 유효하거나 이 요청을 사용하여 목록에 할당하는 값과 값 ID가 모두 필요합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
목록 ID
|
listing_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
속성 ID
|
property_id | True | integer |
Etsy 목록 속성의 고유 ID입니다. |
|
값 ID
|
value_ids | True | integer |
단일 Etsy.com 측정 눈금의 숫자 ID입니다. |
|
가치들
|
values | True | string |
여러 Etsy 목록 속성 값에 대한 값 문자열 배열입니다. |
|
크기 조정 ID
|
scale_id | integer |
단일 Etsy.com 측정 눈금의 숫자 ID입니다. |
반환
구조화된 데이터 값의 표현입니다.
- ListingPropertyValue
- ListingPropertyValue
목록 업데이트
상점 ID로 식별되는 특정 상점에 대해 목록 ID로 식별되는 목록을 업데이트합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
목록 ID
|
listing_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
수량
|
quantity | integer |
목록에서 구매할 수 있는 양의 0이 아닌 제품 수입니다. |
|
|
제목
|
title | string |
목록의 제목 문자열입니다. 유효한 제목 문자열에는 문자, 숫자, 문장 부호, 수학 기호, 공백 문자 ™ © 및 ® . (regex: /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) %, :, 및 + 문자는 각각 한 번만 사용할 수 있습니다. |
|
|
Description
|
description | string |
목록에서 판매할 제품의 설명 문자열입니다. |
|
|
가격
|
price | float |
제품의 양의 0이 아닌 가격입니다. (판매된 제품 목록은 비공개) 참고: 가격은 가능한 최소 가격입니다. |
|
|
만든 사람
|
who_made | string |
제품을 만든 사람이 할당된 문자열입니다. 구매자가 수제 제목 아래에서 목록을 찾을 수 있도록 도와줍니다. 'is_supply' 및 'when_made'이 필요합니다. |
|
|
만든 경우
|
when_made | string |
이 목록에서 제조업체가 제품을 만든 시대의 문자열입니다. 구매자가 빈티지 제목 아래에 목록을 찾을 수 있도록 도와줍니다. 'is_supply' 및 'who_made'이 필요합니다. |
|
|
분류 ID
|
taxonomy_id | integer |
목록의 숫자 분류 ID입니다. 판매자는 자신의 상점에 대한 분류 ID를 나열 관리합니다. |
|
|
배송 프로필 ID
|
shipping_profile_id | integer |
목록과 연결된 배송 프로필의 숫자 ID입니다. |
|
|
Materials
|
materials | string |
제품에 사용되는 재료에 대한 재료 문자열의 배열입니다. 유효한 재질 문자열에는 문자, 숫자 및 공백 문자만 포함됩니다. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u) |
|
|
Shop 섹션 ID
|
shop_section_id | integer |
이 목록에 대한 상점 섹션의 숫자 ID입니다. |
|
|
최소 처리
|
processing_min | integer |
이 목록을 처리하는 데 필요한 최소 일 수입니다. |
|
|
최대 처리
|
processing_max | integer |
이 목록을 처리하는 데 필요한 최대 일 수입니다. |
|
|
태그들
|
tags | string |
목록에 대한 태그 문자열의 배열입니다. 유효한 태그 문자열에는 문자, 숫자, 공백 문자, -, ', ™ , © 및 ® . (regex: /[^\p{L}\p{Nd}\p{Zs}-'™©®]/u) |
|
|
Recipient
|
recipient | string |
이 제품이 적절한 선물을 만들 사람을 나타내는 문자열입니다. |
|
|
경우
|
occasion | string |
이 제품이 적절한 선물을 만드는 경우를 나타내는 문자열입니다. |
|
|
스타일
|
styles | string |
이 목록에 대한 스타일 문자열의 배열이며, 각각은 정식 또는 Steampunk와 같은 자유 형식 텍스트 문자열입니다. 목록에는 최대 2개의 스타일이 있을 수 있습니다. 유효한 스타일 문자열에는 문자, 숫자 및 공백 문자만 포함됩니다. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u) |
|
|
항목 가중치
|
item_weight | float |
항목 중량 단위로 설정된 단위로 측정된 제품의 숫자 가중치입니다. |
|
|
항목 길이
|
item_length | integer |
항목 차원 단위로 설정된 단위로 측정된 제품의 숫자 길이입니다. |
|
|
항목 너비
|
item_width | float |
'항목 차원 단위'에 설정된 단위로 측정된 제품의 숫자 너비입니다. |
|
|
항목 높이
|
item_height | float |
'항목 차원 단위'에 설정된 단위로 측정된 제품의 숫자 높이입니다. |
|
|
항목 가중치 단위
|
item_weight_unit | string |
제품의 가중치를 측정하는 데 사용되는 단위를 정의하는 문자열입니다. |
|
|
항목 차원 단위
|
item_dimensions_unit | string |
제품의 차원을 측정하는 데 사용되는 단위를 정의하는 문자열입니다. |
|
|
Personalizable인가요?
|
is_personalizable | boolean |
true이면 이 목록을 개인 설정할 수 있습니다. |
|
|
이미지 ID
|
image_ids | string |
최대 10개의 이미지를 포함할 수 있는 목록에 있는 이미지의 숫자 이미지 ID 배열입니다. |
|
|
공급입니다.
|
is_supply | boolean |
true이면 목록에 공급 제품으로 태그를 지정하고, 그렇지 않으면 완성된 제품임을 나타냅니다. 구매자가 공급 제목 아래에서 목록을 찾을 수 있도록 도와줍니다. '만든 사람'과 '언제 만들어졌을 때'가 필요합니다. |
|
|
사용자 정의 가능
|
is_customizable | boolean |
true이면 구매자가 판매자에게 연락하여 사용자 지정 주문을 할 수 있습니다. 상점이 사용자 지정 주문을 수락하는 경우 기본값은 true입니다. 사용자 지정 주문을 수락하지 않는 상점에는 적용되지 않습니다. |
|
|
과세 가능
|
is_taxable | boolean |
해당하는 경우 체크 아웃 시 해당 상점 세율이 이 목록에 적용됩니다. |
|
|
추천 순위
|
featured_ rank | integer |
1위 목록이 상점 홈페이지의 추천 목록에서 가장 왼쪽에 나타나는 상점의 추천 목록에서 0이 아닌 긍정적인 숫자 위치입니다. |
|
|
자동 갱신해야 합니다.
|
should_auto_renew | boolean |
true이면 추방 시 4개월 동안 목록을 갱신합니다. 이전에 false일 때 true로 설정된 경우 etsy.com 만료되기 전에 목록을 갱신하지만 갱신 기간은 목록의 만료 날짜를 연장하지 않고 변경적으로 시작됩니다. 목록에 남아 있는 사용되지 않은 시간은 손실됩니다. 갱신하면 사용자의 청구서에 대한 요금이 청구됩니다. |
|
|
유형
|
type | string |
목록이 실제 다운로드인지 디지털 다운로드인지를 나타냅니다. |
|
|
채널
|
channels | string |
열거된 채널 ID 문자열의 배열입니다. 채널은 판매자가 판매를 위해 구매자에게 연락할 수 있는 장소입니다. |
반환
제품 수량, 제목, 설명, 가격 등을 포함하는 상점의 목록입니다.
- ShopListing
- ShopListing
목록 이미지 가져오기
특정 이미지 ID를 사용하여 목록 이미지에 대한 참조 및 메타데이터를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
목록 ID
|
listing_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
이미지 ID 나열
|
listing_image_id | True | integer |
이 트랜잭션에 대한 기본 목록 이미지의 숫자 ID입니다. |
반환
특정 목록과 연결된 이미지에 대한 참조 URL 및 메타데이터입니다. 매개 변수에는 url_fullxfull 전체 크기 이진 이미지 파일의 URL이 포함됩니다.
- ListingImage
- ListingImage
목록 이미지 삭제
목록 이미지를 삭제합니다. 파일의 복사본은 서버에 남아 있으므로 원본 이미지를 다시 업로드하지 않고 삭제된 이미지를 목록과 다시 연결할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
목록 ID
|
listing_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
이미지 ID 나열
|
listing_image_id | True | integer |
이 트랜잭션에 대한 기본 목록 이미지의 숫자 ID입니다. |
목록 이미지 업로드
목록 ID가 있는 상점 ID로 식별되는 목록에 이미지를 업로드하거나 할당합니다. 새 이미지를 업로드하려면 이미지 파일을 이미지 매개 변수의 값으로 설정합니다. 목록 이미지 ID 매개 변수에서 삭제된 이미지의 이미지 ID를 사용하여 이전에 삭제된 이미지를 목록에 할당할 수 있습니다. 요청에 이미지 및 목록 이미지 ID 매개 변수 값이 모두 포함된 경우 엔드포인트는 이미지 매개 변수에만 이미지를 업로드합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
목록 ID
|
listing_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
이미지
|
image | string |
업로드할 파일의 파일 이름 문자열입니다. |
|
|
이미지 ID 나열
|
listing_image_id | integer |
이 트랜잭션에 대한 기본 목록 이미지의 숫자 ID입니다. |
|
|
등급
|
rank | integer |
목록에 표시된 이미지에서 0이 아닌 양의 숫자 위치로, 목록의 맨 왼쪽 위치에 순위 1 이미지가 표시됩니다. |
|
|
덮어쓰기
|
overwrite | boolean |
true이면 이 요청은 지정된 순위의 기존 이미지를 대체합니다. |
|
|
워터마크 표시
|
is_watermarked | boolean |
true이면 업로드된 이미지에 워터마크가 있음을 나타냅니다. |
반환
특정 목록과 연결된 이미지에 대한 참조 URL 및 메타데이터입니다. 매개 변수에는 url_fullxfull 전체 크기 이진 이미지 파일의 URL이 포함됩니다.
- ListingImage
- ListingImage
목록 제품 가져오기
목록에 대한 제품을 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
목록 ID
|
listing_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
제품 ID
|
product_id | True | integer |
이 트랜잭션에 연결된 제품의 숫자 ID입니다. |
|
제품 제공 ID
|
product_offering_id | True | integer |
이 트랜잭션과 연결된 제품 제품의 숫자 ID입니다. |
반환
목록에 대한 제품의 표현입니다.
- ListingInventoryProductOffering
- ListingInventoryProductOffering
목록 제품 가져오기
ID별로 목록 제품을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
목록 ID
|
listing_id | True | integer |
목록 제품을 반환할 목록입니다. |
|
제품 ID
|
product_id | True | integer |
목록에서 구매한 특정 제품의 숫자 ID입니다. |
반환
목록에 대한 제품의 표현입니다.
- ListingInventoryProduct
- ListingInventoryProduct
목록 파일 업로드
디지털 목록에 대한 새 파일을 업로드하거나 기존 파일을 특정 목록에 연결합니다. 기존 파일의 목록 파일 ID 또는 업로드할 파일의 이름 및 이진 파일 데이터를 제공해야 합니다. 기존 파일을 실제 목록에 연결하면 물리적 목록이 디지털 목록으로 변환되어 모든 배송 비용과 제품 및 재고 변형이 제거됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
목록 ID
|
listing_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
목록 파일 ID
|
listing_file_id | integer |
디지털 목록과 연결된 파일의 고유 숫자 ID입니다. |
|
|
File
|
file | True | string |
업로드할 이진 파일입니다. |
|
이름
|
name | string |
업로드할 파일의 파일 이름 문자열 |
|
|
등급
|
rank | integer |
목록에 표시된 이미지에서 0이 아닌 양의 숫자 위치로, 목록의 맨 왼쪽 위치에 순위 1 이미지가 표시됩니다. |
반환
디지털 목록과 연결된 파일입니다.
- ShopListingFile
- ShopListingFile
목록에서 파일 가져오기
지정된 디지털 목록과 연결된 단일 파일을 검색합니다. 물리적 목록에서 파일을 요청하면 빈 결과가 반환됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
목록 ID
|
listing_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
목록 파일 ID
|
listing_file_id | True | integer |
디지털 목록과 연결된 파일의 고유 숫자 ID입니다. |
반환
디지털 목록과 연결된 파일입니다.
- ShopListingFile
- ShopListingFile
목록에서 파일 삭제
디지털 목록의 최종 파일을 삭제하면 목록이 실제 목록으로 변환됩니다. 삭제 요청에 대한 응답은 지정된 목록과 연결된 나머지 파일 레코드 목록을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
목록 ID
|
listing_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
목록 파일 ID
|
listing_file_id | True | integer |
디지털 목록과 연결된 파일의 고유 숫자 ID입니다. |
목록의 번역 가져오기
지정된 언어로 된 목록의 번역을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
목록 ID
|
listing_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
Language
|
language | True | string |
이 번역의 언어에 대한 IETF 언어 태그입니다. 예: de, en, es, fr, it, ja, nl, pl, pt, ru. |
반환
목록의 번역 데이터를 나타냅니다.
- ListingTranslation
- ListingTranslation
목록의 변형 이미지 가져오기
목록의 모든 변형 이미지를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
목록 ID
|
listing_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
반환
여러 목록 변형 이미지를 나타냅니다.
- ListingVariationImages
- ListingVariationImages
목록의 변형 이미지 업데이트
목록에 변형 이미지를 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
목록 ID
|
listing_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
변형 이미지
|
variation_images | True | string |
변형 이미지 데이터의 배열입니다. |
반환
여러 목록 변형 이미지를 나타냅니다.
- ListingVariationImages
- ListingVariationImages
목록의 속성 가져오기
목록의 속성 목록을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
목록 ID
|
listing_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
반환
여러 목록 속성 값을 나타냅니다.
- ListingPropertyValues
- ListingPropertyValues
목록의 속성 가져오기(베타)
목록의 속성을 검색합니다. 이 엔드포인트에 대한 개발이 진행 중입니다. 501 응답만 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
목록 ID
|
listing_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
속성 ID
|
property_id | True | integer |
Etsy 목록 속성의 고유 ID입니다. |
반환
구조화된 데이터 값의 표현입니다.
- ListingPropertyValue
- ListingPropertyValue
목록의 이미지 가져오기
특정 목록 ID를 사용하여 목록에 대한 모든 목록 이미지 리소스를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
목록 ID
|
listing_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
반환
이미지 리소스 목록 목록을 나타내며, 각 리소스에는 이미지에 대한 참조 URL 및 메타데이터가 포함됩니다.
- ListingImages
- ListingImages
목록의 인벤토리 가져오기
목록의 인벤토리 레코드를 검색합니다. Etsy.com 인벤토리 도구를 사용하여 편집하지 않은 목록에는 인벤토리 레코드가 없습니다. 페치되는 인벤토리 레코드의 소유자인 경우 이 엔드포인트는 SKU 데이터를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
목록 ID
|
listing_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
Includes
|
includes | string |
유효한 연결을 연결하는 열거형 문자열입니다. |
반환
연결과 단일 목록의 인벤토리 레코드 표현
- ListingInventoryWithAssociations
- ListingInventoryWithAssociations
목록의 인벤토리 업데이트
목록 ID로 식별되는 목록의 인벤토리를 업데이트합니다. 제품 SKU, 제품 수량 및/또는 가격에 대해 제공된 값이 속성 필드의 값과 호환되지 않으면 업데이트가 실패합니다. 가격을 설정할 때 금액 리소스에 지정된 대로 분할된 금액과 동일한 부동 소수 자릿수를 할당합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
목록 ID
|
listing_id | True | string |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
Products
|
products | True | string |
제품 하나만 있는 경우에도 목록에서 사용할 수 있는 제품의 JSON 배열입니다. JSON Blob의 모든 필드 이름은 소문자입니다. |
|
속성의 가격
|
price_on_property | string |
제품 가격을 변경하는 속성에 대한 고유 목록 속성 ID 정수의 배열입니다(있는 경우). 예를 들어 동일한 목록에 있는 다양한 크기의 제품에 대해 특정 가격을 청구하는 경우 이 배열에는 크기에 대한 속성 ID가 포함됩니다. |
|
|
속성의 수량
|
quantity_on_property | string |
제품의 수량을 변경하는 속성에 대한 고유한 목록 속성 ID 정수 배열(있는 경우)입니다. 예를 들어 동일한 목록에 있는 다양한 색 제품의 특정 수량을 재고하는 경우 이 배열에는 색에 대한 속성 ID가 포함됩니다. |
|
|
SKU on Property
|
sku_on_property | string |
제품 SKU를 변경하는 속성에 대한 고유 목록 속성 ID 정수의 배열입니다(있는 경우). 예를 들어 동일한 목록에서 다른 색 제품에 특정 SKU를 사용하는 경우 이 배열에는 색에 대한 속성 ID가 포함됩니다. |
반환
단일 목록의 인벤토리 레코드 표현입니다.
- ListingInventory
- ListingInventory
목록의 트랜잭션 검색
목록과 연결된 트랜잭션 목록을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
목록 ID
|
listing_id | True | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
한계
|
limit | integer |
반환할 최대 결과 수입니다. |
|
|
상쇄
|
offset | integer |
첫 번째 결과를 선택하기 전에 건너뛸 레코드 수입니다. |
반환
상점 영수증 거래 리소스 집합
- ShopReceiptTransactions
- ShopReceiptTransactions
배송 영수증 만들기
지정된 영수증 ID에 대한 상점 영수증 배송 항목을 만드는 상점 영수증에 대한 추적 정보를 제출합니다. 추적 정보를 성공적으로 제출할 때마다 Etsy는 구매자 사용자에게 알림 이메일을 보냅니다. BCC 보내기가 true이면 Etsy도 판매자에게 배송 알림을 보냅니다. 추적 코드 및 운송업체 이름이 전송되지 않으면 영수증은 배송된 것으로만 표시됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
영수증 ID
|
receipt_id | True | integer |
추적을 제출할 영수증입니다. |
|
추적 코드
|
tracking_code | string |
이 영수증의 추적 코드입니다. |
|
|
운송업체 이름
|
carrier_name | string |
이 영수증의 운송업체 이름입니다. |
|
|
BCC 보내기
|
send_bcc | boolean |
true이면 판매자에게도 배송 알림이 전송됩니다. |
반환
상점에서 구매한 레코드입니다. 상점 영수증은 상점의 통화를 사용하여 통화 값을 표시합니다.
- ShopReceipt
- ShopReceipt
배송 프로필 가져오기
배송 프로필 ID로 참조되는 배송 프로필을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
배송 프로필 ID
|
shipping_profile_id | True | integer |
목록과 연결된 배송 프로필의 숫자 ID입니다. |
배송 프로필 가져오기
상점 ID로 식별된 특정 Etsy 상점에서 사용할 수 있는 배송 프로필 목록을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
반환
목록의 배송 정보를 설정하는 데 사용되는 프로필을 나타냅니다. API를 통해 계산된 배송 템플릿을 만들 수 없습니다. 그러나 Shop Manager에서 만든 계산된 배송 프로필을 API를 사용하여 목록과 연결할 수 있습니다.
- ShopShippingProfile
- ShopShippingProfile
배송 프로필 대상 만들기
배송 프로필의 대상에 대한 배송 비용, 운송업체 및 클래스를 설정하는 새 배송 대상을 만듭니다. 이렇게 하면 관련 상점의 통화를 사용하여 비용이 할당됩니다. 대상 국가 ISO 또는 대상 지역을 사용하여 대상을 설정합니다. 대상 국가 ISO 및 대상 지역은 상호 배타적입니다. 하나 또는 다른 지역을 설정합니다. 두 트리거를 모두 설정해도 오류 400이 발생합니다. 요청이 대상 국가 ISO 또는 대상 지역을 설정하지 않으면 기본 대상은 어디에나 있습니다. 또한 배송업체 ID와 메일 클래스를 모두 할당하거나 최소 배달일과 최대 배달일을 모두 할당해야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
배송 프로필 ID
|
shipping_profile_id | True | integer |
목록과 연결된 배송 프로필의 숫자 ID입니다. |
|
기본 비용
|
primary_cost | True | float |
이 국가/지역으로 배송하는 비용만 저장소의 기본 통화로 측정됩니다. |
|
보조 비용
|
secondary_cost | True | string |
상점의 기본 통화로 측정된 다른 품목을 사용하여 이 국가/지역으로 배송하는 비용입니다. |
|
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 |
반환
배송 프로필에 할당된 배송 대상을 나타냅니다.
- ShopShippingProfileDestination
- ShopShippingProfileDestination
배송 프로필 대상 삭제
배송 대상을 삭제하고 연결된 배송 프로필을 사용하는 모든 목록에서 대상 옵션을 제거합니다. 배송 프로필에는 하나 이상의 배송 대상이 필요하므로 이 엔드포인트는 배송 프로필의 최종 배송 대상을 삭제할 수 없습니다. 배송 프로필에서 최종 배송 대상을 삭제하려면 전체 배송 프로필을 삭제해야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
배송 프로필 ID
|
shipping_profile_id | True | integer |
목록과 연결된 배송 프로필의 숫자 ID입니다. |
|
배송 프로필 대상 ID
|
shipping_profile_destination_id | True | integer |
목록과 연결된 배송 프로필에 있는 배송 프로필 대상의 숫자 ID입니다. |
배송 프로필 대상 업데이트
대상에 대한 배송 비용, 운송업체 및 클래스를 설정하거나 다시 할당할 수 있는 기존 배송 대상을 업데이트합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
배송 프로필 ID
|
shipping_profile_id | True | string |
목록과 연결된 배송 프로필의 숫자 ID입니다. |
|
배송 프로필 대상 ID
|
shipping_profile_destination_id | True | string |
목록과 연결된 배송 프로필 대상의 숫자 ID입니다. |
|
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 |
반환
배송 프로필에 할당된 배송 대상을 나타냅니다.
- ShopShippingProfileDestination
- ShopShippingProfileDestination
배송 프로필 만들기
새 배송 프로필을 만듭니다. 배송 프로필을 만들 때 국가 ISO 코드 또는 지역을 전달할 수 있지만 둘 다 전달할 수는 없습니다. 하나만 필요합니다. 배송업체 ID와 메일 클래스 또는 최소 및 최대 배송일을 모두 전달해야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
제목
|
title | True | string |
이 배송 프로필의 이름 문자열입니다. |
|
Origin Country ISO
|
origin_country_iso | True | string |
목록이 제공되는 국가의 ISO 코드입니다. |
|
기본 비용
|
primary_cost | True | float |
이 국가/지역으로 배송하는 비용만 저장소의 기본 통화로 측정됩니다. |
|
보조 비용
|
secondary_cost | True | float |
상점의 기본 통화로 측정된 다른 품목을 사용하여 이 국가/지역으로 배송하는 비용입니다. |
|
최소 처리 시간
|
min_processing_time | True | integer |
이 배송 프로필을 사용하여 목록을 배송하는 데 필요한 최소 시간입니다. |
|
최대 처리 시간
|
max_processing_time | True | integer |
목록이 배송되어야 하는 최대 처리 시간입니다. |
|
처리 시간 단위
|
processing_time_unit | string |
처리 시간을 나타내는 데 사용되는 단위입니다. 1주일은 영업일 기준 5일과 같습니다. |
|
|
대상 국가 ISO
|
destination_country_iso | string |
목록이 제공되는 국가의 ISO 코드입니다. Null인 경우 요청은 대상 지역을 대상 지역으로 설정합니다. |
|
|
대상 지역
|
destination_region | string |
목록이 제공되는 지역의 코드입니다. 지역은 국가 집합을 나타냅니다. 지원되는 지역은 유럽 연합 및 비유럽 연합(유럽이 아닌 유럽 국가)입니다. 없는 경우 요청은 대상 국가 ISO로 대상을 설정하거나 대상 국가 ISO도 null인 경우 어디에나 설정합니다. |
|
|
원본 우편 번호
|
origin_postal_code | string |
목록이 제공되는 위치에 대한 우편 번호 문자열(반드시 숫자가 아님)입니다. |
|
|
배송업체 ID
|
shipping_carrier_id | integer |
예상 배송 날짜를 계산하는 데 사용되는 지원되는 배송업체의 고유 ID입니다. |
|
|
메일 클래스
|
mail_class | string |
배송업체 메일 클래스의 고유 ID 문자열로, 예상 배달 날짜를 계산하는 데 사용됩니다. |
|
|
최소 배달 일수
|
min_delivery_days | integer |
구매자가 구매한 품목이 배송되면 받기를 기다릴 것으로 예상할 수 있는 최소 영업일수입니다. |
|
|
최대 배달 일수
|
max_delivery_days | integer |
구매자가 구매한 품목이 배송되면 받을 때까지 기다릴 것으로 예상할 수 있는 최대 영업일수입니다. |
반환
목록의 배송 정보를 설정하는 데 사용되는 프로필을 나타냅니다. API를 통해 계산된 배송 템플릿을 만들 수 없습니다. 그러나 Shop Manager에서 만든 계산된 배송 프로필을 API를 사용하여 목록과 연결할 수 있습니다.
- ShopShippingProfile
- ShopShippingProfile
배송 프로필 삭제
지정된 ID로 배송 프로필을 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
배송 프로필 ID
|
shipping_profile_id | True | integer |
목록과 연결된 배송 프로필의 숫자 ID입니다. |
반환
목록의 배송 정보를 설정하는 데 사용되는 프로필을 나타냅니다. API를 통해 계산된 배송 템플릿을 만들 수 없습니다. 그러나 Shop Manager에서 만든 계산된 배송 프로필을 API를 사용하여 목록과 연결할 수 있습니다.
- ShopShippingProfile
- ShopShippingProfile
배송 프로필 업그레이드 가져오기
특정 배송 프로필에 할당된 배송 프로필 업그레이드 목록을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
배송 프로필 ID
|
shipping_profile_id | True | integer |
목록과 연결된 배송 프로필의 숫자 ID입니다. |
반환
배송 업그레이드 옵션 목록입니다.
- ShopShippingProfileUpgrades
- ShopShippingProfileUpgrades
배송 프로필 업그레이드 만들기
대체 운송업체 또는 더 빠른 배송과 같은 배송 옵션에 대한 가격을 설정할 수 있는 새 배송 프로필 업그레이드를 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
배송 프로필 ID
|
shipping_profile_id | True | integer |
목록과 연결된 배송 프로필의 숫자 ID입니다. |
|
유형
|
type | True | string |
배송 업그레이드의 유형입니다. 국내(0) 또는 국제(1). |
|
업그레이드 이름
|
upgrade_name | True | string |
체크 아웃 시 쇼핑객에게 표시되는 배송 업그레이드 이름(예: USPS 우선 순위). |
|
가격
|
price | True | float |
배송 업그레이드를 추가하는 추가 비용입니다. |
|
보조 가격
|
secondary_price | True | float |
각 추가 항목에 대한 배송 업그레이드를 추가하는 추가 비용입니다. |
|
배송업체 ID
|
shipping_carrier_id | integer |
예상 배송 날짜를 계산하는 데 사용되는 지원되는 배송업체의 고유 ID입니다. |
|
|
메일 클래스
|
mail_class | string |
배송업체 메일 클래스의 고유 ID 문자열로, 예상 배달 날짜를 계산하는 데 사용됩니다. |
|
|
최소 배달 일수
|
min_delivery_days | integer |
min_delivery_days |
|
|
최대 배달 일수
|
max_delivery_days | integer |
구매자가 구매한 품목이 배송되면 받을 때까지 기다릴 것으로 예상할 수 있는 최대 영업일수입니다. |
반환
배송 프로필 업그레이드 옵션의 표현입니다.
- ShopShippingProfileUpgrade
- ShopShippingProfileUpgrade
배송 프로필 업그레이드 삭제
배송 프로필 업그레이드를 삭제하고 연결된 배송 프로필을 사용하는 모든 목록에서 업그레이드 옵션을 제거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
배송 프로필 ID
|
shipping_profile_id | True | integer |
배송 프로필의 숫자 ID입니다. |
|
업그레이드 ID
|
upgrade_id | True | integer |
배송 업그레이드와 연결된 숫자 ID입니다. |
배송 프로필 업그레이드 업데이트
배송 프로필 업그레이드를 업데이트하고 배송 프로필을 사용하는 모든 목록을 업데이트합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
배송 프로필 ID
|
shipping_profile_id | True | integer |
목록과 연결된 배송 프로필의 숫자 ID입니다. |
|
업그레이드 ID
|
upgrade_id | True | integer |
배송 업그레이드와 연결된 숫자 ID입니다. |
|
유형
|
type | string |
배송 업그레이드의 유형입니다. 국내(0) 또는 국제(1). |
|
|
업그레이드 이름
|
upgrade_name | string |
체크 아웃 시 쇼핑객에게 표시되는 배송 업그레이드 이름(예: USPS 우선 순위). |
|
|
가격
|
price | float |
배송 업그레이드를 추가하는 추가 비용입니다. |
|
|
보조 가격
|
secondary_price | float |
각 추가 항목에 대한 배송 업그레이드를 추가하는 추가 비용입니다. |
|
|
배송업체 ID
|
shipping_carrier_id | integer |
예상 배송 날짜를 계산하는 데 사용되는 지원되는 배송업체의 고유 ID입니다. |
|
|
메일 클래스
|
mail_class | string |
배송업체 메일 클래스의 고유 ID 문자열로, 예상 배달 날짜를 계산하는 데 사용됩니다. |
|
|
최소 배달 일수
|
min_delivery_days | integer |
min_delivery_days |
|
|
최대 배달 일수
|
max_delivery_days | integer |
구매자가 구매한 품목이 배송되면 받을 때까지 기다릴 것으로 예상할 수 있는 최대 영업일수입니다. |
반환
배송 프로필 업그레이드 옵션의 표현입니다.
- ShopShippingProfileUpgrade
- ShopShippingProfileUpgrade
배송 프로필 업데이트
배송 프로필의 설정을 변경합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
배송 프로필 ID
|
shipping_profile_id | True | integer |
목록과 연결된 배송 프로필의 숫자 ID입니다. |
|
제목
|
title | string |
이 배송 프로필의 이름 문자열입니다. |
|
|
Origin Country ISO
|
origin_country_iso | string |
목록이 제공되는 국가의 ISO 코드입니다. |
|
|
최소 처리 시간
|
min_processing_time | integer |
이 배송 프로필을 사용하여 목록을 배송하는 데 필요한 최소 시간입니다. |
|
|
최대 처리 시간
|
max_processing_time | integer |
목록이 배송되어야 하는 최대 처리 시간입니다. |
|
|
처리 시간 단위
|
processing_time_unit | string |
처리 시간을 나타내는 데 사용되는 단위입니다. 1주일은 영업일 기준 5일과 같습니다. 아무 것도 제공되지 않으면 단위가 business_days 설정됩니다. |
|
|
원본 우편 번호
|
origin_postal_code | string |
목록이 제공되는 위치에 대한 우편 번호 문자열(반드시 숫자가 아님)입니다. |
반환
목록의 배송 정보를 설정하는 데 사용되는 프로필을 나타냅니다. API를 통해 계산된 배송 템플릿을 만들 수 없습니다. 그러나 Shop Manager에서 만든 계산된 배송 프로필을 API를 사용하여 목록과 연결할 수 있습니다.
- ShopShippingProfile
- ShopShippingProfile
배송 프로필로 프로필 대상 가져오기
배송 프로필과 연결된 배송 대상 개체 목록을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
배송 프로필 ID
|
shipping_profile_id | True | integer |
목록과 연결된 배송 프로필의 숫자 ID입니다. |
|
한계
|
limit | integer |
반환할 최대 결과 수입니다. |
|
|
상쇄
|
offset | integer |
첫 번째 결과를 선택하기 전에 건너뛸 레코드 수입니다. |
반환
배송 대상 개체의 목록을 나타냅니다.
- ShopShippingProfileDestinations
- ShopShippingProfileDestinations
배송업체 가져오기
지정된 국가에 대해 사용 가능한 배송업체 및 해당 운송업체와 연결된 메일 클래스 목록을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Origin Country ISO
|
origin_country_iso | True | string |
목록이 제공되는 국가의 ISO 코드입니다. |
반환
여러 ShippingCarriers를 나타냅니다.
- ShippingCarriers
- ShippingCarriers
분류 ID로 제품 속성 가져오기
특정 판매자 분류 ID에 대해 지원되는 해당 크기 조정 및 값을 사용하여 제품 속성 목록을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
분류 ID
|
taxonomy_id | True | string |
판매자 분류 계층 구조 트리로 구성된 목록의 메타데이터 범주인 Etsy 분류 노드의 고유 숫자 ID입니다. |
반환
제품 속성 정의 목록입니다.
- TaxonomyNodeProperties
- TaxonomyNodeProperties
사용자 가져오기
사용자 ID로 식별된 사용자의 사용자 프로필을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 ID
|
user_id | True | integer |
사용자에 대한 고유 양의 0이 아닌 숫자 ID입니다. |
반환
사이트의 단일 사용자를 나타냅니다.
- 사용자
- User
사용자 주소 가져오기
사용자 주소 목록을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
한계
|
limit | integer |
반환할 최대 결과 수입니다. |
|
|
상쇄
|
offset | integer |
첫 번째 결과를 선택하기 전에 건너뛸 레코드 수입니다. |
반환
여러 UserAddress 레코드를 나타냅니다.
- UserAddresses
- UserAddresses
사용자의 주소 가져오기
사용자의 주소를 검색합니다. 이 엔드포인트에 대한 개발이 진행 중입니다. 501 응답만 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 주소 ID
|
user_address_id | True | integer |
사용자 주소의 숫자 ID입니다. |
반환
사용자의 주소를 나타냅니다.
- UserAddress
- UserAddress
상점 검색
일치하는 이름의 상점 목록을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 이름
|
shop_name | True | string |
상점의 이름 문자열입니다. |
|
한계
|
limit | integer |
반환할 최대 결과 수입니다. |
|
|
상쇄
|
offset | integer |
첫 번째 결과를 선택하기 전에 건너뛸 레코드 수입니다. |
반환
Shop 레코드 집합입니다.
- 상점
- Shops
상점 결제 계정 원장의 항목 가져오기
상점의 결제 계정 원장의 항목을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
최소 생성
|
min_created | True | integer |
레코드를 만들 때의 가장 빠른 unix 타임스탬프입니다. |
|
만든 최대값
|
max_created | True | integer |
레코드를 만들 때의 최신 unix 타임스탬프입니다. |
|
한계
|
limit | integer |
반환할 최대 결과 수입니다. |
|
|
상쇄
|
offset | integer |
첫 번째 결과를 선택하기 전에 건너뛸 레코드 수입니다. |
반환
결제 계정 원장 항목 리소스 집합
- PaymentAccountLedgerEntries
- PaymentAccountLedgerEntries
상점 섹션 ID로 목록 가져오기
특정 상점의 섹션에서 모든 목록을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
Shop 섹션 ID
|
shop_section_ids | True | string |
특정 Etsy 상점의 모든 섹션에 대한 숫자 ID 배열입니다. |
|
한계
|
limit | integer |
반환할 최대 결과 수입니다. |
|
|
상쇄
|
offset | integer |
첫 번째 결과를 선택하기 전에 건너뛸 레코드 수입니다. |
|
|
정렬 기준
|
sort_on | string |
목록의 검색 결과를 정렬할 값입니다. |
|
|
정렬 순서
|
sort_order | string |
목록을 정렬할 오름차순(위쪽) 또는 내림차순(아래쪽) 순서입니다. |
반환
리소스를 나열하는 상점 집합입니다.
- ShopListings
- ShopListings
상점 섹션 가져오기
섹션 ID 및 상점 ID로 참조되는 상점 섹션을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
Shop 섹션 ID
|
shop_section_id | True | integer |
특정 Etsy 상점에 있는 섹션의 숫자 ID입니다. |
반환
사용자가 목록을 정렬할 수 있는 상점 내의 섹션입니다.
- ShopSection
- ShopSection
상점 섹션 가져오기
상점 ID로 식별된 특정 상점의 상점 섹션 목록을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
반환
스프레크 숍의 모든 섹션.
- ShopSections
- ShopSections
상점 섹션 만들기
특정 상점에 새 섹션을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
제목
|
title | True | string |
상점 섹션의 제목 문자열입니다. |
반환
사용자가 목록을 정렬할 수 있는 상점 내의 섹션입니다.
- ShopSection
- ShopSection
상점 업데이트
상점을 업데이트합니다. 모든 문자열 매개 변수가 상점의 기본 언어로 제공된다고 가정합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
제목
|
title | string |
상점의 메인 페이지에 대한 간단한 제목 문자열입니다. |
|
|
알림
|
announcement | string |
상점의 홈페이지에 표시되는 구매자에 대한 알림 문자열입니다. |
|
|
판매 메시지
|
sale_message | string |
이 가게에서 구매를 완료한 사용자에게 보낸 메시지 문자열입니다. |
|
|
디지털 판매 메시지
|
digital_sale_message | string |
이 가게에서 디지털 아이템을 구매한 사용자에게 보내는 메시지 문자열입니다. |
반환
Etsy 사용자가 만든 상점입니다.
- 쇼핑
- Shop
상점 영수증으로 목록 가져오기
영수증과 연결된 모든 목록을 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
이 트랜잭션과 연결된 영수증의 숫자 ID입니다. |
|
영수증 ID
|
receipt_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
한계
|
limit | integer |
반환할 최대 결과 수입니다. |
|
|
상쇄
|
offset | integer |
첫 번째 결과를 선택하기 전에 건너뛸 레코드 수입니다. |
반환
리소스를 나열하는 상점 집합입니다.
- ShopListings
- ShopListings
상점별 목록 가져오기
Shop에 속한 목록을 반환합니다. 상태 매개 변수를 사용하여 목록을 필터링할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
주
|
State | string |
활성 또는 비활성 중 하나에서 열거된 문자열입니다. |
|
|
한계
|
limit | integer |
반환할 최대 결과 수입니다. |
|
|
상쇄
|
offset | integer |
첫 번째 결과를 선택하기 전에 건너뛸 레코드 수입니다. |
|
|
정렬 기준
|
Sort On | string |
목록의 검색 결과를 정렬할 값입니다. |
|
|
정렬 순서
|
Sort Order | string |
목록을 정렬할 오름차순(위쪽) 또는 내림차순(아래쪽) 순서입니다. |
반환
리소스를 나열하는 상점 집합입니다.
- ShopListings
- ShopListings
상점별 추천 목록 가져오기
추천 상점과 연결된 목록을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
한계
|
limit | integer |
반환할 최대 결과 수입니다. |
|
|
상쇄
|
offset | integer |
첫 번째 결과를 선택하기 전에 건너뛸 레코드 수입니다. |
반환
리소스를 나열하는 상점 집합입니다.
- ShopListings
- ShopListings
상점별 활성 목록 가져오기
생성 날짜를 나열하여 페이지를 매긴 특정 상점의 Etsy에 있는 모든 활성 목록 목록을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
한계
|
limit | integer |
반환할 최대 결과 수입니다. |
|
|
상쇄
|
offset | integer |
첫 번째 결과를 선택하기 전에 건너뛸 레코드 수입니다. |
|
|
Includes
|
keywords | string |
모든 결과에 표시되어야 하는 검색 용어 또는 구입니다. |
반환
리소스를 나열하는 상점 집합입니다.
- ShopListings
- ShopListings
상점의 거래 가져오기
상점과 연결된 트랜잭션 목록을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
한계
|
limit | integer |
반환할 최대 결과 수입니다. |
|
|
상쇄
|
offset | integer |
첫 번째 결과를 선택하기 전에 건너뛸 레코드 수입니다. |
반환
상점 영수증 거래 리소스 집합
- ShopReceiptTransactions
- ShopReceiptTransactions
소유자 ID로 상점 가져오기
상점 주인의 사용자 ID로 식별된 상점을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 ID
|
user_id | True | string |
이 상점을 소유한 사용자의 숫자 사용자 ID입니다. |
반환
Etsy 사용자가 만든 상점입니다.
- 쇼핑
- Shop
영수증 받기
Etsy 상점에서 영수증 ID로 식별되는 영수증을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
영수증 ID
|
receipt_id | True | integer |
이 트랜잭션과 연결된 영수증의 숫자 ID입니다. |
반환
상점에서 구매한 레코드입니다. 상점 영수증은 상점의 통화를 사용하여 통화 값을 표시합니다.
- ShopReceipt
- ShopReceipt
영수증 받기
영수증 ID 범위 또는 오프셋, 날짜, 유료 및/또는 배송된 구매를 기준으로 필터링되거나 필터링된 특정 상점에서 상점 영수증을 요청합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
최소 생성
|
min_created | integer |
레코드를 만들 때의 가장 빠른 unix 타임스탬프입니다. |
|
|
만든 최대값
|
max_created | integer |
레코드를 만들 때의 최신 unix 타임스탬프입니다. |
|
|
가장 먼저 마지막으로 수정한 날짜
|
min_last_modified | integer |
레코드가 마지막으로 변경된 경우의 가장 빠른 unix 타임스탬프입니다. |
|
|
마지막으로 수정한 최신 날짜
|
max_last_modified | integer |
레코드가 마지막으로 변경된 경우의 최신 unix 타임스탬프입니다. |
|
|
한계
|
limit | integer |
반환할 최대 결과 수입니다. |
|
|
상쇄
|
offset | integer |
첫 번째 결과를 선택하기 전에 건너뛸 레코드 수입니다. |
|
|
지불되었습니다.
|
was_paid | boolean |
true이면 판매자가 이 영수증에서 제품에 대한 지불을 받았습니다. |
|
|
배송되었습니다.
|
was_shipped | boolean |
true이면 판매자가 이 영수증에 제품을 배송했습니다. |
반환
특정 상점의 영수증입니다.
- ShopReceipts
- ShopReceipts
영수증의 트랜잭션 가져오기
특정 영수증과 연결된 트랜잭션 목록을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
영수증 ID
|
receipt_id | True | integer |
이 트랜잭션과 연결된 영수증의 숫자 ID입니다. |
반환
상점 영수증 거래 리소스 집합
- ShopReceiptTransactions
- ShopReceiptTransactions
초안 목록 만들기
Etsy 채널의 상점에서 실제 초안 목록 제품을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
수량
|
quantity | True | integer |
목록에서 구매할 수 있는 양의 0이 아닌 제품 수입니다. |
|
제목
|
title | True | string |
목록의 제목 문자열입니다. 유효한 제목 문자열에는 문자, 숫자, 문장 부호, 수학 기호, 공백 문자 ™ © 및 ® . (regex: /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) %, :, 및 + 문자는 각각 한 번만 사용할 수 있습니다. |
|
Description
|
description | True | string |
목록에서 판매할 제품의 설명 문자열입니다. |
|
가격
|
price | True | float |
제품의 양의 0이 아닌 가격입니다. (판매된 제품 목록은 비공개) 참고: 가격은 가능한 최소 가격입니다. |
|
만든 사람
|
who_made | True | string |
제품을 만든 사람이 할당된 문자열입니다. 구매자가 수제 제목 아래에서 목록을 찾을 수 있도록 도와줍니다. 'is_supply' 및 'when_made'이 필요합니다. |
|
만든 경우
|
when_made | string |
이 목록에서 제조업체가 제품을 만든 시대의 문자열입니다. 구매자가 빈티지 제목 아래에 목록을 찾을 수 있도록 도와줍니다. 'is_supply' 및 'who_made'이 필요합니다. |
|
|
분류 ID
|
taxonomy_id | True | integer |
목록의 숫자 분류 ID입니다. 판매자는 자신의 상점에 대한 분류 ID를 나열 관리합니다. |
|
배송 프로필 ID
|
shipping_profile_id | True | integer |
목록과 연결된 배송 프로필의 숫자 ID입니다. |
|
Materials
|
materials | string |
제품에 사용되는 재료에 대한 재료 문자열의 배열입니다. 유효한 재질 문자열에는 문자, 숫자 및 공백 문자만 포함됩니다. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u) |
|
|
Shop 섹션 ID
|
shop_section_id | integer |
이 목록에 대한 상점 섹션의 숫자 ID입니다. |
|
|
최소 처리
|
processing_min | integer |
이 목록을 처리하는 데 필요한 최소 일 수입니다. |
|
|
최대 처리
|
processing_max | integer |
이 목록을 처리하는 데 필요한 최대 일 수입니다. |
|
|
태그들
|
tags | string |
목록에 대한 태그 문자열의 배열입니다. 유효한 태그 문자열에는 문자, 숫자, 공백 문자, -, ', ™ , © 및 ® . (regex: /[^\p{L}\p{Nd}\p{Zs}-'™©®]/u) |
|
|
Recipient
|
recipient | string |
이 제품이 적절한 선물을 만들 사람을 나타내는 문자열입니다. |
|
|
경우
|
occasion | string |
이 제품이 적절한 선물을 만드는 경우를 나타내는 문자열입니다. |
|
|
스타일
|
styles | string |
이 목록에 대한 스타일 문자열의 배열이며, 각각은 정식 또는 Steampunk와 같은 자유 형식 텍스트 문자열입니다. 목록에는 최대 2개의 스타일이 있을 수 있습니다. 유효한 스타일 문자열에는 문자, 숫자 및 공백 문자만 포함됩니다. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u) |
|
|
항목 가중치
|
item_weight | float |
항목 중량 단위로 설정된 단위로 측정된 제품의 숫자 가중치입니다. |
|
|
항목 길이
|
item_length | integer |
항목 차원 단위로 설정된 단위로 측정된 제품의 숫자 길이입니다. |
|
|
항목 너비
|
item_width | float |
'항목 차원 단위'에 설정된 단위로 측정된 제품의 숫자 너비입니다. |
|
|
항목 높이
|
item_height | float |
'항목 차원 단위'에 설정된 단위로 측정된 제품의 숫자 높이입니다. |
|
|
항목 가중치 단위
|
item_weight_unit | string |
제품의 가중치를 측정하는 데 사용되는 단위를 정의하는 문자열입니다. |
|
|
항목 차원 단위
|
item_dimensions_unit | string |
제품의 차원을 측정하는 데 사용되는 단위를 정의하는 문자열입니다. |
|
|
Personalizable인가요?
|
is_personalizable | boolean |
true이면 이 목록을 개인 설정할 수 있습니다. |
|
|
이미지 ID
|
image_ids | string |
최대 10개의 이미지를 포함할 수 있는 목록에 있는 이미지의 숫자 이미지 ID 배열입니다. |
|
|
공급입니다.
|
is_supply | boolean |
true이면 목록에 공급 제품으로 태그를 지정하고, 그렇지 않으면 완성된 제품임을 나타냅니다. 구매자가 공급 제목 아래에서 목록을 찾을 수 있도록 도와줍니다. '만든 사람'과 '언제 만들어졌을 때'가 필요합니다. |
|
|
사용자 정의 가능
|
is_customizable | boolean |
true이면 구매자가 판매자에게 연락하여 사용자 지정 주문을 할 수 있습니다. 상점이 사용자 지정 주문을 수락하는 경우 기본값은 true입니다. 사용자 지정 주문을 수락하지 않는 상점에는 적용되지 않습니다. |
|
|
과세 가능
|
is_taxable | boolean |
해당하는 경우 체크 아웃 시 해당 상점 세율이 이 목록에 적용됩니다. |
반환
제품 수량, 제목, 설명, 가격 등을 포함하는 상점의 목록입니다.
- ShopListing
- ShopListing
트랜잭션 가져오기
트랜잭션 ID로 트랜잭션을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
트랜잭션 ID
|
transaction_id | True | integer |
트랜잭션의 고유 숫자 ID입니다. |
반환
상점 영수증과 연결된 트랜잭션 개체입니다. Etsy는 주문 영수증에 기록된 대로 구매한 목록당 하나의 트랜잭션을 생성합니다.
- ShopReceiptTransaction
- ShopReceiptTransaction
특정 영수증에서 결제 받기
특정 상점의 영수증 ID로 식별되는 특정 영수증에서 상점 ID로 식별되는 결제를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상점 ID
|
shop_id | True | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
영수증 ID
|
receipt_id | True | string |
이 트랜잭션과 연결된 영수증의 숫자 ID입니다. |
반환
Etsy Payments로 이루어진 여러 결제를 나타냅니다. 달리 지정하지 않는 한 모든 금액은 USD 동전으로 제공됩니다.
- 결제
- Payments
판매자 분류 노드 가져오기
활성 목록 가져오기
생성 날짜별로 페이지를 매긴 Etsy의 모든 활성 목록 목록입니다. 정렬 순서 목록이 없으면 기본적으로 최신 순서 목록이 반환됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
한계
|
limit | integer |
반환할 최대 결과 수입니다. |
|
|
상쇄
|
offset | integer |
첫 번째 결과를 선택하기 전에 건너뛸 레코드 수입니다. |
|
|
Includes
|
keywords | string |
모든 결과에 표시되어야 하는 검색 용어 또는 구입니다. |
|
|
정렬 기준
|
sort_on | string |
목록의 검색 결과를 정렬할 값입니다. 참고: 정렬은 검색 옵션(키워드, 지역 등) 중 하나와 결합된 경우에만 작동합니다. |
|
|
정렬 순서
|
sort_order | string |
목록을 정렬할 오름차순(위쪽) 또는 내림차순(아래쪽) 순서입니다. 참고: sort_order 검색 옵션(키워드, 지역 등) 중 하나와 결합된 경우에만 작동합니다. |
|
|
최소 가격
|
min_price | float |
검색 결과에서 반환할 목록의 최소 가격입니다. |
|
|
최대 가격
|
max_price | float |
검색 결과에서 반환할 목록의 최대 가격입니다. |
|
|
분류 ID
|
taxonomy_id | integer |
목록의 숫자 분류 ID입니다. 판매자는 자신의 상점에 대한 분류 ID를 나열 관리합니다. |
|
|
쇼핑 위치
|
shop_location | string |
상점 위치별로 필터링합니다. 위치를 구문 분석할 수 없는 경우 Etsy는 오류로 응답합니다. |
반환
리소스를 나열하는 상점 집합입니다.
- ShopListings
- ShopListings
정의
ShopListing
제품 수량, 제목, 설명, 가격 등을 포함하는 상점의 목록입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
목록 ID
|
listing_id | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
사용자 ID
|
user_id | integer |
목록을 게시하는 사용자의 숫자 ID입니다. |
|
상점 ID
|
shop_id | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
제목
|
title | string |
목록의 제목 문자열입니다. 유효한 제목 문자열에는 문자, 숫자, 문장 부호, 수학 기호, 공백 문자 ™ © 및 ® . (regex: /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) %, :, 및 + 문자는 각각 한 번만 사용할 수 있습니다. |
|
Description
|
description | string |
목록에서 판매할 제품의 설명 문자열입니다. |
|
주
|
state | State |
활성 또는 비활성 중 하나에서 열거된 문자열입니다. 참고: 초안 목록을 활성으로 설정하면 etsy.com 목록도 게시됩니다. |
|
만들기 타임스탬프
|
creation_timestamp | integer |
목록의 생성 시간(epoch 초)입니다. |
|
끝 타임스탬프
|
ending_timestamp | integer |
목록의 만료 시간(epoch 초)입니다. |
|
원래 만들기 타임스탬프
|
original_creation_timestamp | integer |
목록의 생성 시간(epoch 초)입니다. |
|
마지막으로 수정한 타임스탬프
|
last_modified_timestamp | integer |
목록에 대한 마지막 업데이트 시간(epoch 초)입니다. |
|
마지막 상태 변경 타임스탬프
|
state_timestamp | integer |
이 목록의 마지막 상태 변경 날짜 및 시간입니다. |
|
수량
|
quantity | integer |
목록에서 구매할 수 있는 양의 0이 아닌 제품 수입니다. 참고: 목록 수량은 사용 가능한 제품 수량의 합계입니다. 목록 인벤토리 엔드포인트 가져오기를 사용하여 ListingInventory 리소스에서 개별 제품에 대한 수량을 요청할 수 있습니다. |
|
Shop 섹션 ID
|
shop_section_id | integer |
특정 Etsy 상점에 있는 섹션의 숫자 ID입니다. |
|
추천 순위
|
featured_rank | integer |
매장의 추천 목록에서 0이 아닌 긍정적인 숫자 위치로, 1위 목록은 상점 홈페이지의 추천 목록에서 가장 왼쪽에 나타납니다. |
|
URL
|
url | string |
Etsy의 목록 페이지에 대한 전체 URL입니다. |
|
호의자 수
|
num_favorers | integer |
이 목록을 즐겨찾기로 표시한 사용자 수입니다. |
|
비과세
|
non_taxable | boolean |
해당하는 경우 체크 아웃 시 해당 상점 세율이 이 목록에 적용되지 않습니다. |
|
사용자 정의 가능
|
is_customizable | boolean |
true이면 구매자가 판매자에게 연락하여 사용자 지정 주문을 할 수 있습니다. 상점이 사용자 지정 주문을 수락하는 경우 기본값은 true입니다. 사용자 지정 주문을 수락하지 않는 상점에는 적용되지 않습니다. |
|
Peronalizable인가요?
|
is_personalizable | boolean |
true이면 이 목록을 개인 설정할 수 있습니다. 기본값은 null합니다. |
|
개인 설정이 필요합니다.
|
personalization_is_required | boolean |
true이면 이 목록에 개인 설정이 필요합니다. 기본값은 null합니다. |
|
최대 개인 설정 문자 수
|
personalization_char_count_max | integer |
구매자가 입력한 개인 설정 메시지의 최대 길이를 나타내는 정수 값입니다. |
|
개인 설정 지침
|
personalization_instructions | string |
true이면 이 목록에 개인 설정이 필요합니다. 기본값은 null합니다. |
|
목록 유형
|
listing_type | boolean |
목록이 실제 다운로드인지 디지털 다운로드인지를 나타내는 열거형 형식 문자열입니다. |
|
태그들
|
tags | array of string |
목록에 대한 태그 문자열 목록입니다. 유효한 태그 문자열에는 문자, 숫자, 공백 문자, -, ', ™ , © 및 ® . (regex: /[^\p{L}\p{Nd}\p{Zs}\-'™©®]/u) 기본값은 null입니다. |
|
Materials
|
materials | array of string |
제품에 사용되는 재료의 재질 문자열 목록입니다. 유효한 재질 문자열에는 문자, 숫자 및 공백 문자만 포함됩니다. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u) 기본값은 null입니다. |
|
배송 프로필 ID
|
shipping_profile_id | integer |
목록과 연결된 배송 프로필의 숫자 ID입니다. |
|
최소 처리 일수
|
processing_min | integer |
이 목록을 처리하는 데 필요한 최소 일 수입니다. 기본값은 null입니다. |
|
최대 처리 일수
|
processing_max | integer |
이 목록을 처리하는 데 필요한 최대 일 수입니다. 기본값은 null입니다. |
|
WhoMade
|
who_made | WhoMade |
제품을 만든 사람이 포함된 열거형 문자열입니다. 구매자가 수제 제목 아래에서 목록을 찾을 수 있도록 도와줍니다. 'is_supply' 및 'when_made'이 필요합니다. |
|
WhenMade
|
when_made | WhenMade |
제조업체가 이 목록에서 제품을 만든 시대의 열거형 문자열입니다. 구매자가 빈티지 제목 아래에 목록을 찾을 수 있도록 도와줍니다. 'is_supply' 및 'who_made'이 필요합니다. |
|
제품 공급
|
is_supply | boolean |
true이면 목록에 공급 제품으로 태그를 지정하고, 그렇지 않으면 완성된 제품임을 나타냅니다. 구매자가 공급 제목 아래에서 목록을 찾을 수 있도록 도와줍니다. 'who_made' 및 'when_made'이 필요합니다. |
|
항목 가중치
|
item_weight | double |
항목 중량 단위로 설정된 단위로 측정된 제품의 숫자 가중치입니다. 기본값은 null입니다. 설정하면 값이 0보다 커야 합니다. |
|
ItemWeightUnit
|
item_weight_unit | ItemWeightUnit |
제품의 가중치를 측정하는 데 사용되는 단위를 정의하는 문자열입니다. 기본값은 null입니다. |
|
항목 길이
|
item_length | double |
항목 차원 단위로 설정된 단위로 측정된 제품의 숫자 길이입니다. 기본값은 null입니다. 설정하면 값이 0보다 커야 합니다. |
|
항목 너비
|
item_width | double |
항목 차원 단위로 설정된 단위로 측정된 제품의 숫자 너비입니다. 기본값은 null입니다. 설정하면 값이 0보다 커야 합니다. |
|
항목 높이
|
item_height | double |
항목 차원 단위로 설정된 단위로 측정된 제품의 숫자 길이입니다. 기본값은 null입니다. 설정하면 값이 0보다 커야 합니다. |
|
ItemDimensionsUnit
|
item_dimensions_unit | ItemDimensionsUnit |
제품의 차원을 측정하는 데 사용되는 단위를 정의하는 문자열입니다. 기본값은 null입니다. |
|
비공개임
|
is_private | boolean |
사실이라면, 이것은 특정 구매자를위한 개인 목록이며 상점 보기에서 숨겨져 있습니다. |
|
Recipient
|
recipient | Recipient |
이 제품이 적절한 선물을 만들 사람을 나타내는 열거형 문자열입니다. 기본값은 null입니다. |
|
경우
|
occasion | Occasion |
이 제품이 적절한 선물을 만드는 경우를 나타내는 열거형 문자열입니다. 기본값은 null입니다. |
|
스타일
|
style | array of string |
이 목록에 대한 스타일 문자열의 배열이며, 각각은 정식 또는 Steampunk와 같은 자유 형식 텍스트 문자열입니다. 목록에는 최대 2개의 스타일이 있을 수 있습니다. 유효한 스타일 문자열에는 문자, 숫자 및 공백 문자만 포함됩니다. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u) 기본값은 null입니다. |
|
파일 데이터
|
file_data | string |
디지털 목록에 첨부된 파일을 설명하는 문자열입니다. |
|
변형이 있습니다.
|
has_variations | boolean |
true이면 목록에 변형이 있습니다. |
|
자동 갱신해야 합니다.
|
should_auto_renew | boolean |
true이면 추방 시 4개월 동안 목록을 갱신합니다. 이전에 false일 때 true로 설정된 경우 etsy.com 만료되기 전에 목록을 갱신하지만 갱신 기간은 목록의 만료 날짜를 연장하지 않고 변경적으로 시작됩니다. 목록에 남아 있는 사용되지 않은 시간은 손실됩니다. 갱신하면 사용자의 청구서에 대한 요금이 청구됩니다. |
|
Language
|
language | string |
목록의 기본 언어에 대한 IETF 언어 태그입니다. 예: |
|
돈
|
price | Money |
금액의 표현입니다. |
|
분류 ID
|
taxonomy_id | integer |
목록의 숫자 분류 ID입니다. 판매자는 자신의 상점에 대한 분류 ID를 나열 관리합니다. 자세한 내용은 판매자 분류를 참조하세요. |
돈
금액의 표현입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
금액
|
amount | integer |
이 데이터가 나타내는 양입니다. |
|
제수
|
divisor | integer |
양을 렌더링할 수수입니다. |
|
통화 코드
|
currency_code | string |
이 데이터에 대한 ISO 통화 코드입니다. |
ShopListingFile
디지털 목록과 연결된 파일입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
목록 파일 ID
|
listing_file_id | integer |
디지털 목록과 연결된 파일의 고유 숫자 ID입니다. |
|
목록 ID
|
listing_id | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
등급
|
rank | integer |
목록에서 이 파일의 표시 순서 위치(1부터)의 숫자 인덱스입니다. |
|
Filename
|
filename | string |
디지털 목록과 연결된 파일의 파일 이름 문자열입니다. |
|
파일화
|
filesize | string |
파일 크기에 대한 사람이 읽을 수 있는 형식 크기 문자열입니다. |
|
크기(바이트)
|
size_bytes | integer |
파일의 크기를 나타내는 숫자로, 바이트 단위로 측정합니다. |
|
파일 형식
|
filetype | string |
파일의 MIME 형식을 나타내는 형식 문자열입니다. |
|
타임스탬프 만들기
|
create_timestamp | integer |
디지털 목록과 연결된 파일의 고유한 숫자 타임스탬프입니다. |
ShopListingFiles
여러 ShopListingFile을 나타냅니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수량
|
count | integer |
반환되는 ShopListingFiles의 수입니다. |
|
Results
|
results | array of ShopListingFile |
ShopListingFile 리소스의 배열입니다. |
ShopListings
리소스를 나열하는 상점 집합입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수량
|
count | integer |
찾은 상점 목록 리소스의 수입니다. |
|
Results
|
results | array of ShopListing |
찾은 리소스를 나열하는 상점입니다. |
사용자
사이트의 단일 사용자를 나타냅니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사용자 ID
|
user_id | integer |
사용자의 숫자 ID입니다. 이 번호는 사용자의 상점에 유효한 상점 ID이기도 합니다. |
|
로그인 이름
|
login_name | string |
사용자의 로그인 이름 문자열입니다. |
|
기본 메일 주소
|
primary_email | string |
사용자의 기본 전자 메일 주소에 대한 이메일 주소 문자열입니다. |
|
이름 (First Name)
|
first_name | string |
사용자의 이름입니다. |
|
성 이름
|
last_name | string |
사용자의 성입니다. |
|
생성된 타임스탬프
|
create_timestamp | integer |
사용자가 계정을 만든 날짜 및 시간(epoch 초)입니다. |
|
사용자 ID로 참조
|
referred_by_user_id | integer |
이 사용자를 참조한 사용자의 숫자 ID입니다. |
|
새 인벤토리 엔드포인트 사용
|
use_new_inventory_endpoints | boolean |
Deprecated. 항상 true입니다. |
|
판매자입니다.
|
is_seller | boolean |
True이면 사용자가 판매자입니다. |
|
전기
|
bio | string |
사용자의 전기입니다. |
|
성별
|
gender | string |
사용자의 성별입니다. |
|
생년월
|
birth_month | string |
사용자의 출생 월입니다. |
|
생일
|
birth_day | string |
사용자의 출생일입니다. |
|
구매 트랜잭션 수
|
transaction_buy_count | integer |
사용자가 구입한 트랜잭션 수입니다. |
|
판매된 트랜잭션 수
|
transaction_sold_count | integer |
사용자가 판매한 트랜잭션 수입니다. |
쇼핑
Etsy 사용자가 만든 상점입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
상점 ID
|
shop_id | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
사용자 ID
|
user_id | integer |
이 상점을 소유한 사용자의 숫자 사용자 ID입니다. |
|
상점 이름
|
shop_name | string |
상점의 이름 문자열입니다. |
|
생성 날짜
|
create_date | integer |
이 가게가 만들어진 날짜와 시간(epoch 초)입니다. |
|
제목
|
title | string |
상점의 메인 페이지에 대한 간단한 제목 문자열입니다. |
|
알림
|
announcement | string |
상점의 홈페이지에 표시되는 구매자에 대한 알림 문자열입니다. |
|
통화 코드
|
currency_code | string |
상점의 통화에 대한 ISO(영문자) 코드입니다. 상점은 기본적으로이 통화로 모든 가격을 표시합니다. |
|
휴가 중
|
is_vacation | boolean |
사실, 이 가게는 구매를 수락하지 않습니다. |
|
휴가 메시지
|
vacation_message | string |
is_vacation 때 표시되는 상점의 메시지 문자열입니다. |
|
판매 메시지
|
sale_message | string |
이 가게에서 구매를 완료한 사용자에게 보낸 메시지 문자열입니다. |
|
디지털 판매 메시지
|
digital_sale_message | string |
이 가게에서 디지털 아이템을 구매한 사용자에게 보내는 메시지 문자열입니다. |
|
업데이트된 날짜
|
update_date | integer |
상점에 대한 마지막 업데이트 날짜 및 시간(epoch 초)입니다. |
|
활성 목록 수
|
listing_active_count | integer |
상점의 활성 목록 수입니다. |
|
디지털 목록 수
|
digital_listing_count | integer |
상점의 디지털 목록 수입니다. |
|
로그인 이름
|
login_name | string |
상점 주인의 로그인 이름 문자열입니다. |
|
사용자 지정 요청을 수락합니다.
|
accepts_custom_requests | boolean |
true이면 스토어에서 사용자 지정 요청을 수락합니다. |
|
시작 정책
|
policy_welcome | string |
상점의 정책 환영 문자열(비어 있을 수 있음). |
|
결제 정책
|
policy_payment | string |
상점의 결제 정책 문자열(비어 있을 수 있음)입니다. |
|
배송 정책
|
policy_shipping | string |
상점의 배송 정책 문자열(비어 있을 수 있음)입니다. |
|
환불 정책
|
policy_refunds | string |
상점의 환불 정책 문자열(비어 있을 수 있음). |
|
추가 정책
|
policy_additional | string |
상점의 추가 정책 문자열(비어 있을 수 있음)입니다. |
|
판매자 정보
|
policy_seller_info | string |
상점의 판매자 정보 문자열(비어 있을 수 있음). |
|
정책 업데이트 날짜
|
policy_update_date | integer |
상점 정책에 대한 마지막 업데이트 날짜 및 시간(epoch 초)입니다. |
|
개인 영수증 정책이 있습니다.
|
policy_has_private_receipt_info | boolean |
true이면 EU 영수증에 개인 정보가 표시됩니다. |
|
구조화되지 않은 정책 사용
|
has_unstructured_policies | boolean |
true이면 상점에 구조화되지 않은 추가 정책 필드가 표시됩니다. |
|
개인 정보 취급 방침
|
policy_privacy | string |
상점의 개인 정보 취급 방침 문자열(비어 있을 수 있음). |
|
휴가 자동 복구
|
vacation_autoreply | string |
is_vacation 때 새 대화에 표시되는 상점의 자동 회신 문자열입니다. |
|
URL
|
url | string |
이 상점의 URL 문자열입니다. |
|
배너 이미지 URL
|
image_url_760x100 | string |
이 상점의 배너 이미지에 대한 URL 문자열입니다. |
|
호의자 수
|
num_favorers | integer |
이 가게를 즐겨찾기로 표시한 사용자 수입니다. |
|
Languages
|
languages | array of string |
상점의 등록된 언어에 대한 언어 문자열 목록입니다. |
|
아이콘 이미지 URL
|
icon_url_fullxfull | string |
이 상점의 아이콘 이미지에 대한 URL 문자열입니다. |
|
구조적 정책을 사용하고 있습니다.
|
is_using_structured_policies | boolean |
사실이라면, 가게는 구조화 된 정책을 사용하여 받아 들였다. |
|
온보딩된 구조적 정책 사용
|
has_onboarded_structured_policies | boolean |
사실이라면, 가게는 구조적 정책 온보딩을 본 후 수락하거나 거절했습니다. |
|
분쟁 양식 링크 포함
|
include_dispute_form_link | boolean |
사실이라면, 이 상점의 정책에는 EU 온라인 분쟁 양식에 대한 링크가 포함되어 있습니다. |
|
직접 체크 아웃 온보딩됨
|
is_direct_checkout_onboarded | boolean |
사실이라면, 가게는 Etsy 결제에 등록되었습니다. |
|
계산된 배송이 적격
|
is_calculated_eligible | boolean |
true이면 계산된 배송 프로필에 대해 상점을 우아하게 사용할 수 있습니다. (미국과 캐나다에서만 사용 가능) |
|
구매자 약속에 옵트인됨
|
is_opted_in_to_buyer_promise | boolean |
사실, 가게는 구매자 약속에 옵트인. |
|
미국 기반인가요?
|
is_shop_us_based | boolean |
사실, 가게는 미국에 본사를 두고 있습니다. |
|
판매 트랜잭션 수
|
transaction_sold_count | integer |
이 상점의 총 판매 거래 수 |
|
국가 ISO에서 배송
|
shipping_from_country_iso | string |
가게에서 배송하는 국가 iso입니다. |
|
쇼핑 위치 ISO
|
shop_location_country_iso | string |
가게가 위치한 국가 iso입니다. |
|
검토 횟수
|
review_count | integer |
지난 1년 동안의 상점 목록 리뷰 수입니다. |
|
평균 검토
|
review_average | double |
지난 1년 동안의 상점 목록 리뷰에 따른 평균 등급입니다. |
ListingImage
특정 목록과 연결된 이미지에 대한 참조 URL 및 메타데이터입니다. 매개 변수에는 url_fullxfull 전체 크기 이진 이미지 파일의 URL이 포함됩니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
목록 ID
|
listing_id | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
이미지 ID 나열
|
listing_image_id | integer |
이 트랜잭션에 대한 기본 목록 이미지의 숫자 ID입니다. |
|
헥스 코드
|
hex_code | string |
이미지의 평균 색에 대한 웹벡스 문자열(웹벡스 표기법)입니다. |
|
빨간색 값
|
red | integer |
숫자 빨간색 값은 0-255(RGB 색)에서 이미지의 평균 빨간색 값과 같습니다. |
|
녹색 값
|
green | integer |
숫자 빨간색 값은 0-255(RGB 색)에서 이미지의 평균 빨간색 값과 같습니다. |
|
파란색 값
|
blue | integer |
숫자 빨간색 값은 0-255(RGB 색)에서 이미지의 평균 빨간색 값과 같습니다. |
|
Hue 값
|
hue | integer |
숫자 색조는 이미지의 평균 색조(0-360(HSV 색))와 같습니다. |
|
채도 값
|
saturation | integer |
숫자 채도는 이미지의 평균 채도(0-100(HSV 색))와 같습니다. |
|
밝기 값
|
brightness | integer |
숫자 밝기(0-100(HSV 색)에서 이미지의 평균 밝기와 같습니다. |
|
흑백
|
is_black_and_white | boolean |
true이면 이미지가 검은색과 흰색으로 표시됩니다. |
|
생성 시간
|
creation_tsz | integer |
목록 이미지의 생성 시간(epoch 초)입니다. |
|
등급
|
rank | integer |
목록에 표시된 이미지에서 0이 아닌 양의 숫자 위치로, 목록의 맨 왼쪽 위치에 순위 1 이미지가 표시됩니다. |
|
75x75 이미지 URL
|
url_75x75 | string |
이미지의 75x75 픽셀 축소판 그림에 대한 URL 문자열입니다. |
|
170x135 이미지 URL
|
url_170x135 | string |
이미지의 170x135 픽셀 축소판 그림에 대한 URL 문자열입니다. |
|
570xN 이미지 URL
|
url_570xN | string |
이미지 썸네일의 URL 문자열로, 너비가 570픽셀 이하인 가변 높이입니다. |
|
전체 크기 이미지 URL
|
url_fullxfull | string |
각 차원에 최대 3,000픽셀의 전체 크기 이미지에 대한 URL 문자열입니다. |
|
전체 크기 이미지 높이
|
full_height | integer |
url_fullxfull 참조된 전체 크기 이미지의 픽셀 단위로 측정된 숫자 높이입니다. |
|
전체 크기 이미지 너비
|
full_width | integer |
url_fullxfull 참조되는 전체 크기 이미지의 숫자 너비(픽셀 단위)입니다. |
ListingImages
이미지 리소스 목록 목록을 나타내며, 각 리소스에는 이미지에 대한 참조 URL 및 메타데이터가 포함됩니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수량
|
count | integer |
결과 수입니다. |
|
Results
|
results | array of ListingImage |
요청된 리소스 목록입니다. |
ListingInventoryWithAssociations
연결과 단일 목록의 인벤토리 레코드 표현
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Products
|
products | array of ListingInventoryProduct |
제품 하나만 있는 경우에도 목록에서 사용할 수 있는 제품의 JSON 배열입니다. JSON Blob의 모든 필드 이름은 소문자입니다. |
|
속성의 가격
|
price_on_property | array of integer |
제품 가격을 변경하는 속성에 대한 고유 목록 속성 ID 정수의 배열입니다(있는 경우). 예를 들어 동일한 목록에 있는 다양한 크기의 제품에 대해 특정 가격을 청구하는 경우 이 배열에는 크기에 대한 속성 ID가 포함됩니다. |
|
속성의 수량
|
quantity_on_property | array of integer |
제품의 수량을 변경하는 속성에 대한 고유한 목록 속성 ID 정수 배열(있는 경우)입니다. 예를 들어 동일한 목록에 있는 다양한 색 제품의 특정 수량을 재고하는 경우 이 배열에는 색에 대한 속성 ID가 포함됩니다. |
|
속성의 SKU
|
sku_on_property | array of integer |
제품 SKU를 변경하는 속성에 대한 고유 목록 속성 ID 정수의 배열입니다(있는 경우). 예를 들어 동일한 목록에서 다른 색 제품에 특정 SKU를 사용하는 경우 이 배열에는 색에 대한 속성 ID가 포함됩니다. |
|
ShopListing
|
listing | ShopListing |
제품 수량, 제목, 설명, 가격 등을 포함하는 상점의 목록입니다. |
ListingInventoryProduct
목록에 대한 제품의 표현입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
제품 ID
|
product_id | integer |
목록에서 구매한 특정 제품의 숫자 ID입니다. |
|
SKU
|
sku | string |
제품의 SKU 문자열 |
|
삭제됨
|
is_deleted | boolean |
true이면 누군가가 이 제품을 삭제했습니다. |
|
Offerings
|
offerings | array of ListingInventoryProductOffering |
이 제품에 대한 제품 제공 항목 목록입니다. |
|
속성 값
|
property_values | array of ListingPropertyValue |
이 제품의 속성 값 항목 목록입니다. |
ListingInventoryProductOffering
목록에 대한 제품의 표현입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
제품 ID
|
offering_id | integer |
제품 제품의 ID |
|
수량
|
quantity | integer |
제품 제공 수량 |
|
사용
|
is_enabled | boolean |
제품을 구매자에게 표시할 수 있는지 여부입니다. |
|
삭제됨
|
is_deleted | boolean |
제품이 삭제되었는지 여부입니다. |
|
돈
|
price | Money |
금액의 표현입니다. |
ListingPropertyValue
구조화된 데이터 값의 표현입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
속성 ID
|
property_id | integer |
속성의 숫자 ID입니다. |
|
이름
|
property_name | string |
속성의 이름입니다. |
|
크기 조정 ID
|
scale_id | integer |
눈금의 숫자 ID(있는 경우)입니다. |
|
크기 조정 이름
|
scale_name | string |
선택한 배율을 설명하는 데 사용되는 레이블입니다(있는 경우). |
|
값 ID
|
value_ids | array of integer |
속성 값의 숫자 ID |
|
가치들
|
values | array of string |
속성 값 |
ListingInventory
단일 목록의 인벤토리 레코드 표현입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Products
|
products | array of ListingInventoryProduct |
제품 하나만 있는 경우에도 목록에서 사용할 수 있는 제품의 JSON 배열입니다. JSON Blob의 모든 필드 이름은 소문자입니다. |
|
속성의 가격
|
price_on_property | array of integer |
제품 가격을 변경하는 속성에 대한 고유 목록 속성 ID 정수의 배열입니다(있는 경우). 예를 들어 동일한 목록에 있는 다양한 크기의 제품에 대해 특정 가격을 청구하는 경우 이 배열에는 크기에 대한 속성 ID가 포함됩니다. |
|
속성의 수량
|
quantity_on_property | array of integer |
제품의 수량을 변경하는 속성에 대한 고유한 목록 속성 ID 정수 배열(있는 경우)입니다. 예를 들어 동일한 목록에 있는 다양한 색 제품의 특정 수량을 재고하는 경우 이 배열에는 색에 대한 속성 ID가 포함됩니다. |
|
속성의 SKU
|
sku_on_property | array of integer |
제품 SKU를 변경하는 속성에 대한 고유 목록 속성 ID 정수의 배열입니다(있는 경우). 예를 들어 동일한 목록에서 다른 색 제품에 특정 SKU를 사용하는 경우 이 배열에는 색에 대한 속성 ID가 포함됩니다. |
ShopListingsWithAssociations
연결과 리소스를 나열하는 상점 집합입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수량
|
count | integer |
찾은 상점 목록 리소스의 수입니다. |
|
Results
|
results | array of ShopListing |
찾은 리소스를 나열하는 상점입니다. |
ListingPropertyValues
여러 목록 속성 값을 나타냅니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수량
|
count | integer |
찾은 상점 목록 리소스의 수입니다. |
|
Results
|
results | array of ListingPropertyValue |
찾은 리소스를 나열하는 상점입니다. |
ShopReceiptTransactions
상점 영수증 거래 리소스 집합
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수량
|
count | integer |
찾은 상점 영수증 트랜잭션 리소스의 수입니다. |
|
Results
|
results | array of ShopReceiptTransaction |
상점 영수증 거래 리소스가 발견되었습니다. |
ShopReceiptTransaction
상점 영수증과 연결된 트랜잭션 개체입니다. Etsy는 주문 영수증에 기록된 대로 구매한 목록당 하나의 트랜잭션을 생성합니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
트랜잭션 ID
|
transaction_id | integer |
트랜잭션의 고유 숫자 ID입니다. |
|
제목
|
title | string |
이 트랜잭션에서 구매한 목록의 제목 문자열입니다. |
|
Description
|
description | string |
이 트랜잭션에서 구매한 목록의 설명 문자열입니다. |
|
판매자 사용자 ID
|
seller_user_id | integer |
이 트랜잭션의 판매자에 대한 숫자 사용자 ID입니다. |
|
구매자 사용자 ID
|
buyer_user_id | integer |
이 트랜잭션의 구매자에 대한 숫자 사용자 ID입니다. |
|
생성된 타임스탬프
|
create_timestamp | integer |
트랜잭션의 생성 날짜 및 시간(epoch 초)입니다. |
|
유료 타임스탬프
|
paid_timestamp | integer |
트랜잭션의 유료 날짜 및 시간(epoch 초)입니다. |
|
배송된 타임스탬프
|
shipped_timestamp | integer |
트랜잭션의 배송 날짜 및 시간(epoch 초)입니다. |
|
수량
|
quantity | integer |
이 트랜잭션에서 구매한 제품의 수량입니다. |
|
이미지 ID 나열
|
listing_image_id | integer |
이 트랜잭션에 대한 기본 목록 이미지의 숫자 ID입니다. |
|
영수증 ID
|
receipt_id | integer |
이 트랜잭션과 연결된 영수증의 숫자 ID입니다. |
|
디지털인가요?
|
is_digital | boolean |
true이면 트랜잭션이 디지털 목록의 구매를 기록했습니다. |
|
파일 데이터
|
file_data | string |
이 트랜잭션에서 구매한 파일을 설명하는 문자열입니다. |
|
목록 ID
|
listing_id | integer |
이 트랜잭션에 연결된 목록의 숫자 ID입니다. |
|
트랜잭션 유형
|
transaction_type | string |
트랜잭션의 형식 문자열로, 일반적으로 나열됩니다. |
|
제품 ID
|
product_id | integer |
목록에서 구매한 특정 제품의 숫자 ID입니다. |
|
돈
|
price | Money |
금액의 표현입니다. |
|
돈
|
shipping_cost | Money |
금액의 표현입니다. |
ListingTranslation
목록의 번역 데이터를 나타냅니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
목록 ID
|
listing_id | integer |
목록의 숫자 ID입니다. |
|
Language
|
language | string |
이 번역의 언어에 대한 IETF 언어 태그(예: 'fr')입니다. |
|
제목
|
title | string |
이 번역 목록의 제목입니다. |
|
Description
|
description | string |
이 번역 목록에 대한 설명입니다. |
|
태그들
|
tags | array of string |
이 번역 목록의 태그입니다. |
ListingVariationImages
여러 목록 변형 이미지를 나타냅니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수량
|
count | integer |
변형 이미지의 수입니다. |
|
Results
|
results | array of ListingVariationImage |
변형 이미지 결과입니다. |
ListingVariationImage
목록의 변형 및 이미지 연결 표현입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
속성 ID
|
property_id | integer |
속성의 숫자 ID입니다. |
|
값 ID
|
value_id | integer |
값의 숫자 ID입니다. |
|
이미지 ID
|
image_id | integer |
이미지의 숫자 ID입니다. |
PaymentAccountLedgerEntries
결제 계정 원장 항목 리소스 집합
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수량
|
count | integer |
찾은 결제 계정 원장 항목 리소스의 수입니다. |
|
Results
|
results | array of PaymentAccountLedgerEntry |
찾은 결제 계정 원장 항목 리소스입니다. |
PaymentAccountLedgerEntry
상점 원장의 항목을 나타냅니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
항목 ID
|
entry_id | integer |
원장 항목의 숫자 ID입니다. |
|
원장 ID
|
ledger_id | integer |
원장의 숫자 ID입니다. |
|
시퀀스 번호
|
sequence_number | integer |
시퀀스를 사용하면 원장 항목을 시간순으로 정렬할 수 있습니다. 시퀀스가 높을수록 항목이 더 최근입니다. |
|
금액
|
amount | integer |
원장에 적립된 금액입니다. |
|
통화
|
currency | string |
원장에 있는 항목의 통화입니다. |
|
Description
|
description | string |
지불, 환불, 실패한 환불의 반전, 지출, 반환된 지출, 회수, 기타 신용, 기타 직불, 청구서 지불 등 원장 항목의 종류를 자세히 설명합니다. |
|
저울
|
balance | integer |
이 항목이 적용된 직후 상점의 원장에 있는 금액입니다. |
|
생성 날짜
|
create_date | integer |
원장 항목이 Epoch 초 단위로 만들어진 날짜 및 시간입니다. |
결제
Etsy Payments로 이루어진 여러 결제를 나타냅니다. 달리 지정하지 않는 한 모든 금액은 USD 동전으로 제공됩니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수량
|
count | integer |
응답의 지불 수입니다. |
|
Results
|
results | array of Payment |
결제 목록입니다. |
지불
Etsy Payments로 결제한 금액을 나타냅니다. 달리 지정하지 않는 한 모든 금액은 USD 동전으로 제공됩니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
결제 아이디
|
payment_id | integer |
특정 Etsy 상점에 대한 지불에 대한 고유 숫자 ID입니다. |
|
구매자 사용자 ID
|
buyer_user_id | integer |
구매를 지불한 사용자의 숫자 ID입니다. |
|
상점 ID
|
shop_id | integer |
Etsy Shop의 고유 양의 0이 아닌 숫자 ID입니다. |
|
영수증 ID
|
receipt_id | integer |
이 트랜잭션과 연결된 영수증의 숫자 ID입니다. |
|
돈
|
amount_gross | Money |
금액의 표현입니다. |
|
돈
|
amount_fees | Money |
금액의 표현입니다. |
|
돈
|
amount_net | Money |
금액의 표현입니다. |
|
돈
|
posted_gross | Money |
금액의 표현입니다. |
|
돈
|
posted_fees | Money |
금액의 표현입니다. |
|
돈
|
posted_net | Money |
금액의 표현입니다. |
|
돈
|
adjusted_gross | Money |
금액의 표현입니다. |
|
돈
|
adjusted_fees | Money |
금액의 표현입니다. |
|
돈
|
adjusted_net | Money |
금액의 표현입니다. |
|
통화
|
currency | string |
결제 통화에 대한 ISO(사전순) 코드 문자열입니다. |
|
상점 통화
|
shop_currency | string |
상점의 통화에 대한 ISO(영문자) 코드입니다. 상점은 기본적으로이 통화로 모든 가격을 표시합니다. |
|
구매자 통화
|
buyer_currency | string |
구매자의 통화 문자열입니다. |
|
사용자 전달 ID
|
shipping_user_id | integer |
판매자가 주문을 배송하는 사용자의 숫자 ID입니다. |
|
배송 주소 ID
|
shipping_address_id | integer |
배송 주소를 식별하는 숫자 ID입니다. |
|
청구 주소 ID
|
billing_address_id | integer |
구매자의 청구 주소를 식별하는 숫자 ID입니다. |
|
상태
|
status | string |
결제의 현재 상태를 나타내는 문자열로, 가장 일반적으로 정산되거나 인증됩니다. |
|
배송된 타임스탬프
|
shipped_timestamp | integer |
트랜잭션의 배송 날짜 및 시간(epoch 초)입니다. |
|
생성된 타임스탬프
|
create_timestamp | integer |
트랜잭션의 생성 날짜 및 시간(epoch 초)입니다. |
|
타임스탬프 업데이트
|
update_timestamp | integer |
Epoch 초 단위의 결제 조정에 대한 마지막 변경 날짜 및 시간입니다. |
|
지불 조정
|
payment_adjustments | array of PaymentAdjustment |
Etsy Payments 트랜잭션의 환불 개체 목록입니다. 달리 지정하지 않는 한 모든 금액은 USD 동전으로 제공됩니다. |
PaymentAdjustment
이전 Etsy 지불에 적용되는 환불을 나타냅니다. 달리 지정하지 않는 한 모든 금액은 USD 동전으로 제공됩니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
결제 조정 ID
|
payment_adjustment_id | integer |
결제 조정에 대한 숫자 ID입니다. |
|
결제 아이디
|
payment_id | integer |
특정 Etsy 상점에 대한 지불에 대한 고유 숫자 ID입니다. |
|
상태
|
status | string |
결제 조정의 상태 문자열입니다. |
|
성공
|
is_success | boolean |
true이면 결제 조정이 성공적으로 완료되었거나 완료되었을 가능성이 높습니다. |
|
사용자 ID
|
user_id | integer |
구매를 이행하는 사용자(판매자)의 숫자 ID입니다. |
|
이유 코드
|
reason_code | string |
환불 이유를 설명하는 사람이 읽을 수 있는 문자열입니다. |
|
총 조정 금액
|
total_adjustment_amount | integer |
결제 통화로 된 환불의 총 숫자 금액입니다. |
|
총 조정 금액 쇼핑
|
shop_total_adjustment_amount | integer |
상점 통화로 된 환불의 숫자 금액입니다. |
|
총 조정 금액
|
buyer_total_adjustment_amount | integer |
구매자 통화로 된 환불의 숫자 금액입니다. |
|
총 수수료 조정 금액
|
total_fee_adjustment_amount | integer |
결제 조정과 관련된 카드 처리 수수료의 숫자 금액입니다. |
|
생성된 타임스탬프
|
create_timestamp | integer |
트랜잭션의 생성 날짜 및 시간(epoch 초)입니다. |
|
타임스탬프 업데이트
|
update_timestamp | integer |
Epoch 초 단위의 결제 조정에 대한 마지막 변경 날짜 및 시간입니다. |
테이블
현재 애플리케이션이 Open API에 액세스할 수 있다는 확인
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
애플리케이션 ID
|
application_id | integer |
인증된 애플리케이션의 ID |
ShopReceipt
상점에서 구매한 레코드입니다. 상점 영수증은 상점의 통화를 사용하여 통화 값을 표시합니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
영수증 ID
|
receipt_id | integer |
이 트랜잭션과 연결된 영수증의 숫자 ID입니다. |
|
영수증 유형
|
receipt_type | integer |
구매를 서비스한 Etsy 채널의 숫자 값: Etsy.com 0, 패턴 상점의 경우 1입니다. |
|
판매자 사용자 ID
|
seller_user_id | integer |
구매를 이행하는 사용자(판매자)의 숫자 ID입니다. |
|
판매자의 전자 메일 주소
|
seller_email | string |
목록의 판매자에 대한 이메일 주소 문자열입니다. |
|
구매자 사용자 ID
|
buyer_user_id | integer |
구매하는 사용자의 숫자 ID입니다. |
|
구매자의 전자 메일 주소
|
buyer_email | string |
목록의 구매자에 대한 이메일 주소 문자열입니다. |
|
이름
|
name | string |
배송 주소에서 받는 사람의 이름 문자열입니다. |
|
첫 번째 주소 줄
|
first_line | string |
배송 주소의 받는 사람에 대한 첫 번째 주소 줄 문자열입니다. |
|
두 번째 주소 줄
|
second_line | string |
배송 주소의 받는 사람에 대한 선택적 두 번째 주소 줄 문자열입니다. |
|
도시
|
city | string |
배송 주소의 받는 사람에 대한 도시 문자열입니다. |
|
주
|
state | string |
배송 주소의 받는 사람에 대한 상태 문자열입니다. |
|
우편번호
|
zip | string |
배송 주소의 받는 사람에 대한 우편 번호 문자열(반드시 숫자가 아님)입니다. |
|
서식이 지정된 주소
|
formatted_address | string |
배송 주소의 받는 사람에 대한 형식이 지정된 배송 주소 문자열입니다. |
|
국가 코드 ISO
|
country_iso | string |
배송 주소의 받는 사람에 대한 ISO-3166 alpha-2 국가 코드 문자열입니다. |
|
결제 방법
|
payment_method | string |
구매자의 결제 방법을 식별하는 결제 방법 문자열입니다. 'cc'(신용 카드), 'PayPal', '수표', '모'(머니 오더), 'bt'(은행 송금), '기타', '이상적', 'sofort', 'apple_pay', 'google', 'android_pay', 'google_pay', '클라나', 'k_pay_in_4'(클라나) 또는 'k_financing'(클라나) 중 하나여야 합니다. |
|
결제 전자 메일 주소
|
payment_email | string |
결제 확인을 보낼 전자 메일 주소의 전자 메일 주소 문자열입니다. |
|
판매자의 메시지
|
message_from_seller | string |
판매자의 선택적 메시지 문자열입니다. |
|
구매자의 메시지
|
message_from_buyer | string |
구매자의 선택적 메시지 문자열입니다. |
|
결제 시스템의 메시지
|
message_from_payment | string |
결제 시스템에서 머신에서 생성된 승인 문자열입니다. |
|
지불
|
is_paid | boolean |
true이면 구매자가 이 구매에 대해 지불했습니다. |
|
배송됨
|
is_shipped | boolean |
true이면 판매자가 제품을 배송했습니다. |
|
생성된 타임스탬프
|
create_timestamp | integer |
영수증의 생성 시간(epoch 초)입니다. |
|
타임스탬프 업데이트
|
update_timestamp | integer |
영수증에 대한 마지막 업데이트 시간(epoch 초)입니다. |
|
기프트 메시지
|
gift_message | string |
구매자가 제품과 함께 배달을 요청하는 선물 메시지 문자열입니다. |
|
돈
|
grandtotal | Money |
금액의 표현입니다. |
|
돈
|
subtotal | Money |
금액의 표현입니다. |
|
돈
|
total_price | Money |
금액의 표현입니다. |
|
돈
|
total_shipping_cost | Money |
금액의 표현입니다. |
|
돈
|
total_tax_cost | Money |
금액의 표현입니다. |
|
돈
|
total_vat_cost | Money |
금액의 표현입니다. |
|
돈
|
discount_amt | Money |
금액의 표현입니다. |
|
돈
|
gift_wrap_price | Money |
금액의 표현입니다. |
|
발송물
|
shipments | array of ShopReceiptShipment |
이 영수증의 배송 명세서 목록입니다. |
ShopReceiptShipment
ShopReceipt에 대한 하나의 배송 이벤트의 레코드입니다. 영수증에는 많은 ShopReceiptShipment 레코드가 있을 수 있습니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
영수증 배송 ID
|
receipt_shipping_id | integer |
상점 영수증 발송 레코드의 고유 숫자 ID입니다. |
|
배송 알림 타임스탬프
|
shipment_notification_timestamp | integer |
Etsy가 배송 이벤트의 구매자에게 Epoch 초 단위로 통보한 시간입니다. |
|
운송업체 이름
|
carrier_name | string |
배송을 담당하는 운송업체/회사의 이름 문자열입니다. |
|
추적 코드
|
tracking_code | string |
배송을 위해 운송업체/회사에서 제공하는 추적 코드 문자열입니다. |
ShopReceipts
특정 상점의 영수증입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수량
|
count | integer |
찾은 상점 영수증의 수입니다. |
|
Results
|
results | array of ShopReceipt |
각 리소스에 대한 모든 상점 영수증 필드와 함께 찾은 상점 영수증 리소스 목록입니다. |
TransactionReviews
사용자가 남긴 트랜잭션 검토 레코드 집합입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수량
|
count | integer |
찾은 TransactionReview 리소스의 수입니다. |
|
Results
|
results | array of TransactionReview |
TransactionReview 리소스를 찾습니다. |
TransactionReview
사용자가 남긴 트랜잭션 검토 레코드입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
상점 ID
|
shop_id | integer |
상점의 숫자 ID입니다. |
|
목록 ID
|
listing_id | integer |
TransactionReview가 속한 상점 목록의 ID입니다. |
|
구매자 사용자 ID
|
buyer_user_id | integer |
이 트랜잭션의 구매자인 사용자의 숫자 ID입니다. 참고: 구매자의 개인 정보 설정에 따라 이 필드가 없을 수 있습니다. |
|
Rating
|
rating | integer |
1에서 5까지의 규모에 대한 등급 값 |
|
메시지 검토
|
review | string |
피드백을 설명하는 작성자가 남긴 메시지입니다. |
|
Language
|
language | string |
TransactionReview의 언어 |
|
이미지 URL 전체화
|
image_url_fullxfull | string |
피드백과 함께 제공되는 사진의 URL로, fullxfull 차원입니다. 참고: 구매자의 개인 정보 설정에 따라 이 필드가 없을 수 있습니다. |
|
생성된 타임스탬프
|
create_timestamp | integer |
TransactionReview가 Epoch 초 단위로 만들어진 날짜 및 시간입니다. |
|
타임스탬프 업데이트
|
update_timestamp | integer |
TransactionReview가 Epoch 초 단위로 업데이트된 날짜 및 시간입니다. |
SellerTaxonomyNodes
판매자 분류 트리의 분류 노드 목록입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수량
|
count | integer |
결과 수입니다. |
|
Results
|
results | array of SellerTaxonomyNode |
요청된 리소스 목록입니다. |
SellerTaxonomyNode
판매자 분류 트리의 분류 노드입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | integer |
판매자 분류 계층 구조 트리로 구성된 목록의 메타데이터 범주인 Etsy 분류 노드의 고유 숫자 ID입니다. 예를 들어 신발 분류 노드(ID: 1429, 수준: 1)가 여자 신발(ID: 1440, 수준: 2)보다 계층 구조에서 더 높습니다. 목록에 할당된 분류 노드는 특정 표준화된 제품 규모 및 속성에 대한 액세스를 지원합니다. 예를 들어 분류 노드 신발 또는 소녀 신발이 할당된 목록은 속성 :1394 |
|
Level
|
level | integer |
수준 0의 루트가 있는 판매자 분류 트리에서 이 분류 노드의 정수 깊이입니다. |
|
이름
|
name | string |
이 분류 노드의 이름 문자열입니다. |
|
부모 ID
|
parent_id | integer |
이 노드의 부모에 대한 숫자 분류 ID입니다. |
|
하위
|
children | array of SellerTaxonomyNode |
판매자 분류 트리에서 이 분류 노드의 모든 직접 자식에 대한 분류 노드의 배열입니다. |
|
분류 경로 ID
|
full_path_taxonomy_ids | array of integer |
이 노드와 판매자 분류 트리의 모든 직접 부모를 루트 노드까지 포함하는 분류 ID의 배열입니다. 루트에서 리프로 순서대로 나열됩니다. |
TaxonomyNodeProperties
제품 속성 정의 목록입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수량
|
count | integer |
결과 수입니다. |
|
Results
|
results | array of TaxonomyNodeProperty |
요청된 리소스 목록입니다. |
TaxonomyNodeProperty
제품 속성 정의입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
속성 ID
|
property_id | integer |
이 제품 속성의 고유 숫자 ID입니다. |
|
이름
|
name | string |
이 분류 노드의 이름 문자열입니다. |
|
표시 이름
|
display_name | string |
사람이 읽을 수 있는 제품 속성 이름 문자열입니다. |
|
저울
|
scales | array of TaxonomyPropertyScale |
사용 가능한 배율 목록입니다. |
|
필수 요소입니다.
|
is_required | boolean |
true이면 할당된 적격 분류 ID 목록에 이 속성이 필요합니다. |
|
특성 지원
|
supports_attributes | boolean |
true이면 특성 나열에 이 속성을 사용할 수 있습니다. |
|
변형 지원
|
supports_variations | boolean |
true이면 이 속성을 목록 변형에 사용할 수 있습니다. |
|
다중값
|
is_multivalued | boolean |
true이면 이 속성에 여러 속성 값을 할당할 수 있습니다. |
|
가능한 값
|
possible_values | array of TaxonomyPropertyValue |
이 속성에 대해 지원되는 속성 값 문자열 목록입니다. |
|
선택한 값
|
selected_values | array of TaxonomyPropertyValue |
지정된 속성에 대해 자동으로 항상 선택된 속성 값 문자열 목록입니다. |
TaxonomyPropertyScale
특정 제품 속성에 사용할 수 있는 속성 값에 대한 할당 가능한 증분을 조각화한 배율입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
크기 조정 ID
|
scale_id | integer |
눈금의 고유 숫자 ID입니다. |
|
표시 이름
|
display_name | string |
눈금의 이름 문자열입니다. |
|
Description
|
description | string |
배율에 대한 설명 문자열입니다. |
TaxonomyPropertyValue
특정 크기 조정을 사용할 수도 있는 특정 제품 속성의 속성 값입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
값 ID
|
value_id | integer |
이 속성 값의 숫자 ID입니다. |
|
이름
|
name | string |
이 속성 값의 이름 문자열입니다. |
|
크기 조정 ID
|
scale_id | integer |
이 속성 값이 속한 눈금의 숫자 배율 ID입니다. |
|
같음
|
equal_to | array of integer |
이 속성 값이 (있는 경우) 같은 숫자 속성 값 ID의 목록입니다. |
ShippingCarriers
여러 ShippingCarriers를 나타냅니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
count
|
count | integer | |
|
results
|
results | array of ShippingCarrier |
ShippingCarrier
예상 배송 날짜를 계산하는 데 사용되는 지원되는 배송업체입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
배송업체 ID
|
shipping_carrier_id | integer |
이 배송업체의 숫자 ID입니다. |
|
이름
|
name | string |
이 배송업체의 이름입니다. |
|
국내 수업
|
domestic_classes | array of ShippingCarrierMailClass |
이 운송업체의 국내 메일 클래스 집합입니다. |
|
국제 수업
|
international_classes | array of ShippingCarrierMailClass |
이 운송업체의 국제 메일 클래스 집합입니다. |
ShippingCarrierMailClass
예상 배달 날짜를 계산하는 데 사용되는 운송업체의 메일 클래스입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
메일 클래스 ID
|
mail_class_key | string |
이 메일 클래스의 고유 식별자입니다. |
|
이름
|
name | string |
이 메일 클래스의 이름입니다. |
상점
Shop 레코드 집합입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수량
|
count | integer |
총 상점 수 |
|
Results
|
results | array of Shop |
Shop 리소스입니다. |
ShopSection
사용자가 목록을 정렬할 수 있는 상점 내의 섹션입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Shop 섹션 ID
|
shop_section_id | integer |
특정 Etsy 상점에 있는 섹션의 숫자 ID입니다. |
|
제목
|
title | string |
상점 섹션의 제목 문자열입니다. |
|
등급
|
rank | integer |
1위 섹션이 먼저 나타나는 상점의 구역 표시 순서에서 이 섹션의 양수 0이 아닌 숫자 위치입니다. |
|
사용자 ID
|
user_id | integer |
이 상점 섹션을 소유한 사용자의 숫자 ID입니다. |
|
활성 목록 수
|
active_listing_count | integer |
특정 Etsy 상점의 한 섹션에 있는 활성 목록 수입니다. |
ShopSections
스프레크 숍의 모든 섹션.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수량
|
count | integer |
결과 수입니다. |
|
Results
|
results | array of ShopSection |
요청된 리소스 목록입니다. |
ShopShippingProfile
목록의 배송 정보를 설정하는 데 사용되는 프로필을 나타냅니다. API를 통해 계산된 배송 템플릿을 만들 수 없습니다. 그러나 Shop Manager에서 만든 계산된 배송 프로필을 API를 사용하여 목록과 연결할 수 있습니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
배송 프로필 ID
|
shipping_profile_id | integer |
배송 프로필의 숫자 ID입니다. |
|
제목
|
title | string |
이 배송 프로필의 이름 문자열입니다. |
|
사용자 ID
|
user_id | integer |
배송 프로필을 소유한 사용자의 숫자 ID입니다. |
|
최소 처리 일수
|
min_processing_days | integer |
목록을 처리하기 위한 최소 일 수입니다. |
|
최대 처리 일수
|
max_processing_days | integer |
목록을 처리하는 최대 일 수입니다. |
|
처리 날짜 레이블
|
processing_days_display_label | string |
처리 날짜에 대한 변환된 표시 레이블 문자열입니다. |
|
Origin Country ISO
|
origin_country_iso | string |
목록이 제공되는 국가의 ISO 코드입니다. |
|
삭제됨
|
is_deleted | boolean |
true이면 누군가가 이 배송 프로필을 삭제했습니다. |
|
배송 프로필 대상
|
shipping_profile_destinations | array of ShopShippingProfileDestination |
이 배송 프로필에 사용할 수 있는 배송 프로필 대상 목록입니다. |
|
배송 프로필 업그레이드
|
shipping_profile_upgrades | array of ShopShippingProfileUpgrade |
이 배송 프로필에 사용할 수 있는 배송 프로필 업그레이드 목록입니다. |
|
원본 우편 번호
|
origin_postal_code | string |
목록이 제공되는 위치에 대한 우편 번호 문자열(반드시 숫자가 아님)입니다. |
|
프로필 유형
|
profile_type | ProfileType |
ShopShippingProfileDestination
배송 프로필에 할당된 배송 대상을 나타냅니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
배송 프로필 대상 ID
|
shipping_profile_destination_id | integer |
목록과 연결된 배송 프로필에 있는 배송 프로필 대상의 숫자 ID입니다. |
|
배송 프로필 ID
|
shipping_profile_id | integer |
배송 프로필의 숫자 ID입니다. |
|
Origin Country ISO
|
origin_country_iso | string |
목록이 제공되는 국가의 ISO 코드입니다. |
|
대상 국가 ISO
|
destination_country_iso | string |
목록이 제공되는 국가의 ISO 코드입니다. null인 경우 요청은 대상을 destination_region 설정합니다. |
|
DestinationRegion
|
destination_region | DestinationRegion |
목록이 제공되는 지역의 코드입니다. 지역은 국가 집합을 나타냅니다. 지원되는 지역은 유럽 연합 및 비유럽 연합(유럽이 아닌 유럽 국가)입니다. 없는 경우 요청은 대상을 destination_country_iso 설정하거나 destination_country_iso null인 경우 모든 위치에서 설정합니다. |
|
돈
|
primary_cost | Money |
금액의 표현입니다. |
|
돈
|
secondary_cost | Money |
금액의 표현입니다. |
|
배송업체 ID
|
shipping_carrier_id | integer |
예상 배송 날짜를 계산하는 데 사용되는 지원되는 배송업체의 고유 ID입니다. |
|
메일 클래스
|
mail_class | string |
배송업체 메일 클래스의 고유 ID 문자열로, 예상 배달 날짜를 계산하는 데 사용됩니다. |
|
최소 배달 일수
|
min_delivery_days | integer |
구매자가 구매한 품목이 배송되면 받기를 기다릴 것으로 예상할 수 있는 최소 영업일수입니다. |
|
최대 배달 일수
|
max_delivery_days | integer |
구매자가 구매한 품목이 배송되면 받을 때까지 기다릴 것으로 예상할 수 있는 최대 영업일수입니다. |
ShopShippingProfileUpgrade
배송 프로필 업그레이드 옵션의 표현입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
배송 프로필 ID
|
shipping_profile_id | integer |
기본 배송 프로필의 숫자 ID입니다. |
|
업그레이드 ID
|
upgrade_id | integer |
배송 업그레이드와 연결된 숫자 ID입니다. |
|
업그레이드 이름
|
upgrade_name | string |
체크 아웃 시 쇼핑객에게 표시되는 배송 업그레이드 이름(예: USPS 우선 순위). |
|
유형
|
type | Type |
배송 업그레이드의 유형입니다. 국내(0) 또는 국제(1). |
|
등급
|
rank | integer |
목록에 표시된 이미지에서 0이 아닌 양의 숫자 위치로, 목록의 맨 왼쪽 위치에 순위 1 이미지가 표시됩니다. |
|
Language
|
language | string |
배송 프로필의 언어에 대한 IETF 언어 태그입니다. 예: de, en, es, fr, it, ja, nl, pl, pt, ru. |
|
돈
|
price | Money |
금액의 표현입니다. |
|
돈
|
secondary_price | Money |
금액의 표현입니다. |
|
배송업체 ID
|
shipping_carrier_id | integer |
예상 배송 날짜를 계산하는 데 사용되는 지원되는 배송업체의 고유 ID입니다. |
|
메일 클래스
|
mail_class | string |
배송업체 메일 클래스의 고유 ID 문자열로, 예상 배달 날짜를 계산하는 데 사용됩니다. |
|
최소 배달 일수
|
min_delivery_days | integer |
구매자가 구매한 품목이 배송되면 받기를 기다릴 것으로 예상할 수 있는 최소 영업일수입니다. |
|
최대 배달 일수
|
max_delivery_days | integer |
구매자가 구매한 품목이 배송되면 받을 때까지 기다릴 것으로 예상할 수 있는 최대 영업일수입니다. |
ShopShippingProfileDestinations
배송 대상 개체의 목록을 나타냅니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수량
|
count | integer |
결과 수입니다. |
|
Results
|
results | array of ShopShippingProfileDestination |
요청된 리소스 목록입니다. |
ShopShippingProfileUpgrades
배송 업그레이드 옵션 목록입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수량
|
count | integer |
결과 수입니다. |
|
Results
|
results | array of ShopShippingProfileUpgrade |
요청된 리소스 목록입니다. |
UserAddress
사용자의 주소를 나타냅니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사용자 주소 ID
|
user_address_id | integer |
사용자 주소의 숫자 ID입니다. |
|
사용자 ID
|
user_id | integer |
사용자의 숫자 ID입니다. |
|
이름
|
name | string |
이 주소의 사용자 이름입니다. |
|
첫 번째 주소 줄
|
first_line | string |
사용자 주소의 첫 번째 줄입니다. |
|
두 번째 주소 줄
|
second_line | string |
사용자 주소의 두 번째 줄입니다. |
|
도시
|
city | string |
사용자 주소의 도시 필드입니다. |
|
주
|
state | string |
사용자 주소의 상태 필드입니다. |
|
우편번호
|
zip | string |
사용자 주소의 우편 번호 필드입니다. |
|
국가 코드 ISO
|
iso_country_code | string |
이 주소에 있는 국가의 ISO 코드입니다. |
|
국가
|
country_name | string |
사용자의 국가 이름입니다. |
|
기본 배송 주소입니다.
|
is_default_shipping_address | boolean |
사용자의 기본 배송 주소입니다. |
UserAddresses
여러 UserAddress 레코드를 나타냅니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수량
|
count | integer |
반환되는 UserAddress 레코드의 수입니다. |
|
Results
|
results | array of UserAddress |
UserAddress 리소스의 배열입니다. |
DestinationRegion
목록이 제공되는 지역의 코드입니다. 지역은 국가 집합을 나타냅니다. 지원되는 지역은 유럽 연합 및 비유럽 연합(유럽이 아닌 유럽 국가)입니다. 없는 경우 요청은 대상을 destination_country_iso 설정하거나 destination_country_iso null인 경우 모든 위치에서 설정합니다.
목록이 제공되는 지역의 코드입니다. 지역은 국가 집합을 나타냅니다. 지원되는 지역은 유럽 연합 및 비유럽 연합(유럽이 아닌 유럽 국가)입니다. 없는 경우 요청은 대상을 destination_country_iso 설정하거나 destination_country_iso null인 경우 모든 위치에서 설정합니다.
- DestinationRegion
- string
ItemDimensionsUnit
제품의 차원을 측정하는 데 사용되는 단위를 정의하는 문자열입니다. 기본값은 null입니다.
제품의 차원을 측정하는 데 사용되는 단위를 정의하는 문자열입니다. 기본값은 null입니다.
- ItemDimensionsUnit
- string
ItemWeightUnit
제품의 가중치를 측정하는 데 사용되는 단위를 정의하는 문자열입니다. 기본값은 null입니다.
제품의 가중치를 측정하는 데 사용되는 단위를 정의하는 문자열입니다. 기본값은 null입니다.
- ItemWeightUnit
- string
경우
이 제품이 적절한 선물을 만드는 경우를 나타내는 열거형 문자열입니다. 기본값은 null입니다.
이 제품이 적절한 선물을 만드는 경우를 나타내는 열거형 문자열입니다. 기본값은 null입니다.
- 경우
- string
프로필 유형
- 프로필 유형
- string
Recipient
이 제품이 적절한 선물을 만들 사람을 나타내는 열거형 문자열입니다. 기본값은 null입니다.
이 제품이 적절한 선물을 만들 사람을 나타내는 열거형 문자열입니다. 기본값은 null입니다.
- Recipient
- string
주
활성 또는 비활성 중 하나에서 열거된 문자열입니다. 참고: 초안 목록을 활성으로 설정하면 etsy.com 목록도 게시됩니다.
활성 또는 비활성 중 하나에서 열거된 문자열입니다. 참고: 초안 목록을 활성으로 설정하면 etsy.com 목록도 게시됩니다.
- 주
- integer
유형
WhenMade
제조업체가 이 목록에서 제품을 만든 시대의 열거형 문자열입니다. 구매자가 빈티지 제목 아래에 목록을 찾을 수 있도록 도와줍니다. 'is_supply' 및 'who_made'이 필요합니다.
제조업체가 이 목록에서 제품을 만든 시대의 열거형 문자열입니다. 구매자가 빈티지 제목 아래에 목록을 찾을 수 있도록 도와줍니다. 'is_supply' 및 'who_made'이 필요합니다.
- WhenMade
- string
WhoMade
제품을 만든 사람이 포함된 열거형 문자열입니다. 구매자가 수제 제목 아래에서 목록을 찾을 수 있도록 도와줍니다. 'is_supply' 및 'when_made'이 필요합니다.
제품을 만든 사람이 포함된 열거형 문자열입니다. 구매자가 수제 제목 아래에서 목록을 찾을 수 있도록 도와줍니다. 'is_supply' 및 'when_made'이 필요합니다.
- WhoMade
- string