Ghi chú phát hành (phiên bản 2.1)

Ngày 18 tháng 8 năm 2025

Content API không dùng được nữa và sẽ ngừng hoạt động từ tháng 8 năm 2026. Di chuyển sang Merchant API

Ngày 19 tháng 6 năm 2025

Dịch vụ sản phẩm

Tài nguyên sản phẩm

Thêm trường maximum_retail_price để cho phép chỉ định giá bán lẻ tối đa (MRP) ở Ấn Độ.

Dịch vụ hỗ trợ người bán

Ngày 26 tháng 5 năm 2025

Dịch vụ tài khoản

Giờ đây, bạn có thể thêm người dùng chỉ có quyền đọc vào tài khoản.

Ngày 14 tháng 4 năm 2025

Dịch vụ tài khoản

Vì đây sẽ không còn là yêu cầu trong tương lai, nên dịch vụ accounttax đã ngừng hoạt động.

Ngày 17 tháng 3 năm 2025

Trong quá trình ngừng hoạt động các API liên quan đến đơn đặt hàng, các dịch vụ sau đây đã bị ngừng cung cấp:

  • accounts.verifyphonenumber
  • returnpolicy

Dịch vụ khác

Không còn cần đến điểm cuối này nữa và bạn có thể ngừng sử dụng:

  • pubsubnotificationsettings

Ngày 10 tháng 2 năm 2025

Đã thêm các trường prerendered_out_of_court_dispute_settlement vào ProductIssue và vào AccountIssue.

Các trường alternate_dispute_resolution không dùng nữa trong RenderProductIssuesResponse và RenderAccountIssuesResponse.

Ngày 12 tháng 12 năm 2024

Dịch vụ sản phẩm

Đã thêm trường sustainability_incentives để chỉ định các ưu đãi về tính bền vững, chẳng hạn như khoản tín dụng thuế hoặc chiết khấu giá cho sản phẩm. Nếu bạn không cung cấp giá trị của trường, thì mặt hàng sẽ không đủ điều kiện nhận bất kỳ ưu đãi nào về tính bền vững.

Ngày 15 tháng 11 năm 2024

Dịch vụ sản phẩm

Đối với LoyaltyProgram, đã 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, thì mặt hàng sẽ không đủ điều kiện hưởng lợi ích vận chuyển của chương trình khách hàng thân thiết cho cấp độ khách hàng thân thiết đã cho.

Ngày 30 tháng 10 năm 2024

Trong quá trình ngừng hoạt động các API liên quan đến việc thanh toán, những dịch vụ sau đây sẽ không được dùng nữa:

  • settlementreports
  • settlementtranscations

Việc ngừng hoạt động 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 những 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 ở 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)

Trong quá trình ngừng hoạt động các API liên quan đến đơn đặt hàng, các dịch vụ sau đây đã bị ngừng cung cấp:

  • orderinvoices
  • orderreports
  • orderreturns
  • orderreturns.labels
  • orders

Các lệnh gọi đến những 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 chưa ngừng hoạt động và vẫn tiếp tục được cung cấp.

Ngày 10 tháng 8 năm 2024

Dịch vụ Mua trên Google

Trong quá trình ngừng cung cấp API Mua bằng Google, tất cả các phương thức trong BuyOnGoogleProgramService sẽ không thành công 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 (nếu có) phạm vi ngày mà giá dành cho thành viên chương trình khách hàng thân thiết có hiệu lực. Nếu bạn không cung cấp giá trị trường, 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ố không được dùng nữa của chương trình Mua trên Google trong bảng MerchantPerformanceView. Sau lần cập nhật này, việc truy xuất bất kỳ chỉ số nào của chương trình Mua trên Google đều trả về giá trị 0. Điều này cũng áp dụng cho các giá trị trong quá khứ của những ngày trước đây.

Để biết thêm thông tin, hãy xem bài viết Ngừng cung cấp 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à loại, cấp độ hoặc điểm), cho phép người dùng tải thông tin chứng nhận lên ngay cả khi cơ quan chứng nhận không cấp 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ẽ 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 cho biết 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 cho biết loại hình thanh toán trả góp (finance hoặc lease). 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 để phí vận chuyển trở thành miễn phí.
  • 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 hành động mới: BuiltInUserInputAction. Hành động này cho phép đố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 người bán đến Merchant Center.

Thêm một 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 thông 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 các dự án "Chiết khấu tự động" và "Chương trình khuyến mãi linh hoạt", đảm bảo rằng chiết khấu cho các 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à lợi nhuận của sản phẩm được giữ nguyên.

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 vì đây là 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 cho giai đoạn xem lại, đồng thời 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 khiến tính năng so khớp cửa hàng của họ không thành cô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 tài khoản này cho phép liên kết với mục đích quản lý dữ liệu sản phẩm tại đị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 thao tác 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. Các trường này cho phép người dùng biết trạng thái so khớp của Cửa hàng POS 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 có vấn đề.

