Ngày 15 tháng 11 năm 2024
Dịch vụ sản phẩm
Đối với LoyaltyProgram, hãy thêm trường shipping_label để chỉ định điều kiện. Nếu trường này có giá trị, thì ưu đãi này có lợi ích vận chuyển dành cho khách hàng thân thiết. Nếu bạn không cung cấp giá trị trường này, mặt hàng sẽ không đủ điều kiện hưởng dịch vụ vận chuyển dành cho khách hàng thân thiết theo cấp độ khách hàng thân thiết đã cho.
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 tắt các API liên quan đến đơn đặt hàng, chúng tôi đã ngừng sử dụng các dịch vụ sau:
– 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. Thông tin cập nhật này cho phép bạn chỉ định phạm vi ngày mà giá dành cho thành viên thân thiết có hiệu lực (nếu 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 còn được dùng 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 tháng 5 năm 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:
downpaymentcung 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.creditTypecung cấp loại hình thanh toán trả góp (financehoặ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 giá sản phẩm tối thiểu để được miễn 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 ưu đãi đượ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 cách sử dụ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_CLICKCROSS_CHANNEL_LINEARCROSS_CHANNEL_POSITION_BASEDCROSS_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 mối liên kết 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ụ POS
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ợ nữa.
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 hàng tại điểm đến lấy hàng là một dịch vụ do bên thứ ba cung cấp (ví dụ: không phải do người bán sở hữu) để giao mặt hàng đến một địa điểm liên kết với bên thứ ba (chẳng hạn như Điểm truy cập UPS), thay vì giao hàng 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 thiết lập trải nghiệm đa kênh (tức là chế độ cài đặt cửa hàng thực tế và lấy hàng tại cửa 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 đó.
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ụ quảng bá
Mở phương thức list trong dịch vụ Promotions từ quyền truy cập hạn chế thành quyền truy cập 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 đến 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
Đích đến Cloud Retail
Tài sản bổ sung của Cloud Retail
Thêm trường thuộc tính bổ sung của nhà bán lẻ trên đám mây. Đây là trường lặp lại dành cho khách hàng sử dụng đích đến 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 lựa chọn phương thức thực hiện đơn hàng là giao hàng tại địa phương cho người bán tạo chế độ cài đặt mới về thông tin vận chuyển. Họ có thể định cấu hình chế độ cài đặt cho các 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ợ việc quản lý 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à Mã người bán đăng ký tham gia hiện đượ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_GOOGLELOCAL_INVENTORY_ADS
Ngày 9 tháng 2 năm 2023
Dịch vụ quảng bá
Mở rộng dịch vụ Khuyến mãi thêm 6 lựa chọn
targetCountry
bằng dịch vụ hỗ trợ
contentLanguage
tại địa phương.:
BRESNLJPITKR
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ụ quảng bá
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 báo cáo 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
BestSellersProductClusterViewvà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ó để có 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 thông tin 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.
Phần 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ụ quảng bá
Thêm Get Promotion vào Promotion API.
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 một 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 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 tài nguyên AccountLabel mới để quản lý 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 bài viết 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ụ Returnpolicy và Returnaddress mới cho chương trình Mua trên Google.
Dịch vụ đơn đặ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 Order (Đơ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 vào dịch vụ Sản phẩm.
Ngày 11 tháng 6 năm 2019
Dịch vụ đơn đặt hàng
Tài nguyên về Order và TestOrder
Thêm thông tin đ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 đưa vào 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
- Accounttax
- Nguồn cấp dữ liệu
- Liasettings
- 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
- Productstatuses
- 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 giới thiệu sau lần ra mắt đầu tiên của 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 rõ ràng các trường này với phần nội dung trống ( {}) để xoá các trường đó. Trong phiên bản 2.1, các trường sẽ bị xoá nếu bạn cung cấp nội dung trống hoặc nếu bạn không cung cấp nội dung.
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->adsLinksadwordsLinks.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 phương thức 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
Xoá nguồn cấp dữ liệu thuộc loại product inventory update.
Dịch vụ 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ụ
localinventorymớ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
CustomBatch đã bị xoá 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 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 còn 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.
Xoá trường customer.email không dùng nữa.
Đị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:
channelcontentLanguageidofferIdtargetCountry
Các 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 nữa. Đ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 giống với mã ưu đãi đầu vào.
Giờ đây, giá sẽ được xác thực trước khi chèn sản phẩm. Chỉ cho phép các ký tự sau 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 các cặp tên đích đến và ý định trong phiên bản 2 trong trường lặp lại destinations. Trường này đã được thay thế bằng hai 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.. Thao tác này sẽ khớp với cấu hình của các đích đến ghi đè trong nguồn cấp dữ liệu.
Đổi tên các trường liên quan đến AdWords
Khi AdWords đổi tên thành Google Ads, các trường liên quan đến AdWords sau đây đã được đổi tên:
adwordsGrouping->adsGroupingadwordsLabels->adsLabelsadwordsRedirect->adsRedirect
Xoá các trường không còn dùng nữa
Các trường không dùng nữa sau đây đã bị xoá:
aspectsdestinationsonlineOnlyvalidatedDestinationswarnings
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á dataQualityIssues
Các phương thức này đã được thay thế bằng itemLevelIssues.