Package google.shopping.merchant.inventories.v1beta

Chỉ mục

LocalInventoryService

Dịch vụ quản lý kho hàng tại địa phương cho sản phẩm

DeleteLocalInventory

rpc DeleteLocalInventory(DeleteLocalInventoryRequest) returns (Empty)

Xoá LocalInventory được chỉ định khỏi sản phẩm nhất định trong tài khoản người bán của bạn. Có thể mất đến một giờ để xoá LocalInventory khỏi sản phẩm cụ thể. Sau khi bạn nhận được phản hồi xoá thành công, hãy đợi khoảng thời gian đó trước khi thử xoá lại.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.
InsertLocalInventory

rpc InsertLocalInventory(InsertLocalInventoryRequest) returns (LocalInventory)

Chèn tài nguyên LocalInventory vào một sản phẩm trong tài khoản người bán của bạn.

Thay thế tài nguyên LocalInventory đầy đủ nếu đã tồn tại mục nhập có cùng storeCode cho sản phẩm.

Có thể mất đến 30 phút để tài nguyên LocalInventory mới hoặc đã cập nhật xuất hiện trong các sản phẩm.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.
ListLocalInventories

rpc ListLocalInventories(ListLocalInventoriesRequest) returns (ListLocalInventoriesResponse)

Liệt kê các tài nguyên LocalInventory của sản phẩm cụ thể trong tài khoản người bán. Phản hồi có thể chứa ít mục hơn so với chỉ định của pageSize. Nếu pageToken được trả về trong yêu cầu trước đó, thì bạn có thể dùng nó để nhận kết quả bổ sung.

LocalInventory tài nguyên được liệt kê cho mỗi sản phẩm đối với một tài khoản cụ thể.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.

RegionalInventoryService

Dịch vụ quản lý kho hàng theo khu vực cho sản phẩm. Ngoài ra, còn có API và tài nguyên regions riêng biệt để quản lý các định nghĩa khu vực.

DeleteRegionalInventory

rpc DeleteRegionalInventory(DeleteRegionalInventoryRequest) returns (Empty)

Xoá tài nguyên RegionalInventory được chỉ định khỏi sản phẩm nhất định trong tài khoản người bán của bạn. Có thể mất đến một giờ để xoá RegionalInventory khỏi sản phẩm cụ thể. Sau khi bạn nhận được phản hồi xoá thành công, hãy đợi khoảng thời gian đó trước khi thử xoá lại.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.
InsertRegionalInventory

rpc InsertRegionalInventory(InsertRegionalInventoryRequest) returns (RegionalInventory)

Chèn RegionalInventory vào một sản phẩm nhất định trong tài khoản người bán của bạn.

Thay thế tài nguyên RegionalInventory đầy đủ nếu đã tồn tại mục nhập có cùng region cho sản phẩm.

Có thể mất đến 30 phút để tài nguyên RegionalInventory mới hoặc đã cập nhật xuất hiện trong các sản phẩm.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.
ListRegionalInventories

rpc ListRegionalInventories(ListRegionalInventoriesRequest) returns (ListRegionalInventoriesResponse)

Liệt kê các tài nguyên RegionalInventory của sản phẩm cụ thể trong tài khoản người bán. Phản hồi có thể chứa ít mục hơn so với chỉ định của pageSize. Nếu pageToken được trả về trong yêu cầu trước đó, thì bạn có thể dùng nó để nhận kết quả bổ sung.

RegionalInventory tài nguyên được liệt kê cho mỗi sản phẩm đối với một tài khoản cụ thể.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.

DeleteLocalInventoryRequest

Thông báo yêu cầu cho phương thức DeleteLocalInventory.

Trường
name

string

Bắt buộc. Tên của kho hàng tại địa phương của một sản phẩm cụ thể cần xoá. Định dạng accounts/{account}/products/{product}/localInventories/{store_code}

DeleteRegionalInventoryRequest

Thông báo yêu cầu cho phương thức DeleteRegionalInventory.

Trường
name

string

Bắt buộc. Tên của tài nguyên RegionalInventory cần xoá. Định dạng: accounts/{account}/products/{product}/regionalInventories/{region}

InsertLocalInventoryRequest

