Ngày 30 tháng 10 năm 2024
Dịch vụ liên quan đến việc thanh toán
Trong quá trình ngừng hoạt động các API liên quan đến việc thanh toán, các dịch vụ sau đây không còn được dùng nữa:
– settlementreports
– settlementtranscations
Việc ngừng cung cấp các API liên quan đến việc thanh toán có liên quan đến chương trình BuyOnGoogle và các API liên quan đến đơn đặt hàng đã ngừng hoạt động trước đó.
Các lệnh gọi đến các dịch vụ nêu trên dự kiến sẽ không thành công với phản hồi Service was not found on the server
.
Ngày 16 tháng 10 năm 2024
update_mask
trong UpdateConversionSourceRequest
hiện là OPTIONAL
. Nếu bạn không chỉ định mặt nạ cập nhật, thì tất cả các trường có giá trị không trống sẽ được cập nhật.
Ngày 26 tháng 8 năm 2024 (sớm hơn so với thông báo ban đầu)
Dịch vụ liên quan đến đơn đặt hàng
Trong quá trình ngừng cung cấp API liên quan đến đơn đặt hàng, các dịch vụ sau đây cũng đã ngừng hoạt động:
– orderinvoices
– orderreports
– orderreturns
– orderreturns.labels
– orders
Các lệnh gọi đến các dịch vụ nêu trên dự kiến sẽ không thành công với phản hồi Service was not found on the server
.
Dịch vụ OrderTrackingSignals
không ngừng hoạt động và vẫn được cung cấp.
Ngày 10 tháng 8 năm 2024
Các dịch vụ của chương trình Mua trên Google
Trong quá trình ngừng cung cấp API Mua trên Google, tất cả các phương thức trong BuyOnGoogleProgramService
sẽ không hoạt động được với service was not found on the server
.
Ngày 19 tháng 7 năm 2024
Dịch vụ sản phẩm
Thêm trường member_price_effective_date
. Nội dung cập nhật này cho phép bạn chỉ định (nếu có) phạm vi ngày mà giá của thành viên thân thiết có hiệu lực. Nếu bạn không cung cấp giá trị cho trường này, thì giá dành cho thành viên sẽ luôn có hiệu lực.
Ngày 20 tháng 5 năm 2024
Dịch vụ sản phẩm
Thêm LoyaltyPrograms
. Bản cập nhật này cho phép bạn cung cấp nhiều cấp với các điểm khách hàng thân thiết, giá, v.v. khác nhau cho một sản phẩm.
Bạn nên sử dụng trường này thay cho trường LoyaltyProgram
số ít.
Dịch vụ báo cáo
Các chỉ số Mua trên Google không dùng nữa trong bảng MerchantPerformanceView
. Sau lần cập nhật này, việc truy xuất bất kỳ chỉ số Mua trên Google nào sẽ trả về giá trị 0. Điều này cũng áp dụng cho các giá trị trong quá khứ cho các ngày trong quá khứ.
Để biết thêm thông tin, hãy xem bài viết Ngừng sử dụng chương trình Mua trên Google.
Ngày 13 tháng 5 năm 2024
Dịch vụ sản phẩm
Tài nguyên sản phẩm
Thay đổi đối với trường chứng nhận: Thêm
certificationValue
vào trường
ProductCertification
để cung cấp giá trị chứng nhận (còn gọi là lớp, cấp hoặc điểm),
cho phép người dùng tải lên
thông tin chứng nhận
ngay cả khi tổ chức chứng nhận không phát hành mã hoặc số chứng nhận.
Để biết thêm thông tin, hãy xem Hướng dẫn về sản phẩm của chúng tôi.
Ngày 6/5/2024
Dịch vụ báo cáo
Thêm nhóm hiệu quả vào bảng PriceInsightsProductView
.
Mức độ hiệu quả cho biết những sản phẩm nào sẽ được hưởng lợi nhiều nhất khi giá thay đổi. Điểm xếp hạng này tính đến mức tăng hiệu suất theo dự đoán bằng cách điều chỉnh giá ưu đãi và mức chênh lệch giữa giá hiện tại so với giá đề xuất.
Ngày 24 tháng 4 năm 2024
Dịch vụ sản phẩm
Tài nguyên sản phẩm
Thêm các trường downpayment
và creditType
không bắt buộc cho Thanh toán trả góp:
downpayment
cung cấp số tiền mà người mua phải trả trước dưới dạng khoản thanh toán một lần.creditType
cung cấp loại hình thanh toán trả góp (finance
hoặclease
). Trường này chỉ áp dụng cho quảng cáo xe.
Ngày 11 tháng 4 năm 2024
Dịch vụ sản phẩm
Tài nguyên sản phẩm
- Thêm thuộc tính ngưỡng vận chuyển miễn phí (
FreeShippingThreshold
) cho thông tin vận chuyển ở cấp mặt hàng. Thuộc tính này cho phép người bán nhập một giá sản phẩm tối thiểu để bạn được miễn phí phí vận chuyển. - Thay đổi chế độ hiển thị của
LoyaltyPoints
Ngày 10 tháng 4 năm 2024
Dịch vụ sản phẩm
Tài nguyên sản phẩm
Thêm LoyaltyProgram
Ngày 9 tháng 4 năm 2024
Dịch vụ sản phẩm
Tài nguyên sản phẩm
Thêm structuredTitle
và structuredDescription
để cung cấp tiêu đề và nội dung mô tả sản phẩm do AI tạo.
Ngày 3 tháng 4 năm 2024
Dịch vụ hỗ trợ người bán
Thêm trường user_input_action_option
cho phép đối tác yêu cầu một loại thao tác mới: BuiltInUserInputAction
. Thao tác này cho phép các đối tác xây dựng chức năng tự phục vụ phức tạp cho người bán ngay trong ứng dụng của họ thay vì chuyển hướng họ đến Merchant Center.
Thêm phương thức TriggerAction
mới cho BuiltInUserInputAction
. Để sử dụng phương thức này, hãy gửi yêu cầu qua biểu mẫu này.
Ngày 27 tháng 3 năm 2024
Dịch vụ sản phẩm
Tài nguyên sản phẩm
Thêm AutoPricingMinPrice
làm biện pháp bảo vệ trong dự án "Chiết khấu tự động" và "Chương trình khuyến mãi linh động", đảm bảo rằng các khoản chiết khấu trên mặt hàng của người bán không làm giảm giá sản phẩm xuống thấp hơn giá trị này. Nhờ đó, giá trị và khả năng sinh lời của mặt hàng được duy trì.
Ngày 15 tháng 3 năm 2024
Ngừng cung cấp chương trình Mua trên Google dành cho Tìm kiếm và Mua sắm. Bạn có thể tiếp tục xem các đơn đặt hàng hiện có cho đến hết ngày 31 tháng 10 năm 2024 bằng orders.list
và orders.get
.
Ngày 8 tháng 3 năm 2024
Dịch vụ báo cáo
Thêm báo cáo TopicTrendsView
vào dịch vụ Reports
.
Để biết thêm thông tin, hãy xem Hướng dẫn báo cáo của chúng tôi.
Ngày 6 tháng 3 năm 2024
Dịch vụ báo cáo
Thêm nhóm tiềm năng tạo lượt nhấp và thứ hạng cho sản phẩm.
Để biết thêm thông tin, hãy xem Hướng dẫn báo cáo của chúng tôi.
Ngày 19 tháng 2 năm 2024
Dịch vụ ConversionSources
Xoá các giá trị sau đây khỏi danh sách nguồn chuyển đổi hợp lệ:
CROSS_CHANNEL_FIRST_CLICK
CROSS_CHANNEL_LINEAR
CROSS_CHANNEL_POSITION_BASED
CROSS_CHANNEL_TIME_DECAY
Xoá các lựa chọn 60 và 90 ngày làm giai đoạn xem lại và thêm 40 ngày làm lựa chọn hợp lệ.
Ngày 17 tháng 1 năm 2024
Dịch vụ POS
Thêm các giá trị mới cho trường matching_status_hint
trong PosStore, cho phép người dùng biết thêm thông tin chi tiết về lý do không so khớp được cửa hàng.
Ngày 11 tháng 1 năm 2024
Dịch vụ tài khoản
Thêm localProductManager
và localProductManagement
lần lượt làm loại đường liên kết và dịch vụ cho phương thức link
. Các URL này cho phép các tài khoản liên kết
với mục đích quản lý dữ liệu sản phẩm tại cửa hàng địa phương.
Ngày 29 tháng 11 năm 2023
Dịch vụ hỗ trợ người bán
Thêm loại hành động bên ngoài VERIFY_IDENTITY_IN_MERCHANT_CENTER
để xác minh danh tính cần được thực hiện trong Merchant Center.
Dịch vụ điểm bán hàng
Thêm các trường matching_status
và matching_status_hint
vào PosStore để cho phép người dùng biết trạng thái so khớp của PosStore với Cửa hàng trên Trang doanh nghiệp trên Google và gợi ý cách khắc phục trong trường hợp xảy ra sự cố.
Ngày 15 tháng 11 năm 2023
Các điểm cuối repricingrules
và repricingrules.repricingreports
không còn được hỗ trợ.
Ngày 1 tháng 11 năm 2023
Dịch vụ Chế độ cài đặt thông tin vận chuyển
shipment_type=pickup
không còn được hỗ trợ nữa.
Ngày 18 tháng 10 năm 2023
Dịch vụ tài khoản
Thêm trường Business Identity
cho phép người bán tự xác định một số giá trị của người tiêu dùng.
Ngày 10 tháng 10 năm 2023
Thêm Collection Point
làm loại lô hàng mới của dịch vụ cài đặt thông tin vận chuyển. Dịch vụ giao tại điểm đến lấy hàng là dịch vụ do một bên thứ ba (ví dụ: không phải do người bán sở hữu) cung cấp để giao mặt hàng đến một địa điểm liên kết của bên thứ ba (như UPS Access Points), thay vì giao trực tiếp đến nhà.
Ngày 18 tháng 9 năm 2023
Dịch vụ cài đặt LIA
Thêm phương thức setOmnichannelExperience
để cho phép người dùng đặt trải nghiệm đa kênh của họ (tức là trang chủ cửa hàng địa phương và chế độ cài đặt đến lấy hàng). Hiện tại, tính năng này chỉ dành cho những người dùng có nhà cung cấp POS đáng tin cậy để bật các chế độ cài đặt như vậy.
Ngày 7 tháng 9 năm 2023
Ngừng sử dụng chương trình Mua trên Google
Thêm trạng thái DEPRECATED
mới vào phương thức GetBuyOnGoogleProgramStastus
.
Bạn không thể kích hoạt lại hoặc tạm dừng chương trình ở trạng thái như vậy.
Ngày 4 tháng 9 năm 2023
Dịch vụ hỗ trợ người bán
Thêm hành động tích hợp FIX_ACCOUNT_ISSUE
cho các vấn đề về sản phẩm cần được giải quyết ở cấp tài khoản. Thêm thao tác tích hợp SHOW_ADDITIONAL_CONTENT
sẽ được dùng để cung cấp lý do của một cơ quan quản lý cấp quốc gia.
Ngày 28 tháng 8 năm 2023
Dịch vụ khuyến mãi
Mở phương thức list
trong dịch vụ Promotions
từ quyền truy cập giới hạn đối với tất cả.
Ngày 22 tháng 8 năm 2023
Dịch vụ hỗ trợ người bán
Ra mắt Dịch vụ hỗ trợ người bán. Dịch vụ này cung cấp nội dung hỗ trợ cho các vấn đề về tài khoản và sản phẩm.
Ngày 4 tháng 8 năm 2023
Dịch vụ báo cáo
Thêm báo cáo Khả năng hiển thị so với đối thủ cạnh tranh gần nhất vào dịch vụ Báo cáo.
Để biết thêm thông tin, hãy xem Hướng dẫn báo cáo của chúng tôi.
Ngày 25 tháng 7 năm 2023
Dịch vụ POS
Tài nguyên khoảng không quảng cáo
Thêm các trường pickup_method
và pickup_sla
để cho phép người bán gửi thông tin đến lấy hàng cùng với kho hàng của họ.
Ngày 14 tháng 7 năm 2023
Dịch vụ báo cáo
Thêm báo cáo Khả năng hiển thị so với đối thủ cạnh tranh vào dịch vụ Báo cáo.
Để biết thêm thông tin, hãy xem Hướng dẫn báo cáo của chúng tôi.
Ngày 7 tháng 7 năm 2023
Dịch vụ sản phẩm
Tài nguyên sản phẩm
Thêm virtualModelLink
để cung cấp URL cho hình ảnh mô hình 3D.
Ngày 4 tháng 7 năm 2023
Dịch vụ sản phẩm
Tài nguyên sản phẩm
Thêm trường certifications
để cung cấp chứng nhận sản phẩm, chẳng hạn như để gắn nhãn hiệu suất năng lượng cho sản phẩm dựa trên cơ sở dữ liệu EPREL của Liên minh Châu Âu.
Ngày 26 tháng 6 năm 2023
Dịch vụ Chế độ cài đặt thông tin vận chuyển
Thực hiện đơn hàng tại địa phương
Thêm trường no_delivery_post_cutoff
để cho phép người bán chọn không hiển thị thông tin giao hàng tại địa phương trong n+1 ngày khi họ thiết lập dịch vụ vận chuyển là giao hàng tại địa phương trong n ngày.
Ngày 29 tháng 5 năm 2023
Dịch vụ quảng bá
Thêm phương thức list
cho dịch vụ Promotions
.
Dịch vụ đề xuất
Bật tính năng đóng tương tác trong phương thức ReportInteraction
của dịch vụ Đề xuất.
Ngày 9 tháng 5 năm 2023
Vị trí xuất hiện của Cloud Retail
Tài sản bổ sung của Cloud Retail
Thêm trường thuộc tính bổ sung cho bán lẻ trên đám mây. Đây là trường lặp lại dành cho những khách hàng sử dụng đích đến của Cloud Retail. Khi sử dụng trường này, bạn sẽ có thể sử dụng trường này khi sử dụng chương trình bán lẻ trên đám mây. Giá trị này sẽ được liên kết với trường thuộc tính trong mô hình sản phẩm Google Cloud Retail.
Ngày 22 tháng 5 năm 2023
Dịch vụ quảng bá
Thêm phương thức list
cho dịch vụ Promotions
.
Ngày 11 tháng 4 năm 2023
Dịch vụ Chế độ cài đặt thông tin vận chuyển
Thực hiện đơn hàng tại địa phương
Thêm tuỳ chọn thực hiện đơn hàng tại địa phương cho người bán tạo một chế độ cài đặt thông tin vận chuyển mới. Họ có thể định cấu hình chế độ cài đặt cho cửa hàng địa phương trong trường storeConfig
mới. Thông tin này bao gồm bán kính phục vụ, thời hạn đặt hàng và mã cửa hàng đối với những cửa hàng cung cấp dịch vụ giao hàng tại địa phương.
Ngày 3 tháng 4
Dịch vụ đề xuất
Ra mắt Dịch vụ đề xuất. Dịch vụ này đưa ra các đề xuất về cách cải thiện hiệu suất của tài khoản người bán và cho phép bạn báo cáo số lượt nhấp của người bán vào các đề xuất hữu ích.
Ngày 20 tháng 2 năm 2023
Dịch vụ tài khoản
Tài nguyên tài khoản
Thêm một phần mới Account.ConversionSettings trong tài nguyên Accounts.
Dịch vụ ConversionSources
Thêm dịch vụ Nguồn chuyển đổi để hỗ trợ quản lý các nguồn chuyển đổi (thuộc phần Cài đặt lượt chuyển đổi trong Merchant Center).
Ngày 16 tháng 2 năm 2023
Dịch vụ Chế độ cài đặt thông tin vận chuyển
Xác thực mã cửa hàng
Giờ đây, mã cửa hàng sẽ được xác thực để đảm bảo rằng mã cửa hàng đó thuộc về người bán trước khi cập nhật chế độ cài đặt thông tin vận chuyển.
Xác thực người bán LIA
Các chương trình mà bạn đã đăng ký Mã người bán sẽ được xác thực trước khi cập nhật chế độ cài đặt thông tin vận chuyển. Người bán phải tham gia một trong các chương trình sau:
LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
LOCAL_INVENTORY_ADS
Ngày 9 tháng 2 năm 2023
Dịch vụ khuyến mãi
Mở rộng dịch vụ Khuyến mãi sang 6 lựa chọn
targetCountry
bổ sung với dịch vụ hỗ trợ
contentLanguage
tại địa phương.:
BR
ES
NL
JP
IT
KR
Ngày 12 tháng 1 năm 2023
Dịch vụ sản phẩm
Tài nguyên sản phẩm
Thêm lifestyleImageLinks
để cung cấp URL cho hình ảnh phong cách sống.
Ngày 24 tháng 11 năm 2022
Dịch vụ khuyến mãi
Thêm trường mới "promotionStatus" trong mục Promotions.PromotionStatus. Đây là trường chỉ có thể đọc.
Ngày 15 tháng 11 năm 2022
Dịch vụ báo cáo
Thêm các báo cáo của chương trình Phân tích thị trường vào dịch vụ Báo cáo.
Giờ đây, bạn có thể truy vấn dịch vụ Báo cáo để biết:
- Báo cáo sản phẩm và thương hiệu bán chạy nhất sử dụng bảng
BestSellersProductClusterView
vàBestSellersBrandView
. - Báo cáo sức cạnh tranh về giá bằng bảng
PriceCompetitivenessProductView
. - Báo cáo thông tin chi tiết về giá
sử dụng bảng
PriceInsightsProductView
.
Để biết thêm thông tin, hãy xem Hướng dẫn báo cáo của chúng tôi.
Ngày 7 tháng 11 năm 2022
Dịch vụ nguồn cấp dữ liệu
Thêm tính năng hỗ trợ feedLabel
cho dịch vụ Nguồn cấp dữ liệu.
Ngày 14 tháng 9 năm 2022
Cập nhật feedLabel
để chấp nhận mọi chuỗi.
Ngày 9 tháng 8 năm 2022
Thêm feedLabel
cho sản phẩm.
Giờ đây, bạn có thể sử dụng feedLabel
thay vì targetCountry
để chỉ định quốc gia cho mã mặt hàng. Mã ưu đãi hiện được tạo dưới dạng online:language:feedLabel:offerId
.
feedLabel
đã được tự động điền giá trị targetCountry
cho các nguồn cấp dữ liệu hiện có nhằm đảm bảo khả năng tương thích ngược.
Ngừng sử dụng targetCountry
.
Để hỗ trợ các mặt hàng trên toàn cầu, Content API for Shopping đã ngừng sử dụng trường targetCountry
. Thay vào đó, bạn nên sử dụng trường shipping
để chỉ định các quốc gia mục tiêu.
targetCountry
hiện được tự động điền bằng giá trị mà bạn cung cấp trong feedLabel
.
Hãy xem bài đăng trên blog Nhãn nguồn cấp dữ liệu thay thế quốc gia mục tiêu trong Content API for Shopping để biết thêm chi tiết.
Ngày 8 tháng 12 năm 2021
Dịch vụ tài khoản
Tài nguyên tài khoản
Thêm một phần mới Account.AutomaticImprovements trong tài nguyên Accounts.
Mục mới này sẽ cho phép người bán tự động cập nhật mặt hàng, cải thiện hình ảnh và chế độ cài đặt thông tin vận chuyển.
Ngày 25 tháng 10 năm 2021
Dịch vụ khuyến mãi
Thêm chương trình khuyến mãi vào API Khuyến mãi.
Ngày 11 tháng 10 năm 2021
Shipping Settings API
Thêm trường warehouse
mới trong tài nguyên
ShippingSettings
để cho phép người bán quản lý các kho hàng có thể được sử dụng trong
WarehouseBasedDeliveryTime.
Thêm trường warehouseName
mới trong
WarehouseBasedDeliveryTime
để tham chiếu đến
warehouse theo tên kho.
Ngày 4 tháng 10 năm 2021
Dịch vụ tài khoản
Tài nguyên tài khoản
Thêm trường mới "phone_verification_status" trong phần Accounts.BusinessInformation. Đây là trường chỉ có thể đọc, do Accounts.VerifyPhoneNumber đặt.
Ngày 13 tháng 9 năm 2021
Dịch vụ BuyOnGooglePrograms
Tài nguyên BuyOnGoogleProgramStatus
Thêm các trường mới trong tài nguyên BuyOnGooglePrograms.BuyOnProgramStatus đại diện cho: kênh bán hàng trực tuyến, mô hình kinh doanh và số điện thoại dịch vụ khách hàng.
Phương thức UpdateBuyOnGoogleProgramStatus mới
Thêm một phương thức UpdateBuyOnGoogleProgramStatus mới cho phép cập nhật tài nguyên BuyOnGooglePrograms.BuyOnProgramStatus mở rộng.
Ngày 6 tháng 9 năm 2021
Dịch vụ tài khoản
Tài nguyên tài khoản
Thêm trường mới "korean_business_registration_number" trong phần Accounts.BusinessInformation. Trường này sẽ chỉ bị xoá nếu bạn đặt rõ ràng thành một chuỗi trống.
Ngày 30 tháng 8 năm 2021
Dịch vụ quảng bá
Thêm một Dịch vụ khuyến mãi mới có thể chèn chương trình khuyến mãi.
Dịch vụ đơn đặt hàng
Thêm phương thức mới orders/captureOrder
để thu tiền trước khi vận chuyển.
Lý do huỷ đơn đặt hàng mới FAILED_TO_CAPTURE_FUNDS
Dịch vụ sản phẩm
Tài nguyên sản phẩm
Thêm productLength
, productHeight
, productWidth
và productWeight
để cung cấp kích thước và trọng lượng sản phẩm.
Ngày 9 tháng 8 năm 2021
Dịch vụ RepricingRule
Loại RepricingRule
Giá trị enum mới cho trường RepricingRuleType
.
Thêm TYPE_SALES_VOLUME_BASED
và TYPE_COMPETITIVE_PRICE
.
Ngày 17 tháng 5 năm 2021
Dịch vụ đặt nhãn trả lại hàng
Thêm trường "product_id" mới trong CreateReturnRequest. Người bán có thể chỉ định product_id hoặc line_item_id để xác định mặt hàng cần trả lại.
Dịch vụ sản phẩm
Thêm một phương thức mới để cập nhật các sản phẩm hiện có. Bạn có thể cập nhật một sản phẩm bằng cách chỉ cung cấp những trường cần cập nhật thay vì toàn bộ sản phẩm.
Ngày 3 tháng 5 năm 2021
Dịch vụ đặt nhãn trả lại hàng
Thêm các phương thức mới để tải nhãn lên cho chương trình Trả lại hàng do người bán quản lý (MMR). Với orderreturns.labels.create
mới, bạn có thể tải nhãn trả lại hàng lên để chia sẻ với khách hàng.
Ngày 26 tháng 4 năm 2021
Shipping Settings API
Trường warehouseBasedDeliveryTimes
mới trong DeliveryTime để hỗ trợ các dịch vụ vận chuyển tính toán ngày giao hàng dự kiến dựa trên vị trí kho và dịch vụ vận chuyển đã chọn.
Trường eddServices
mới trong đối tượng CarriersCarrier để trả về tên của các dịch vụ áp dụng cho việc tính toán ngày giao hàng dự kiến.
Ngày 12 tháng 4 năm 2021
Dịch vụ sản phẩm
Tài nguyên sản phẩm
Trường additionalSizeType
mới để hỗ trợ tối đa 2 loại kích thước cho mỗi sản phẩm.
Thay đổi đối với trường vận chuyển: Thêm minHandlingTime
, maxHandlingTime
, minTransitTime
và maxTransitTime
vào ProductShipping
để cung cấp tốc độ vận chuyển ở cấp mặt hàng.
Ngày 28 tháng 1 năm 2021
Dịch vụ tài khoản
Thêm tính năng hỗ trợ nhãn tự động vào tài nguyên AccountLabel
và Account
. Để biết thêm thông tin, hãy xem phần Các loại nhãn CSS trong hướng dẫn quản lý Nhãn CSS.
Ngày 5 tháng 10 năm 2020
Dịch vụ CSSES
Tài nguyên CSS
Thêm dịch vụ csses
mới để truy xuất thông tin về các miền CSS và
chỉ định nhãn cho các miền đó. Giờ đây, bạn cũng có thể sử dụng tài nguyên AccountLabel
để tạo và liệt kê các nhãn cấp nhóm CSS. Để biết thêm thông tin, hãy xem phần Quản lý nhãn của CSS.
Ngày 24 tháng 8 năm 2020
Dịch vụ sản phẩm
Tài nguyên sản phẩm
Trường shoppingAdsExcludedCountries
mới để loại trừ các mặt hàng khỏi quảng cáo ở một số quốc gia.
Tài nguyên Productstatuses
Các trường approvedCountries
, pendingCountries
và disapprovedCountries
mới trong đối tượng destinationStatuses
cung cấp thông tin về trạng thái ưu đãi ngoài targetCountry
.
Trường itemLevelIssues.applicableCountries
mới.
Ngày 10 tháng 8 năm 2020
Dịch vụ tài khoản
Thêm một tài nguyên AccountLabel
mới để quản lý các nhãn tài khoản Merchant Center
cho CSS Center. Giờ đây, người dùng CSS Center cũng có thể liệt kê các tài khoản Merchant Center và chỉ định nhãn cho các tài khoản đó bằng các phương thức accounts.list
, accounts.get
và accounts.updatelabels
. Để biết thêm thông tin, hãy xem phần Quản lý nhãn CSS.
Ngày 19 tháng 6 năm 2020
Dịch vụ sản phẩm
Tài nguyên sản phẩm
Trường mới
Các trường productDetails
, productHighlights
, subscriptionCost
và canonicalLink
mới.
Ngày 2 tháng 6 năm 2020
Dịch vụ đơn đặt hàng
Thêm các phương thức mới để bắt đầu hoàn tiền mà không cần trả lại hàng. Với orders.refunditem
và orders.refundorder
mới, bạn có thể bắt đầu hoàn tiền cho các đơn đặt hàng ngay cả khi khách hàng không trả lại hàng.
Ngày 27 tháng 4 năm 2020
Dịch vụ trả lại hàng
Thêm các phương thức mới acknowledge
và process
, cũng như các bộ lọc và trường mới cho các phương thức đọc (list
, get
).
Liên kết với GMB
Thêm tính năng liên kết tài khoản Merchant Center với tài khoản GMB bằng Mã tài khoản GMB.
Ngày 14 tháng 4 năm 2020
API Báo cáo thanh toán
Thêm một dịch vụ mới để nhận báo cáo giải quyết.
Ngày 9 tháng 3 năm 2020
API kho hàng tại địa phương
Thêm một dịch vụ mới để gửi dữ liệu kho hàng tại địa phương.
Ngày 2 tháng 3 năm 2020
API cài đặt thông báo Pubsub
Thêm một dịch vụ mới để quản lý chế độ cài đặt cho thông báo pubsub.
Ngày 3 tháng 12 năm 2019
Dịch vụ sản phẩm
Thêm tính năng hỗ trợ cho nguồn cấp dữ liệu Content API bổ sung của tài khoản nhiều khách hàng.
Ngày 11 tháng 9 năm 2019
Dịch vụ đơn đặt hàng
Thêm tính năng hỗ trợ cho các đơn đặt hàng vận chuyển đến điểm đến lấy hàng và các tính năng hộp cát tương ứng.
Ngày 14 tháng 8 năm 2019
Dịch vụ mới
Thêm dịch vụ mới là Returnpolicy và Returnaddress cho chương trình Mua trên Google.
Dịch vụ đặt hàng
Tài nguyên đơn đặt hàng
Trường mới
Trường quantityUndeliverable
mới.
Ngày 7 tháng 8 năm 2019
Dịch vụ đơn đặt hàng
Tài nguyên đơn đặt hàng
Trường mới
Thêm các trường loyaltyInfo
và invoiceReceivingEmail
mới vào tài nguyên Đơn đặt hàng.
Ngày 1 tháng 7 năm 2019
Dịch vụ sản phẩm
Hỗ trợ nguồn cấp dữ liệu Content API bổ sung được thêm trong dịch vụ Sản phẩm.
Ngày 11 tháng 6 năm 2019
Dịch vụ đặt hàng
Tài nguyên về Order và TestOrder
Bổ sung tính năng điều chỉnh giá
Thêm trường lineItem[].adjustments
mới chứa thông tin điều chỉnh giá và thuế của mục hàng ban đầu do việc áp dụng chương trình khuyến mãi.
Ngày 14 tháng 2 năm 2019
Các thay đổi có trong phiên bản này
Không còn hỗ trợ quy tắc kiểm tra
Tham số dryRun
đã bị xoá khỏi phiên bản 2.1. Điều này áp dụng cho tất cả lệnh gọi API.
Không còn hỗ trợ các phương thức vá
Các dịch vụ sau đây không còn hỗ trợ phương thức patch
:
- Tài khoản
- Thuế tài khoản
- Nguồn cấp dữ liệu
- Cài đặt liên kết
- Chế độ cài đặt thông tin vận chuyển
Xoá các phương thức HTTP BATCH
Tất cả phương thức BATCH
HTTP đã bị xoá khỏi phiên bản 2.1. Thay vào đó, hãy sử dụng customBatch
.
Sau đây là các dịch vụ bị ảnh hưởng:
- Tài khoản
- Accountstatuses
- Nguồn cấp dữ liệu
- Datafeedstatuses
- Liasettings
- Orderreports
- VTr
- Sản phẩm
- Trạng thái sản phẩm
- Chế độ cài đặt thông tin vận chuyển
Dịch vụ tài khoản
Cập nhật
Các trường businessInformation
và googleMyBusinessLink
trong yêu cầu được ra mắt sau lần đầu ra mắt Content API phiên bản 2. Do đó, có một biện pháp bảo vệ giúp người bán không vô tình xoá thông tin trong hai trường này bằng update
nếu họ không cung cấp thông tin.
Trong phiên bản 2, người bán phải cung cấp phần nội dung trống ( {}
) cho các trường này một cách rõ ràng để xoá các trường này. Trong phiên bản 2.1, các trường sẽ bị xoá nếu bạn cung cấp phần nội dung trống hoặc nếu bạn không cung cấp các trường đó.
Tài nguyên tài khoản
AdWords -> Đổi thương hiệu thành Google Ads
Khi AdWords đổi tên thành Google Ads, các trường liên quan đến AdWords sau đây đã được đổi tên:
adwordsLinks
->adsLinks
adwordsLinks.adwordsId
->adsLinks.adsId
Xoá các trường và giá trị không dùng nữa
Xoá trường reviewsUrl
không dùng nữa. Ngoài ra, trạng thái đường liên kết inactive
đã bị xoá đối với adsLinks
, googleMyBusinessLink
và youtubeChannelLinks
.
Dịch vụ Accountstatuses
Tài nguyên AccountStatus
Xoá dataQualityIssues
Các tham số này đã được thay thế bằng itemLevelIssues
.
Dịch vụ nguồn cấp dữ liệu
Tài nguyên nguồn cấp dữ liệu
Xoá các trường không còn dùng nữa
Các trường contentLanguage
, targetCountry
và intendedDestinations
đã bị xoá và thay thế bằng country
, language
, includedDestinations
và excludedDestinations
trong targets
.
Xoá thông tin cập nhật về kho hàng
Nguồn cấp dữ liệu thuộc loại product inventory update
đã bị xóa.
Dịch vụ quản lý khoảng không quảng cáo
Dịch vụ inventory
phiên bản 2 đã bị xoá và thay thế bằng hai tính năng mới trong phiên bản 2.1:
- Sử dụng Nguồn cấp dữ liệu bổ sung mới để cập nhật một phần sản phẩm.
- Sử dụng dịch vụ
localinventory
mới để cập nhật sản phẩm tại địa phương.
Dịch vụ đơn đặt hàng
CancelLineItem
Các trường amount
, amountPretax
và amountTax
trong yêu cầu đã bị xoá. Số tiền hoàn lại hiện được tính tự động.
CustomBatch
Đã xoá CustomBatch
khỏi phiên bản 2.1.
InStoreRefundLineItem
Các trường amountPretax
và amountTax
lần lượt được thay thế bằng priceAmount
và taxAmount
. Trường priceAmount
có thể là trước thuế hoặc sau thuế tuỳ thuộc vào vị trí của đơn đặt hàng.
Hoàn tiền
Phương thức này đã bị xoá. Thay vào đó, hãy sử dụng returnRefundLineItem
.
ReturnLineItem
Phương thức này đã bị xoá. Thay vào đó, hãy sử dụng returnRefundLineItem
mà không cần cung cấp số tiền hoàn lại.
ReturnRefundLineItem
Các trường amountPretax
và amountTax
lần lượt được thay thế bằng priceAmount
và taxAmount
. Trường priceAmount
có thể là trước thuế hoặc sau thuế tuỳ thuộc vào vị trí của đơn đặt hàng.
ShipLineItem
Các trường carrier
, shipmentId
và trackingId
trong yêu cầu đã được chuyển sang shipmentInfos
.
Tài nguyên về Order và TestOrder
Định dạng chương trình khuyến mãi mới
Có một định dạng quảng bá mới trong phiên bản 2.1. Bạn không thể tạo đơn đặt hàng thử nghiệm có chương trình khuyến mãi.
Xoá các trường không dùng nữa
Trường paymentMethod
đã bị xoá và billingAddress
vàpredefinedBillingAddress
hiện là các trường cấp cao nhất trong Order
và
TestOrder
, tương ứng.
Hơn nữa, customer.explicitMarketingPreference
đã bị xoá và thay thế bằng customer.marketingRightsInfo
trong cả Order
và TestOrder
.
Trường customer.email
không dùng nữa đã bị xoá.
Định dạng của trường promotions
đã thay đổi trong tài nguyên Order
.
Dịch vụ Orderpayments
Dịch vụ này đã bị xoá khỏi phiên bản 2.1.
Dịch vụ sản phẩm
Phản hồi từ insert
sẽ chỉ chứa các thuộc tính sau:
channel
contentLanguage
id
offerId
targetCountry
Cảnh báo và lỗi không nghiêm trọng không còn được trả về trong phản hồi. Điều này cho phép tích hợp tốt hơn với các quy tắc nguồn cấp dữ liệu và các tính năng quản lý nguồn cấp dữ liệu nâng cao khác.
Hiện tại, bạn sẽ phải đợi vài phút thì mới có thể truy xuất sản phẩm đã chèn bằng get
hoặc list
.
Mã ưu đãi được trả về không còn được đảm bảo sẽ giống với mã ưu đãi đầu vào.
Giá hiện đã được kiểm tra trước khi chèn sản phẩm. Chỉ những ký tự sau đây mới được phép trong chuỗi giá trị: +
, -
, .
và chữ số (0
-9
). Dấu phẩy không còn được chấp nhận.
Tài nguyên sản phẩm
CustomGroups được thay thế bằng customAttributes đệ quy
Trước đây, bạn có thể nhóm các thuộc tính tuỳ chỉnh với nhau bằng cách thêm các thuộc tính tuỳ chỉnh trong cùng một nhóm tuỳ chỉnh trong phiên bản 2. Các thuộc tính tuỳ chỉnh hiện có tính đệ quy trong phiên bản 2.1, vì vậy, bạn không cần phải sử dụng nhóm tuỳ chỉnh nữa.
Các thuộc tính tuỳ chỉnh hiện có thêm trường groupValues
ngoài trường value
ban đầu; bạn phải đặt đúng một trong các trường này, nghĩa là không thể đặt hoặc bỏ qua đồng thời các trường này.
Vì người bán có thể chuyển đổi giữa phiên bản 2 và 2.1, nên các sản phẩm có thể có thuộc tính tuỳ chỉnh đệ quy không thể được biểu thị trong phiên bản 2 vì các nhóm tuỳ chỉnh có tối đa 2 cấp. Trong trường hợp này, nhóm thuộc tính tuỳ chỉnh sẽ bị cắt bớt.
Xoá loại và đơn vị trong customAttributes
Trong phiên bản 2.1, các thuộc tính tuỳ chỉnh sẽ không còn chứa type
và unit
. Thay vào đó, các đơn vị sẽ được thêm vào value
(nếu có) và các loại sẽ được phát hiện tự động. Ví dụ: sử dụng "1,23 EUR" hoặc "5,6 cm" làm value
trong phiên bản 2.1.
ProductTypes thay thế productType và additionalProductTypes
Trước đây, các loại sản phẩm được lưu trữ trong hai trường, trong đó loại đầu tiên nằm trong trường số ít productType
và các loại còn lại nằm trong trường lặp lại additionalProductTypes
. Trong phiên bản 2.1, hai trường này đã được thay thế bằng một trường lặp lại productTypes
.
Thuộc tính Đích đến được thay thế bằng includedDestinations và excludedDestinations
Các đích đến được nhập dưới dạng danh sách tên và các cặp ý định trong v2 trong trường lặp lại destinations
. Trường này đã được thay thế bằng 2 trường lặp lại sau: includedDestinations
và excludedDestinations
. Bạn không cần đưa các đích đến được bật theo mặc định vào includedDestinations.
. Các đích đến này sẽ khớp với cấu hình ghi đè đích đến trong nguồn cấp dữ liệu.
Đổi tên các trường liên quan đến AdWords
Với việc AdWords trở thành Google Ads, các trường có liên quan đến AdWords sau đây đã được đổi tên:
adwordsGrouping
->adsGrouping
adwordsLabels
->adsLabels
adwordsRedirect
->adsRedirect
Xoá các trường không dùng nữa
Các trường không dùng nữa sau đây đã bị xoá:
aspects
destinations
onlineOnly
validatedDestinations
warnings
Dịch vụ Productstatuses
Lấy và liệt kê
Xoá thuộc tính product
cùng với tham số includeAttributes
. Để truy xuất các thuộc tính của sản phẩm tương ứng với một trạng thái, hãy sử dụng dịch vụ Products
và giá trị của trường productId
mới.
Danh sách
Tham số includeInvalidInsertedItems
đã bị xoá. Giờ đây, tất cả sản phẩm đều được trả về bất kể sản phẩm đó có hợp lệ hay không, nghĩa là list
hiện hoạt động như thể includeInvalidInsertedItems
luôn được đặt thành true
.
Tài nguyên ProductStatus
DestinationsStatuses
Các trường intention
, approvalStatus
và approvalPending
trong destinationStatuses
đã được thay thế bằng status
. Đây là một chuỗi có thể là approved
, disapproved
hoặc pending
.
Xoá dữ liệu về các vấn đề
Các phương thức này đã được thay thế bằng itemLevelIssues
.