출시 노트 (v2.1)

2024년 11월 15일

제품 서비스

LoyaltyProgram의 경우 자격 요건을 지정하는 shipping_label 필드를 추가했습니다. 이 필드에 값이 있으면 이 제품에 포인트 제도 대상 배송 혜택이 적용됩니다. 필드 값이 제공되지 않으면 해당 포인트 등급의 포인트 제도 대상 배송이 적용되지 않습니다.

2024년 10월 30일

결제 관련 API 종료의 일환으로 다음 서비스가 지원 중단됩니다. - settlementreports - settlementtranscations

결제 관련 API 종료는 이전에 종료된 BuyOnGoogle 프로그램 및 주문 관련 API와 관련이 있습니다.

앞서 언급한 서비스 호출은 Service was not found on the server 응답과 함께 실패할 것으로 예상됩니다.

2024년 10월 16일

UpdateConversionSourceRequestupdate_mask가 이제 OPTIONAL입니다. 업데이트 마스크를 지정하지 않으면 값이 비어 있지 않은 모든 필드가 업데이트됩니다.

2024년 8월 26일 (원래 안내된 날짜보다 빠름)

주문 관련 API 종료의 일환으로 다음 서비스가 지원 중단되었습니다. - orderinvoices - orderreports - orderreturns - orderreturns.labels - orders

앞서 언급한 서비스 호출은 Service was not found on the server 응답과 함께 실패할 것으로 예상됩니다.

OrderTrackingSignals 서비스는 지원 중단되지 않으며 계속 사용할 수 있습니다.

2024년 8월 10일

Buy on Google 서비스

Buy on Google API 종료의 일환으로 BuyOnGoogleProgramService 내의 모든 메서드가 service was not found on the server로 실패합니다.

2024년 7월 19일

제품 서비스

member_price_effective_date 필드를 추가했습니다. 이번 업데이트를 통해 포인트 멤버십 회원 가격이 적용되는 기간(해당하는 경우)을 지정할 수 있습니다. 필드 값이 제공되지 않으면 회원 가격이 항상 적용됩니다.

2024년 5월 20일

제품 서비스

LoyaltyPrograms를 추가했습니다. 이 업데이트를 통해 단일 제품에 대해 포인트, 가격 등이 다른 여러 등급을 제공할 수 있습니다. 단수 LoyaltyProgram 필드 대신 이 필드를 사용해야 합니다.

보고서 서비스

MerchantPerformanceView 표에서 Buy on Google 측정항목이 지원 중단되었습니다. 이 업데이트 후 Buy on Google 측정항목을 검색하면 0이 반환됩니다. 이는 이전 날짜의 이전 값에도 적용됩니다.

자세한 내용은 Buy on Google 지원 중단을 참고하세요.

2024년 5월 13일

제품 서비스

제품 리소스

인증 필드 변경사항: 인증 기관에서 인증 코드 또는 번호를 발급하지 않더라도 사용자가 인증 정보를 업로드할 수 있도록 인증 값 (등급, 수준 또는 성적이라고도 함)을 제공하기 위해 ProductCertification 필드에 certificationValue를 추가했습니다.

자세한 내용은 제품 가이드를 참고하세요.

2024년 5월 6일

보고서 서비스

PriceInsightsProductView 표에 효과 버킷을 추가했습니다. 효과는 가격을 변경할 경우 어떤 제품의 실적이 가장 개선될지 알려줍니다. 이 평가에는 할인가, 현재 가격과 추천 가격 간의 차이를 조정하여 예상한 실적 향상이 반영됩니다.

2024년 4월 24일

제품 서비스

제품 리소스

할부 결제에 선택사항인 downpaymentcreditType 필드를 추가했습니다.

  • downpayment는 구매자가 일회성으로 선불 결제해야 하는 금액을 제공합니다.
  • creditType는 할부 유형 (finance 또는 lease)을 제공합니다. 이 필드는 차량 광고에만 적용됩니다.

2024년 4월 11일

제품 서비스