Thông báo yêu cầu cho phương thức InsertLocalInventory.

Trường
parent

string

Bắt buộc. Tài khoản và sản phẩm mà kho hàng này sẽ được chèn. Định dạng accounts/{account}/products/{product}
local_inventory

LocalInventory

Bắt buộc. Thông tin về kho hàng tại địa phương của sản phẩm. Nếu sản phẩm đã có tài nguyên LocalInventory cho cùng một storeCode, việc thay thế hoàn toàn tài nguyên LocalInventory sẽ được thực hiện.

InsertRegionalInventoryRequest

Thông báo yêu cầu cho phương thức InsertRegionalInventory.

Trường
parent

string

Bắt buộc. Tài khoản và sản phẩm mà kho hàng này sẽ được chèn. Định dạng accounts/{account}/products/{product}
regional_inventory

RegionalInventory

Bắt buộc. Thông tin về kho hàng tại khu vực để thêm vào sản phẩm. Nếu sản phẩm đã có tài nguyên RegionalInventory cho cùng một region, việc thay thế hoàn toàn tài nguyên RegionalInventory sẽ được thực hiện.

ListLocalInventoriesRequest

Thông báo yêu cầu cho phương thức ListLocalInventories.

Trường
parent

string

Bắt buộc. name của sản phẩm chính để đăng kho hàng tại địa phương. Định dạng: accounts/{account}/products/{product}
page_size

int32

Số lượng tài nguyên tối đa LocalInventory để trả về sản phẩm cụ thể. Dịch vụ sẽ trả về ít hơn giá trị này nếu số lượng kho hàng của một sản phẩm cụ thể ít hơn pageSize. Giá trị mặc định là 25000. Giá trị tối đa là 25000; Nếu giá trị cao hơn giá trị tối đa được chỉ định, thì pageSize sẽ mặc định là giá trị tối đa
page_token

string

Mã thông báo trang, nhận được từ lệnh gọi ListLocalInventories trước đó. Cung cấp mã thông báo trang để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho ListLocalInventories phải khớp với lệnh gọi đã cung cấp mã thông báo trang. Mã thông báo được trả về dưới dạng nextPageToken trong phản hồi cho yêu cầu trước đó.

ListLocalInventoriesResponse

Thông báo phản hồi cho phương thức ListLocalInventories.

Trường
local_inventories[]

LocalInventory

Các tài nguyên LocalInventory của sản phẩm cụ thể từ tài khoản cụ thể.
next_page_token

string

Mã thông báo này có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua, thì không có trang tiếp theo nào.

ListRegionalInventoriesRequest

Thông báo yêu cầu cho phương thức ListRegionalInventories.

Trường
parent

string

Bắt buộc. name của sản phẩm mẹ để liệt kê RegionalInventory tài nguyên. Định dạng: accounts/{account}/products/{product}
page_size

int32

Số lượng tài nguyên tối đa RegionalInventory để trả về sản phẩm cụ thể. Dịch vụ sẽ trả về ít hơn giá trị này nếu số lượng kho hàng của một sản phẩm cụ thể ít hơn pageSize. Giá trị mặc định là 25000. Giá trị tối đa là 100.000; Nếu giá trị cao hơn giá trị tối đa được chỉ định, thì pageSize sẽ mặc định là giá trị tối đa.
page_token

string

Mã thông báo trang, nhận được từ lệnh gọi ListRegionalInventories trước đó. Cung cấp mã thông báo trang để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho ListRegionalInventories phải khớp với lệnh gọi đã cung cấp mã thông báo trang. Mã thông báo được trả về dưới dạng nextPageToken trong phản hồi cho yêu cầu trước đó.

ListRegionalInventoriesResponse

Thông báo phản hồi cho phương thức ListRegionalInventories.

Trường
regional_inventories[]

RegionalInventory

Các tài nguyên RegionalInventory của sản phẩm cụ thể từ tài khoản cụ thể.
next_page_token

string

Mã thông báo này có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua, thì không có trang tiếp theo nào.

LocalInventory

Thông tin về kho hàng tại địa phương của sản phẩm. Trình bày thông tin tại cửa hàng của một sản phẩm cụ thể tại cửa hàng do storeCode chỉ định. Để biết danh sách tất cả các giá trị thuộc tính được chấp nhận, hãy xem quy cách dữ liệu kho hàng tại địa phương.

