2024년 10월 30일
정산 관련 서비스
Settlement 관련 API 종료에 따라 다음 서비스가 지원 중단됩니다.
- settlementreports
- settlementtranscations
결제 관련 API 종료는 이전에 종료된 BuyOnGoogle 프로그램 및 주문 관련 API와 관련이 있습니다.
앞서 언급한 서비스 호출은 Service was not found on the server 응답과 함께 실패할 것으로 예상됩니다.
2024년 10월 16일
UpdateConversionSourceRequest의 update_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일
제품 서비스
제품 리소스
할부 결제에 선택사항인 downpayment 및 creditType 필드를 추가했습니다.
downpayment는 구매자가 일회성으로 선불로 결제해야 하는 금액을 제공합니다.creditType는 할부 유형 (finance또는lease)을 제공합니다. 이 필드는 차량 광고에만 적용됩니다.
2024년 4월 11일
제품 서비스
제품 리소스
- 제품 수준 배송에 무료 배송 기준 속성 (
FreeShippingThreshold)을 추가했습니다. 이 속성을 사용하면 판매자가 배송비가 무료가 되는 최소 제품 가격을 입력할 수 있습니다. LoyaltyPoints의 공개 상태가 변경되었습니다.
2024년 4월 10일
제품 서비스
제품 리소스
LoyaltyProgram 추가됨
2024년 4월 9일
제품 서비스
제품 리소스
AI 생성 제품 제목과 내용 입력란을 제공하기 위해 structuredTitle 및 structuredDescription를 추가했습니다.
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.list 및 orders.get를 사용하여 기존 주문을 계속 확인할 수 있습니다.
2024년 3월 8일
보고서 서비스
Reports 서비스에 TopicTrendsView 보고서를 추가했습니다.
자세한 내용은 보고 가이드를 참고하세요.
2024년 3월 6일
보고서 서비스
제품의 클릭 가능성 버킷 및 순위가 추가되었습니다.
자세한 내용은 보고 가이드를 참고하세요.
2024년 2월 19일
ConversionSources 서비스
유효한 전환 소스로서의 다음 값이 삭제되었습니다.
CROSS_CHANNEL_FIRST_CLICKCROSS_CHANNEL_LINEARCROSS_CHANNEL_POSITION_BASEDCROSS_CHANNEL_TIME_DECAY
전환 확인 기간으로 60일 및 90일 옵션을 삭제하고 40일을 유효한 옵션으로 추가했습니다.
2024년 1월 17일
POS 서비스
사용자가 매장 일치에 실패한 이유를 자세히 알 수 있도록 PosStore에 matching_status_hint 필드의 새 값을 추가했습니다.
2024년 1월 11일
계정 서비스
link 메서드에 localProductManager 및 localProductManagement를 각각 링크 유형 및 서비스로 추가했습니다. 이를 통해 오프라인 제품 데이터 관리를 목적으로 계정을 연결할 수 있습니다.
2023년 11월 29일
판매자 지원 서비스
판매자 센터에서 수행해야 하는 본인 인증을 위한 VERIFY_IDENTITY_IN_MERCHANT_CENTER 외부 작업 유형을 추가했습니다.
POS 서비스
사용자가 POS 매장과 Google 비즈니스 프로필 매장의 일치 상태를 확인하고 문제가 있는 경우 수정 방법을 알 수 있도록 PosStore에 matching_status 및 matching_status_hint 필드를 추가했습니다.
2023년 11월 15일
repricingrules 및 repricingrules.repricingreports 엔드포인트는 더 이상 지원되지 않습니다.
2023년 11월 1일
배송 설정 서비스
shipment_type=pickup는 더 이상 지원되지 않습니다.
2023년 10월 18일
계정 서비스
판매자가 특정 소비자 가치를 스스로 식별할 수 있는 Business Identity 필드를 추가했습니다.
2023년 10월 10일
배송 설정 서비스의 새 배송 유형으로 Collection Point를 추가했습니다. 화물 취급소 배송은 상품을 자택으로 직접 배송하지 않고 제3자 제휴 위치 (예: UPS Access Points)로 배송하기 위해 제3자 (예: 판매자가 소유하지 않음)에서 제공하는 서비스입니다.
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_method 및 pickup_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_GOOGLELOCAL_INVENTORY_ADS
2023년 2월 9일
프로모션 서비스
프로모션 서비스를 로컬 contentLanguage 지원을 통해 6가지 추가 targetCountry 옵션으로 확장합니다.
BRESNLJPITKR
2023년 1월 12일
제품 서비스
제품 리소스
라이프스타일 이미지의 URL을 제공하는 lifestyleImageLinks를 추가했습니다.
2022년 11월 24일
프로모션 서비스
Promotions.PromotionStatus 섹션에 새 필드 `promotionStatus`를 추가했습니다. 읽기 전용 입력란입니다.
2022년 11월 15일
보고서 서비스
보고서 서비스에 시장 통계 보고서가 추가되었습니다.
이제 보고서 서비스에 대해 다음을 쿼리할 수 있습니다.
BestSellersProductClusterView및BestSellersBrandView표를 사용하는 베스트셀러 보고서PriceCompetitivenessProductView표를 사용하는 가격 경쟁력 보고서PriceInsightsProductView표를 사용하는 가격 정보 보고서
자세한 내용은 보고 가이드를 참고하세요.
2022년 11월 7일
Datafeeds 서비스
데이터 피드 서비스에 feedLabel 지원을 추가했습니다.
2022년 9월 14일
문자열을 허용하도록 feedLabel를 업데이트했습니다.
2022년 8월 9일
제품에 feedLabel를 추가했습니다.
이제 targetCountry 대신 feedLabel를 사용하여 제품 ID의 국가를 지정할 수 있습니다. 이제 혜택 ID가 online:language:feedLabel:offerId로 구성됩니다.
이전 버전과의 호환성을 위해 기존 피드의 feedLabel에 targetCountry 값이 자동으로 채워졌습니다.
targetCountry가 지원 중단되었습니다.
전 세계 제품을 지원하기 위해 쇼핑용 Content API에서 targetCountry 필드를 지원 중단했습니다. 대신 shipping 필드를 사용하여 대상 국가를 지정하는 것이 좋습니다.
이제 targetCountry가 feedLabel에 제공한 값으로 자동으로 채워집니다.
자세한 내용은 쇼핑용 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 필드를 추가하여 창고 이름으로 warehouse를 참조합니다.
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_BASED 및 TYPE_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일
제품 서비스
제품 리소스
새로운 additionalSizeType 필드가 제품당 최대 2개의 사이즈 유형을 지원합니다.
배송 필드 변경사항: 제품 수준 배송 속도를 제공하기 위해 ProductShipping에 minHandlingTime, maxHandlingTime, minTransitTime, maxTransitTime를 추가했습니다.
2021년 1월 28일
계정 서비스
AccountLabel 및 Account 리소스에 자동 라벨 지원을 추가했습니다. 자세한 내용은 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.refunditem 및 orders.refundorder를 사용하면 고객이 반품하지 않은 경우에도 주문에 대한 환불을 시작할 수 있습니다.
2020년 4월 27일
Orderreturns 서비스
새 메서드 acknowledge 및 process와 읽기 메서드용 새 필터 및 입력란 (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일
주문 서비스
주문 리소스
새 필드
주문 리소스에 새 loyaltyInfo 및 invoiceReceivingEmail 필드가 추가되었습니다.
2019년 7월 1일
제품 서비스
제품 서비스에 보조 Content API 피드 지원이 추가되었습니다.
2019년 6월 11일
주문 서비스
Order 및 TestOrder 리소스
가격 조정 추가
프로모션을 적용하여 발생한 원래 광고 항목 가격 및 세금에 대한 조정이 포함된 lineItem[].adjustments 필드가 새로 추가되었습니다.
2019년 2월 14일
이 버전에 도입된 변경사항
테스트 실행이 더 이상 지원되지 않음
dryRun 매개변수가 v2.1에서 삭제되었습니다. 이는 모든 API 호출에 적용됩니다.
패치 메서드가 더 이상 지원되지 않음
다음 서비스는 더 이상 patch 메서드를 지원하지 않습니다.
- 계정
- Accounttax
- 데이터 피드
- Liasettings
- Shippingsettings
HTTP BATCH 메서드 삭제
모든 HTTP BATCH 메서드가 v2.1에서 삭제되었습니다. 대신 customBatch를 사용합니다.
영향을 받는 서비스는 다음과 같습니다.
- 계정
- 계정 상태
- 데이터 피드
- Datafeedstatuses
- Liasettings
- Orderreports
- 포지션
- 제품
- Productstatuses
- Shippingsettings
계정 서비스
업데이트
요청의 businessInformation 및 googleMyBusinessLink 필드는 Content API v2가 처음 출시된 후에 도입되었습니다. 따라서 판매자가 이러한 두 입력란의 정보를 제공하지 않은 경우 update를 사용하여 의도치 않게 삭제하는 것을 방지하는 보호 조치가 있습니다.
v2에서는 판매자가 이러한 필드를 삭제하려면 빈 본문 ( {})을 명시적으로 제공해야 합니다. v2.1에서는 빈 본문을 제공하거나 본문을 제공하지 않으면 필드가 삭제됩니다.
계정 리소스
애드워즈 -> Google Ads 리브랜딩
애드워즈가 Google Ads로 변경됨에 따라 다음과 같은 애드워즈 관련 필드의 이름이 변경되었습니다.
adwordsLinks->adsLinksadwordsLinks.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
amountPretax 및 amountTax 필드가 각각 priceAmount 및 taxAmount로 대체되었습니다. priceAmount 필드는 주문 위치에 따라 세금 전 또는 세금 후일 수 있습니다.
환불
이 메서드는 삭제되었습니다. 대신 returnRefundLineItem를 사용하세요.
ReturnLineItem
이 메서드는 삭제되었습니다. 환불 금액을 제공하지 않고 returnRefundLineItem를 대신 사용하세요.
ReturnRefundLineItem
amountPretax 및 amountTax 필드가 각각 priceAmount 및 taxAmount로 대체되었습니다. priceAmount 필드는 주문 위치에 따라 세전 또는 세후일 수 있습니다.
ShipLineItem
요청의 carrier, shipmentId, trackingId 필드가 shipmentInfos로 이동했습니다.
Order 및 TestOrder 리소스
새 프로모션 형식
v2.1에는 새로운 프로모션 형식이 있습니다. 프로모션이 포함된 테스트 주문은 만들 수 없습니다.
지원 중단된 필드 삭제
paymentMethod 필드가 삭제되었으며 billingAddress 및 predefinedBillingAddress는 이제 각각 Order 및 TestOrder의 최상위 필드입니다.
또한 customer.explicitMarketingPreference가 삭제되고 Order 및 TestOrder에서 customer.marketingRightsInfo로 대체되었습니다.
지원 중단된 customer.email 필드가 삭제되었습니다.
Order 리소스에서 promotions 필드의 형식이 변경되었습니다.
Orderpayments 서비스
이 서비스는 v2.1에서 삭제되었습니다.
제품 서비스
insert의 응답에는 다음 속성만 포함됩니다.
channelcontentLanguageidofferIdtargetCountry
심각하지 않은 경고와 오류가 더 이상 응답에 반환되지 않습니다. 이를 통해 피드 규칙 및 기타 고급 피드 관리 기능과 더 효과적으로 통합할 수 있습니다.
이제 삽입된 제품을 get 또는 list로 검색할 수 있기까지 몇 분 정도 지연됩니다.
반환된 혜택 ID가 더 이상 입력된 혜택 ID와 동일하지 않을 수 있습니다.
이제 제품을 삽입하기 전에 가격이 검증됩니다. 값 문자열에는 +, -, ., 숫자 (0~9)만 허용됩니다. 더 이상 쉼표는 허용되지 않습니다.
제품 리소스
CustomGroups가 재귀 customAttributes로 대체됨
이전에는 v2에서 동일한 맞춤 그룹 아래에 맞춤 속성을 추가하여 맞춤 속성을 그룹화할 수 있었습니다. 이제 v2.1에서 커스텀 속성이 재귀적이므로 커스텀 그룹이 필요하지 않습니다.
이제 맞춤 속성에 원래 value 필드 외에 groupValues 필드가 추가되었습니다. 둘 중 하나만 설정해야 하므로 동시에 설정하거나 생략할 수는 없습니다.
판매자가 v2와 v2.1 간에 전환할 수 있으므로 제품에 재귀형 맞춤 속성이 있을 수 있습니다. 맞춤 그룹의 수준이 최대 2개이므로 v2에서는 재귀형 맞춤 속성을 나타낼 수 없습니다. 이 경우 맞춤 속성 그룹이 잘립니다.
customAttributes에서 유형 및 단위 삭제
v2.1에서는 맞춤 속성에 더 이상 type 및 unit가 포함되지 않습니다. 대신 단위는 value (있는 경우)에 추가되고 유형은 자동으로 감지되어야 합니다. 예를 들어 v2.1에서 value로 '1.23 EUR' 또는 '5.6cm'를 사용합니다.
ProductType은 productType 및 추가ProductType을 대체합니다.
이전에는 제품 유형이 두 필드에 저장되었으며 첫 번째 유형은 단수 필드 productType에, 나머지는 반복 필드 additionalProductTypes에 저장되었습니다. v2.1에서는 두 필드가 단일 반복 필드 productTypes로 대체되었습니다.
대상 속성이 includeDestinations 및 excludedDestinations로 대체됨
v2에서는 반복되는 필드 destinations에 대상 이름과 의도 쌍의 목록으로 대상이 입력되었습니다. 이 필드는 includedDestinations 및 excludedDestinations의 반복되는 두 필드로 대체되었습니다. 기본적으로 사용 설정된 대상은 includedDestinations.에 포함할 필요가 없습니다. 이는 피드의 대상 재정의 구성과 일치합니다.
애드워즈 관련 필드 이름 변경
애드워즈가 Google Ads로 변경됨에 따라 다음과 같은 애드워즈 관련 필드의 이름이 변경되었습니다.
adwordsGrouping->adsGroupingadwordsLabels->adsLabelsadwordsRedirect->adsRedirect
지원 중단된 필드 삭제
지원 중단된 다음 필드가 삭제되었습니다.
aspectsdestinationsonlineOnlyvalidatedDestinationswarnings
Productstatuses 서비스
가져오기 및 목록
includeAttributes 매개변수와 함께 product 속성이 삭제되었습니다. 상태에 해당하는 제품의 속성을 검색하려면 Products 서비스와 새 productId 필드의 값을 사용합니다.
목록
includeInvalidInsertedItems 매개변수가 삭제되었습니다. 이제 모든 제품이 유효한지 여부에 관계없이 반환됩니다. 즉, 이제 list는 includeInvalidInsertedItems가 항상 true로 설정된 것처럼 작동합니다.
ProductStatus 리소스
DestinationsStatuses
destinationStatuses의 intention, approvalStatus, approvalPending 필드가 approved, disapproved, pending 중 하나일 수 있는 문자열인 status로 대체되었습니다.
dataQualityIssues 삭제
itemLevelIssues(으)로 대체되었습니다.