제품 리소스

  • 제품 수준 배송에 무료 배송 기준 속성 (FreeShippingThreshold)을 추가했습니다. 이 속성을 사용하면 판매자가 배송비가 무료가 되는 최소 제품 가격을 입력할 수 있습니다.
  • LoyaltyPoints의 공개 상태를 변경했습니다.

2024년 4월 10일

제품 서비스

제품 리소스

LoyaltyProgram를 추가했습니다.

2024년 4월 9일

제품 서비스

제품 리소스

AI 생성 제품 제목과 내용 입력란을 제공하기 위해 structuredTitlestructuredDescription를 추가했습니다.

2024년 4월 3일

판매자 지원 서비스

파트너가 새로운 작업 유형인 BuiltInUserInputAction을 요청할 수 있는 user_input_action_option 필드를 추가했습니다. 이 작업을 사용하면 파트너가 판매자를 판매자 센터로 리디렉션하는 대신 애플리케이션에서 직접 판매자를 위한 복잡한 셀프서비스 기능을 빌드할 수 있습니다.

BuiltInUserInputAction에 새로운 TriggerAction 메서드를 추가했습니다. 이 메서드에 액세스하려면 이 양식에 요청을 제출하세요.

2024년 3월 27일

제품 서비스

제품 리소스

'자동 할인' 및 '동적 프로모션' 프로젝트에 안전 장치로 AutoPricingMinPrice를 추가하여 판매자 제품의 할인이 제품 가격을 이 값보다 낮게 낮추지 않도록 합니다. 따라서 제품의 가치와 수익성을 보존할 수 있습니다.

2024년 3월 15일

Google 검색 및 쇼핑용 Buy on Google이 지원 종료됩니다. 2024년 10월 31일까지는 orders.listorders.get를 사용하여 기존 주문을 계속 확인할 수 있습니다.

2024년 3월 8일

보고서 서비스

Reports 서비스에 TopicTrendsView 보고서를 추가했습니다.

자세한 내용은 보고 가이드를 참고하세요.

2024년 3월 6일

보고서 서비스

제품의 클릭 가능성 버킷 및 순위가 추가되었습니다.

자세한 내용은 보고 가이드를 참고하세요.

2024년 2월 19일

ConversionSources 서비스

다음 값을 유효한 전환 소스로 삭제했습니다.

  • CROSS_CHANNEL_FIRST_CLICK
  • CROSS_CHANNEL_LINEAR
  • CROSS_CHANNEL_POSITION_BASED
  • CROSS_CHANNEL_TIME_DECAY

전환 확인 기간으로 60일 및 90일 옵션을 삭제하고 40일을 유효한 옵션으로 추가했습니다.

2024년 1월 17일

POS 서비스

사용자가 매장 일치에 실패한 이유를 자세히 알 수 있도록 PosStorematching_status_hint 필드의 새 값을 추가했습니다.

2024년 1월 11일

계정 서비스

link 메서드에 localProductManagerlocalProductManagement를 각각 링크 유형 및 서비스로 추가했습니다. 이를 통해 계정을 연결하여 오프라인 제품 데이터를 관리할 수 있습니다.

2023년 11월 29일

판매자 지원 서비스

판매자 센터에서 실행해야 하는 본인 인증을 위한 VERIFY_IDENTITY_IN_MERCHANT_CENTER 외부 작업 유형을 추가했습니다.

POS 서비스

사용자가 POS 매장과 Google 비즈니스 프로필 매장의 일치 상태를 확인하고 문제가 있는 경우 수정 방법을 알 수 있도록 PosStorematching_statusmatching_status_hint 필드를 추가했습니다.

2023년 11월 15일

repricingrulesrepricingrules.repricingreports 엔드포인트는 더 이상 지원되지 않습니다.

2023년 11월 1일

배송 설정 서비스

shipment_type=pickup는 더 이상 지원되지 않습니다.

2023년 10월 18일

계정 서비스

판매자가 특정 소비자 가치를 스스로 식별할 수 있는 Business Identity 필드를 추가했습니다.

2023년 10월 10일

