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 đã chỉ định khỏi sản phẩm đã cho trong tài khoản người 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 OAuth 2.0 Overview.
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.

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

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 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 OAuth 2.0 Overview.
ListLocalInventories

rpc ListLocalInventories(ListLocalInventoriesRequest) returns (ListLocalInventoriesResponse)

Liệt kê các tài nguyên LocalInventory cho sản phẩm nhất định 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 số lượng mà pageSize chỉ định. Nếu pageToken được trả về trong yêu cầu trước đó, bạn có thể sử dụng pageToken để nhận thêm kết quả.

Tài nguyên LocalInventory được liệt kê theo sản phẩm cho một tài khoản nhất định.

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 OAuth 2.0 Overview.

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ó tài nguyên regions và API riêng để quản lý các định nghĩa về khu vực.

DeleteRegionalInventory

rpc DeleteRegionalInventory(DeleteRegionalInventoryRequest) returns (Empty)

Xoá tài nguyên RegionalInventory đã chỉ định khỏi sản phẩm đã cho trong tài khoản người 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 OAuth 2.0 Overview.
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.

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

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 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 OAuth 2.0 Overview.
ListRegionalInventories

rpc ListRegionalInventories(ListRegionalInventoriesRequest) returns (ListRegionalInventoriesResponse)

Liệt kê các tài nguyên RegionalInventory cho sản phẩm nhất định 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 số lượng mà pageSize chỉ định. Nếu pageToken được trả về trong yêu cầu trước đó, bạn có thể sử dụng pageToken để nhận thêm kết quả.

Tài nguyên RegionalInventory được liệt kê theo sản phẩm cho một tài khoản nhất định.

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 OAuth 2.0 Overview.

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 cho sản phẩm 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 nơi 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 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, thì tài nguyên LocalInventory sẽ được thay thế hoàn toà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 nơi 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 kho hàng theo 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, thì tài nguyên RegionalInventory sẽ được thay thế hoàn toà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 mẹ để liệt kê 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 LocalInventory tối đa mà sản phẩm nhất định trả về. Dịch vụ sẽ trả về ít hơn giá trị này nếu số lượng kho hàng của sản phẩm nhất định ít hơn pageSize. Giá trị mặc định là 25.000. Giá trị tối đa là 25000; Nếu bạn chỉ định một giá trị cao hơn giá trị tối đa, 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

Tài nguyên LocalInventory cho sản phẩm nhất định từ tài khoản được chỉ định.
next_page_token

string

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

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 gốc để liệt kê tài nguyên RegionalInventory. Định dạng: accounts/{account}/products/{product}
page_size

int32

Số lượng tài nguyên RegionalInventory tối đa mà sản phẩm nhất định trả về. Dịch vụ sẽ trả về ít hơn giá trị này nếu số lượng kho hàng của sản phẩm nhất định ít hơn pageSize. Giá trị mặc định là 25.000. Giá trị tối đa là 100000; Nếu bạn chỉ định một giá trị cao hơn giá trị tối đa, 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

Tài nguyên RegionalInventory cho sản phẩm nhất định từ tài khoản được chỉ định.
next_page_token

string

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

LocalInventory

Thông tin kho hàng tại địa phương của sản phẩm. Biểu thị thông tin tại cửa hàng cho 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ả 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 cửa hàng đị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 trong Trang doanh nghiệp) của cửa hàng thực tế bán sản phẩm. Hãy xem Quy cách dữ liệu kho hàng tại cửa hàng đị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 bạn đã xác định salePriceEffectiveDate.
sale_price_effective_date

Interval

TimePeriod của chương trình 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 sản phẩm tại cửa hàng địa phương
quantity

int64

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

string

Phương thức nhận hàng được hỗ trợ cho sản phẩm này. Trừ phi 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 sản phẩm tại cửa hàng địa phương
pickup_sla

string

Khoảng thời gian tương đối từ ngày đặt hàng cho đến khi đơn đặt hàng sản phẩm này (từ cửa hàng này) sẵn sàng để đến lấy hàng. Phải 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 sản phẩm tại cửa hàng địa phương
instore_product_location

string

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

RegionalInventory

Thông tin kho hàng theo khu vực của sản phẩm. Biểu thị 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ả giá trị thuộc tính được chấp nhận, hãy xem quy cách dữ liệu kho hàng sản phẩm theo 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ã nhận dạng của khu vực cho tài nguyên RegionalInventory này. Hãy xem bài viết 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 tại khu vực này.
sale_price

Price

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

Interval

TimePeriod của giá ưu đãi tạ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 tại 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 sản phẩm theo khu vực