다음을 통해 공유


eBay(독립 게시자)(미리 보기)

eBay는 웹사이트를 통해 소비자-소비자 및 기업-소비자 판매를 용이하게 하는 미국의 다국적 전자 상거래 회사입니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 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)
연락처
이름 Artesian Software Technologies LLP
URL https://artesian.io
전자 메일 amit.sharma@artesian.io
커넥터 메타데이터
게시자 Artesian Software Technologies LLP
웹 사이트 https://www.ebay.com/
개인 정보 취급 방침 https://www.ebay.com/help/policies/member-behaviour-policies/user-privacy-notice-privacy-policy?id=4260
카테고리 상업; 판매 및 CRM

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.

기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 Description 필수
클라이언트 ID - eBay clientId 문자열 클라이언트 ID를 입력하세요. 진실
클라이언트 암호 시큐어스트링 (보안 문자열) 클라이언트 암호를 입력하세요. 진실

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

GET 제안

이 호출은 지정된 SKU 값에 대한 모든 기존 제품을 검색합니다. 판매자는 특정 이베이 마켓플레이스 또는 목록 형식으로 검색되는 제품을 제한할 수 있습니다.

GET 제품

이 호출은 게시되거나 게시되지 않은 특정 제품을 검색합니다.

결제 정책 가져오기

이 메서드는 marketplace_id 쿼리 매개 변수를 사용하여 지정한 Marketplace에 대해 구성된 모든 결제 정책을 검색합니다.

결제 정책 가져오기

이 메서드는 결제 정책의 전체 세부 정보를 검색합니다. paymentPolicyId 경로 매개 변수를 사용하여 검색하려는 정책의 ID를 제공합니다.

기본 범주 TreeId 가져오기

지정된 이베이 마켓플레이스는 여러 범주 트리를 사용할 수 있지만 이러한 트리 중 하나는 해당 마켓플레이스의 기본값으로 간주됩니다. 이 호출은 지정된 이베이 마켓플레이스 ID와 연결된 기본 범주 트리에 대한 참조를 검색합니다.

반환 정책 가져오기

이 메서드는 marketplace_id 쿼리 매개 변수를 사용하여 지정한 마켓플레이스에 대해 구성된 모든 반환 정책을 검색합니다.

반환 정책 가져오기

이 메서드는 returnPolicyId 경로 매개 변수로 지정된 반환 정책의 전체 세부 정보를 검색합니다.

범주 제안 가져오기

이 호출은 지정된 범주 트리에 있는 범주 트리 리프 노드의 배열을 반환하며, 이 노드는 이베이에서 쿼리에 가장 가깝게 대응하는 것으로 간주됩니다.

범주에 대한 항목 측면 가져오기

이 호출은 지정된 리프 범주의 항목을 정확하게 설명하는 데 적합하거나 필요한 측면 목록을 반환합니다. 각 측면은 eBay에서 해당 범주의 항목을 제공할 때 판매자가 요구하거나 값(또는 변형 값)을 제공하도록 권장되는 항목 특성(예: 색)을 식별합니다.

인벤토리 위치 가져오기

이 호출은 merchantLocationKey 경로 매개 변수로 지정된 인벤토리 위치에 대해 정의된 모든 세부 정보를 검색합니다.

인벤토리 위치 가져오기

이 호출은 판매자의 계정과 연결된 모든 인벤토리 위치에 대해 정의된 모든 세부 정보를 검색합니다.

인벤토리 위치 만들기

이 호출을 사용하여 새 인벤토리 위치를 만듭니다. 제품을 만들고 게시하려면 모든 제품이 위치와 연결되어야 하므로 판매자에게 가장 가까운 인벤토리 위치가 있어야 합니다.

인벤토리 항목 가져오기

이 호출은 지정된 SKU에 대한 인벤토리 항목 레코드를 검색합니다.

인벤토리 항목 가져오기

이 호출은 판매자의 계정에 대해 정의된 모든 인벤토리 항목 레코드를 검색합니다.

인벤토리 항목 만들기 또는 바꾸기

이 호출은 새 인벤토리 항목 레코드를 만들거나 기존 인벤토리 항목 레코드를 대체합니다.

제안 철회

이 호출은 지정된 제품과 연결된 단일 변형 목록을 종료하는 데 사용됩니다.

제품 게시

이 호출은 게시되지 않은 제품을 게시된 제품 또는 라이브 이베이 목록으로 변환하는 데 사용됩니다. 제안의 고유 식별자(offerId)는 호출 URI가 끝날 때 전달됩니다.

제품 만들기

이 호출은 특정 이베이 마켓플레이스에서 특정 인벤토리 항목에 대한 제안을 만듭니다.

제품 삭제

이 호출은 제품을 영구적으로 삭제합니다.

제품 업데이트

이 호출은 게시되거나 게시되지 않은 상태일 수 있는 기존 제품을 업데이트합니다.

처리 정책 가져오기

이 메서드는 marketplace_id 쿼리 매개 변수를 사용하여 지정한 마켓플레이스에 대해 구성된 모든 처리 정책을 검색합니다.

처리 정책 가져오기

이 메서드는 처리 정책의 전체 세부 정보를 검색합니다. fulfillmentPolicyId 경로 매개 변수를 사용하여 검색하려는 정책의 ID를 제공합니다.

항목 조건 정책 가져오기

이 메서드는 이베이 마켓플레이스에서 하나, 여러 개 또는 모든 이베이 범주에 항목 조건 메타데이터를 반환합니다.

GET 제안

이 호출은 지정된 SKU 값에 대한 모든 기존 제품을 검색합니다. 판매자는 특정 이베이 마켓플레이스 또는 목록 형식으로 검색되는 제품을 제한할 수 있습니다.

매개 변수

Name 필수 형식 Description
SKU
sku True string

판매자 정의 SKU 값

Marketplace Id
marketplace_id string

이베이 마켓플레이스의 고유 식별자입니다.

포맷
format string

제품의 목록 형식입니다.

한계
limit string

데이터 페이지당 반환할 최대 레코드 수입니다.

상쇄
offset string

검색할 페이지 번호입니다.

반환

Name 경로 형식 Description
Href
href string

제품의 현재 페이지에 대한 URL입니다.

한계
limit integer

각 결과 페이지에 표시될 제안 수입니다.

Next
next string

제품의 다음 페이지에 대한 URL입니다.

offers
offers array of object

이 컨테이너는 SKU 값에 대한 하나 이상의 판매자 제품 배열입니다.

사용 가능한 수량
offers.availableQuantity integer

구매할 수 있는 인벤토리 항목 수량입니다.

범주 ID
offers.categoryId string

인벤토리 항목이 나열된 이베이 범주 고유 ID입니다.

자선 ID
offers.charity.charityId string

판매 수익금의 백분율을 받을 자선 단체의 이베이 할당 고유 식별자입니다.

기부 비율
offers.charity.donationPercentage string

자선 단체가 각 판매에 대해 받을 구매 가격 비율입니다.

생산자 제품 ID
offers.extendedProducerResponsibility.producerProductId string

항목과 관련된 생산자의 고유 식별자입니다.

제품 패키지 ID
offers.extendedProducerResponsibility.productPackageId string

판매자가 추가한 패키지 제품의 고유 ID입니다.

배송 패키지 ID
offers.extendedProducerResponsibility.shipmentPackageId string

판매자가 항목을 배송하는 데 사용하는 패키징 생산자의 고유 식별자입니다.

제품 설명서 ID
offers.extendedProducerResponsibility.productDocumentationId string

판매자가 항목의 소포에 추가한 모든 용지의 생산자 고유 식별자입니다.

통화
offers.extendedProducerResponsibility.ecoParticipationFee.currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
offers.extendedProducerResponsibility.ecoParticipationFee.value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

포맷
offers.format string

이 값은 제품의 목록 형식을 설정합니다.

구매자 세부 정보 숨기기
offers.hideBuyerDetails boolean

이 필드는 제품에 대해 프라이빗 목록 기능을 사용하도록 설정한 경우 true로 반환됩니다.

카탈로그 제품 세부 정보 포함
offers.includeCatalogProductDetails boolean

이 필드는 이베이 제품 카탈로그 세부 정보가 목록에 적용되는지 여부를 나타냅니다.

목록 ID
offers.listing.listingId string

게시된 제품과 연결된 이베이 목록의 고유 식별자입니다.

목록 상태
offers.listing.listingStatus string

게시된 제품과 연결된 상태를 나열합니다.

판매 수량
offers.listing.soldQuantity integer

게시된 제품에 대해 판매된 제품 수량입니다.

목록 설명
offers.listingDescription string

이베이 목록 설명.

기간 나열
offers.listingDuration string

목록이 활성화될 일 수를 나타냅니다.

통화
offers.listingPolicies.bestOfferTerms.autoAcceptPrice.currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
offers.listingPolicies.bestOfferTerms.autoAcceptPrice.value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

통화
offers.listingPolicies.bestOfferTerms.autoDeclinePrice.currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
offers.listingPolicies.bestOfferTerms.autoDeclinePrice.value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

최상의 제품 사용
offers.listingPolicies.bestOfferTerms.bestOfferEnabled boolean

이 필드는 목록에 대해 최상의 제품 기능을 사용할 수 있는지 여부를 나타냅니다.

eBay Plus 적격인 경우
offers.listingPolicies.eBayPlusIfEligible boolean

이 필드는 제품에 포함되며 Top-Rated 판매자가 이베이 플러스 프로그램에 옵트인된 경우 true로 설정됩니다.

처리 정책 ID
offers.listingPolicies.fulfillmentPolicyId string

고유 식별자는 제품이 게시되고 eBay 목록으로 변환되면 사용될 처리 비즈니스 정책을 나타냅니다.

결제 정책 ID
offers.listingPolicies.paymentPolicyId string

고유 식별자는 제품이 게시되고 eBay 목록으로 변환되면 사용될 결제 비즈니스 정책을 나타냅니다.

productCompliancePolicyIds
offers.listingPolicies.productCompliancePolicyIds array of string

이 필드에는 판매자가 목록에 대해 만든 준수 정책을 지정하는 최대 5개의 ID 배열이 포함되어 있습니다.

반환 정책 ID
offers.listingPolicies.returnPolicyId string

고유 식별자는 제품이 게시되고 eBay 목록으로 변환되면 사용될 반환 비즈니스 정책을 나타냅니다.

shippingCostOverrides
offers.listingPolicies.shippingCostOverrides array of object

이 컨테이너는 판매자가 처리 목록 정책에 정의된 하나 이상의 국내 또는 국제 배송 서비스 옵션에 대한 배송 비용 또는 추가 요금을 재정의하려는 경우에 사용됩니다.

currency
offers.listingPolicies.shippingCostOverrides.additionalShippingCost.currency string

currency

value
offers.listingPolicies.shippingCostOverrides.additionalShippingCost.value string

value

우선순위
offers.listingPolicies.shippingCostOverrides.priority integer

우선순위

currency
offers.listingPolicies.shippingCostOverrides.shippingCost.currency string

currency

value
offers.listingPolicies.shippingCostOverrides.shippingCost.value string

value

shippingServiceType
offers.listingPolicies.shippingCostOverrides.shippingServiceType string

shippingServiceType

정책 ID 다시 가져오기
offers.listingPolicies.takeBackPolicyId string

테이크백 정책을 만든 판매자 ID입니다.

목록 시작 날짜
offers.listingStartDate string

예약된 목록에 대해 판매자가 설정한 날짜/시간입니다.

Lot Size
offers.lotSize integer

이 필드는 목록이 많은 목록인 경우에만 적용 가능하고 반환됩니다.

Marketplace Id
offers.marketplaceId string

제품을 사용할 수 있거나 사용할 수 있게 될 이베이 사이트의 고유 식별자입니다.

가맹점 위치 키
offers.merchantLocationKey string

인벤토리 위치의 고유 식별자입니다.

제품 ID
offers.offerId string

제품의 고유 식별자입니다.

통화
offers.pricingSummary.auctionReservePrice.currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
offers.pricingSummary.auctionReservePrice.value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

통화
offers.pricingSummary.auctionStartPrice.currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
offers.pricingSummary.auctionStartPrice.value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

통화
offers.pricingSummary.minimumAdvertisedPrice.currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
offers.pricingSummary.minimumAdvertisedPrice.value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

원래 소매 가격에 판매
offers.pricingSummary.originallySoldForRetailPriceOn string

이 필드는 취소선 가격 책정 기능이 제품에 사용되는 경우에 필요합니다. 이 필드는 제품이 이베이 사이트의 원래 RetailPrice 필드에서 가격으로 판매되었거나 타사 소매 업체가 해당 가격에 판매했음을 나타냅니다.

통화
offers.pricingSummary.originalRetailPrice.currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
offers.pricingSummary.originalRetailPrice.value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

통화
offers.pricingSummary.price.currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
offers.pricingSummary.price.value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

