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일
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_CLICK
CROSS_CHANNEL_LINEAR
CROSS_CHANNEL_POSITION_BASED
CROSS_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
를 추가했습니다. 화물 취급소 배송은 집으로 직접 배송하는 대신 서드 파티 제휴 위치 (예: 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_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_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일
보고서 서비스
보고서 서비스에 시장 통계 보고서가 추가되었습니다.
이제 보고서 서비스에 대해 다음을 쿼리할 수 있습니다.
BestSellersProductClusterView
및BestSellersBrandView
표를 사용하는 베스트셀러 보고서PriceCompetitivenessProductView
표를 사용하는 가격 경쟁력 보고서PriceInsightsProductView
표를 사용하는 가격 정보 보고서
자세한 내용은 보고 가이드를 참고하세요.
2022년 11월 7일
데이터 피드 서비스
데이터 피드 서비스에 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
필드를 추가합니다.
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일
제품 서비스
제품 리소스
제품당 최대 2개의 사이즈 유형을 지원하는 새 additionalSizeType
필드
배송 필드 변경사항: 제품 수준 배송 속도를 제공하기 위해 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일
이번 버전에 도입된 변경사항
테스트 실행이 더 이상 지원되지 않음
v2.1에서 dryRun
매개변수가 삭제되었습니다. 이는 모든 API 호출에 적용됩니다.
패치 메서드가 더 이상 지원되지 않음
다음 서비스는 더 이상 patch
메서드를 지원하지 않습니다.
- 계정
- Accounttax
- 데이터 피드
- Liasettings
- Shippingsettings
HTTP BATCH 메서드 삭제
모든 HTTP BATCH
메서드가 v2.1에서 삭제되었습니다. 대신 customBatch
를 사용합니다.
영향을 받는 서비스는 다음과 같습니다.
- 계정
- Accountstatuses
- 데이터 피드
- Datafeedstatuses
- Liasettings
- Orderreports
- 포지션
- 제품
- Productstatuses
- Shippingsettings
계정 서비스
업데이트
요청의 businessInformation
및 googleMyBusinessLink
필드는 Content API v2가 처음 출시된 후에 도입되었습니다. 따라서 판매자가 이러한 두 입력란의 정보를 제공하지 않은 경우 update
를 사용하여 의도치 않게 삭제하는 것을 방지하는 보호 조치가 있습니다.
v2에서는 판매자가 이러한 필드를 삭제하려면 빈 본문 ( {}
)을 명시적으로 제공해야 합니다. v2.1에서는 빈 본문을 제공하거나 본문을 제공하지 않으면 필드가 삭제됩니다.
계정 리소스
애드워즈 -> Google Ads 리브랜딩
애드워즈가 Google Ads로 변경됨에 따라 다음과 같은 애드워즈 관련 필드의 이름이 변경되었습니다.
adwordsLinks
->adsLinks
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
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
의 응답에는 다음 속성만 포함됩니다.
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에서는 맞춤 속성에 더 이상 type
및 unit
가 포함되지 않습니다. 대신 단위는 value
(있는 경우)에 추가되고 유형은 자동으로 감지되어야 합니다. 예를 들어 v2.1에서 value
로 '1.23 EUR' 또는 '5.6cm'를 사용합니다.
ProductTypes가 productType 및 additionalProductTypes보다 우선 적용됨
이전에는 제품 유형이 두 필드에 저장되었으며 첫 번째 유형은 단수 필드 productType
에, 나머지는 반복 필드 additionalProductTypes
에 저장되었습니다. v2.1에서는 두 필드가 단일 반복 필드 productTypes
로 대체되었습니다.
대상 속성이 includedDestinations 및 excludedDestinations로 대체됨
v2에서는 반복되는 필드 destinations
에 대상 이름과 의도 쌍의 목록으로 대상이 입력되었습니다. 이 필드는 다음 두 개의 반복 필드인 includedDestinations
및 excludedDestinations
로 대체되었습니다. 기본적으로 사용 설정된 대상은 includedDestinations.
에 포함할 필요가 없습니다. 이는 피드의 대상 재정의 구성과 일치합니다.
애드워즈 관련 필드 이름 변경
애드워즈가 Google Ads로 변경됨에 따라 다음과 같은 애드워즈 관련 필드의 이름이 변경되었습니다.
adwordsGrouping
->adsGrouping
adwordsLabels
->adsLabels
adwordsRedirect
->adsRedirect
지원 중단된 필드 삭제
지원 중단된 다음 필드가 삭제되었습니다.
aspects
destinations
onlineOnly
validatedDestinations
warnings
Productstatuses 서비스
가져오기 및 목록
product
속성이 includeAttributes
매개변수와 함께 삭제되었습니다. 상태에 해당하는 제품의 속성을 검색하려면 Products
서비스와 새 productId
필드의 값을 사용합니다.
목록
includeInvalidInsertedItems
매개변수가 삭제되었습니다. 이제 모든 제품이 유효한지와 관계없이 반환됩니다. 즉, 이제 list
는 includeInvalidInsertedItems
가 항상 true
로 설정된 것처럼 동작합니다.
ProductStatus 리소스
DestinationsStatuses
destinationStatuses
의 intention
, approvalStatus
, approvalPending
필드가 approved
, disapproved
, pending
중 하나일 수 있는 문자열인 status
로 대체되었습니다.
dataQualityIssues 삭제
itemLevelIssues
로 대체되었습니다.