Ngày 15 tháng 11 năm 2023

Đ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 để người bán có thể tự xác định đối với 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 giao hàng của 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 tại địa phương và đến lấy hàng). Tại thời điểm này, chế độ cài đặt 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

Chương trình Mua trên Google ngừng hoạt động

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 này.

Ngày 4 tháng 9 năm 2023

Dịch vụ hỗ trợ người bán

Đã thêm thao tác FIX_ACCOUNT_ISSUE tích hợp 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 SHOW_ADDITIONAL_CONTENT được tích hợp sẵn. Thao tác này sẽ được dùng để cung cấp lý do của 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 có giới hạn thành quyền truy cập cho 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 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 để giúp người bán có thể gửi thông tin đến lấy hàng cùng với kho hàng.

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, ví dụ: để 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

Hoàn tất đơ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ị dịch vụ 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 để giao hàng tại địa phương trong n ngày.

Ngày 29 tháng 5 năm 2023

Dịch vụ khuyến mãi

Thêm phương thức list cho dịch vụ Promotions.

Dịch vụ đề xuất

Bật tính năng loại bỏ 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

Các thuộc tính bổ sung của Cloud Retail

Thêm trường thuộc tính bổ sung cho nhà bán lẻ trên đám mây. Đây là một trường lặp lại mà khách hàng sử dụng vị trí xuất hiện Cloud Retail. Khi bạn sử dụng trường này, trường này sẽ có sẵn khi bạn sử dụng chương trình bán lẻ trên đám mây. Thao tác này sẽ được ánh xạ đến 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ụ khuyến mãi

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

Hoàn tất đơn hàng tại địa phương

Thêm lựa chọn thực hiện đơn hàng giao hàng tại địa phương cho những người bán tạo 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ác cửa hàng địa phương trong trường storeConfig mới. Trong đó có bán kính dịch vụ, thời hạn đặt hàng và mã cửa hàng của 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 cung cấp các cách đề xuất để 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 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 mục 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 mục 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ã đó thuộc về người bán trước khi chế độ cài đặt thông tin vận chuyển được cập nhật.

Xác thực người bán LIA

Giờ đây, các chương trình mà một Mã người bán đăng ký sẽ được xác thực trước khi chế độ cài đặt thông tin vận chuyển được cập nhật. 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 bổ sung targetCountry có 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 một trường mới "promotionStatus" trong mục Promotions.PromotionStatus. Đây là trường chỉ đọ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 cho những thông tin sau:

Để 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 chế độ 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ã sản phẩm. Giờ đây, mã ưu đãi được tạo thành từ 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ó để đả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 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 vào tài nguyên Accounts.

Phần mới này sẽ giú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 hà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 ShippingSettings resource (Tài nguyên ShippingSettings) để cho phép người bán quản lý những kho hàng có thể dùng trong WarehouseBasedDeliveryTime (Thời gian giao hàng dựa trên kho hàng).

Thêm trường warehouseName mới trong WarehouseBasedDeliveryTime để tham chiếu đến kho hàng theo tên kho hàng.

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 một 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. Tài nguyên này đạ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 một trường mới "korean_business_registration_number" trong phần Accounts.BusinessInformation. Trường này sẽ chỉ được 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ụ khuyến mãi

Đã thêm một Dịch vụ khuyến mãi mới có tính năng Chèn 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 của 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ụ nhãn trả lại đơn đặt hàng

Đã thêm một 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ụ nhãn trả lại đơn đặt hàng

Thêm các phương thức mới để tải nhãn lên cho tính năng 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 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 hàng và dịch vụ của hãng vận chuyển được 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 để tính 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 cho các 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 một 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ể dùng tài nguyên AccountLabel để tạo và liệt kê nhãn ở cấp nhóm CSS. Để biết thêm thông tin, hãy xem bài viết 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 của mặt hàng 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ý 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 quy trình 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 đơn đặt hàng ngay cả khi khách hàng không trả lại đơn đặt hàng.

Ngày 27 tháng 4 năm 2020

Dịch vụ Orderreturns

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 phương thức đọc (list, get).

Liên kết với Google Doanh nghiệp của tôi

Thêm khả năng liên kết tài khoản Merchant Center với tài khoản GMB bằng cách sử dụng mã tài khoản GMB.

Ngày 14 tháng 4 năm 2020

Settlement Report APIs

Đã thêm một dịch vụ mới để nhận báo cáo thanh toán.

Ngày 9 tháng 3 năm 2020