가격 책정 표시 유형
offers.pricingSummary.pricingVisibility string

이 필드는 최소 광고 가격 기능이 제품에 사용되는 경우에 필요합니다.

구매자당 수량 제한
offers.quantityLimitPerBuyer integer

이 필드는 판매자가 판매자당 재고 항목의 구매 수량에 대한 제한을 설정하려는 경우에만 적용되며 설정됩니다.

보조 범주 ID
offers.secondaryCategoryId string

보조 범주에 대한 고유 식별자입니다.

SKU
offers.sku string

제품에 있는 제품의 판매자 정의 SKU 값입니다.

상태
offers.status string

값은 제품의 상태를 지정합니다.

storeCategoryNames
offers.storeCategoryNames array of string

판매자가 이베이 스토어에 대해 설정한 하나 또는 두 개의 이베이 스토어 범주에 재고 항목을 배치하도록 선택한 경우 이 컨테이너가 반환됩니다.

세금 적용
offers.tax.applyTax boolean

판매자가 주문에 대한 판매세를 계산하기 위해 계정 수준 판매세 테이블을 참조하려는 경우 이 필드가 포함됩니다.

타사 세금 범주
offers.tax.thirdPartyTaxCategory string

세금 예외 범주 코드입니다.

VAT 백분율
offers.tax.vatPercentage number

항목의 부가가치세(VAT) 비율 값(있는 경우)입니다.

이전
prev string

제품의 이전 페이지에 대한 URL입니다.

Size
size integer

결과의 현재 페이지에 표시되는 제안 수입니다.

총계
total integer

지정된 SKU 값에 대해 존재하는 총 제안 수입니다.

GET 제품

이 호출은 게시되거나 게시되지 않은 특정 제품을 검색합니다.

매개 변수

Name 필수 형식 Description
제품 ID
offerId True string

검색할 제품의 고유 식별자입니다.

반환

Name 경로 형식 Description
사용 가능한 수량
availableQuantity integer

구매자가 구매할 수 있는 인벤토리 항목의 수량입니다.

범주 ID
categoryId string

인벤토리 항목이 나열된 기본 이베이 범주의 고유 식별자입니다.

자선 ID
charity.charityId string

판매 수익금의 비율을 받을 자선 단체의 이베이 할당 고유 식별자입니다.

기부 비율
charity.donationPercentage string

자선 단체가 목록이 생성하는 각 판매에 대해 받게 되는 구매 가격 비율입니다.

생산자 제품 ID
extendedProducerResponsibility.producerProductId string

항목과 관련된 생산자의 고유 식별자입니다.

제품 패키지 ID
extendedProducerResponsibility.productPackageId string

판매자가 추가한 제품과 관련된 패키징 생산자의 고유 ID입니다.

배송 패키지 ID
extendedProducerResponsibility.shipmentPackageId string

판매자가 항목을 배송하는 데 사용하는 패키징 생산자의 고유 식별자입니다.

제품 설명서 ID
extendedProducerResponsibility.productDocumentationId string

판매자가 항목의 소포에 추가한 모든 용지의 생산자 고유 식별자입니다.

통화
extendedProducerResponsibility.ecoParticipationFee.currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
extendedProducerResponsibility.ecoParticipationFee.value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

포맷
format string

제품의 목록 형식

구매자 세부 정보 숨기기
hideBuyerDetails boolean

이 필드는 제품에 대해 프라이빗 목록 기능을 사용하도록 설정한 경우 true로 반환됩니다.

카탈로그 제품 세부 정보 포함
includeCatalogProductDetails boolean

이 필드는 이베이 제품 카탈로그 세부 정보가 목록에 적용되는지 여부를 나타냅니다.

목록 ID
listing.listingId string

게시된 제품과 연결된 이베이 목록의 고유 식별자입니다.

목록 상태
listing.listingStatus string

게시된 제품과 연결된 상태를 나열합니다.

판매 수량
listing.soldQuantity integer

게시된 제품에 대해 판매된 제품의 수량입니다.

목록 설명
listingDescription string

이베이 목록에 대한 설명

기간 나열
listingDuration string

이 필드는 목록이 활성화될 일 수를 나타냅니다.

통화
listingPolicies.bestOfferTerms.autoAcceptPrice.currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
listingPolicies.bestOfferTerms.autoAcceptPrice.value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

통화
listingPolicies.bestOfferTerms.autoDeclinePrice.currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
listingPolicies.bestOfferTerms.autoDeclinePrice.value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

최상의 제품 사용
listingPolicies.bestOfferTerms.bestOfferEnabled boolean

판매자가 목록에서 최상의 제품 기능을 지원하려는 경우 이 컨테이너가 사용됩니다.

eBay Plus 적격인 경우
listingPolicies.eBayPlusIfEligible boolean

이 필드는 Top-Rated 판매자가 이베이 플러스 프로그램에 옵트인되는 경우 제안에 포함됩니다.

처리 정책 ID
listingPolicies.fulfillmentPolicyId string

고유 식별자는 제품이 게시되고 eBay 목록으로 변환되면 사용될 처리 비즈니스 정책을 나타냅니다.

결제 정책 ID
listingPolicies.paymentPolicyId string

고유 식별자는 제품이 게시되고 eBay 목록으로 변환되면 사용될 결제 비즈니스 정책을 나타냅니다.

productCompliancePolicyIds
listingPolicies.productCompliancePolicyIds array of string

이 필드에는 판매자가 목록에 대해 만든 준수 정책을 지정하는 최대 5개의 ID 배열이 포함되어 있습니다.

반환 정책 ID
listingPolicies.returnPolicyId string

고유 식별자는 제품이 게시되고 eBay 목록으로 변환되면 사용될 반환 비즈니스 정책을 나타냅니다.

shippingCostOverrides
listingPolicies.shippingCostOverrides array of object

이 컨테이너는 판매자가 처리 목록 정책에 정의된 하나 이상의 국내 또는 국제 배송 서비스 옵션에 대한 배송 비용을 재정의하려는 경우에 사용됩니다.

통화
listingPolicies.shippingCostOverrides.additionalShippingCost.currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
listingPolicies.shippingCostOverrides.additionalShippingCost.value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

Priority
listingPolicies.shippingCostOverrides.priority integer

이 필드에 대한 정수 값 입력과 shippingServiceType 값은 처리 정책에서 업데이트된 배송 비용으로 수정될 국내 또는 국제 배송 서비스 옵션을 설정합니다.

통화
listingPolicies.shippingCostOverrides.shippingCost.currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
listingPolicies.shippingCostOverrides.shippingCost.value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

배송 서비스 유형
listingPolicies.shippingCostOverrides.shippingServiceType string

이 값은 배송 서비스가 국내 또는 국제 배송 서비스 옵션인지 여부를 나타냅니다.

정책 ID 다시 가져오기
listingPolicies.takeBackPolicyId string

판매자 ID가 테이크백 정책을 만들었습니다.

목록 시작 날짜
listingStartDate string

이 타임스탬프는 예약된 목록에 대해 판매자가 설정한 날짜/시간입니다.

Lot Size
lotSize integer

이 필드는 목록이 많은 경우에만 적용됩니다. 많은 목록은 동일한 제품의 여러 수량을 가진 목록입니다.

Marketplace Id
marketplaceId string

제품을 사용할 수 있거나 사용할 수 있게 될 이베이 사이트의 고유 식별자입니다.

가맹점 위치 키
merchantLocationKey string

인벤토리 위치의 고유 식별자입니다.

제품 ID
offerId string

제품의 고유 식별자입니다.

통화
pricingSummary.auctionReservePrice.currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
pricingSummary.auctionReservePrice.value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

통화
pricingSummary.auctionStartPrice.currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
pricingSummary.auctionStartPrice.value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

통화
pricingSummary.minimumAdvertisedPrice.currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
pricingSummary.minimumAdvertisedPrice.value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

원래 소매 가격에 판매
pricingSummary.originallySoldForRetailPriceOn string

이 필드는 취소선 가격 책정 기능이 제품에 사용되는 경우에 필요합니다. 이 필드는 제품이 이베이 사이트의 원래 RetailPrice 필드에서 가격으로 판매되었거나 타사 소매 업체가 해당 가격에 판매했음을 나타냅니다.

통화
pricingSummary.originalRetailPrice.currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
pricingSummary.originalRetailPrice.value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

통화
pricingSummary.price.currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
pricingSummary.price.value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

가격 책정 표시 유형
pricingSummary.pricingVisibility string

이 필드는 최소 광고 가격 기능이 제품에 사용되는 경우에 필요합니다.

구매자당 수량 제한
quantityLimitPerBuyer integer

이 필드는 판매자가 판매자당 재고 항목의 구매 수량에 대한 제한을 설정하려는 경우에만 적용됩니다.

보조 범주 ID
secondaryCategoryId string

보조 범주에 대한 고유 식별자이며 판매자가 두 범주 아래에 항목을 나열하기로 결정한 경우 적용됩니다.

SKU
sku string

제품에 있는 제품의 판매자 정의 SKU 값입니다.

상태
status string

값은 제품의 상태를 지정합니다.

스토어 범주 이름
storeCategoryNames array of string

스토어 범주 이름

세금 적용
tax.applyTax boolean

판매자가 계정 수준 판매세를 참조하려는 경우 이 필드가 포함됩니다.

타사 세금 범주
tax.thirdPartyTaxCategory string

세금 예외 범주 코드입니다. 이 필드를 사용하는 경우 판매세는 항목 가격뿐만 아니라 서비스/수수료에도 적용됩니다.

VAT 백분율
tax.vatPercentage number

이 값은 항목에 대한 VAT 비율(있는 경우)입니다. VAT 백분율을 지정하면 항목의 VAT 정보가 목록의 항목 보기 페이지에 표시됩니다.

결제 정책 가져오기

이 메서드는 marketplace_id 쿼리 매개 변수를 사용하여 지정한 Marketplace에 대해 구성된 모든 결제 정책을 검색합니다.

매개 변수

Name 필수 형식 Description
Marketplace Id
marketplace_id string

검색하려는 정책의 이베이 마켓플레이스 ID입니다.

반환

Name 경로 형식 Description
Href
href string

이 필드는 나중에 사용할 수 있습니다.

한계
limit integer

이 필드는 나중에 사용할 수 있습니다.

Next
next string

이 필드는 나중에 사용할 수 있습니다.

상쇄
offset integer

이 필드는 나중에 사용할 수 있습니다.

paymentPolicies
paymentPolicies array of object

지정된 마켓플레이스에 대해 정의된 판매자의 결제 비즈니스 정책 목록입니다.

categoryTypes
paymentPolicies.categoryTypes array of object

이 컨테이너는 이행 정책이 자동차 또는 비자동차 목록에 적용되는지 여부를 나타냅니다.

default
paymentPolicies.categoryTypes.default boolean

default

이름
paymentPolicies.categoryTypes.name string

이름

통화
paymentPolicies.deposit.amount.currency string

통화 금액을 설정하기 위해 값 필드에 적용되는 기본 통화입니다.

가치
paymentPolicies.deposit.amount.value string

지정된 통화의 금액입니다.

단위
paymentPolicies.deposit.dueIn.unit string

이러한 값은 DAY와 같은 시간 측정 단위를 나타냅니다.

가치
paymentPolicies.deposit.dueIn.value integer

단위 필드에 지정된 시간 측정 단위 값입니다.

Description
paymentPolicies.description string

결제 정책에 대한 판매자 정의 설명입니다.

단위
paymentPolicies.fullPaymentDueIn.unit string

DAY와 같은 시간 측정 단위입니다.

가치
paymentPolicies.fullPaymentDueIn.value integer

단위 필드에 지정된 시간 측정 단위 값입니다.

즉시 지급
paymentPolicies.immediatePay boolean

이 필드가 true로 반환되면 구매자로부터 즉시 결제가 필요합니다.

Marketplace Id
paymentPolicies.marketplaceId string

결제 비즈니스 정책이 적용되는 이베이 마켓플레이스 ID입니다.

이름
paymentPolicies.name string

이 처리 정책에 대한 판매자 정의 이름입니다.

결제 관련 지침
paymentPolicies.paymentInstructions string

이 필드는 일부 이전 결제 비즈니스 정책에 대해 반환될 수 있지만 결제 지침은 더 이상 결제 비즈니스 정책에서 지원되지 않습니다. 이 필드가 반환되면 무시될 수 있으며 해당 비즈니스 정책을 사용하는 목록에는 이러한 지불 지침이 표시되지 않습니다.

paymentMethods
paymentPolicies.paymentMethods array of object

이 컨테이너는 결제 비즈니스 정책에 허용되는 결제 방법을 표시하기 위해 반환됩니다.

paymentMethodType
paymentPolicies.paymentMethods.paymentMethodType string

결제 방법 유형

결제 정책 ID
paymentPolicies.paymentPolicyId string

