Merchant API

Quản lý các tài khoản Merchant Center theo phương thức lập trình.

Dịch vụ: merchantapi.googleapis.com

Để gọi dịch vụ này, bạn nên sử dụng thư viện ứng dụng do Google cung cấp. Nếu ứng dụng cần sử dụng thư viện của riêng bạn để gọi dịch vụ này, hãy sử dụng thông tin sau khi bạn yêu cầu API.

Tài liệu khám phá

Discovery Document (Tài liệu khám phá) là quy cách mà máy có thể đọc được để mô tả và sử dụng các API REST. Thư viện này được dùng để tạo thư viện ứng dụng, trình bổ trợ IDE và các công cụ khác tương tác với API của Google. Một dịch vụ có thể cung cấp nhiều tài liệu khám phá. Dịch vụ này cung cấp các tài liệu khám phá sau:

Điểm cuối dịch vụ

Điểm cuối của dịch vụ là một URL cơ sở chỉ định địa chỉ mạng của một dịch vụ API. Một dịch vụ có thể có nhiều điểm cuối dịch vụ. Dịch vụ này có điểm cuối dịch vụ sau đây và tất cả các URI bên dưới đều liên quan đến điểm cuối dịch vụ này:

  • https://merchantapi.googleapis.com

Tài nguyên REST: reports_v1beta.accounts.reports