배송 설정 서비스의 새 배송 유형으로 Collection Point를 추가했습니다. 화물 취급소 배송은 집으로 직접 배송하는 대신 서드 파티 제휴 위치 (예: UPS 액세스 포인트)로 상품을 배송하는 서드 파티 (예: 판매자가 소유하지 않음)에서 제공하는 서비스입니다.

2023년 9월 18일

LIA 설정 서비스

사용자가 옴니채널 환경 (즉, 오프라인 매장 및 수령 설정)을 설정할 수 있는 setOmnichannelExperience 메서드를 추가했습니다. 현재 이 기능은 POS 제공업체가 이러한 설정을 사용 설정할 수 있는 것으로 신뢰할 수 있는 사용자만 사용할 수 있습니다.

2023년 9월 7일

Buy on Google 지원 중단

GetBuyOnGoogleProgramStastus 메서드에 새 DEPRECATED 상태를 추가합니다. 이러한 상태에서 프로그램을 다시 활성화하거나 일시중지할 수는 없습니다.

2023년 9월 4일

판매자 지원 서비스

계정 수준에서 해결해야 하는 제품 문제에 관한 FIX_ACCOUNT_ISSUE 내장 작업을 추가했습니다. 정부 기관의 근거를 전달하는 데 사용되는 SHOW_ADDITIONAL_CONTENT 내장 작업을 추가했습니다.

2023년 8월 28일

프로모션 서비스

Promotions 서비스에서 제한된 액세스 권한에서 모든 액세스 권한으로 list 메서드를 엽니다.

2023년 8월 22일

판매자 지원 서비스

판매자 지원 서비스를 출시했습니다. 이 서비스는 계정 문제 및 제품 문제에 대한 지원 콘텐츠를 제공합니다.

2023년 8월 4일

보고서 서비스

보고서 서비스에 밀접한 경쟁자 노출 경쟁 보고서가 추가되었습니다.

자세한 내용은 보고 가이드를 참고하세요.

2023년 7월 25일

POS 서비스

인벤토리 리소스

판매자가 인벤토리와 함께 수령 정보를 제출할 수 있는 기능을 제공하기 위해 pickup_methodpickup_sla 필드를 추가합니다.

2023년 7월 14일

보고서 서비스

보고서 서비스에 노출 경쟁 보고서를 추가했습니다.

자세한 내용은 보고 가이드를 참고하세요.

2023년 7월 7일

제품 서비스

제품 리소스

3D 모델 이미지의 URL을 제공하는 virtualModelLink를 추가했습니다.

2023년 7월 4일

제품 서비스

제품 리소스

certifications 필드를 추가하여 제품 인증을 제공합니다(예: EU EPREL 데이터베이스를 기반으로 제품의 에너지 효율 라벨링).

2023년 6월 26일

배송 설정 서비스

로컬 처리

판매자가 n일 오프라인 배송으로 배송 서비스를 구성한 경우 n+1일 오프라인 배송을 표시하지 않도록 선택할 수 있는 no_delivery_post_cutoff 필드를 추가했습니다.

2023년 5월 29일

프로모션 서비스

Promotions 서비스에 list 메서드를 추가했습니다.

추천 서비스

맞춤 콘텐츠 서비스의 ReportInteraction 메서드에서 상호작용 닫기를 사용 설정합니다.

2023년 5월 9일

Cloud Retail 대상 유형

Cloud Retail 추가 속성

클라우드 소매 추가 속성 필드를 추가합니다. Cloud Retail 대상을 사용하는 고객이 사용할 수 있도록 고안된 반복 필드입니다. 이 필드는 클라우드 소매 프로그램을 사용할 때 사용할 수 있습니다. 이는 Google Cloud Retail 제품 모델의 속성 필드에 매핑됩니다.

2023년 5월 22일

프로모션 서비스

Promotions 서비스에 list 메서드를 추가했습니다.

2023년 4월 11일

배송 설정 서비스

로컬 처리