결제 비즈니스 정책에 대한 고유한 eBay 할당 ID입니다.

이전
prev string

이 필드는 나중에 사용할 수 있습니다.

총계
total integer

결과 집합에서 검색된 총 결제 비즈니스 정책 수입니다.

결제 정책 가져오기

이 메서드는 결제 정책의 전체 세부 정보를 검색합니다. paymentPolicyId 경로 매개 변수를 사용하여 검색하려는 정책의 ID를 제공합니다.

매개 변수

Name 필수 형식 Description
결제 정책 ID
payment_policy_id True string

검색하려는 결제 정책 ID입니다.

반환

Name 경로 형식 Description
categoryTypes
categoryTypes array of object

이 컨테이너는 이행 정책이 자동차 또는 비자동차 목록에 적용되는지 여부를 나타냅니다.

이름
categoryTypes.name string

정책이 적용되는 범주 유형입니다.

통화
deposit.amount.currency string

통화 금액을 설정하기 위해 값 필드에 적용되는 기본 통화입니다.

가치
deposit.amount.value string

지정된 통화의 금액입니다.

단위
deposit.dueIn.unit string

DAY와 같은 시간 측정 단위입니다.

가치
deposit.dueIn.value integer

단위 필드에 지정된 시간 측정 단위 값입니다.

Description
description string

결제 정책에 대한 판매자 정의 설명입니다.

단위
fullPaymentDueIn.unit string

DAY와 같은 시간 측정 단위입니다.

가치
fullPaymentDueIn.value integer

단위 필드에 지정된 시간 측정 단위 값입니다.

즉시 지급
immediatePay boolean

이 필드가 true로 반환되면 구매자로부터 즉시 결제가 필요합니다.

Marketplace Id
marketplaceId string

결제 비즈니스 정책이 적용되는 이베이 마켓플레이스의 ID입니다.

이름
name string

결제 비즈니스 정책이 적용되는 이베이 마켓플레이스의 ID입니다.

결제 관련 지침
paymentInstructions string

이 필드는 일부 이전 결제 비즈니스 정책에 대해 반환될 수 있지만 결제 지침은 더 이상 결제 비즈니스 정책에서 지원되지 않습니다.

paymentMethods
paymentMethods array of object

이 컨테이너는 결제 비즈니스 정책에 허용되는 결제 방법을 표시하기 위해 반환됩니다.

결제 방법 유형
paymentMethods.paymentMethodType string

오프라인 지원을 위한 결제 방법 유형

결제 정책 ID
paymentPolicyId string

결제 비즈니스 정책에 대한 고유한 eBay 할당 ID입니다.

기본 범주 TreeId 가져오기

지정된 이베이 마켓플레이스는 여러 범주 트리를 사용할 수 있지만 이러한 트리 중 하나는 해당 마켓플레이스의 기본값으로 간주됩니다. 이 호출은 지정된 이베이 마켓플레이스 ID와 연결된 기본 범주 트리에 대한 참조를 검색합니다.

매개 변수

Name 필수 형식 Description
Marketplace ID
marketplace_id True string

범주 트리 ID가 요청되는 eBay 마켓플레이스 ID입니다.

여러 언어 수용 (Accept-Language)
Accept-Language True string

판매자가 응답에 선호하는 자연어를 나타내는 데 사용되는 헤더입니다.

반환

Name 경로 형식 Description
범주 트리 ID
categoryTreeId string

지정된 마켓플레이스의 eBay 고유 범주 트리 ID입니다.

범주 트리 버전
categoryTreeVersion string

categoryTreeId로 식별되는 범주 트리의 버전입니다.

반환 정책 가져오기

이 메서드는 marketplace_id 쿼리 매개 변수를 사용하여 지정한 마켓플레이스에 대해 구성된 모든 반환 정책을 검색합니다.

매개 변수

Name 필수 형식 Description
Marketplace ID
marketplace_id True string

검색하려는 정책의 이베이 마켓플레이스 ID입니다.

반환

Name 경로 형식 Description
Href
href string

이 필드는 나중에 사용할 수 있습니다.

한계
limit integer

이 필드는 나중에 사용할 수 있습니다.

Next
next string

이 필드는 나중에 사용할 수 있습니다.

상쇄
offset integer

이 필드는 나중에 사용할 수 있습니다.

이전
prev string

이 필드는 나중에 사용할 수 있습니다.

returnPolicies
returnPolicies array of object

지정된 마켓플레이스에 대해 정의된 판매자의 반품 비즈니스 정책 목록입니다.

categoryTypes
returnPolicies.categoryTypes array of object

이 컨테이너는 반환 정책이 적용되는 범주 그룹을 나타냅니다.

이름
returnPolicies.categoryTypes.name string

이름

Description
returnPolicies.description string

반품 비즈니스 정책에 대한 판매자 정의 설명입니다.

Return 메서드
returnPolicies.internationalOverride.returnMethod string

이 필드는 판매자가 국제 반품의 경우 구매자에게 대체 항목을 제공하는지 확인합니다.

단위
returnPolicies.internationalOverride.returnPeriod.unit string

이러한 열거형 값은 DAY와 같은 시간 측정 단위를 나타냅니다.

가치
returnPolicies.internationalOverride.returnPeriod.value integer

DAY와 같은 시간 측정 단위입니다.

수락된 값을 반환합니다.
returnPolicies.internationalOverride.returnsAccepted boolean

true로 설정하면 판매자는 국제 반품을 수락합니다.

반송 비용 지불자
returnPolicies.internationalOverride.returnShippingCostPayer string

이 필드는 반환된 항목에 대한 배송 요금을 지불할 책임이 있는 사용자를 나타냅니다.

Marketplace Id
returnPolicies.marketplaceId string

이 반환 비즈니스 정책이 적용되는 eBay Marketplace ID입니다.

이름
returnPolicies.name string

이 결제 비즈니스 정책의 판매자 정의 이름입니다.

환불 방법
returnPolicies.refundMethod string

판매자가 구매자 반품을 수락한다고 표시하면 이 값은 MONEY_BACK 설정됩니다.

반환 지침
returnPolicies.returnInstructions string

이 텍스트 기반 필드는 판매자가 지정한 반환 지침에 대한 자세한 내용을 제공합니다.

Return 메서드
returnPolicies.returnMethod string

이 필드는 판매자가 'Money Back'의 대안으로 대체 항목을 제공하려는 경우에만 반환됩니다.

단위
returnPolicies.returnPeriod.unit string

DAY와 같은 시간 측정 단위입니다.

가치
returnPolicies.returnPeriod.value integer

단위 필드에 지정된 시간 측정 단위 값입니다.

반환 정책 ID
returnPolicies.returnPolicyId string

반품 비즈니스 정책에 대한 고유한 eBay 할당 ID입니다.

반품 수락됨
returnPolicies.returnsAccepted boolean

이 필드가 true로 반환되면 판매자는 반환을 허용합니다.

반송 비용 지불자
returnPolicies.returnShippingCostPayer string

이 필드는 반환된 항목에 대한 배송 요금을 지불할 책임이 있는 사용자를 나타냅니다.

총계
total integer

결과 집합에서 검색된 총 반환 비즈니스 정책 수입니다.

반환 정책 가져오기

이 메서드는 returnPolicyId 경로 매개 변수로 지정된 반환 정책의 전체 세부 정보를 검색합니다.

매개 변수

Name 필수 형식 Description
반환 정책 ID
return_policy_id True string

검색할 정책 ID를 반환합니다.

반환

Name 경로 형식 Description
categoryTypes
categoryTypes array of object

이 컨테이너는 반환 정책이 적용되는 범주 그룹을 나타냅니다.

이름
categoryTypes.name string

정책이 적용되는 범주 유형입니다.

Description
description string

반품 비즈니스 정책에 대한 판매자 정의 설명입니다.

Return 메서드
internationalOverride.returnMethod string

이 필드는 판매자가 국제 반품의 경우 구매자에게 대체 항목을 제공하는지 확인합니다.

단위
internationalOverride.returnPeriod.unit string

DAY와 같은 시간 측정 단위입니다.

가치
internationalOverride.returnPeriod.value integer

단위 필드에 지정된 시간 측정 단위 값입니다.

수락된 값을 반환합니다.
internationalOverride.returnsAccepted boolean

단위 필드에 지정된 시간 측정 단위 값입니다.

반송 비용 지불자
internationalOverride.returnShippingCostPayer string

이 필드는 반환된 항목에 대한 배송 요금을 지불할 책임이 있는 사용자를 나타냅니다.

Marketplace Id
marketplaceId string

이 반환 비즈니스 정책이 적용되는 이베이 마켓플레이스의 ID입니다.

이름
name string

이 결제 비즈니스 정책의 판매자 정의 이름입니다.

환불 방법
refundMethod string

판매자가 구매자 반품을 수락한다고 표시하면 이 값은 MONEY_BACK 설정됩니다.

반환 지침
returnInstructions string

이 텍스트 기반 필드는 판매자가 지정한 반환 지침에 대한 자세한 내용을 제공합니다. 이 필드는 반환 비즈니스 정책에 대해 설정된 경우에만 반환됩니다.

Return 메서드
returnMethod string

이 필드는 판매자가 'Money Back'의 대안으로 대체 항목을 제공하려는 경우에만 반환됩니다.

단위
returnPeriod.unit string

DAY와 같은 시간 측정 단위입니다.

가치
returnPeriod.value integer

단위 필드에 지정된 시간 측정 단위 값입니다.

반환 정책 ID
returnPolicyId string

반환 비즈니스 정책에 대한 고유한 eBay 할당 ID입니다. 이 ID는 정책을 만들 때 생성됩니다.

수락된 값을 반환합니다.
returnsAccepted boolean

이 필드가 true로 반환되면 판매자는 반환을 허용합니다.

반송 비용 지불자
returnShippingCostPayer string

이 필드는 반환된 항목에 대한 배송 요금을 지불할 책임이 있는 사용자를 나타냅니다.

범주 제안 가져오기

이 호출은 지정된 범주 트리에 있는 범주 트리 리프 노드의 배열을 반환하며, 이 노드는 이베이에서 쿼리에 가장 가깝게 대응하는 것으로 간주됩니다.

매개 변수

Name 필수 형식 Description
범주 트리 ID
category_tree_id True string

제안된 노드가 요청되는 eBay 범주 트리 고유 식별자입니다.

검색 용어
q True string

판매용으로 제공되는 항목을 설명하는 검색어입니다.

반환

Name 경로 형식 Description
categorySuggestions
categorySuggestions array of object

제공된 키워드에 해당하는 하나 이상의 제안된 범주에 대한 세부 정보를 포함합니다.

범주 ID
categorySuggestions.category.categoryId string

해당 범주 트리 내에서 eBay 범주의 고유 식별자입니다.

범주 이름
categorySuggestions.category.categoryName string

categoryId로 식별되는 범주의 이름입니다.

범주 트리 노드 상위 항목
categorySuggestions.categoryTreeNodeAncestors array of object

지정된 범주 트리에서 제안된 범주의 위치를 설명하는 정렬된 범주 참조 목록의 배열입니다.

categoryId
categorySuggestions.categoryTreeNodeAncestors.categoryId string

이베이 상위 범주의 고유 식별자입니다.

categoryName
categorySuggestions.categoryTreeNodeAncestors.categoryName string

categoryId로 식별되는 상위 범주의 이름입니다.

categorySubtreeNodeHref
categorySuggestions.categoryTreeNodeAncestors.categorySubtreeNodeHref string

상위 범주 노드 아래의 하위 트리를 검색하는 getCategorySubtree 호출의 href 부분입니다.

categoryTreeNodeLevel
categorySuggestions.categoryTreeNodeAncestors.categoryTreeNodeLevel integer

해당 범주 트리의 계층 구조에 있는 상위 범주 노드의 절대 수준입니다.

범주 트리 노드 수준
categorySuggestions.categoryTreeNodeLevel integer

해당 범주 트리의 계층 구조에 있는 상위 범주 노드의 절대 수준입니다.

관련성
categorySuggestions.relevancy string

이 필드는 내부 또는 향후 사용을 위해 예약되어 있습니다.

범주 트리 ID
categoryTreeId string

제안이 반환되는 이베이 범주 트리의 고유 식별자입니다.

범주 트리 버전
categoryTreeVersion string

categoryTreeId로 식별되는 범주 트리의 버전입니다.

범주에 대한 항목 측면 가져오기

이 호출은 지정된 리프 범주의 항목을 정확하게 설명하는 데 적합하거나 필요한 측면 목록을 반환합니다. 각 측면은 eBay에서 해당 범주의 항목을 제공할 때 판매자가 요구하거나 값(또는 변형 값)을 제공하도록 권장되는 항목 특성(예: 색)을 식별합니다.

매개 변수

Name 필수 형식 Description
범주 트리 ID
category_tree_id True string

지정된 범주의 측면이 요청되는 eBay 범주 트리 고유 ID입니다.

