출시 노트 (v2.1)

2025년 8월 18일

Content API는 지원 중단되었으며 2026년 8월에 종료될 예정입니다. Merchant API로 이전

2025년 6월 19일

제품 서비스

제품 리소스

인도에서 최대 소매 가격 (MRP)을 지정할 수 있도록 maximum_retail_price 필드를 추가했습니다.

판매자 지원 서비스

2025년 5월 26일

계정 서비스

이제 계정에 읽기 전용 사용자를 추가할 수 있습니다.

2025년 4월 14일

계정 서비스

향후에는 더 이상 필요하지 않으므로 accounttax 서비스가 지원 중단되었습니다.

2025년 3월 17일

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

  • accounts.verifyphonenumber
  • returnpolicy

기타 서비스

이 엔드포인트는 더 이상 필요하지 않으며 지원 중단될 수 있습니다.

  • pubsubnotificationsettings

2025년 2월 10일

prerendered_out_of_court_dispute_settlement 필드가 ProductIssue 및 AccountIssue에 추가되었습니다.

RenderProductIssuesResponse 및 RenderAccountIssuesResponse에서 alternate_dispute_resolution 필드가 지원 중단되었습니다.

2024년 12월 12일

제품 서비스

제품의 세액 공제 또는 가격 할인과 같은 지속 가능성 인센티브를 지정하는 sustainability_incentives 필드가 추가되었습니다. 필드 값을 제공하지 않으면 지속 가능성 인센티브를 받을 수 없습니다.

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일

Google에서 구매 서비스

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 측정항목 이 업데이트 후에는 Google에서 구매 측정항목을 가져오면 0이 반환됩니다. 이는 과거 날짜의 이전 값에도 적용됩니다.

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

2024년 5월 13일

제품 서비스

제품 리소스

인증 필드 변경사항: 인증 기관에서 인증 코드나 번호를 발급하지 않는 경우에도 사용자가 인증 정보를 업로드할 수 있도록 인증 값 (클래스, 등급 또는 등급이라고도 함)을 제공하는 certificationValue이 ProductCertification 필드에 추가되었습니다.

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

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일

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

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 서비스

사용자가 Google 비즈니스 프로필 매장과의 POS 매장 일치 상태를 알 수 있고 문제가 있는 경우 해결 방법을 힌트로 제공하는 matching_status 및 matching_status_hint 필드가 PosStore에 추가되었습니다.

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일

계정 서비스

계정 리소스

Accounts 리소스에 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일

보고 서비스

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

이제 다음과 같은 항목에 대해 Reports 서비스를 쿼리할 수 있습니다.

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

2022년 11월 7일

Datafeeds Service

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

2022년 9월 14일

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

2022년 8월 9일

제품에 feedLabel이 추가되었습니다.

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

이전 버전과의 호환성을 위해 기존 피드의 feedLabel에 targetCountry 값이 자동으로 입력되었습니다.

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

전 세계 상품을 지원하기 위해 Content API for Shopping에서 targetCountry 필드가 지원 중단되었습니다. 대신 shipping 필드를 사용하여 타겟 국가를 지정하는 것이 좋습니다.

이제 targetCountry에 feedLabel에 제공한 값이 자동으로 입력됩니다.

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

2021년 12월 8일

계정 서비스

계정 리소스

Accounts 리소스에 Account.AutomaticImprovements라는 새 섹션을 추가했습니다.

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

2021년 10월 25일

프로모션 서비스

프로모션 API에 프로모션 가져오기 추가

2021년 10월 11일

Shipping Settings API

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

창고 이름으로 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 리소스

targetCountry을 넘어 혜택 상태 정보를 제공하는 destinationStatuses 객체의 새로운 approvedCountries, pendingCountries, disapprovedCountries 필드

새 itemLevelIssues.applicableCountries 필드

2020년 8월 10일

계정 서비스

CSS 센터의 판매자 센터 계정 라벨을 관리하기 위한 새로운 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 알림 설정 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를 사용합니다. 영향을 받는 서비스는 다음과 같습니다.

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

계정 서비스

업데이트

요청의 businessInformation 및 googleMyBusinessLink 필드는 Content API v2의 초기 출시 후에 도입되었습니다. 따라서 이 두 필드가 제공되지 않은 경우 판매자가 update를 사용하여 실수로 정보를 삭제하지 못하도록 하는 보호 조치가 있습니다.

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

계정 리소스

AdWords -> 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

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

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 간에 전환할 수 있으므로 제품에 v2에서 표현할 수 없는 재귀 맞춤 속성이 있을 수 있습니다. 맞춤 그룹에는 최대 2개의 수준이 있기 때문입니다. 이 경우 맞춤 속성 그룹이 잘립니다.

customAttributes에서 유형 및 단위 삭제

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

ProductTypes가 productType 및 additionalProductTypes를 대체함

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

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

대상은 반복 필드 destinations의 v2에서 대상 이름과 의도 쌍의 목록으로 입력되었습니다. 이 필드는 includedDestinations 및 excludedDestinations이라는 두 개의 반복 필드로 대체되었습니다. 기본적으로 사용 설정된 대상은 includedDestinations.에 포함하지 않아도 됩니다. 이렇게 하면 피드의 대상 재정의 구성과 일치합니다.

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

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

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

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

Productstatuses 서비스

가져오기 및 나열

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

목록

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

ProductStatus 리소스

DestinationsStatuses

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

dataQualityIssues 삭제

이러한 항목은 itemLevelIssues로 대체되었습니다.