판매자가 새 배송 설정을 만들 때 사용할 수 있는 지역 배송 처리 옵션이 추가되었습니다. 새 storeConfig 필드에서 오프라인 매장의 설정을 구성할 수 있습니다. 여기에는 지역 배송을 제공하는 매장의 서비스 반경, 마감 시간, 매장 코드가 포함됩니다.

4월 3일

맞춤 콘텐츠 서비스

추천 서비스가 출시되었습니다. 이 서비스는 판매자 계정의 실적을 개선하는 데 도움이 되는 방법을 제안하고 유용한 추천에 대한 판매자 클릭수를 보고할 수 있도록 지원합니다.

2023년 2월 20일

계정 서비스

계정 리소스

계정 리소스에 새 섹션 Account.ConversionSettings가 추가되었습니다.

ConversionSources 서비스

전환 소스 관리를 지원하는 전환 소스 서비스(판매자 센터의 전환 설정 섹션에 포함됨)를 추가했습니다.

2023년 2월 16일

배송 설정 서비스

상점 코드 유효성 검사

이제 배송 설정이 업데이트되기 전에 판매자 소유의 판매점 코드인지 확인합니다.

LIA 판매자 확인

이제 판매자 ID가 등록된 프로그램이 배송 설정이 업데이트되기 전에 검증됩니다. 판매자는 다음 프로그램 중 하나에 참여해야 합니다.

  • LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
  • LOCAL_INVENTORY_ADS

2023년 2월 9일

프로모션 서비스

프로모션 서비스를 로컬 contentLanguage 지원을 통해 6가지 추가 targetCountry 옵션으로 확장합니다.

  • BR
  • ES
  • NL
  • JP
  • IT
  • KR

2023년 1월 12일

제품 서비스

제품 리소스

라이프스타일 이미지의 URL을 제공하는 lifestyleImageLinks를 추가했습니다.

2022년 11월 24일

프로모션 서비스

Promotions.PromotionStatus 섹션에 새 필드 `promotionStatus`를 추가했습니다. 읽기 전용 입력란입니다.

2022년 11월 15일

보고서 서비스

보고서 서비스에 시장 통계 보고서가 추가되었습니다.

이제 보고서 서비스에 대해 다음을 쿼리할 수 있습니다.

자세한 내용은 보고 가이드를 참고하세요.

2022년 11월 7일

데이터 피드 서비스

데이터 피드 서비스에 feedLabel 지원을 추가했습니다.

2022년 9월 14일

모든 문자열을 허용하도록 feedLabel를 업데이트했습니다.

2022년 8월 9일

제품에 feedLabel를 추가했습니다.

이제 targetCountry 대신 feedLabel를 사용하여 제품 ID의 국가를 지정할 수 있습니다. 이제 혜택 ID가 online:language:feedLabel:offerId로 구성됩니다.

이전 버전과의 호환성을 위해 기존 피드의 feedLabeltargetCountry 값이 자동으로 채워졌습니다.

targetCountry가 지원 중단되었습니다.

전 세계 제품을 지원하기 위해 쇼핑용 Content API에서 targetCountry 필드를 지원 중단했습니다. 대신 shipping 필드를 사용하여 대상 국가를 지정하는 것이 좋습니다.

이제 targetCountryfeedLabel에 제공한 값으로 자동으로 채워집니다.

자세한 내용은 쇼핑용 Content API에서 피드 라벨이 대상 국가를 대체함 블로그 게시물을 참고하세요.

2021년 12월 8일

계정 서비스

계정 리소스

계정 리소스에 새 섹션 Account.AutomaticImprovements를 추가했습니다.

이 새로운 섹션을 통해 판매자는 상품을 자동으로 업데이트하고 이미지와 배송 설정을 개선할 수 있습니다.

2021년 10월 25일

프로모션 서비스

Promotion API에 Get Promotion을 추가했습니다.

2021년 10월 11일

Shipping Settings API

판매자가 WarehouseBasedDeliveryTime에서 사용할 수 있는 창고를 관리할 수 있도록 ShippingSettings 리소스에 새 warehouse 필드가 추가되었습니다.

창고 이름으로 창고를 참조하도록 WarehouseBasedDeliveryTime에 새 warehouseName 필드를 추가합니다.