범주 ID
category_id True string

측면이 요청되는 리프 범주 고유 식별자입니다.

반환

Name 경로 형식 Description
측면
aspects array of object

특정 리프 범주의 항목을 설명하는 데 적합한 항목 측면 목록

적용할 수 있는 측면
aspects.aspectConstraint.aspectApplicableTo array of string

이 값은 aspects.localizedAspectName 필드로 식별되는 측면이 제품 측면인지 또는 항목/인스턴스 측면인지를 나타내며, 이는 해당 값이 제품의 특정 인스턴스에 따라 달라지는 측면입니다.

측면 데이터 형식
aspects.aspectConstraint.aspectDataType string

양상 데이터 형식입니다.

변형에 사용할 수 있는 측면
aspects.aspectConstraint.aspectEnabledForVariations boolean

true 값은 이 측면을 사용하여 항목 변형을 식별할 수 있음을 나타냅니다.

가로 세로 형식
aspects.aspectConstraint.aspectFormat string

aspectDataType 값이 특정 서식이 필요한 데이터 형식을 식별하는 경우에만 반환됩니다.

가로 세로 최대 길이
aspects.aspectConstraint.aspectMaxLength integer

항목 측면 값의 최대 길이입니다.

가로 세로 모드
aspects.aspectConstraint.aspectMode string

판매자가 이 측면의 값을 지정해야 하는 방식입니다.

필요한 측면
aspects.aspectConstraint.aspectRequired boolean

true 값은 지정된 범주의 항목을 제공할 때 이 측면이 필요하다는 것을 나타냅니다.

측면 사용량
aspects.aspectConstraint.aspectUsage string

값은 해당 측면이 권장되는지 선택 사항인지를 나타냅니다.

날짜별로 필요한 예상
aspects.aspectConstraint.expectedRequiredByDate string

예상 날짜 후 측면이 필요합니다.

측면 카디널리티에 대한 항목
aspects.aspectConstraint.itemToAspectCardinality string

이 측면이 지정된 범주의 항목에 대해 단일 또는 여러 값을 허용할 수 있는지 여부를 나타냅니다.

aspectValues
aspects.aspectValues array of object

이 측면에 대한 제약 조건과 함께 유효한 값 목록입니다.

localizedValue
aspects.aspectValues.localizedValue string

이 측면의 지역화된 값입니다.

valueConstraints
aspects.aspectValues.valueConstraints array of object

localizedValue 필드의 값을 현재 측면에 사용할 수 있는 시기를 식별하는 종속성 목록을 포함합니다.

applicableForLocalizedAspectName
aspects.aspectValues.valueConstraints.applicableForLocalizedAspectName string

현재 가로 세로 값이 의존하는 컨트롤 측면의 이름입니다.

applicableForLocalizedAspectValues
aspects.aspectValues.valueConstraints.applicableForLocalizedAspectValues array of string

이 측면의 값이 의존하는 컨트롤 측면의 값 목록을 포함합니다.

지역화된 가로 세로 이름
aspects.localizedAspectName string

이 측면의 지역화된 이름입니다.

검색 개수
aspects.relevanceIndicator.searchCount integer

측면에 대한 최근 검색 수입니다.

인벤토리 위치 가져오기

이 호출은 merchantLocationKey 경로 매개 변수로 지정된 인벤토리 위치에 대해 정의된 모든 세부 정보를 검색합니다.

매개 변수

Name 필수 형식 Description
가맹점 위치 키
merchantLocationKey True string

인벤토리 위치에 대한 고유한 가맹점 정의 키(ID)입니다.

반환

Name 경로 형식 Description
주소 줄 1
location.address.addressLine1 string

주소의 첫 줄입니다.

주소 줄 2
location.address.addressLine2 string

주소의 두 번째 줄입니다.

도시
location.address.city string

인벤토리 위치가 있는 도시입니다.

국가
location.address.country string

주소가 있는 국가 코드

location.address.county string

주소가 있는 카운티입니다.

우편 번호
location.address.postalCode string

주소의 우편/우편 번호입니다.

주 또는 주
location.address.stateOrProvince string

인벤토리 위치가 있는 시/도입니다.

위도
location.geoCoordinates.latitude string

지리적 좌표의 위도 구성 요소입니다.

경도
location.geoCoordinates.longitude string

지리적 좌표의 경도 구성 요소입니다.

위치 ID
location.locationId string

위치에 대한 고유 이베이 할당 ID입니다.

위치 추가 정보
locationAdditionalInformation string

이 텍스트 필드는 인벤토리 위치에 대한 추가 정보를 제공합니다.

위치 지침
locationInstructions string

이 필드는 판매자가 매장 위치에 대한 특별 픽업 지침을 제공하는 데 사용됩니다.

locationTypes
locationTypes array of string

이 컨테이너는 인벤토리 위치의 함수를 정의합니다.

위치 웹 URL
locationWebUrl string

필드에는 인벤토리 위치와 연결된 웹 사이트 주소가 표시됩니다.

가맹점 위치 키
merchantLocationKey string

인벤토리 위치의 고유 식별자입니다.

가맹점 위치 상태
merchantLocationStatus string

필드는 인벤토리 위치의 사용 여부를 나타냅니다.

이름
name string

인벤토리 위치의 이름입니다.

operatingHours
operatingHours array of object

이 컨테이너는 요일 동안 매장 위치의 정기적인 운영 시간을 보여줍니다.

주 열거형
operatingHours.dayOfWeekEnum string

매장 위치에 정기적인 운영 시간이 있는 요일마다 값이 필요합니다.

간격
operatingHours.intervals array of object

이 컨테이너는 매장 작업일의 영업/폐점 시간을 정의하는 데 사용됩니다.

close
operatingHours.intervals.close string

close

열다
operatingHours.intervals.open string

열다

Phone
phone string

인벤토리 위치의 전화 번호입니다.

SpecialHours
specialHours array of object

이 컨테이너는 특정 날짜 또는 날짜에 저장소 위치에 대한 특별한 운영 시간을 표시합니다.

날짜
specialHours.date string

저장소 위치에 특별한 운영 시간이 있는 각 특정 날짜에 날짜 값이 필요합니다.

간격
specialHours.intervals array of object

이 컨테이너는 특정 날짜에 저장소의 열기/닫는 시간을 정의하는 데 사용됩니다.

close
specialHours.intervals.close string

close

열다
specialHours.intervals.open string

열다

인벤토리 위치 가져오기

이 호출은 판매자의 계정과 연결된 모든 인벤토리 위치에 대해 정의된 모든 세부 정보를 검색합니다.

매개 변수

Name 필수 형식 Description
상쇄
offset string

첫 번째 위치를 반환하기 전에 결과 집합에서 건너뛸 위치 수를 지정합니다.

한계
limit string

데이터 페이지당 반환할 최대 레코드 수입니다.

반환

Name 경로 형식 Description
Href
href string

결과 집합의 결과 현재 페이지의 URI입니다.

한계
limit integer

결과 집합에서 단일 페이지에 반환된 항목 수입니다.

Next
next string

결과의 다음 페이지에 대한 URI입니다.

상쇄
offset string

첫 번째 반환된 결과를 나열하기 전에 결과 집합에서 건너뛴 결과 수입니다.

이전
prev string

결과의 이전 페이지에 대한 URI입니다.

총계
total integer

결과 집합에서 검색된 총 항목 수입니다.

위치
locations array of object

하나 이상의 가맹점 인벤토리 위치 배열입니다.

주소 줄 1
locations.location.address.addressLine1 string

주소의 첫 줄입니다.

주소 줄 2
locations.location.address.addressLine2 string

주소의 두 번째 줄입니다.

도시
locations.location.address.city string

인벤토리 위치가 있는 도시입니다.

국가
locations.location.address.country string

주소가 있는 국가 코드입니다.

locations.location.address.county string

주소가 있는 카운티입니다.

우편 번호
locations.location.address.postalCode string

주소의 우편/우편 번호입니다.

주 또는 주
locations.location.address.stateOrProvince string

인벤토리 위치가 있는 시/도입니다.

위도
locations.location.geoCoordinates.latitude string

지리적 좌표의 위도 구성 요소입니다.

경도
locations.location.geoCoordinates.longitude string

지리적 좌표의 경도 구성 요소입니다.

위치 ID
locations.location.locationId string

위치에 대한 고유 이베이 할당 ID입니다.

위치 추가 정보
locations.locationAdditionalInformation string

이 필드는 인벤토리 위치에 대한 추가 정보를 제공합니다.

위치 지침
locations.locationInstructions string

이 필드는 판매자가 매장 위치에 대한 특별 픽업 지침을 제공하는 데 사용됩니다.

locationTypes
locations.locationTypes array of string

이 컨테이너는 인벤토리 위치의 함수를 정의합니다.

위치 웹 URL
locations.locationWebUrl string

이 필드에는 인벤토리 위치와 연결된 웹 사이트 주소가 표시됩니다.

가맹점 위치 키
locations.merchantLocationKey string

인벤토리 위치의 고유 식별자입니다.

가맹점 위치 상태
locations.merchantLocationStatus string

이 필드는 인벤토리 위치의 사용 여부를 나타냅니다.

이름
locations.name string

인벤토리 위치의 이름입니다.

operatingHours
locations.operatingHours array of object

이 컨테이너는 요일 동안 매장 위치의 정기적인 운영 시간을 보여줍니다.

dayOfWeekEnum
locations.operatingHours.dayOfWeekEnum string

dayOfWeekEnum

간격
locations.operatingHours.intervals array of object

이 컨테이너는 매장 작업일의 영업/폐점 시간을 정의하는 데 사용됩니다.

close
locations.operatingHours.intervals.close string

close

열다
locations.operatingHours.intervals.open string

열다

Phone
locations.phone string

인벤토리 위치의 전화 번호입니다.

specialHours
locations.specialHours array of object

이 컨테이너는 특정 날짜 또는 날짜에 저장소 위치에 대한 특별한 운영 시간을 표시합니다.

date
locations.specialHours.date string

date

간격
locations.specialHours.intervals array of object

이 컨테이너는 특정 날짜에 저장소의 열기 및 닫는 시간을 정의하는 데 사용됩니다.

close
locations.specialHours.intervals.close string

close

열다
locations.specialHours.intervals.open string

열다

인벤토리 위치 만들기

이 호출을 사용하여 새 인벤토리 위치를 만듭니다. 제품을 만들고 게시하려면 모든 제품이 위치와 연결되어야 하므로 판매자에게 가장 가까운 인벤토리 위치가 있어야 합니다.

매개 변수

Name 필수 형식 Description
가맹점 위치 키
merchantLocationKey True string

인벤토리 위치에 대한 고유한 가맹점 정의 키입니다.

주소 줄 1
addressLine1 string

주소의 첫 줄입니다.

주소 줄 2
addressLine2 string

주소의 두 번째 줄입니다.

도시
city string

인벤토리 위치가 있는 도시입니다.

국가
country string

주소가 상주하는 국가 코드입니다.

county string

주소가 상주하는 카운티입니다.

우편 번호
postalCode string

주소의 우편/우편 번호입니다.

주 또는 주
stateOrProvince string

인벤토리 위치가 있는 시/도입니다.

위도
latitude string

지리적 좌표의 위도 구성 요소입니다.

경도
longitude string

지리적 좌표의 경도 구성 요소입니다.

위치 추가 정보
locationAdditionalInformation string

인벤토리 위치에 대한 추가 정보입니다.

위치 지침
locationInstructions string

매장 인벤토리 위치에 대한 특별 픽업 지침입니다.

locationTypes
locationTypes array of string

위치 유형

위치 웹 URL
locationWebUrl string

인벤토리 위치와 연결된 웹 사이트 주소입니다.

가맹점 위치 상태
merchantLocationStatus string

인벤토리 위치 상태를 사용하거나 사용하지 않도록 설정할 수 있습니다.

이름
name string

인벤토리 위치의 이름입니다.

요일
dayOfWeekEnum string

매장 위치에 정기적인 운영 시간이 있는 날입니다.

close
close string

스토어 닫는 시간.

열다
open string

스토어 열기 시간입니다.

Phone
phone string

매장 인벤토리 위치의 전화 번호입니다.

날짜
date string

저장소 위치에 특별한 운영 시간이 있는 특정 날짜 값입니다.

close
close string

스토어 닫는 시간.

열다
open string

스토어 열기 시간입니다.

반환

response
string

인벤토리 항목 가져오기

이 호출은 지정된 SKU에 대한 인벤토리 항목 레코드를 검색합니다.

매개 변수

Name 필수 형식 Description
SKU
sku True string

인벤토리 항목 레코드를 검색하려는 제품의 판매자 정의 값입니다.

반환

Name 경로 형식 Description
PickupAtLocationAvailability
availability.pickupAtLocationAvailability array of object