Phương thức
search POST /reports/v1beta/{parent=accounts/*}/reports:search
Truy xuất báo cáo được xác định theo cụm từ tìm kiếm.

Tài nguyên REST: quota_v1beta.accounts.quotas

Phương thức
list GET /quota/v1beta/{parent=accounts/*}/quotas
Liệt kê hạn mức cuộc gọi hằng ngày và mức sử dụng mỗi nhóm cho tài khoản Merchant Center của bạn.

Tài nguyên REST: promotions_v1beta.accounts.promotions

Phương thức
get GET /promotions/v1beta/{name=accounts/*/promotions/*}
Truy xuất chương trình khuyến mãi từ tài khoản Merchant Center của bạn.
insert POST /promotions/v1beta/{parent=accounts/*}/promotions:insert
Chèn chương trình khuyến mãi cho tài khoản Merchant Center của bạn.
list GET /promotions/v1beta/{parent=accounts/*}/promotions
Liệt kê các chương trình khuyến mãi trong tài khoản Merchant Center của bạn.

Tài nguyên REST: products_v1beta.accounts.productInputs

Phương thức
delete DELETE /products/v1beta/{name=accounts/*/productInputs/*}
Xoá dữ liệu sản phẩm đã nhập khỏi tài khoản Merchant Center.
insert POST /products/v1beta/{parent=accounts/*}/productInputs:insert
Tải dữ liệu nhập về sản phẩm lên tài khoản Merchant Center.

Tài nguyên REST: products_v1beta.accounts.products

Phương thức
get GET /products/v1beta/{name=accounts/*/products/*}
Truy xuất sản phẩm đã xử lý từ tài khoản Merchant Center.
list GET /products/v1beta/{parent=accounts/*}/products
Liệt kê các sản phẩm đã xử lý trong tài khoản Merchant Center của bạn.

Tài nguyên REST: notifications_v1beta.accounts.notificationsubscriptions

Phương thức
create POST /notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
Tạo gói đăng ký thông báo cho người bán.
delete DELETE /notifications/v1beta/{name=accounts/*/notificationsubscriptions/*}
Xoá gói thuê bao thông báo cho người bán.
get GET /notifications/v1beta/{name=accounts/*/notificationsubscriptions/*}
Nhận thông báo đã đăng ký nhận cho một tài khoản.
list GET /notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
Xem tất cả thông báo đã đăng ký nhận cho người bán.
patch PATCH /notifications/v1beta/{notificationSubscription.name=accounts/*/notificationsubscriptions/*}
Cập nhật gói đăng ký thông báo hiện có cho người bán.

Tài nguyên REST: lfp_v1beta.accounts.lfpInventories

Phương thức
insert POST /lfp/v1beta/{parent=accounts/*}/lfpInventories:insert
Chèn một tài nguyên LfpInventory cho tài khoản người bán mục tiêu đó.

Tài nguyên REST: lfp_v1beta.accounts.lfpSales

Phương thức
insert POST /lfp/v1beta/{parent=accounts/*}/lfpSales:insert
Chèn LfpSale cho người bán cụ thể.

Tài nguyên REST: lfp_v1beta.accounts.lfpStores

Phương thức
delete DELETE /lfp/v1beta/{name=accounts/*/lfpStores/*}
Xoá cửa hàng của người bán mục tiêu.
get GET /lfp/v1beta/{name=accounts/*/lfpStores/*}
Truy xuất thông tin về cửa hàng.
insert POST /lfp/v1beta/{parent=accounts/*}/lfpStores:insert
Chèn một cửa hàng cho người bán mục tiêu.
list GET /lfp/v1beta/{parent=accounts/*}/lfpStores
Liệt kê các cửa hàng của người bán mục tiêu, do bộ lọc chỉ định trong ListLfpStoresRequest.

Tài nguyên REST: inventories_v1beta.accounts.products.localInventories

Phương thức
delete DELETE /inventories/v1beta/{name=accounts/*/products/*/localInventories/*}
Xoá LocalInventory được chỉ định khỏi sản phẩm cụ thể trong tài khoản người bán của bạn.
insert POST /inventories/v1beta/{parent=accounts/*/products/*}/localInventories:insert
Chèn tài nguyên LocalInventory vào một sản phẩm trong tài khoản người bán.
list GET /inventories/v1beta/{parent=accounts/*/products/*}/localInventories
Liệt kê các tài nguyên LocalInventory cho sản phẩm cụ thể trong tài khoản người bán của bạn.

Tài nguyên REST: inventories_v1beta.accounts.products.regionalInventories

Phương thức
delete DELETE /inventories/v1beta/{name=accounts/*/products/*/regionalInventories/*}
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.
insert POST /inventories/v1beta/{parent=accounts/*/products/*}/regionalInventories:insert
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.
list GET /inventories/v1beta/{parent=accounts/*/products/*}/regionalInventories
Liệt kê các tài nguyên RegionalInventory cho sản phẩm cụ thể trong tài khoản người bán của bạn.

Tài nguyên REST: datasources_v1beta.accounts.dataSources

Phương thức
create POST /datasources/v1beta/{parent=accounts/*}/dataSources
Tạo cấu hình nguồn dữ liệu mới cho tài khoản cụ thể.
delete DELETE /datasources/v1beta/{name=accounts/*/dataSources/*}
Xoá nguồn dữ liệu khỏi tài khoản Merchant Center của bạn.
fetch POST /datasources/v1beta/{name=accounts/*/dataSources/*}:fetch
Thực hiện tìm nạp dữ liệu ngay lập tức (kể cả bên ngoài lịch tìm nạp) trên một nguồn dữ liệu từ tài khoản Merchant Center của bạn.
get GET /datasources/v1beta/{name=accounts/*/dataSources/*}
Truy xuất cấu hình nguồn dữ liệu cho tài khoản cụ thể.
list GET /datasources/v1beta/{parent=accounts/*}/dataSources
Liệt kê cấu hình của các nguồn dữ liệu của một tài khoản cụ thể.
patch PATCH /datasources/v1beta/{dataSource.name=accounts/*/dataSources/*}
Cập nhật cấu hình nguồn dữ liệu hiện có.

Tài nguyên REST: conversions_v1beta.accounts.conversionSources

Phương thức
create POST /conversions/v1beta/{parent=accounts/*}/conversionSources
Tạo nguồn chuyển đổi mới.
delete DELETE /conversions/v1beta/{name=accounts/*/conversionSources/*}
Lưu trữ nguồn chuyển đổi hiện có.
get GET /conversions/v1beta/{name=accounts/*/conversionSources/*}
Tìm nạp nguồn chuyển đổi.
list GET /conversions/v1beta/{parent=accounts/*}/conversionSources
Truy xuất danh sách nguồn chuyển đổi mà phương thức gọi có quyền truy cập.
patch PATCH /conversions/v1beta/{conversionSource.name=accounts/*/conversionSources/*}
Cập nhật thông tin của một nguồn chuyển đổi hiện có.
undelete POST /conversions/v1beta/{name=accounts/*/conversionSources/*}:undelete
Bật lại nguồn chuyển đổi đã lưu trữ.

Tài nguyên REST: accounts_v1beta.accounts

Phương thức
createAndConfigure POST /accounts/v1beta/accounts:createAndConfigure
Tạo một tài khoản Merchant Center độc lập có cấu hình bổ sung.
delete DELETE /accounts/v1beta/{name=accounts/*}
Xoá tài khoản được chỉ định bất kể loại tài khoản: tài khoản độc lập, tài khoản nhiều khách hàng (MCA) hoặc tài khoản phụ.
get GET /accounts/v1beta/{name=accounts/*}
Truy xuất một tài khoản từ tài khoản Merchant Center của bạn.
getBusinessIdentity GET /accounts/v1beta/{name=accounts/*/businessIdentity}
Truy xuất thông tin nhận dạng doanh nghiệp của một tài khoản.
getBusinessInfo GET /accounts/v1beta/{name=accounts/*/businessInfo}
Truy xuất thông tin doanh nghiệp của tài khoản.
getHomepage GET /accounts/v1beta/{name=accounts/*/homepage}
Truy xuất trang chủ của cửa hàng.
getShippingSettings GET /accounts/v1beta/{name=accounts/*/shippingSettings}
Truy xuất thông tin trong chế độ cài đặt thông tin vận chuyển.
list GET /accounts/v1beta/accounts
Liệt kê các tài khoản mà người dùng gọi có thể truy cập và khớp với các điều kiện ràng buộc của yêu cầu, chẳng hạn như kích thước trang hoặc bộ lọc.
listSubaccounts GET /accounts/v1beta/{provider=accounts/*}:listSubaccounts
Liệt kê tất cả các tài khoản phụ của một tài khoản nhiều khách hàng cụ thể.
patch PATCH /accounts/v1beta/{account.name=accounts/*}
Cập nhật một tài khoản bất kể loại tài khoản: tài khoản độc lập, tài khoản nhiều khách hàng (MCA) hoặc tài khoản phụ.
updateBusinessIdentity PATCH /accounts/v1beta/{businessIdentity.name=accounts/*/businessIdentity}
Cập nhật thông tin nhận dạng doanh nghiệp của một tài khoản.
updateBusinessInfo PATCH /accounts/v1beta/{businessInfo.name=accounts/*/businessInfo}
Cập nhật thông tin doanh nghiệp của một tài khoản.
updateHomepage PATCH /accounts/v1beta/{homepage.name=accounts/*/homepage}
Cập nhật trang chủ của cửa hàng.