2021년 10월 4일

계정 서비스

계정 리소스

Accounts.BusinessInformation 섹션에 새 필드 'phone_verification_status'를 추가했습니다. 이 필드는 Accounts.VerifyPhoneNumber에서 설정하는 읽기 전용 필드입니다.

2021년 9월 13일

BuyOnGooglePrograms 서비스

BuyOnGoogleProgramStatus 리소스

온라인 판매 채널, 비즈니스 모델, 고객 서비스 전화를 나타내는 새 필드가 BuyOnGooglePrograms.BuyOnProgramStatus 리소스에 추가되었습니다.

새로운 UpdateBuyOnGoogleProgramStatus 메서드

확장된 BuyOnGooglePrograms.BuyOnProgramStatus 리소스를 업데이트할 수 있는 새로운 UpdateBuyOnGoogleProgramStatus 메서드가 추가되었습니다.

2021년 9월 6일

계정 서비스

계정 리소스

Accounts.BusinessInformation 섹션에 새 필드 'korean_business_registration_number'를 추가했습니다. 이 필드는 명시적으로 빈 문자열로 설정된 경우에만 삭제됩니다.

2021년 8월 30일

프로모션 서비스

프로모션 삽입이 가능한 새로운 프로모션 서비스를 추가했습니다.

주문 서비스

배송 전에 대금을 징수하는 새 메서드 orders/captureOrder를 추가했습니다.

새 주문 취소 사유 FAILED_TO_CAPTURE_FUNDS

제품 서비스

제품 리소스

제품 크기 및 무게를 제공하기 위해 productLength, productHeight, productWidth, productWeight를 추가했습니다.

2021년 8월 9일

RepricingRule 서비스

RepricingRule 유형

RepricingRuleType 필드의 새 enum 값입니다.

TYPE_SALES_VOLUME_BASEDTYPE_COMPETITIVE_PRICE를 추가했습니다.

2021년 5월 17일

주문 반품 라벨 서비스

CreateReturnRequest에 새 'product_id' 필드가 추가되었습니다. 판매자는 product_id 또는 line_item_id를 지정하여 반품할 상품을 식별할 수 있습니다.

제품 서비스

기존 제품을 업데이트하는 새 메서드를 추가했습니다. 전체 제품 대신 업데이트해야 하는 필드만 제공하여 제품을 업데이트할 수 있습니다.

2021년 5월 3일

주문 반품 라벨 서비스

판매자가 관리하는 반품 (MMR) 라벨을 업로드하는 새로운 방법을 추가했습니다. 새 orderreturns.labels.create를 사용하면 반품 라벨을 업로드하여 고객과 공유할 수 있습니다.

2021년 4월 26일

Shipping Settings API

창고 위치와 선택한 운송업체 서비스를 기반으로 예상 배송일을 계산하는 배송 서비스를 지원하기 위해 DeliveryTime에 새 warehouseBasedDeliveryTimes 필드가 추가되었습니다.

예상 배송일 계산에 적용되는 서비스의 이름을 반환하는 CarriersCarrier 객체의 새 eddServices 필드

2021년 4월 12일

제품 서비스

제품 리소스

제품당 최대 2개의 사이즈 유형을 지원하는 새 additionalSizeType 필드

배송 필드 변경사항: 제품 수준 배송 속도를 제공하기 위해 ProductShippingminHandlingTime, maxHandlingTime, minTransitTime, maxTransitTime를 추가했습니다.

2021년 1월 28일

계정 서비스

AccountLabelAccount 리소스에 자동 라벨 지원이 추가되었습니다. 자세한 내용은 CSS 라벨 관리 가이드의 CSS 라벨 유형 섹션을 참고하세요.

2020년 10월 5일

CSSES 서비스

CSS 리소스

CSS 도메인에 관한 정보를 검색하고 라벨을 할당하는 새로운 csses 서비스를 추가했습니다. 이제 AccountLabel 리소스를 사용하여 CSS 그룹 수준 라벨을 만들고 나열할 수도 있습니다. 자세한 내용은 CSS 라벨 관리를 참고하세요.