이 컨테이너는 매장 내 픽업에 재고 항목을 사용할 수 있는 가맹점의 실제 매장 배열로 구성됩니다.

가용성 유형
availability.pickupAtLocationAvailability.availabilityType string

이 필드는 가맹점의 실제 저장소에 있는 재고 항목의 가용성 상태를 나타냅니다.

단위
availability.pickupAtLocationAvailability.fulfillmentTime.unit string

이 값은 처리 시간을 지정하는 데 사용되는 시간 단위를 나타냅니다.

가치
availability.pickupAtLocationAvailability.fulfillmentTime.value integer

이 필드의 정수 값과 단위 필드의 시간 단위는 처리 시간을 나타냅니다.

가맹점 위치 키
availability.pickupAtLocationAvailability.merchantLocationKey string

In-Store 픽업 인벤토리 항목이 현재 있거나 전송될 판매자의 스토어 고유 식별자입니다.

수량
availability.pickupAtLocationAvailability.quantity integer

이 정수 값은 In-Store 픽업에 사용할 수 있는 인벤토리 항목의 수량을 나타냅니다.

경매
availability.shipToLocationAvailability.allocationByFormat.auction integer

이 정수 값은 SKU의 게시된 경매 형식 제품에 예약된 인벤토리 항목의 수량을 나타냅니다.

고정 가격
availability.shipToLocationAvailability.allocationByFormat.fixedPrice integer

이 정수 값은 SKU의 고정 가격 제안에 사용할 수 있는 인벤토리 항목의 수량을 나타냅니다.

AvailabilityDistributions
availability.shipToLocationAvailability.availabilityDistributions array of object

이 컨테이너는 하나 이상의 웨어하우스 위치에서 재고 항목의 사용 가능한 수량을 설정하는 데 사용됩니다.

단위
availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.unit string

이 값은 처리 시간을 지정하는 데 사용되는 시간 단위를 나타냅니다.

가치
availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.value integer

이 필드의 정수 값과 단위 필드의 시간 단위는 처리 시간을 나타냅니다.

가맹점 위치 키
availability.shipToLocationAvailability.availabilityDistributions.merchantLocationKey string

인벤토리 항목에 수량을 사용할 수 있는 인벤토리 위치의 고유 식별자입니다.

수량
availability.shipToLocationAvailability.availabilityDistributions.quantity integer

이 인벤토리 위치에서 사용할 수 있는 인벤토리 항목의 수량입니다.

수량
availability.shipToLocationAvailability.quantity integer

이 컨테이너는 하나 이상의 게시된 제품을 통해 구매할 수 있는 재고 항목의 총 '배송-투-홈' 수량을 설정하는 데 사용됩니다.

Condition
condition string

이 값은 항목의 조건을 나타냅니다.

조건 설명
conditionDescription string

이 문자열 필드는 판매자가 사용된 항목 또는 'New', 'New with tags' 또는 'New in box'가 아닌 항목을 보다 명확하게 설명하는 데 사용됩니다.

그룹 ID
groupIds array of string
inventoryItemGroupKeys
inventoryItemGroupKeys array of string

인벤토리 항목이 인벤토리 항목 그룹과 연결된 경우 이 배열이 반환됩니다.

로케일
locale string

이 필드는 요청 페이로드의 필드 값에 제공된 자연어를 반환합니다.

높이
packageWeightAndSize.dimensions.height number

배송 패키지의 실제 높이입니다.

Length
packageWeightAndSize.dimensions.length number

배송 패키지의 실제 길이입니다.

단위
packageWeightAndSize.dimensions.unit string

배송 패키지의 크기를 지정하는 데 사용되는 측정 단위입니다.

너비
packageWeightAndSize.dimensions.width number

배송 패키지의 실제 너비입니다.

패키지 유형
packageWeightAndSize.packageType string

이 값은 인벤토리 항목을 배송하는 데 사용되는 배송 패키지의 유형을 나타냅니다.

단위
packageWeightAndSize.weight.unit string

배송 패키지의 가중치를 지정하는 데 사용되는 측정 단위입니다.

가치
packageWeightAndSize.weight.value number

배송 패키지의 실제 가중치입니다.

측면
product.aspects object

제품에 대한 자세한 정보를 제공하고 구매자가 더 쉽게 찾을 수 있도록 하는 항목별 이름-값 쌍의 컬렉션입니다.

브랜드
product.brand string

제품의 브랜드입니다.

Description
product.description string

제품에 대한 설명입니다.

ean
product.ean array of string

제품에 대한 유럽 문서 번호/국제 문서 번호(EAN)입니다.

ePID
product.epid string

제품의 ePID(eBay 제품 식별자)입니다.

imageUrls
product.imageUrls array of string

제품에 대한 이미지에 대한 하나 이상의 링크 배열입니다.

isbn
product.isbn array of string

제품의 국제 표준 도서 번호 값입니다.

MPN
product.mpn string

제품의 MPN(제조업체 부품 번호)입니다.

부제목
product.subtitle string

부제목은 판매자가 검색 결과에 도움이 될 수 있는 키워드를 포함하여 제품에 대한 자세한 정보를 제공할 수 있는 선택적 목록 기능입니다.

제목
product.title string

createOrReplaceInventoryItem 호출을 사용하여 인벤토리 항목의 제목을 추가하거나 수정할 수 있습니다.

upc
product.upc array of string

제품의 국제 표준 도서 번호 값입니다.

videoIds
product.videoIds array of string

제품에 대한 하나 이상의 VideoId 값 배열입니다.

SKU
sku string

인벤토리 항목의 판매자 정의 SKU(Stock-Keeping Unit)입니다. 판매자는 판매하는 모든 제품에 대해 고유한 SKU 값을 가져야 합니다.

인벤토리 항목 가져오기

이 호출은 판매자의 계정에 대해 정의된 모든 인벤토리 항목 레코드를 검색합니다.

매개 변수

Name 필수 형식 Description
한계
limit string

데이터 페이지당 반환할 최대 레코드 수입니다.

상쇄
offset string

검색할 페이지 번호입니다.

반환

Name 경로 형식 Description
Href
href string

인벤토리 항목의 현재 페이지에 대한 URL입니다.

inventoryItems
inventoryItems array of object

이 컨테이너는 하나 이상의 인벤토리 항목 배열입니다.

pickupAtLocationAvailability
inventoryItems.availability.pickupAtLocationAvailability array of object

이 컨테이너는 매장 내 픽업에 재고 항목을 사용할 수 있는 가맹점의 실제 매장 배열로 구성됩니다.

availabilityType
inventoryItems.availability.pickupAtLocationAvailability.availabilityType string

인벤토리 항목의 가용성 상태

단위
inventoryItems.availability.pickupAtLocationAvailability.fulfillmentTime.unit string

처리 시간을 지정하는 데 사용되는 시간 단위

value
inventoryItems.availability.pickupAtLocationAvailability.fulfillmentTime.value integer

이 필드의 정수 값과 단위 필드의 시간 단위는 처리 시간을 나타냅니다.

merchantLocationKey
inventoryItems.availability.pickupAtLocationAvailability.merchantLocationKey string

In-Store 픽업 인벤토리 항목이 현재 있거나 전송되는 판매자의 저장소 고유 식별자입니다.

수량
inventoryItems.availability.pickupAtLocationAvailability.quantity integer

수량

경매
inventoryItems.availability.shipToLocationAvailability.allocationByFormat.auction integer

이 정수 값은 SKU의 게시된 경매 형식 제품에 예약된 인벤토리 항목의 수량을 나타냅니다.

고정 가격
inventoryItems.availability.shipToLocationAvailability.allocationByFormat.fixedPrice integer

이 값은 SKU의 고정 가격 제품에 사용할 수 있는 인벤토리 항목의 수량을 나타냅니다.

availabilityDistributions
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions array of object

이 컨테이너는 하나 이상의 웨어하우스 위치에서 재고 항목의 사용 가능한 수량을 설정하는 데 사용됩니다.

단위
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.unit string

단위

value
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.value integer

value

merchantLocationKey
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.merchantLocationKey string

merchantLocationKey

수량
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.quantity integer

수량

수량
inventoryItems.availability.shipToLocationAvailability.quantity integer

이 컨테이너는 하나 이상의 게시된 제품을 통해 구매할 수 있는 재고 항목의 총 '배송-투-홈' 수량을 설정하는 데 사용됩니다.

Condition
inventoryItems.condition string

이 값은 항목의 조건을 나타냅니다.

조건 설명
inventoryItems.conditionDescription string

이 문자열 필드는 판매자가 항목의 조건을 보다 명확하게 설명하는 데 사용됩니다.

그룹 ID
inventoryItems.groupIds array of string

인벤토리 항목이 인벤토리 항목 그룹과 연결된 경우 이 배열이 반환됩니다.

inventoryItemGroupKeys
inventoryItems.inventoryItemGroupKeys array of string

인벤토리 항목이 인벤토리 항목 그룹과 연결된 경우 이 배열이 반환됩니다.

로케일
inventoryItems.locale string

이 필드는 요청 페이로드의 필드 값에 제공된 자연어를 반환합니다.

높이
inventoryItems.packageWeightAndSize.dimensions.height number

배송 패키지의 실제 높이입니다.

Length
inventoryItems.packageWeightAndSize.dimensions.length number

배송 패키지의 실제 길이입니다.

단위
inventoryItems.packageWeightAndSize.dimensions.unit string

배송 패키지의 크기를 지정하는 데 사용되는 측정 단위입니다.

너비
inventoryItems.packageWeightAndSize.dimensions.width number

배송 패키지의 실제 너비입니다.

너비
inventoryItems.packageWeightAndSize.packageType string

인벤토리 항목을 배송하는 데 사용되는 배송 패키지의 유형입니다.

단위
inventoryItems.packageWeightAndSize.weight.unit string

배송 패키지의 가중치를 지정하는 데 사용되는 측정 단위입니다.

가치
inventoryItems.packageWeightAndSize.weight.value number

배송 패키지의 실제 가중치입니다.

측면
inventoryItems.product.aspects object

제품에 대한 자세한 정보를 제공하고 구매자가 더 쉽게 찾을 수 있도록 하는 항목별 이름-값 쌍의 컬렉션입니다.

브랜드
inventoryItems.product.brand string

제품의 브랜드입니다. 이 필드는 제조 부품 번호로 특정 제품을 식별하기 위해 mpn 필드와 페어링되는 경우가 많습니다.

Description
inventoryItems.product.description string

제품에 대한 설명입니다.

ean
inventoryItems.product.ean array of string

제품에 대한 유럽 문서 번호/국제 문서 번호입니다.

ePID
inventoryItems.product.epid string

제품의 ePID(eBay 제품 식별자)입니다.

imageUrls
inventoryItems.product.imageUrls array of string

제품에 대한 이미지에 대한 하나 이상의 링크 배열입니다.

isbn
inventoryItems.product.isbn array of string

제품의 국제 표준 도서 번호 값입니다.

MPN
inventoryItems.product.mpn string

제품의 제조업체 부품 번호입니다.

부제목
inventoryItems.product.subtitle string

부제목은 판매자가 검색 결과에 도움이 될 수 있는 키워드를 포함하여 제품에 대한 자세한 정보를 제공할 수 있는 선택적 목록 기능입니다.

제목
inventoryItems.product.title string

인벤토리 항목의 제목을 추가하거나 수정할 수 있습니다.

upc
inventoryItems.product.upc array of string

제품에 대한 유니버설 제품 코드 값입니다.

videoIds
inventoryItems.product.videoIds array of string

제품에 대한 하나 이상의 VideoId 값 배열입니다.

SKU
inventoryItems.sku string

인벤토리 항목의 판매자 정의 Stock-Keeping 단위입니다.

한계
limit integer

각 결과 페이지에 표시될 인벤토리 항목 수입니다.

Next
next string

인벤토리 항목의 다음 페이지에 대한 URL입니다.

이전
prev string

인벤토리 항목의 이전 페이지에 대한 URL입니다.

Size
size integer

사용할 수 있는 결과의 총 페이지 수입니다.

총계
total integer

판매자 계정에 대해 존재하는 인벤토리 항목의 Ttotal 수입니다.

인벤토리 항목 만들기 또는 바꾸기

이 호출은 새 인벤토리 항목 레코드를 만들거나 기존 인벤토리 항목 레코드를 대체합니다.

매개 변수

Name 필수 형식 Description
SKU
sku True string

인벤토리 항목에 대한 판매자 정의 값입니다.

Content-Language
Content-Language True string

헤더는 요청 페이로드의 필드 값에 사용될 자연어를 설정합니다.

유형
availabilityType string

가맹점의 실제 저장소에 있는 재고 항목의 가용성 상태입니다.

단위
unit string

처리 시간을 지정하는 데 사용되는 시간 단위입니다.

가치
value integer

처리 시간 값입니다.

가맹점 위치 키
merchantLocationKey string

