다음을 통해 공유


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

애플리케이션을 사용하여 Etsy API에 대한 연결을 확인합니다.

반환

현재 애플리케이션이 Open API에 액세스할 수 있다는 확인

테이블
Pong

결제 계정 원장 항목 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

판매자 분류 노드 가져오기

판매자 분류 노드의 전체 계층 트리를 검색합니다.

반환

판매자 분류 트리의 분류 노드 목록입니다.

SellerTaxonomyNodes
SellerTaxonomyNodes

활성 목록 가져오기

생성 날짜별로 페이지를 매긴 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 언어 태그입니다. 예: de, ,en, es,itfr, ja, nlpl, ptru.

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 name및 :38과 같은 value_idEU 신발 크기의 관련 속성 이름과 ID를 사용하여 EU 신발 크기 규모에 대한 액세스를 지원합니다.

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

유형

배송 업그레이드의 유형입니다. 국내(0) 또는 국제(1).

배송 업그레이드의 유형입니다. 국내(0) 또는 국제(1).

유형
integer

WhenMade

제조업체가 이 목록에서 제품을 만든 시대의 열거형 문자열입니다. 구매자가 빈티지 제목 아래에 목록을 찾을 수 있도록 도와줍니다. 'is_supply' 및 'who_made'이 필요합니다.

제조업체가 이 목록에서 제품을 만든 시대의 열거형 문자열입니다. 구매자가 빈티지 제목 아래에 목록을 찾을 수 있도록 도와줍니다. 'is_supply' 및 'who_made'이 필요합니다.

WhenMade
string

WhoMade

제품을 만든 사람이 포함된 열거형 문자열입니다. 구매자가 수제 제목 아래에서 목록을 찾을 수 있도록 도와줍니다. 'is_supply' 및 'when_made'이 필요합니다.

제품을 만든 사람이 포함된 열거형 문자열입니다. 구매자가 수제 제목 아래에서 목록을 찾을 수 있도록 도와줍니다. 'is_supply' 및 'when_made'이 필요합니다.

WhoMade
string