Trường
name

string

Chỉ có đầu ra. Tên của tài nguyên LocalInventory. Định dạng: accounts/{account}/products/{product}/localInventories/{store_code}
account

int64

Chỉ có đầu ra. Tài khoản sở hữu sản phẩm. Trường này sẽ bị bỏ qua nếu ứng dụng đặt.
store_code

string

Bắt buộc. Không thể thay đổi. Mã cửa hàng (mã cửa hàng trên Trang doanh nghiệp của bạn) của cửa hàng thực tế có bán sản phẩm. Hãy xem Quy cách dữ liệu kho hàng tại địa phương để biết thêm thông tin.
price

Price

Giá của sản phẩm tại cửa hàng này.
sale_price

Price

Giá ưu đãi của sản phẩm tại cửa hàng này. Bắt buộc nếu salePriceEffectiveDate được xác định.
sale_price_effective_date

Interval

TimePeriod giảm giá tại cửa hàng này.
custom_attributes[]

CustomAttribute

Danh sách các thuộc tính tuỳ chỉnh (do người bán cung cấp). Bạn cũng có thể sử dụng CustomAttribute để gửi bất kỳ thuộc tính nào của quy cách dữ liệu ở dạng chung.
availability

string

Tình trạng còn hàng của sản phẩm tại cửa hàng này. Để biết các giá trị thuộc tính được chấp nhận, hãy xem quy cách dữ liệu kho hàng tại địa phương
quantity

int64

Số lượng sản phẩm có hàng tại cửa hàng này. Phải lớn hơn hoặc bằng 0.
pickup_method

string

Phương pháp nhận hàng được hỗ trợ cho sản phẩm này. Trừ trường hợp giá trị là "not supported", bạn phải gửi trường này cùng với pickupSla. Để biết các giá trị thuộc tính được chấp nhận, hãy xem quy cách dữ liệu kho hàng tại địa phương
pickup_sla

string

Khoảng thời gian tương đối tính từ ngày đặt hàng sản phẩm này (tại cửa hàng này) cho đến khi khách hàng đến lấy hàng. Phải được gửi bằng pickupMethod. Để biết các giá trị thuộc tính được chấp nhận, hãy xem quy cách dữ liệu kho hàng tại địa phương
instore_product_location

string

Vị trí của sản phẩm trong cửa hàng. Độ dài tối đa là 20 byte.

RegionalInventory

Thông tin về kho hàng tại khu vực của sản phẩm. Biểu thị các thông tin cụ thể như giá và tình trạng còn hàng của một sản phẩm nhất định trong một region cụ thể. Để biết danh sách tất cả các giá trị thuộc tính được chấp nhận, hãy xem quy cách dữ liệu kho hàng tại khu vực.

Trường
name

string

Chỉ có đầu ra. Tên của tài nguyên RegionalInventory. Định dạng: {regional_inventory.name=accounts/{account}/products/{product}/regionalInventories/{region}
account

int64

Chỉ có đầu ra. Tài khoản sở hữu sản phẩm. Trường này sẽ bị bỏ qua nếu ứng dụng đặt.
region

string

Bắt buộc. Không thể thay đổi. Mã khu vực cho tài nguyên RegionalInventory này. Xem trang Tình trạng còn hàng và giá theo khu vực để biết thêm thông tin chi tiết.
price

Price

Giá của sản phẩm ở khu vực này.
sale_price

Price

Giá ưu đãi của sản phẩm ở khu vực này. Bắt buộc nếu salePriceEffectiveDate được xác định.
sale_price_effective_date

Interval

TimePeriod giá ưu đãi ở khu vực này.
custom_attributes[]

CustomAttribute

Danh sách các thuộc tính tuỳ chỉnh (do người bán cung cấp). Bạn cũng có thể sử dụng CustomAttribute để gửi bất kỳ thuộc tính nào của quy cách dữ liệu ở dạng chung.
availability

string

Tình trạng còn hàng của sản phẩm ở khu vực này. Để biết các giá trị thuộc tính được chấp nhận, hãy xem quy cách dữ liệu kho hàng tại khu vực