In-Store 픽업 인벤토리 항목이 현재 있거나 전송되는 판매자의 스토어 고유 ID입니다.

수량
quantity integer

In-Store 픽업에 사용할 수 있는 인벤토리 항목의 수량입니다.

단위
unit string

처리 시간을 지정하는 데 사용되는 시간 단위입니다.

가치
value integer

처리 시간 값입니다.

가맹점 위치 키
merchantLocationKey string

In-Store 픽업 인벤토리 항목이 현재 있거나 전송될 판매자의 스토어 고유 ID입니다.

수량
quantity integer

이 인벤토리 위치에서 사용할 수 있는 인벤토리 항목의 수량입니다.

수량
quantity integer

하나 이상의 게시된 제품을 통해 구매할 수 있는 재고 항목의 총 '배송-투-홈' 수량입니다.

Condition
condition string

항목의 조건입니다.

조건 설명
conditionDescription string

인벤토리 항목에 대한 조건 설명입니다.

높이
height number

배송 패키지의 실제 높이입니다.

Length
length number

배송 패키지의 실제 길이입니다.

단위
unit string

배송 패키지의 크기를 지정하는 데 사용되는 측정 단위입니다.

너비
width number

배송 패키지의 실제 너비입니다.

패키지 유형
packageType string

인벤토리 항목을 배송하는 데 사용되는 배송 패키지 값입니다.

단위
unit string

배송 패키지의 가중치를 지정하는 데 사용되는 측정 단위입니다.

가치
value number

배송 패키지의 실제 가중치입니다.

측면
aspects object

제품에 대한 자세한 정보를 제공하고 구매자가 더 쉽게 찾을 수 있도록 하는 항목별 이름-값 쌍의 컬렉션입니다.

브랜드
brand string

제품의 브랜드입니다.

Description
description string

제품에 대한 설명입니다.

EAN 항목
ean array of string

EAN

ePID
epid string

제품에 대한 이베이 제품 식별자입니다.

이미지 URL
imageUrls array of string

이미지 URL

ISBN 항목
isbn array of string

ISBN

MPN
mpn string

제품의 제조업체 부품 번호입니다.

부제목
subtitle string

판매자가 검색 결과에 도움이 될 수 있는 키워드를 포함하여 제품에 대한 자세한 정보를 제공할 수 있는 선택적 목록 기능입니다.

제목
title string

인벤토리 항목의 제목을 추가하거나 수정할 수 있습니다.

UPC 항목
upc array of string

upc

비디오 ID
videoIds array of string

videoIds

반환

Name 경로 형식 Description
경고
warnings array of object

하나 이상의 경고 또는 오류가 트리거되는 경우 이 컨테이너는 호출 응답 페이로드에 반환됩니다.

카테고리
warnings.category string

이 문자열 값은 오류 범주를 나타냅니다.

도메인
warnings.domain string

오류 또는 경고가 발생한 도메인의 이름입니다.

오류 ID
warnings.errorId integer

발생한 특정 오류 또는 경고를 식별하는 고유 코드입니다.

inputRefIds
warnings.inputRefIds array of string

오류 또는 경고와 가장 밀접하게 연결된 특정 요청 요소를 식별하는 하나 이상의 참조 ID 배열입니다(있는 경우).

긴 메시지
warnings.longMessage string

오류 또는 경고를 발생시킨 조건에 대한 자세한 설명 및 문제를 해결하기 위해 수행할 작업 정보입니다.

Message
warnings.message string

오류 또는 경고를 발생시킨 조건에 대한 설명입니다.

outputRefIds
warnings.outputRefIds array of string

오류 또는 경고와 가장 밀접하게 연결된 특정 응답 요소를 식별하는 하나 이상의 참조 ID 배열입니다(있는 경우).

parameters
warnings.parameters array of object

다양한 경고 및 오류 메시지는 오류 또는 경고에 대한 컨텍스트 정보를 포함하는 하나 이상의 변수를 반환합니다.

이름
warnings.parameters.name string

이름

value
warnings.parameters.value string

value

Subdomain
warnings.subdomain object

오류 또는 경고를 발생시킨 조건에 대한 설명입니다.

제안 철회

이 호출은 지정된 제품과 연결된 단일 변형 목록을 종료하는 데 사용됩니다.

매개 변수

Name 필수 형식 Description
제품 ID
offerId True string

철회할 제품의 고유 식별자입니다.

반환

Name 경로 형식 Description
목록 ID
listingId string

철회된 제품과 연결된 이베이 목록의 고유 식별자입니다.

경고
warnings array of object

제안을 철회하려는 시도와 관련된 경고가 하나 이상 있는 경우 이 컨테이너가 반환됩니다.

카테고리
warnings.category string

이 문자열 값은 오류 범주를 나타냅니다.

도메인
warnings.domain string

이 문자열 값은 오류 범주를 나타냅니다.

오류 ID
warnings.errorId integer

발생한 특정 오류 또는 경고를 식별하는 고유 코드입니다.

inputRefIds
warnings.inputRefIds array of string

오류 또는 경고와 가장 밀접하게 연결된 특정 요청 요소를 식별하는 하나 이상의 참조 ID 배열입니다(있는 경우).

긴 메시지
warnings.longMessage string

오류 또는 경고를 발생시킨 조건에 대한 자세한 설명 및 문제를 해결하기 위해 수행할 작업 정보입니다.

Message
warnings.message string

오류 또는 경고를 발생시킨 조건에 대한 설명입니다.

outputRefIds
warnings.outputRefIds array of string

제안을 철회하려는 시도와 관련된 경고가 하나 이상 있는 경우 이 컨테이너가 반환됩니다.

parameters
warnings.parameters array of object

다양한 경고 및 오류 메시지는 오류 또는 워딩에 대한 컨텍스트 정보를 포함하는 하나 이상의 변수를 반환합니다.

이름
warnings.parameters.name string

이름

value
warnings.parameters.value string

value

Subdomain
warnings.subdomain string

오류 또는 경고가 발생한 하위 도메인의 이름입니다.

제품 게시

이 호출은 게시되지 않은 제품을 게시된 제품 또는 라이브 이베이 목록으로 변환하는 데 사용됩니다. 제안의 고유 식별자(offerId)는 호출 URI가 끝날 때 전달됩니다.

매개 변수

Name 필수 형식 Description
제품 ID
offerId True string

게시할 제품의 고유 식별자입니다.

반환

Name 경로 형식 Description
목록 ID
listingId string

새로 만든 이베이 목록의 고유 식별자입니다.

경고
warnings array of object

제안을 철회하려는 시도와 관련된 경고가 하나 이상 있는 경우 이 컨테이너가 반환됩니다.

카테고리
warnings.category string

이 문자열 값은 오류 범주를 나타냅니다.

도메인
warnings.domain string

오류 또는 경고가 발생한 도메인의 이름입니다.

오류 ID
warnings.errorId integer

발생한 특정 오류 또는 경고를 식별하는 고유 코드입니다.

inputRefIds
warnings.inputRefIds array of string

오류 또는 경고와 가장 밀접하게 연결된 특정 요청 요소를 식별하는 하나 이상의 참조 ID 배열입니다(있는 경우).

긴 메시지
warnings.longMessage string

오류 또는 경고를 발생시킨 조건에 대한 자세한 설명 및 문제를 해결하기 위해 수행할 작업 정보입니다.

Message
warnings.message string

오류 또는 경고를 발생시킨 조건에 대한 설명입니다.

outputRefIds
warnings.outputRefIds array of string

오류 또는 경고와 가장 밀접하게 연결된 특정 응답 요소를 식별하는 하나 이상의 참조 ID 배열입니다(있는 경우).

parameters
warnings.parameters array of object

다양한 경고 및 오류 메시지는 오류 또는 경고에 대한 컨텍스트 정보를 포함하는 하나 이상의 변수를 반환합니다.

이름
warnings.parameters.name string

이름

value
warnings.parameters.value string

value

Subdomain
warnings.subdomain string

오류 또는 경고가 발생한 하위 도메인의 이름입니다.

제품 만들기

이 호출은 특정 이베이 마켓플레이스에서 특정 인벤토리 항목에 대한 제안을 만듭니다.

매개 변수

Name 필수 형식 Description
사용 가능한 수량
availableQuantity integer

구매에 사용할 수 있는 재고 수량입니다.

범주 ID
categoryId string

제품이 나열될 이베이 고유 범주 ID입니다.

자선 ID
charityId string

판매 수익의 비율을 받을 자선 단체의 이베이 할당 고유 ID입니다.

기부 비율
donationPercentage string

자선 단체가 목록이 생성하는 각 판매에 대해 받게 되는 구매 가격 비율입니다.

생산자 제품 ID
producerProductId string

항목과 관련된 생산자의 고유 식별자입니다.

제품 패키지 ID
productPackageId string

판매자가 추가한 제품 패키징 생산자의 고유 ID입니다.

배송 패키지 ID
shipmentPackageId string

판매자가 품목을 배송하는 데 사용하는 패키징 생산자의 고유 ID입니다.

제품 설명서 ID
productDocumentationId string

판매자가 항목의 소포에 추가한 모든 용지의 생산자 고유 식별자입니다.

통화
currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

포맷
format string

제품의 목록 형식입니다.

구매자 세부 정보 숨기기
hideBuyerDetails boolean

판매자가 비공개 목록을 만들려는 경우 이 필드가 포함됩니다.

카탈로그 제품 세부 정보 포함
includeCatalogProductDetails boolean

이베이 제품 카탈로그 세부 정보가 목록에 적용되는지 여부를 나타냅니다.

목록 설명
listingDescription string

이베이 목록에 대한 설명입니다.

기간 나열
listingDuration string

목록이 활성화될 일 수입니다.

통화
currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

통화
currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

최상의 제품 사용
bestOfferEnabled boolean

목록에 대해 최상의 제품 기능을 사용할 수 있는지 여부를 나타냅니다.

eBay Plus 적격인 경우
eBayPlusIfEligible boolean

이 필드는 Top-Rated 판매자가 이베이 플러스 프로그램에 옵트인되는 경우 제안에 포함됩니다.

처리 정책 ID
fulfillmentPolicyId string

고유 식별자는 제품이 게시되고 eBay 목록으로 변환되면 사용될 처리 비즈니스 정책을 나타냅니다.

결제 정책 ID
paymentPolicyId string

고유 식별자는 제품이 게시되고 eBay 목록으로 변환되면 사용될 결제 비즈니스 정책을 나타냅니다.

제품 준수 정책 ID
productCompliancePolicyIds array of string

이 필드에는 판매자가 목록에 대해 만든 준수 정책을 지정하는 최대 5개의 ID 배열이 포함되어 있습니다.

반환 정책 ID
returnPolicyId string

제품이 게시되고 eBay 목록으로 변환되면 사용할 비즈니스 정책 고유 ID를 반환합니다.

통화
currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

Priority
priority integer

이 필드에 대한 정수 값 입력과 shippingServiceType 값은 처리 정책에서 업데이트된 배송 비용으로 수정될 국내 또는 국제 배송 서비스 옵션을 설정합니다.

통화
currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

서비스 유형
shippingServiceType string

이 값은 우선 순위 필드에 지정된 배송 서비스가 국내 또는 국제 배송 서비스 옵션인지 여부를 나타냅니다.

정책 ID 다시 가져오기
takeBackPolicyId string

테이크백 정책을 만든 판매자 ID입니다.

목록 시작 날짜
listingStartDate string

판매자가 이베이에서 목록이 활성화될 시간을 지정하려는 경우 이 필드를 사용할 수 있습니다.

Lot Size
lotSize integer

이 필드는 목록이 많은 목록인 경우에만 적용됩니다. 이 필드에 전달된 정수 값은 로트의 총 항목 수입니다.

Marketplace Id
marketplaceId string

제품을 사용할 수 있게 될 eBay 사이트 고유 ID입니다.

가맹점 위치 키
merchantLocationKey string

판매자의 인벤토리 위치의 고유 식별자

통화
currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

통화
currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

통화
currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

원래 소매 가격에 판매
originallySoldForRetailPriceOn string

이 필드는 취소선 가격 책정 기능이 제품에 사용되는 경우에 필요합니다. 이 필드는 제품이 이베이 사이트의 원래 RetailPrice 필드에서 가격으로 판매되었거나 타사 소매 업체가 해당 가격에 판매했음을 나타냅니다.

통화
currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

통화
currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

가격 책정 표시 유형
pricingVisibility string

이 필드는 최소 광고 가격 기능이 제품에 사용되는 경우에 필요합니다.

구매자당 수량 제한
quantityLimitPerBuyer integer

이 필드는 판매자가 판매자당 구매 수량에 대한 제한을 설정하려는 경우에만 적용되며 설정됩니다.

보조 범주 ID
secondaryCategoryId string

고유한 보조 범주 ID이며 판매자가 두 범주 아래에 항목을 나열하기로 결정한 경우 적용됩니다.

