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

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

Ngưỡng vận chuyển miễn phí

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 để miễn phí vận chuyển.

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

Đã thay đổi chế độ hiển thị của LoyaltyPoints

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

Đã 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 các đố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 đố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. Để truy cập phương thức này, hãy gửi yêu cầu đến 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 việc 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ờ đó, duy trì giá trị và khả năng sinh lời của ưu đãi.

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

Ngày 6 tháng 3 năm 2024

Dịch vụ báo cáo

Đã thêm nhóm và thứ hạng tiềm năng tạo lượt nhấp cho sản phẩm.

Để biết thêm thông tin, hãy xem Hướng dẫn báo cáo.

Ngày 19 tháng 2 năm 2024

Dịch vụ ConversionSources

Đã xoá những giá trị sau dưới dạng 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 dưới dạng số ngày của giai đoạn xem lại và thêm 40 làm lựa chọn hợp lệ.

Ngày 17 tháng 1 năm 2024

Dịch vụ điểm bán hàng

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 của họ.

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

Dịch vụ tài khoản

Thêm localProductManagerlocalProductManagement làm loại liên kết và dịch vụ tương ứng cho phương thức link. Việc này giú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 địa phương.

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

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

Thêm VERIFY_IDENTITY_IN_MERCHANT_CENTER loại thao tác bên ngoài để xác minh danh tính cần 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, giúp người dùng biết được trạng thái so khớp của Pos Store với Cửa hàng Trang doanh nghiệp trên Google, đồng thời gợi ý cách khắc phục trong trường hợp xảy ra vấn đề.

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

Các điểm cuối repricingrulesrepricingrules.repricingreports không còn được hỗ trợ nữa.

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

Dịch vụ 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ị nhất định của người tiêu dùng.

Ngày 10 tháng 10 năm 2023

Thêm Collection Point làm một loại dịch vụ vận chuyển mới của chế độ cài đặt thông tin vận chuyển. 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 của người bán) cung cấp để giao hàng đến một địa điểm liên kết của bên thứ ba (như Điểm truy cập của UPS), 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 (quảng cáo kho hàng tại địa phương)

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 trang chủ cửa hàng địa phương và đến lấy hàng). Hiện tại, mã này chỉ dành cho những người dùng có nhà cung cấp POS được 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 từ trạng thái nêu trên.

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 dùng để đưa ra lý do của một cơ quan 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 bị giới hạn vào 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ị cạnh tranh của đối thủ cạnh tranh đóng 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.

Ngày 25 tháng 7 năm 2023

Dịch vụ điểm bán hàng

Tài nguyên khoảng không quảng cáo

Thêm các trường pickup_methodpickup_sla để người bán có thể gửi thông tin đến lấy hàng cùng với kho hàng của mình.

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.

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 các 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ụ 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ị dịch vụ giao hàng tại địa phương n + 1 ngày khi họ đã thiết lập dịch vụ vận chuyển thành giao hàng địa phương 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 loại bỏ tương tác trong phương pháp ReportInteraction của dịch vụ Đề xuất.

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

Điểm đến bán lẻ trên đám mây

Thuộc tính bổ sung của Cloud Retail

Thêm trường thuộc tính bổ sung cho ngà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 trên Cloud Retail. Khi được sử dụng, trường này sẽ có sẵn 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 bán lẻ của Google Cloud.

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ụ 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 giao hàng tại địa phương cho 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. Thông tin này bao gồm bán kính phục vụ, hạn chót nhận đơn đặt hàng và mã cửa hàng của các 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 phương pháp được đề 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 số lượt nhấp của người bán về 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 của tài khoản

Thêm mục mới Account.ConversionSettings trong tài nguyên Accounts (Tài khoản).

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 (một phần của phần Cài đặt lượt chuyển đổi trong Merchant Center).

Ngày 16/2/2023

Dịch vụ Cài đặt thông tin vận chuyển

Xác thực mã cửa hàng

Trước khi cập nhật chế độ cài đặt thông tin vận chuyển, mã cửa hàng sẽ được xác thực để đảm bảo rằng mã đó thuộc về người bán.

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

Các chương trình mà mã người bán đã đăng ký hiệ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 lên 6 lựa chọn bổ sung targetCountry có hỗ trợ contentLanguage cục bộ.:

  • 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 đến 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 "promotionStatus" mới 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 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 cho những nội dung sau:

Để biết thêm thông tin, hãy xem Hướng dẫn báo cáo.

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ụ Datafeeds.

Ngày 14 tháng 9 năm 2022

Cập nhật feedLabel để chấp nhận chuỗi bất kỳ.

Ngày 9 tháng 8 năm 2022

Đã thêm feedLabel cho các 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 sẵn bằng 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 quốc gia mục tiêu.

Giờ đây, targetCountry được tự động điền bằng giá trị mà bạn cung cấp trong feedLabel.

Hãy xem bài đăng 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 của tài khoản

Thêm mục mới Account.AutomaticImprovements (Tài khoản) trong tài nguyên Accounts (Tài khoản).

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 tính năng Nhận chương trình khuyến mãi vào API chương trình khuyến mãi.

Ngày 11 tháng 10 năm 2021

API cài đặt vận chuyển

Thêm trường warehouse mới trong tài nguyên ShippingSettings để cho phép người bán quản lý kho hàng có thể được sử dụng trong WarehouseBasedDeliveryTime.

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 của tài khoản

Thêm trường mới "phone_verification_status" trong mục Accounts.BusinessInformation. Đây là trường chỉ có thể đọc do Accounts.VerifyPhoneNumber thiết lập.

Ngày 13 tháng 9 năm 2021

Dịch vụ MuaOnGooglePrograms

Tài nguyên BuyOnGoogleProgramStatus

Thêm các trường mới trong tài nguyên trình bày lại tài nguyên BuyOnGooglePrograms.BuyOnProgramStatus: kênh bán hàng trực tuyến, mô hình kinh doanh và số điện thoại của dịch vụ khách hàng.

Phương thức UpdateBuyOnGoogleProgramStatus mới

Thêm phương thức UpdateBuyOnGoogleProgramStatus mới. Phương thức này sẽ 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 của tài khoản

Thêm trường mới "korean_business_registration_number" trong mục Accounts.BusinessInformation. Trường này sẽ chỉ bị xoá nếu được đặ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ụ đặt món

Thêm phương thức mới orders/captureOrder để nhận 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 quy tắc định giá lại

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ụ nhãn trả lại hàng cho đơn đặt 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 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 các 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 hàng cho đơn đặt hàng

Thêm các phương thức mới để tải nhãn lên cho trường hợp 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ẻ các nhãn đó với khách hàng.

Ngày 26 tháng 4 năm 2021

API cài đặt vận chuyển

Trường warehouseBasedDeliveryTimes mới trong DeliveryTime (Thời gian giao hàng) để hỗ trợ các dịch vụ vận chuyển tính ngày giao hàng dự kiến dựa trên vị trí nhà kho và dịch vụ của hãng 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 để 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.

Các thay đổi đối với trường thông tin 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 các 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ể 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 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 nhất định.

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 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 của mình và gắn nhãn cho các tài khoản đó bằng 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ụ đặt món

Thêm 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.refunditemorders.refundorder mới, bạn có thể bắt đầu quy trình hoàn tiền cho các đơn đặt hàng ngay cả khi khách hàng không trả lại các đơn đặt 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 phương thức đọc (list, get).

Liên kết GMB

Đã thêm khả 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 thanh toán.

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ý các 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

Hỗ trợ thêm 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ụ đặt món

Hỗ trợ thêm các gói hàng đến lấy hàng trong đơn đặt 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 các dịch vụ Chính sách trả lại hàng và Địa chỉ trả lại hàng mới cho chương trình Mua trên Google.

Dịch vụ đặt món

Tài nguyê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ụ đặt món

Tài nguyê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ợ các nguồn cấp dữ liệu bổ sung Content API được thêm vào dịch vụ Sản phẩm.

Ngày 11 tháng 6 năm 2019

Dịch vụ đặt món

Tài nguyên về đơn đặt hàng và TestOrder

Bổ sung mức điều chỉnh giá

Thêm trường lineItem[].adjustments mới có chứa khoản điều chỉnh đối với giá và thuế của mục hàng gốc 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 giới thiệu trong phiên bản này

Không còn hỗ trợ quy trình chạy thử nghiệm

Xoá tham số dryRun 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.

Phương pháp vá không còn được hỗ trợ nữa

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
  • Liasettings
  • Chế độ cài đặt thông tin vận chuyển

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