Tài nguyên REST: accounts_v1beta.accounts.accounttax

Phương thức
get GET /accounts/v1beta/{name=accounts/*/accounttax/*}
Trả về quy tắc thuế khớp với điều kiện của GetAccountTaxRequest
list GET /accounts/v1beta/{parent=accounts/*}/accounttax
Chỉ liệt kê chế độ cài đặt thuế của các tài khoản phụ trong tài khoản Merchant Center.
patch PATCH /accounts/v1beta/{accountTax.name=accounts/*/accounttax/*}
Cập nhật chế độ cài đặt thuế của tài khoản.

Tài nguyên REST: accounts_v1beta.accounts.homepage

Phương thức
claim POST /accounts/v1beta/{name=accounts/*/homepage}:claim
Xác nhận quyền sở hữu trang chủ của cửa hàng.
unclaim POST /accounts/v1beta/{name=accounts/*/homepage}:unclaim
Huỷ xác nhận quyền sở hữu đối với trang chủ của một cửa hàng.

Tài nguyên REST: accounts_v1beta.accounts.issues

Phương thức
list GET /accounts/v1beta/{parent=accounts/*}/issues
Liệt kê tất cả các vấn đề về tài khoản của một tài khoản Merchant Center.

Tài nguyên REST: accounts_v1beta.accounts.onlineReturnPolicies

Phương thức
get GET /accounts/v1beta/{name=accounts/*/onlineReturnPolicies/*}
Xem một chính sách trả lại hàng hiện có.
list GET /accounts/v1beta/{parent=accounts/*}/onlineReturnPolicies
Liệt kê tất cả các chính sách trả lại hàng hiện có.

Tài nguyên REST: accounts_v1beta.accounts.programs

Phương thức
disable POST /accounts/v1beta/{name=accounts/*/programs/*}:disable
Vô hiệu hoá quyền tham gia vào chương trình đã chỉ định cho tài khoản.
enable POST /accounts/v1beta/{name=accounts/*/programs/*}:enable
Cho phép tham gia chương trình đã chỉ định cho tài khoản.
get GET /accounts/v1beta/{name=accounts/*/programs/*}
Truy xuất chương trình đã chỉ định cho tài khoản.
list GET /accounts/v1beta/{parent=accounts/*}/programs
Truy xuất tất cả chương trình cho tài khoản.

Tài nguyên REST: accounts_v1beta.accounts.regions

Phương thức
create POST /accounts/v1beta/{parent=accounts/*}/regions
Tạo định nghĩa về khu vực trong tài khoản Merchant Center.
delete DELETE /accounts/v1beta/{name=accounts/*/regions/*}
Xoá định nghĩa về khu vực khỏi tài khoản Merchant Center.
get GET /accounts/v1beta/{name=accounts/*/regions/*}
Truy xuất khu vực đã xác định trong tài khoản Merchant Center.
list GET /accounts/v1beta/{parent=accounts/*}/regions
Liệt kê các khu vực trong tài khoản Merchant Center của bạn.
patch PATCH /accounts/v1beta/{region.name=accounts/*/regions/*}
Cập nhật định nghĩa về khu vực trong tài khoản Merchant Center.

Tài nguyên REST: accounts_v1beta.accounts.shippingSettings

Phương thức
insert POST /accounts/v1beta/{parent=accounts/*}/shippingSettings:insert
Thay thế chế độ cài đặt thông tin vận chuyển của người bán bằng chế độ cài đặt yêu cầu vận chuyển.

Tài nguyên REST: accounts_v1beta.accounts.termsOfServiceAgreementStates

Phương thức
get GET /accounts/v1beta/{name=accounts/*/termsOfServiceAgreementStates/*}
Trả về trạng thái của thoả thuận điều khoản dịch vụ.
retrieveForApplication GET /accounts/v1beta/{parent=accounts/*}/termsOfServiceAgreementStates:retrieveForApplication
Truy xuất trạng thái của thoả thuận cho điều khoản dịch vụ của ứng dụng.

Tài nguyên REST: accounts_v1beta.accounts.users

Phương thức
create POST /accounts/v1beta/{parent=accounts/*}/users
Tạo người dùng tài khoản Merchant Center.
delete DELETE /accounts/v1beta/{name=accounts/*/users/*}
Xoá người dùng tài khoản Merchant Center.
get GET /accounts/v1beta/{name=accounts/*/users/*}
Truy xuất người dùng tài khoản Merchant Center.
getEmailPreferences GET /accounts/v1beta/{name=accounts/*/users/*/emailPreferences}
Trả về các lựa chọn ưu tiên về email cho người dùng tài khoản Merchant Center.
list GET /accounts/v1beta/{parent=accounts/*}/users
Liệt kê tất cả người dùng của một tài khoản Merchant Center.
patch PATCH /accounts/v1beta/{user.name=accounts/*/users/*}
Cập nhật người dùng tài khoản Merchant Center.
updateEmailPreferences PATCH /accounts/v1beta/{emailPreferences.name=accounts/*/users/*/emailPreferences}
Cập nhật lựa chọn ưu tiên về email cho người dùng tài khoản Merchant Center.

Tài nguyên REST: accounts_v1beta.termsOfService

Phương thức
accept GET /accounts/v1beta/{name=termsOfService/*}:accept
Chấp nhận TermsOfService.
get GET /accounts/v1beta/{name=termsOfService/*}
Truy xuất TermsOfService liên kết với phiên bản đã cung cấp.
retrieveLatest GET /accounts/v1beta/termsOfService:retrieveLatest
Truy xuất phiên bản mới nhất của TermsOfService cho một kindregion_code nhất định.