SKU
sku string

이베이 사이트에 나열될 제품의 판매자 정의 SKU 값입니다.

스토어 범주 이름
storeCategoryNames array of string

스토어 범주 이름

세금 적용
applyTax boolean

이 컨테이너는 판매세 테이블, Value-Added 세율 또는 세금 예외 범주 코드가 제품에 적용되는 경우에만 적용되며 사용됩니다.

타사 세금 범주
thirdPartyTaxCategory string

세금 예외 범주 코드입니다. 이 필드를 사용하는 경우 판매세는 항목 가격뿐만 아니라 서비스/수수료에도 적용됩니다.

VAT 백분율
vatPercentage number

이 값은 항목에 대한 VAT 비율(있는 경우)입니다. VAT 백분율을 지정하면 항목의 VAT 정보가 목록의 항목 보기 페이지에 표시됩니다.

반환

Name 경로 형식 Description
제품 ID
offerId string

제품의 고유 식별자

경고
warnings array of object

이 컨테이너는 호출이 수행될 때 반환되며 오류 및/또는 경고가 발생합니다.

카테고리
warnings.category string

이 문자열 값은 오류 범주를 나타냅니다.

도메인
warnings.domain string

오류 또는 경고가 발생한 도메인 이름입니다.

오류 ID
warnings.errorId integer

발생한 특정 오류 또는 경고를 식별하는 고유 코드입니다.

inputRefIds
warnings.inputRefIds array of string

오류 또는 경고와 가장 밀접하게 연결된 특정 요청 요소를 식별하는 하나 이상의 참조 ID 배열입니다(있는 경우).

긴 메시지
warnings.longMessage string

오류 또는 경고를 발생시킨 조건에 대한 자세한 설명 및 문제를 해결하기 위해 수행할 작업 정보입니다.

Message
warnings.message string

오류 또는 경고를 발생시킨 조건에 대한 설명입니다.

outputRefIds
warnings.outputRefIds array of string

오류 또는 경고와 가장 밀접하게 연결된 특정 응답 요소를 식별하는 하나 이상의 참조 ID 배열입니다(있는 경우).

parameters
warnings.parameters array of object

다양한 경고 및 오류 메시지는 오류 또는 경고에 대한 컨텍스트 정보를 포함하는 하나 이상의 변수를 반환합니다.

이름
warnings.parameters.name string

이름

value
warnings.parameters.value string

value

Subdomain
warnings.subdomain string

오류 또는 경고가 발생한 하위 도메인 이름입니다.

제품 삭제

이 호출은 제품을 영구적으로 삭제합니다.

매개 변수

Name 필수 형식 Description
제품 ID
offerId True string

삭제할 제품의 고유 식별자입니다.

반환

response
string

제품 업데이트

이 호출은 게시되거나 게시되지 않은 상태일 수 있는 기존 제품을 업데이트합니다.

매개 변수

Name 필수 형식 Description
제품 ID
offerId True string

업데이트하려는 제품의 고유 식별자입니다.

사용 가능한 수량
availableQuantity integer

구매에 사용할 수 있는 재고 수량입니다.

범주 ID
categoryId string

제품이 나열될 이베이 고유 범주 ID입니다.

자선 ID
charityId string

판매 수익의 비율을 받을 자선 단체의 이베이 할당 고유 ID입니다.

기부 비율
donationPercentage string

자선 단체가 목록이 생성하는 각 판매에 대해 받게 되는 구매 가격 비율입니다.

생산자 제품 ID
producerProductId string

항목과 관련된 생산자의 고유 식별자입니다.

제품 패키지 ID
productPackageId string

판매자가 추가한 제품 패키징 생산자의 고유 ID입니다.

배송 패키지 ID
shipmentPackageId string

판매자가 품목을 배송하는 데 사용하는 패키징 생산자의 고유 ID입니다.

제품 설명서 ID
productDocumentationId string

판매자가 항목의 소포에 추가한 모든 용지의 생산자 고유 식별자입니다.

통화
currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

구매자 세부 정보 숨기기
hideBuyerDetails boolean

판매자가 비공개 목록을 만들려는 경우 이 필드가 포함됩니다.

카탈로그 제품 세부 정보 포함
includeCatalogProductDetails boolean

이베이 제품 카탈로그 세부 정보가 목록에 적용되는지 여부를 나타냅니다.

목록 설명
listingDescription string

이베이 목록에 대한 설명입니다.

기간 나열
listingDuration string

목록이 활성화될 일 수입니다.

통화
currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

통화
currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

최상의 제품 사용
bestOfferEnabled boolean

목록에 대해 최상의 제품 기능을 사용할 수 있는지 여부를 나타냅니다.

eBay Plus 적격인 경우
eBayPlusIfEligible boolean

이 필드는 Top-Rated 판매자가 이베이 플러스 프로그램에 옵트인되는 경우 제안에 포함됩니다.

처리 정책 ID
fulfillmentPolicyId string

고유 식별자는 제품이 게시되고 eBay 목록으로 변환되면 사용될 처리 비즈니스 정책을 나타냅니다.

결제 정책 ID
paymentPolicyId string

고유 식별자는 제품이 게시되고 eBay 목록으로 변환되면 사용될 결제 비즈니스 정책을 나타냅니다.

제품 준수 정책 ID
productCompliancePolicyIds array of string

이 필드에는 판매자가 목록에 대해 만든 준수 정책을 지정하는 최대 5개의 ID 배열이 포함되어 있습니다.

반환 정책 ID
returnPolicyId string

제품이 게시되고 eBay 목록으로 변환되면 사용할 비즈니스 정책 고유 ID를 반환합니다.

통화
currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

Priority
priority integer

이 필드에 대한 정수 값 입력과 shippingServiceType 값은 처리 정책에서 업데이트된 배송 비용으로 수정될 국내 또는 국제 배송 서비스 옵션을 설정합니다.

통화
currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

서비스 유형
shippingServiceType string

이 값은 우선 순위 필드에 지정된 배송 서비스가 국내 또는 국제 배송 서비스 옵션인지 여부를 나타냅니다.

정책 ID 다시 가져오기
takeBackPolicyId string

테이크백 정책을 만든 판매자 ID입니다.

목록 시작 날짜
listingStartDate string

판매자가 이베이에서 목록이 활성화될 시간을 지정하려는 경우 이 필드를 사용할 수 있습니다.

Lot Size
lotSize integer

이 필드는 목록이 많은 목록인 경우에만 적용됩니다. 이 필드에 전달된 정수 값은 로트의 총 항목 수입니다.

가맹점 위치 키
merchantLocationKey string

판매자의 인벤토리 위치의 고유 식별자

통화
currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

통화
currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

통화
currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

원래 소매 가격에 판매
originallySoldForRetailPriceOn string

이 필드는 취소선 가격 책정 기능이 제품에 사용되는 경우에 필요합니다. 이 필드는 제품이 이베이 사이트의 원래 RetailPrice 필드에서 가격으로 판매되었거나 타사 소매 업체가 해당 가격에 판매했음을 나타냅니다.

통화
currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

통화
currency string

통화 형식을 나타내는 세 자리 문자열 값입니다.

가치
value string

통화 필드에 표현된 달러 값의 문자열 표현입니다.

가격 책정 표시 유형
pricingVisibility string

이 필드는 최소 광고 가격 기능이 제품에 사용되는 경우에 필요합니다.

구매자당 수량 제한
quantityLimitPerBuyer integer

이 필드는 판매자가 판매자당 구매 수량에 대한 제한을 설정하려는 경우에만 적용되며 설정됩니다.

보조 범주 ID
secondaryCategoryId string

고유한 보조 범주 ID이며 판매자가 두 범주 아래에 항목을 나열하기로 결정한 경우 적용됩니다.

스토어 범주 이름
storeCategoryNames array of string

스토어 범주 이름

세금 적용
applyTax boolean

이 컨테이너는 판매세 테이블, Value-Added 세율 또는 세금 예외 범주 코드가 제품에 적용되는 경우에만 적용되며 사용됩니다.

타사 세금 범주
thirdPartyTaxCategory string

세금 예외 범주 코드입니다. 이 필드를 사용하는 경우 판매세는 항목 가격뿐만 아니라 서비스/수수료에도 적용됩니다.

VAT 백분율
vatPercentage number

이 값은 항목에 대한 VAT 비율(있는 경우)입니다. VAT 백분율을 지정하면 항목의 VAT 정보가 목록의 항목 보기 페이지에 표시됩니다.

반환

Name 경로 형식 Description
제품 ID
offerId string

제품의 고유 식별자

경고
warnings array of object

이 컨테이너는 호출이 수행될 때 반환되며 오류 및/또는 경고가 발생합니다.

카테고리
warnings.category string

이 문자열 값은 오류 범주를 나타냅니다.

도메인
warnings.domain string

오류 또는 경고가 발생한 도메인 이름입니다.

오류 ID
warnings.errorId integer

발생한 특정 오류 또는 경고를 식별하는 고유 코드입니다.

inputRefIds
warnings.inputRefIds array of string

오류 또는 경고와 가장 밀접하게 연결된 특정 요청 요소를 식별하는 하나 이상의 참조 ID 배열입니다(있는 경우).

긴 메시지
warnings.longMessage string

오류 또는 경고를 발생시킨 조건에 대한 자세한 설명 및 문제를 해결하기 위해 수행할 작업 정보입니다.

Message
warnings.message string

오류 또는 경고를 발생시킨 조건에 대한 설명입니다.

outputRefIds
warnings.outputRefIds array of string

오류 또는 경고와 가장 밀접하게 연결된 특정 응답 요소를 식별하는 하나 이상의 참조 ID 배열입니다(있는 경우).

parameters
warnings.parameters array of object

다양한 경고 및 오류 메시지는 오류 또는 경고에 대한 컨텍스트 정보를 포함하는 하나 이상의 변수를 반환합니다.

이름
warnings.parameters.name string

이름

value
warnings.parameters.value string

value

Subdomain
warnings.subdomain string

오류 또는 경고가 발생한 하위 도메인 이름입니다.

처리 정책 가져오기

이 메서드는 marketplace_id 쿼리 매개 변수를 사용하여 지정한 마켓플레이스에 대해 구성된 모든 처리 정책을 검색합니다.

매개 변수

Name 필수 형식 Description
Marketplace Id
marketplace_id True string

검색하려는 정책의 이베이 마켓플레이스 ID입니다.

반환

Name 경로 형식 Description
fulfillmentPolicies
fulfillmentPolicies array of object

지정된 마켓플레이스에 대해 정의된 판매자의 처리 정책 목록입니다.

범주 유형
fulfillmentPolicies.categoryTypes array of object

이 컨테이너는 이행 정책이 자동차 또는 비자동차 목록에 적용되는지 여부를 나타냅니다.

이름
fulfillmentPolicies.categoryTypes.name string

정책이 적용되는 범주 유형입니다.

Description
fulfillmentPolicies.description string

처리 정책에 대한 판매자 정의 설명입니다.

화물 운송
fulfillmentPolicies.freightShipping boolean

true로 반환되는 경우 판매자는 150 파운드가 넘는 대형 품목에 대한 화물 운송을 제공합니다.

처리 정책 ID
fulfillmentPolicies.fulfillmentPolicyId string

처리 정책에 대한 고유한 eBay 할당 ID입니다.

글로벌 배송
fulfillmentPolicies.globalShipping boolean

사실로 반환되는 경우, 이베이의 글로벌 배송 프로그램은 국제 위치에 항목을 배송하는 판매자에 의해 사용됩니다.

단위
fulfillmentPolicies.handlingTime.unit string

DAY와 같은 시간 측정 단위입니다.

가치
fulfillmentPolicies.handlingTime.value integer

단위 필드에 지정된 시간 측정 단위 값입니다.

로컬 픽업
fulfillmentPolicies.localPickup boolean

true로 반환되는 경우 이 정책에 로컬 픽업을 사용할 수 있습니다.

Marketplace Id
fulfillmentPolicies.marketplaceId string

이 처리 정책이 적용되는 이베이 마켓플레이스의 ID입니다.

이름
fulfillmentPolicies.name string

이 처리 정책에 대한 판매자 정의 이름입니다. 이름은 동일한 마켓플레이스에 할당된 정책에 대해 고유해야 합니다.

픽업 드롭오프
fulfillmentPolicies.pickupDropOff boolean

true로 반환된 경우 판매자는 "클릭 및 수집" 옵션을 제공합니다.

shippingOptions
fulfillmentPolicies.shippingOptions array of object

배열은 정책에 사용할 수있는 국내 및 국제 배송 옵션에 대한 자세한 정보를 제공합니다.

비용 유형
fulfillmentPolicies.shippingOptions.costType string

이 필드는 배송 비용 모델이 FLAT_RATE 계산인지 여부를 정의합니다.

통화
fulfillmentPolicies.shippingOptions.insuranceFee.currency string