2020년 8월 24일

제품 서비스

제품 리소스

특정 국가에서 광고에서 제품을 제외하는 새 shoppingAdsExcludedCountries 필드

Productstatuses 리소스

destinationStatuses 객체의 새로운 approvedCountries, pendingCountries, disapprovedCountries 필드는 targetCountry 외의 제품 상태 정보를 제공합니다.

itemLevelIssues.applicableCountries 필드

2020년 8월 10일

계정 서비스

CSS Center의 판매자 센터 계정 라벨을 관리하기 위한 새로운 AccountLabel 리소스를 추가했습니다. 이제 CSS Center 사용자는 accounts.list, accounts.get, accounts.updatelabels 메서드를 사용하여 판매자 센터 계정을 나열하고 라벨을 할당할 수도 있습니다. 자세한 내용은 CSS 라벨 관리를 참고하세요.

2020년 6월 19일

제품 서비스

제품 리소스

새 필드

새로운 productDetails, productHighlights, subscriptionCost, canonicalLink 필드

2020년 6월 2일

주문 서비스

반품 없이 환불을 시작하는 새로운 메서드를 추가했습니다. 새 orders.refunditemorders.refundorder를 사용하면 고객이 주문 제품을 반품하지 않더라도 주문에 대한 환불을 시작할 수 있습니다.

2020년 4월 27일

Orderreturns 서비스

새 메서드 acknowledgeprocess와 읽기 메서드용 새 필터 및 입력란 (list, get)을 추가했습니다.

GMB 연결

GMB 계정 ID를 사용하여 판매자 센터 계정을 GMB 계정에 연결하는 기능을 추가했습니다.

2020년 4월 14일

Settlement Report API

결제 보고서를 가져오는 새 서비스를 추가했습니다.

2020년 3월 9일

오프라인 판매점 인벤토리 API

오프라인 판매점 인벤토리 데이터를 제출하는 새로운 서비스를 추가했습니다.

2020년 3월 2일

Pubsub notification settings API

pubsub 알림의 설정을 관리하는 새로운 서비스를 추가했습니다.

2019년 12월 3일

제품 서비스

멀티 클라이언트 계정 보조 Content API 피드에 대한 지원이 추가되었습니다.

2019년 9월 11일

주문 서비스

주문의 픽업 배송 및 상응하는 샌드박스 기능에 대한 지원이 추가되었습니다.

2019년 8월 14일

새 서비스

Buy on Google에 새로운 Returnpolicy 및 Returnaddress 서비스를 추가했습니다.

주문 서비스

주문 리소스

새로운 필드

quantityUndeliverable 필드

2019년 8월 7일

주문 서비스

주문 리소스

새 필드

주문 리소스에 새 loyaltyInfoinvoiceReceivingEmail 필드가 추가되었습니다.

2019년 7월 1일

제품 서비스

제품 서비스에 보조 Content API 피드 지원이 추가되었습니다.

2019년 6월 11일

주문 서비스

Order 및 TestOrder 리소스

가격 조정 추가

프로모션 적용으로 인한 원래 상품 가격 및 세금 조정이 포함된 새 lineItem[].adjustments 필드를 추가했습니다.

2019년 2월 14일

이번 버전에 도입된 변경사항

테스트 실행이 더 이상 지원되지 않음

v2.1에서 dryRun 매개변수가 삭제되었습니다. 이는 모든 API 호출에 적용됩니다.

패치 메서드가 더 이상 지원되지 않음

다음 서비스는 더 이상 patch 메서드를 지원하지 않습니다.

  • 계정
  • Accounttax
  • 데이터 피드
  • Liasettings
  • Shippingsettings

HTTP BATCH 메서드 삭제

모든 HTTP BATCH 메서드가 v2.1에서 삭제되었습니다. 대신 customBatch를 사용합니다. 영향을 받는 서비스는 다음과 같습니다.

  • 계정
  • Accountstatuses
  • 데이터 피드
  • Datafeedstatuses
  • Liasettings
  • Orderreports
  • 포지션
  • 제품
  • Productstatuses
  • Shippingsettings

