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

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, các dịch vụ sau đây không còn được dùng nữa: – settlementreportssettlementtranscations

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)

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: – orderinvoicesorderreportsorderreturnsorderreturns.labelsorders

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 downpaymentcreditType 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ặ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 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 structuredTitlestructuredDescription để 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.listorders.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 localProductManagerlocalProductManagement 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_statusmatching_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 repricingrulesrepricingrules.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_methodpickup_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:

Để 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, productWidthproductWeight để 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_BASEDTYPE_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, minTransitTimemaxTransitTime 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 AccountLabelAccount. Để 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, pendingCountriesdisapprovedCountries 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.getaccounts.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, subscriptionCostcanonicalLink 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.refunditemorders.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 acknowledgeprocess, 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 loyaltyInfoinvoiceReceivingEmail 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 businessInformationgoogleMyBusinessLink 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:

  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 đường liên kết inactive đã bị xoá đối với adsLinks, googleMyBusinessLinkyoutubeChannelLinks.

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, targetCountryintendedDestinations đã bị xoá và thay thế bằng country, language, includedDestinationsexcludedDestinations 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:

Dịch vụ đơn đặt hàng

CancelLineItem

Các trường amount, amountPretaxamountTax 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 amountPretaxamountTax lần lượt được thay thế bằng priceAmounttaxAmount. 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 amountPretaxamountTax lần lượt được thay thế bằng priceAmounttaxAmount. 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, shipmentIdtrackingId 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à billingAddresspredefinedBillingAddress hiện là các trường cấp cao nhất trong OrderTestOrder, tương ứng.

Hơn nữa, customer.explicitMarketingPreference đã bị xoá và thay thế bằng customer.marketingRightsInfo trong cả OrderTestOrder.

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 typeunit. 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: includedDestinationsexcludedDestinations. 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.

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, approvalStatusapprovalPending 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.