Local Inventory API

Đã 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 Pub/Sub

Đã 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ợ nguồn cấp dữ liệu Content API bổ sung cho 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 lô hàng đến lấy trong đơn đặt hàng và các tính năng tương ứng của hộp cát.

Ngày 14 tháng 8 năm 2019

Dịch vụ mới

Thêm các 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 Đặt hàng.

Ngày 1 tháng 7 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 trong 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 Order và TestOrder

Thêm mức điều chỉnh giá

Đã thêm trường lineItem[].adjustments mới chứa mức điều chỉnh đối với giá và thuế ban đầu của mặt hàng do áp dụng chương trình khuyến mãi.

Ngày 14 tháng 2 năm 2019

Các thay đổi 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ả cá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 nữa:

  • Tài khoản
  • Accounttax
  • Nguồn cấp dữ liệu
  • Liasettings
  • Shippingsettings

Xoá các phương thức HTTP BATCH

Tất cả phương thức HTTP BATCH đều đã bị xoá khỏi phiên bản 2.1. Thay vào đó, hãy sử dụng customBatch. Các dịch vụ bị ảnh hưởng là:

  • Tài khoản
  • Accountstatuses
  • Nguồn cấp dữ liệu
  • Datafeedstatuses
  • Liasettings
  • Orderreports
  • VTr
  • Sản phẩm
  • Productstatuses
  • Shippingsettings

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 ban đầu của Content API phiên bản 2. Do đó, có một biện pháp bảo vệ ngăn người bán vô tình xoá thông tin trong hai trường này bằng update nếu họ không cung cấp.

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 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 một 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 -> 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:

  1. adwordsLinks -> adsLinks
  2. 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 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 hàm 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 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 kho hàng của sản phẩm

Nguồn cấp dữ liệu thuộc loại product inventory update đã bị xoá.

Dịch vụ kho hàng

Dịch vụ inventory phiên bản 2 đã bị xoá và thay thế bằng 2 tính năng mới trong phiên bản 2.1:

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à giá trước thuế hoặc giá 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à giá trước thuế hoặc giá 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 Order và TestOrder

Định dạng khuyến mãi mới

Có một định dạng khuyến mãi mới trong phiên bản 2.1. Bạn không thể tạo đơn đặt hàng thử nghiệm bằng 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.

Đã 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:

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

Các cảnh báo và lỗi không nghiêm trọng sẽ không còn được trả về trong phản hồi nữa. Điều này giúp tích hợp tốt hơn với 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, có một độ trễ vài phút trước khi get hoặc list có thể truy xuất một sản phẩm đã được chèn.

ID ưu đãi được trả về không còn được đảm bảo giống với ID ưu đãi đầu vào.

Giờ đây, giá được xác thực trước khi chèn sản phẩm. Bạn chỉ được dùng các ký tự sau trong chuỗi giá trị: +, -, . và các chữ số (0 – 9). Chúng tôi không còn chấp nhận dấu phẩy nữa.

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 bằng cách thêm các thuộc tính tuỳ chỉnh vào cùng một nhóm tuỳ chỉnh trong phiên bản 2. Giờ đây, các thuộc tính tuỳ chỉnh có tính đệ quy trong phiên bản 2.1, nên bạn không cần dùng các nhóm tuỳ chỉnh nữa.

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 chính xác một trong hai trường này, tức là bạn không thể đặt đồng thời hoặc bỏ qua cả hai trường.

Vì người bán có thể chuyển đổi giữa phiên bản 2 và phiên bản 2.1, nên các sản phẩm có thể có các thuộc tính tuỳ chỉnh đệ quy không thể 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 nữa. Thay vào đó, các đơn vị sẽ được thêm vào value (nếu có) và các loại sẽ được tự động phát hiện. 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 2 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 duy nhất productTypes.

Thuộc tính Vị trí được thay thế bằng includedDestinations và excludedDestinations

Các đích đến được nhập dưới dạng danh sách gồm 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 2 trường lặp lại sau đây: includedDestinations và excludedDestinations. Bạn không cần thêm những đích đến được bật theo mặc định vào includedDestinations.. Điều này sẽ khớp với cấu hình của chế độ ghi đè đích đến trong nguồn cấp dữ liệu.

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 -> adsGrouping
  • adwordsLabels -> adsLabels
  • adwordsRedirect -> adsRedirect
Xoá các trường không dùng nữa

Các trường không còn dùng nữa sau đây đã bị xoá:

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

Dịch vụ Productstatuses

Nhận và liệt kê

Thuộc tính product đã bị xoá 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à một trong các giá trị approved, disapproved hoặc pending.

Xoá dataQualityIssues

Các hàm này đã được thay thế bằng itemLevelIssues.