계정 서비스

업데이트

요청의 businessInformationgoogleMyBusinessLink 필드는 Content API v2가 처음 출시된 후에 도입되었습니다. 따라서 판매자가 이러한 두 입력란의 정보를 제공하지 않은 경우 update를 사용하여 의도치 않게 삭제하는 것을 방지하는 보호 조치가 있습니다.

v2에서는 판매자가 이러한 필드를 삭제하려면 빈 본문 ( {})을 명시적으로 제공해야 합니다. v2.1에서는 빈 본문을 제공하거나 본문을 제공하지 않으면 필드가 삭제됩니다.

계정 리소스

애드워즈 -> Google Ads 리브랜딩

애드워즈가 Google Ads로 변경됨에 따라 다음과 같은 애드워즈 관련 필드의 이름이 변경되었습니다.

  1. adwordsLinks -> adsLinks
  2. adwordsLinks.adwordsId -> adsLinks.adsId
지원 중단된 필드 및 값 삭제

지원 중단된 reviewsUrl 필드가 삭제되었습니다. 또한 adsLinks, googleMyBusinessLink, youtubeChannelLinks의 링크 상태 inactive가 삭제되었습니다.

Accountstatuses 서비스

AccountStatus 리소스

dataQualityIssues 삭제

itemLevelIssues로 대체되었습니다.

데이터 피드 서비스

데이터 피드 리소스

지원 중단된 필드 삭제

contentLanguage, targetCountry, intendedDestinations 필드가 삭제되고 targets에서 country, language, includedDestinations, excludedDestinations로 대체되었습니다.

제품 인벤토리 업데이트 삭제

product inventory update 유형의 피드가 삭제되었습니다.

인벤토리 서비스

v2 inventory 서비스가 삭제되고 v2.1에서 두 가지 새로운 기능으로 대체되었습니다.

  • 부분 제품 업데이트에는 새로운 보조 피드를 사용하세요.
  • 오프라인 제품 업데이트에는 새 localinventory 서비스를 사용하세요.

주문 서비스

CancelLineItem

요청의 amount, amountPretax, amountTax 필드가 삭제되었습니다. 이제 환불 금액이 자동으로 계산됩니다.

CustomBatch

v2.1에서 CustomBatch가 삭제되었습니다.

InStoreRefundLineItem

amountPretaxamountTax 필드가 각각 priceAmounttaxAmount로 대체되었습니다. priceAmount 필드는 주문 위치에 따라 세금 전 또는 세금 후일 수 있습니다.

환불

이 메서드는 삭제되었습니다. 대신 returnRefundLineItem를 사용하세요.

ReturnLineItem

이 메서드는 삭제되었습니다. 대신 환불 금액을 제공하지 않고 returnRefundLineItem를 사용하세요.

ReturnRefundLineItem

amountPretaxamountTax 필드가 각각 priceAmounttaxAmount로 대체되었습니다. priceAmount 필드는 주문 위치에 따라 세금 전 또는 세금 후일 수 있습니다.

ShipLineItem

요청의 carrier, shipmentId, trackingId 필드가 shipmentInfos로 이동했습니다.

Order 및 TestOrder 리소스

새로운 프로모션 형식

v2.1에는 새로운 프로모션 형식이 있습니다. 프로모션이 포함된 테스트 주문은 만들 수 없습니다.

지원 중단된 필드 삭제

paymentMethod 필드가 삭제되었으며 billingAddresspredefinedBillingAddress는 이제 각각 OrderTestOrder의 최상위 필드입니다.

또한 customer.explicitMarketingPreference가 삭제되고 OrderTestOrder 모두에서 customer.marketingRightsInfo로 대체되었습니다.

지원 중단된 customer.email 필드가 삭제되었습니다.

Order 리소스에서 promotions 필드의 형식이 변경되었습니다.

Orderpayments 서비스

이 서비스는 v2.1에서 삭제되었습니다.

제품 서비스

insert의 응답에는 다음 속성만 포함됩니다.

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