Tất cả phương thức HTTP BATCH đều đã bị xoá khỏi phiên bản 2.1. Sử dụng customBatch thay thế. Sau đây là các dịch vụ bị ảnh hưởng:

  • Tài khoản
  • Trạng thái tài khoản
  • Nguồn cấp dữ liệu
  • Trạng thái nguồn cấp dữ liệu
  • Liasettings
  • Báo cáo đơn đặt hàng
  • 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 đưa ra 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ăn người bán vô tình xoá thông tin trong 2 trường này bằng update nếu chúng không được cung cấp.

Ở 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á. 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 các trường đó.

Tài nguyên của tài khoản

AdWords -> Đổi mới thương hiệu Google Ads

Khi AdWords trở thành Google Ads, các trường có 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 không dùng nữa reviewsUrl. Ngoài ra, trạng thái liên kết inactive đã bị xoá cho adsLinks, googleMyBusinessLinkyoutubeChannelLinks.

Dịch vụ Accountstatuses

Tài nguyên của trạng thái tài khoản

Xoá các vấn đề về chất lượng dữ liệu

Các thuộc tính 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, 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

Đã xóa nguồn cấp dữ liệu thuộc loại product inventory update.

Dịch vụ kho hàng

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

Dịch vụ đặt món

CancelLineItem

Các trường amount, amountPretaxamountTax trong yêu cầu đã bị xoá. Giờ đây, số tiền được hoàn lại sẽ được tính tự động.

CustomBatch

CustomBatch đã bị xoá 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ường trước thuế hoặc sau thuế tuỳ thuộc vào vị trí đặ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á. Hãy sử dụng returnRefundLineItem mà không cần hoàn tiền.

ReturnRefundLineItem

Các trường amountPretaxamountTax lần lượt được thay thế bằng priceAmounttaxAmount. Trường priceAmount có thể là trường trước thuế hoặc sau thuế tuỳ thuộc vào vị trí đặt hàng.

ShipLineItem

Các trường carrier, shipmentIdtrackingId trong yêu cầu đã được di chuyển sang shipmentInfos.

Tài nguyên về đơn đặt hàng và TestOrder

Định dạng chương trình 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 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á, billingAddresspredefinedBillingAddress hiện là các trường cấp cao nhất lần lượt trong OrderTestOrder.

Ngoài ra, customer.explicitMarketingPreference đã bị xoá và thay thế bằng customer.marketingRightsInfo trong cả OrderTestOrder.

Xoá trường không dùng nữa customer.email.

Định dạng của trường promotions đã thay đổi trong tài nguyên Order.

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

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

Hệ thống sẽ không còn trả về các cảnh báo và lỗi không nghiêm trọng trong phản hồi. Điều này cho phé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 nâng cao khác để quản lý nguồn cấp dữ liệu.

get hoặc list hiện có thể truy xuất sản phẩm đã chèn bị trễ vài phút.

Mã mặt hàng được trả về không còn được đảm bảo giống với mã nhận dạng mặt hàng đầu vào.

Giá hiện được xác thực trước khi chèn sản phẩm. Chuỗi giá trị chỉ được chứa các ký tự sau: +, -, . và các chữ số (0-9). Dấu phẩy không còn được chấp nhận 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 lại 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 có các nhóm tuỳ chỉnh nữa.

Các thuộc tính tuỳ chỉnh hiện có thêm một trường groupValues ngoài trường value gốc. Bạn phải đặt chính xác một trường trong số đó, nghĩa là bạn không thể đặt hoặc bỏ đồ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à 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ì 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 chứa typeunit 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ụ, hãy 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, với loại đầu tiên ở trường số ít productType và trường còn lại ở 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 productTypes lặp lại.

Đã thay thế thuộc tính destinations bằng includeDestinations và excludedDestinations

Đích đến được nhập dưới dạng danh sách các cặp ý định và tên đích đến ở 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: includedDestinationsexcludedDestinations. Bạn không cần đưa các đí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 cơ chế ghi đè đích đến trong nguồn cấp dữ liệu.

Khi 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

Tải 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

Thông số includeInvalidInsertedItems đã bị xoá. Hiện tại, tất cả sản phẩm đều được trả về bất kể có hợp lệ hay không, nghĩa là list hiện sẽ 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à một trong các giá trị approved, disapproved hoặc pending.

Xoá các vấn đề về chất lượng dữ liệu

Các thuộc tính này đã được thay thế bằng itemLevelIssues.