통화 금액을 설정하기 위해 값 필드에 적용되는 기본 통화입니다.

가치
fulfillmentPolicies.shippingOptions.insuranceFee.value string

지정된 통화의 금액입니다.

optionType
fulfillmentPolicies.shippingOptions.optionType string

optionType

currency
fulfillmentPolicies.shippingOptions.packageHandlingCost.currency string

currency

value
fulfillmentPolicies.shippingOptions.packageHandlingCost.value string

value

rateTableId
fulfillmentPolicies.shippingOptions.rateTableId string

rateTableId

shippingServices
fulfillmentPolicies.shippingOptions.shippingServices array of object

shippingServices

currency
fulfillmentPolicies.shippingOptions.shippingServices.additionalShippingCost.currency string

currency

value
fulfillmentPolicies.shippingOptions.shippingServices.additionalShippingCost.value string

value

buyerResponsibleForPickup
fulfillmentPolicies.shippingOptions.shippingServices.buyerResponsibleForPickup boolean

buyerResponsibleForPickup

buyerResponsibleForShipping
fulfillmentPolicies.shippingOptions.shippingServices.buyerResponsibleForShipping boolean

buyerResponsibleForShipping

currency
fulfillmentPolicies.shippingOptions.shippingServices.cashOnDeliveryFee.currency string

currency

value
fulfillmentPolicies.shippingOptions.shippingServices.cashOnDeliveryFee.value string

value

freeShipping
fulfillmentPolicies.shippingOptions.shippingServices.freeShipping boolean

freeShipping

shippingCarrierCode
fulfillmentPolicies.shippingOptions.shippingServices.shippingCarrierCode string

shippingCarrierCode

currency
fulfillmentPolicies.shippingOptions.shippingServices.shippingCost.currency string

currency

value
fulfillmentPolicies.shippingOptions.shippingServices.shippingCost.value string

value

shippingServiceCode
fulfillmentPolicies.shippingOptions.shippingServices.shippingServiceCode string

shippingServiceCode

regionExcluded
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded array of object

regionExcluded

지역 이름
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded.regionName string

지역 이름

regionType
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded.regionType string

regionType

regionIncluded
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded array of object

regionIncluded

지역 이름
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded.regionName string

지역 이름

regionType
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded.regionType string

regionType

sortOrder
fulfillmentPolicies.shippingOptions.shippingServices.sortOrder integer

sortOrder

currency
fulfillmentPolicies.shippingOptions.shippingServices.surcharge.currency string

currency

value
fulfillmentPolicies.shippingOptions.shippingServices.surcharge.value string

value

제외된 지역
fulfillmentPolicies.shipToLocations.regionExcluded array of object

판매자가 배송하지 않는 영역을 지정하는 regionName 값의 배열입니다.

지역 이름
fulfillmentPolicies.shipToLocations.regionExcluded.regionName string

지역 이름

regionType
fulfillmentPolicies.shipToLocations.regionExcluded.regionType string

regionType

포함된 지역
fulfillmentPolicies.shipToLocations.regionIncluded array of object

판매자가 배송할 영역을 지정하는 regionName 필드의 배열입니다.

지역 이름
fulfillmentPolicies.shipToLocations.regionIncluded.regionName string

지역 이름

regionType
fulfillmentPolicies.shipToLocations.regionIncluded.regionType string

regionType

Href
href string

이 필드는 나중에 사용할 수 있습니다.

한계
limit integer

이 필드는 나중에 사용할 수 있습니다.

Next
next string

이 필드는 나중에 사용할 수 있습니다.

상쇄
offset integer

이 필드는 나중에 사용할 수 있습니다.

이전
prev string

이 필드는 나중에 사용할 수 있습니다.

총계
total integer

결과 집합에서 검색된 총 처리 정책 수입니다.

처리 정책 가져오기

이 메서드는 처리 정책의 전체 세부 정보를 검색합니다. fulfillmentPolicyId 경로 매개 변수를 사용하여 검색하려는 정책의 ID를 제공합니다.

매개 변수

Name 필수 형식 Description
처리 정책 ID
fulfillmentPolicyId True string

검색하려는 처리 정책 ID

반환

Name 경로 형식 Description
categoryTypes
categoryTypes array of object

이 컨테이너는 이행 정책이 자동차 목록 또는 비자동차 목록에 적용되는지 여부를 나타냅니다.

이름
categoryTypes.name string

정책이 적용되는 범주 유형 이름입니다.

Description
description string

처리 정책에 대한 판매자 정의 설명입니다. 이 설명은 판매자의 용도로만 사용되며 이베이 페이지에는 노출되지 않습니다.

화물 운송
freightShipping boolean

true로 반환되는 경우 판매자는 화물 운송을 제공합니다.

처리 정책 Id
fulfillmentPolicyId string

처리 정책에 대한 고유한 eBay 할당 ID입니다.

글로벌 배송
globalShipping boolean

사실로 반환되는 경우, 이베이의 글로벌 배송 프로그램은 국제 위치에 항목을 배송하는 판매자에 의해 사용됩니다.

단위
handlingTime.unit string

시간 범위는 값 필드에 지정된 값을 단위에 지정된 값에 적용할 때 정의됩니다.

가치
handlingTime.value integer

단위 필드에 지정된 시간 측정 단위 값입니다.

로컬 픽업
localPickup boolean

true로 반환되는 경우 이 정책에 로컬 픽업을 사용할 수 있습니다.

Marketplace Id
marketplaceId string

이 처리 정책이 적용되는 eBay Marketplace ID입니다.

이름
name string

이 처리 정책에 대한 고유한 판매자 정의 이름입니다.

픽업 드롭오프
pickupDropOff boolean

true로 반환된 경우 판매자는 "클릭 및 수집" 옵션을 제공합니다.

shippingOptions
shippingOptions array of object

이 배열은 정책에 사용할 수 있는 국내 및 국제 배송 옵션에 대한 자세한 정보를 제공하는 데 사용됩니다.

비용 유형
shippingOptions.costType string

이 필드는 배송 비용 모델이 FLAT_RATE 계산인지 여부를 정의합니다.

옵션 유형
shippingOptions.optionType string

이 필드는 해당 배송 서비스 옵션이 국내 또는 국제 배송지 여부를 나타내는 데 사용됩니다.

통화
shippingOptions.packageHandlingCost.currency string

통화 금액을 설정하기 위해 값 필드에 적용되는 기본 통화입니다.

가치
shippingOptions.packageHandlingCost.value string

지정된 통화의 금액입니다.

Rate Table Id
shippingOptions.rateTableId string

이 필드는 판매자가 국내 또는 국제 운송 요금 테이블을 이행 비즈니스 정책에 연결하려는 경우에 사용됩니다.

shippingServices
shippingOptions.shippingServices array of object

이 배열은 정책에 대해 정의된 국내 또는 국제 배송 서비스 옵션으로 구성됩니다.

currency
shippingOptions.shippingServices.additionalShippingCost.currency string

currency

value
shippingOptions.shippingServices.additionalShippingCost.value string

value

buyerResponsibleForPickup
shippingOptions.shippingServices.buyerResponsibleForPickup boolean

이 필드는 전체 지불 후 구입 한 자동차를 선택하는 구매자의 책임이 될 경우 자동차 목록에 포함되어야합니다.

buyerResponsibleForShipping
shippingOptions.shippingServices.buyerResponsibleForShipping boolean

이 필드는 전체 지불 후 구입 한 자동차의 선적을 준비하는 구매자의 책임이 될 경우 자동차 목록에 포함되어야합니다

currency
shippingOptions.shippingServices.cashOnDeliveryFee.currency string

currency

value
shippingOptions.shippingServices.cashOnDeliveryFee.value string

value

freeShipping
shippingOptions.shippingServices.freeShipping boolean

판매자가 구매자에게 무료 배송 옵션을 제공하는 경우 이 필드가 포함됩니다.

shippingCarrierCode
shippingOptions.shippingServices.shippingCarrierCode string

이 필드는 운송업체를 설정/나타냅니다.

currency
shippingOptions.shippingServices.shippingCost.currency string

currency

value
shippingOptions.shippingServices.shippingCost.value string

value

shippingServiceCode
shippingOptions.shippingServices.shippingServiceCode string

이 필드는 국내 또는 국제 배송 서비스 옵션을 설정/나타냅니다.

regionExcluded
shippingOptions.shippingServices.shipToLocations.regionExcluded array of object

regionExcluded

지역 이름
shippingOptions.shippingServices.shipToLocations.regionExcluded.regionName string

지역 이름

regionType
shippingOptions.shippingServices.shipToLocations.regionExcluded.regionType string

regionType

regionIncluded
shippingOptions.shippingServices.shipToLocations.regionIncluded array of object

regionIncluded

지역 이름
shippingOptions.shippingServices.shipToLocations.regionIncluded.regionName string

지역 이름

regionType
shippingOptions.shippingServices.shipToLocations.regionIncluded.regionType string

regionType

sortOrder
shippingOptions.shippingServices.sortOrder integer

이 필드에 설정된 정수 값은 배송 서비스의 순서를 제어합니다.

regionExcluded
shipToLocations.regionExcluded array of object

판매자가 배송하지 않는 영역을 지정하는 regionName 값의 배열입니다.

지역 이름
shipToLocations.regionExcluded.regionName string

이베이에서 정의한 지역 이름을 나타내는 문자열입니다.

지역 유형
shipToLocations.regionExcluded.regionType string

향후 사용을 위해 예약됨.

regionIncluded
shipToLocations.regionIncluded array of object

판매자가 배송할 영역을 지정하는 regionName 필드의 배열입니다.

지역 이름
shipToLocations.regionIncluded.regionName string

이베이에서 정의한 지역 이름을 나타내는 문자열입니다.

지역 유형
shipToLocations.regionIncluded.regionType string

향후 사용을 위해 예약됨.

항목 조건 정책 가져오기

이 메서드는 이베이 마켓플레이스에서 하나, 여러 개 또는 모든 이베이 범주에 항목 조건 메타데이터를 반환합니다.

매개 변수

Name 필수 형식 Description
Marketplace Id
marketplace_id True string

정책 정보가 검색되는 eBay 마켓플레이스 ID입니다.

Filter
filter string

범주 트리의 선택한 섹션에 대해서만 정책 정보를 반환하여 응답을 제한합니다.

반환

Name 경로 형식 Description
itemConditionPolicies
itemConditionPolicies array of object

범주 ID 목록 및 나열된 각 범주에서 항목의 조건을 나타내는 방법에 대한 정책입니다.

범주 ID
itemConditionPolicies.categoryId string

항목 조건 정책이 적용되는 범주 ID입니다.

범주 트리 ID
itemConditionPolicies.categoryTreeId string

응답 집합에 사용되는 범주 트리의 루트 노드를 나타내는 값입니다.

항목 조건 필요
itemConditionPolicies.itemConditionRequired boolean

이 플래그는 지정된 범주에 대한 목록의 항목 조건을 나열해야 하는지 여부를 표시합니다.

itemConditions
itemConditionPolicies.itemConditions array of object

범주에 허용되는 항목 조건 값입니다.

conditionDescription
itemConditionPolicies.itemConditions.conditionDescription string

조건에 대해 사람이 읽을 수 있는 레이블입니다.

conditionId
itemConditionPolicies.itemConditions.conditionId string

선택한 항목 조건의 ID 값입니다.

usage
itemConditionPolicies.itemConditions.usage string

usage

경고
warnings array of object

요청의 결과로 생성된 경고 목록입니다.

카테고리
warnings.category string

이 오류 또는 경고의 범주 유형입니다.

도메인
warnings.domain string

서비스 또는 애플리케이션을 포함하는 도메인 이름입니다.

오류 ID
warnings.errorId integer

발생한 특정 오류 조건을 고유하게 식별하는 양의 정수입니다.

inputRefIds
warnings.inputRefIds array of string

오류와 연결된 특정 요청 요소를 식별합니다(있는 경우). inputRefId의 응답은 형식에 따라 다릅니다.

긴 메시지
warnings.longMessage string

100~200자 정도의 길이여야 하지만 그렇게 할 필요는 없는 확장된 메시지 버전입니다.

Message
warnings.message string

최종 사용자 및 앱 개발자에게 친숙한 디바이스에 구애받지 않은 메시지입니다.

outputRefIds
warnings.outputRefIds array of string

오류와 관련된 특정 응답 요소를 식별합니다(있는 경우).

parameters
warnings.parameters array of object

다양한 경고 및 오류 메시지는 오류 또는 경고에 대한 컨텍스트 정보를 포함하는 하나 이상의 변수를 반환합니다.

이름
warnings.parameters.name string

이름

value
warnings.parameters.value string

value

Subdomain
warnings.subdomain string

도메인의 하위 시스템 또는 하위 구성의 이름입니다.

정의

문자열

기본 데이터 형식 'string'입니다.