치명적이지 않은 경고 및 오류가 더 이상 응답에 반환되지 않습니다. 이를 통해 피드 규칙 및 기타 고급 피드 관리 기능과 더 효과적으로 통합할 수 있습니다.

이제 삽입된 제품을 get 또는 list로 검색할 수 있기까지 몇 분 정도 지연됩니다.

반환된 혜택 ID가 더 이상 입력된 혜택 ID와 동일하지 않을 수 있습니다.

이제 제품을 삽입하기 전에 가격이 검증됩니다. 값 문자열에는 +, -, ., 숫자 (0~9)만 허용됩니다. 더 이상 쉼표는 허용되지 않습니다.

제품 리소스

CustomGroups가 재귀 customAttributes로 대체됨

이전에는 v2에서 동일한 맞춤 그룹 아래에 맞춤 속성을 추가하여 맞춤 속성을 그룹화할 수 있었습니다. 이제 v2.1에서 맞춤 속성이 재귀적이므로 맞춤 그룹이 필요하지 않습니다.

이제 맞춤 속성에 원래 value 필드 외에 groupValues 필드가 추가되었습니다. 둘 중 하나만 설정해야 하므로 둘 다 설정하거나 둘 다 생략할 수는 없습니다.

판매자가 v2와 v2.1 간에 전환할 수 있으므로 제품에 재귀형 맞춤 속성이 있을 수 있습니다. 맞춤 그룹의 수준이 최대 2개이므로 v2에서는 재귀형 맞춤 속성을 나타낼 수 없습니다. 이 경우 맞춤 속성 그룹이 잘립니다.

customAttributes에서 유형 및 단위 삭제

v2.1에서는 맞춤 속성에 더 이상 typeunit가 포함되지 않습니다. 대신 단위는 value (있는 경우)에 추가되고 유형은 자동으로 감지되어야 합니다. 예를 들어 v2.1에서 value로 '1.23 EUR' 또는 '5.6cm'를 사용합니다.

ProductTypes가 productType 및 additionalProductTypes보다 우선 적용됨

이전에는 제품 유형이 두 필드에 저장되었으며 첫 번째 유형은 단수 필드 productType에, 나머지는 반복 필드 additionalProductTypes에 저장되었습니다. v2.1에서는 두 필드가 단일 반복 필드 productTypes로 대체되었습니다.

대상 속성이 includedDestinations 및 excludedDestinations로 대체됨

v2에서는 반복되는 필드 destinations에 대상 이름과 의도 쌍의 목록으로 대상이 입력되었습니다. 이 필드는 다음 두 개의 반복 필드인 includedDestinationsexcludedDestinations로 대체되었습니다. 기본적으로 사용 설정된 대상은 includedDestinations.에 포함할 필요가 없습니다. 이는 피드의 대상 재정의 구성과 일치합니다.

애드워즈가 Google Ads로 변경됨에 따라 다음과 같은 애드워즈 관련 필드의 이름이 변경되었습니다.

  • adwordsGrouping -> adsGrouping
  • adwordsLabels -> adsLabels
  • adwordsRedirect -> adsRedirect
지원 중단된 필드 삭제

지원 중단된 다음 필드가 삭제되었습니다.

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

Productstatuses 서비스

가져오기 및 목록

product 속성이 includeAttributes 매개변수와 함께 삭제되었습니다. 상태에 해당하는 제품의 속성을 검색하려면 Products 서비스와 새 productId 필드의 값을 사용합니다.

목록

includeInvalidInsertedItems 매개변수가 삭제되었습니다. 이제 모든 제품이 유효한지와 관계없이 반환됩니다. 즉, 이제 listincludeInvalidInsertedItems가 항상 true로 설정된 것처럼 동작합니다.

ProductStatus 리소스

DestinationsStatuses

destinationStatusesintention, approvalStatus, approvalPending 필드가 approved, disapproved, pending 중 하나일 수 있는 문자열인 status로 대체되었습니다.

dataQualityIssues 삭제

itemLevelIssues로 대체되었습니다.