Package google.shopping.merchant.accounts.v1beta

Chỉ mục

AccountIssueService

Dịch vụ hỗ trợ API AccountIssueService.

ListAccountIssues

rpc ListAccountIssues(ListAccountIssuesRequest) returns (ListAccountIssuesResponse)

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.

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 bài viết Tổng quan về OAuth 2.0.

AccountTaxService

Quản lý dữ liệu về chế độ cài đặt thuế ở cấp tài khoản.

API này xác định mô hình tài nguyên sau đây:

  • AccountTax
GetAccountTax

rpc GetAccountTax(GetAccountTaxRequest) returns (AccountTax)

Trả về các quy tắc thuế khớp với điều kiện của GetAccountTaxRequest

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 bài viết Tổng quan về OAuth 2.0.
ListAccountTax

rpc ListAccountTax(ListAccountTaxRequest) returns (ListAccountTaxResponse)

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. Phương thức này chỉ có thể được gọi trên tài khoản nhiều khách hàng, nếu không thì phương thức này sẽ trả về 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 bài viết Tổng quan về OAuth 2.0.
UpdateAccountTax

rpc UpdateAccountTax(UpdateAccountTaxRequest) returns (AccountTax)

Cập nhật chế độ cài đặt thuế của tài khoản.

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 bài viết Tổng quan về OAuth 2.0.

AccountsService

Dịch vụ hỗ trợ API Tài khoản.

CreateAndConfigureAccount

rpc CreateAndConfigureAccount(CreateAndConfigureAccountRequest) returns (Account)

Tạo một tài khoản Merchant Center độc lập có cấu hình bổ sung. Thêm người dùng đưa ra yêu cầu làm quản trị viên của tài khoản mớ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 bài viết Tổng quan về OAuth 2.0.
DeleteAccount

rpc DeleteAccount(DeleteAccountRequest) returns (Empty)

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ụ. Khi bạn xoá MCA, tất cả các tài khoản phụ của tài khoản đó sẽ bị xoá. Để thực thi phương thức này, bạn cần có quyền quản trị.

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 bài viết Tổng quan về OAuth 2.0.
GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

Truy xuất một tài khoản từ tài khoản Merchant Center. Sau khi chèn, cập nhật hoặc xoá tài khoản, có thể mất vài phút trước khi các thay đổi có hiệu lực.

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 bài viết Tổng quan về OAuth 2.0.
ListAccounts

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

Liệt kê những 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. Trang này không chỉ liệt kê các tài khoản phụ của một MCA, mà còn tất cả tài khoản mà người dùng gọi có quyền truy cập, bao gồm cả các MCA khác, tài khoản đã liên kết, tài khoản độc lập, v.v.

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 bài viết Tổng quan về OAuth 2.0.
ListSubAccounts

rpc ListSubAccounts(ListSubAccountsRequest) returns (ListSubAccountsResponse)

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ể. Đây là một trình bao bọc tiện lợi cho phương thức ListAccounts mạnh mẽ hơn. Phương thức này sẽ cho ra kết quả tương tự như khi gọi ListsAccounts bằng bộ lọc sau: relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION"))

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 bài viết Tổng quan về OAuth 2.0.
UpdateAccount

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

Cập nhậ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ụ. Để thực thi phương thức này, bạn cần có quyền quản trị.

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 bài viết Tổng quan về OAuth 2.0.

BusinessIdentityService

Dịch vụ hỗ trợ API thông tin nhận dạng doanh nghiệp.

GetBusinessIdentity

rpc GetBusinessIdentity(GetBusinessIdentityRequest) returns (BusinessIdentity)

Truy xuất thông tin nhận dạng doanh nghiệp của một tài khoản.

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 bài viết Tổng quan về OAuth 2.0.
UpdateBusinessIdentity

rpc UpdateBusinessIdentity(UpdateBusinessIdentityRequest) returns (BusinessIdentity)

Cập nhật thông tin nhận dạng doanh nghiệp của một tài khoản. Để thực thi phương thức này, bạn cần có quyền quản trị.

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 bài viết Tổng quan về OAuth 2.0.

BusinessInfoService

Dịch vụ hỗ trợ API thông tin doanh nghiệp.

GetBusinessInfo

rpc GetBusinessInfo(GetBusinessInfoRequest) returns (BusinessInfo)

Truy xuất thông tin doanh nghiệp của tài khoản.

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 bài viết Tổng quan về OAuth 2.0.
UpdateBusinessInfo

rpc UpdateBusinessInfo(UpdateBusinessInfoRequest) returns (BusinessInfo)

Cập nhật thông tin doanh nghiệp của một tài khoản. Để thực thi phương thức này, bạn cần có quyền quản trị.

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 bài viết Tổng quan về OAuth 2.0.

EmailPreferencesService

Dịch vụ hỗ trợ API EmailPreferences.

Dịch vụ này chỉ cho phép truy xuất và cập nhật các lựa chọn ưu tiên về email cho người dùng đã xác thực.

GetEmailPreferences

rpc GetEmailPreferences(GetEmailPreferencesRequest) returns (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.

Sử dụng bí danh name=accounts/*/users/me/emailPreferences để nhận các lựa chọn ưu tiên cho người dùng đã xác thực.

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 bài viết Tổng quan về OAuth 2.0.
UpdateEmailPreferences

rpc UpdateEmailPreferences(UpdateEmailPreferencesRequest) returns (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. Người dùng MCA phải chỉ định tài khoản MCA thay vì tài khoản phụ của MCA.

Các lựa chọn ưu tiên không được chọn rõ ràng trong mặt nạ cập nhật sẽ không được cập nhật.

Việc chỉ định giá trị trạng thái chọn không sử dụng CHƯA ĐƯỢC XÁC NHẬN là không hợp lệ.

Sử dụng bí danh name=accounts/*/users/me/emailPreferences để cập nhật các lựa chọn ưu tiên cho người dùng đã xác thực.

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 bài viết Tổng quan về OAuth 2.0.

HomepageService

Dịch vụ hỗ trợ API cho trang chủ của cửa hàng.

ClaimHomepage

rpc ClaimHomepage(ClaimHomepageRequest) returns (Homepage)

Xác nhận quyền sở hữu trang chủ của cửa hàng. Để thực thi phương thức này, bạn cần có quyền quản trị.

Nếu trang chủ đã được xác nhận quyền sở hữu, thao tác này sẽ kiểm tra lại trạng thái xác minh (trừ phi người bán được miễn xác nhận quyền sở hữu, do đó cũng miễn xác minh) và trả về phản hồi thành công. Nếu quyền sở hữu không còn được xác minh nữa, hệ thống sẽ trả về lỗi nhưng không xoá thông báo xác nhận quyền sở hữu. Trong trường hợp không thành công, hệ thống sẽ trả về thông báo lỗi chính tắc: * PERMISSION_DENIED: người dùng không có các quyền cần thiết đối với tài khoản MC này; * FAILED_PRE vòng: – Tài khoản không phải là tài khoản Merchant Center; – Tài khoản MC không có trang chủ; – xác nhận quyền sở hữu không thành công (trong trường hợp này, thông báo lỗi sẽ chứa thêm thông tin chi tiết).

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 bài viết Tổng quan về OAuth 2.0.
GetHomepage

rpc GetHomepage(GetHomepageRequest) returns (Homepage)

Truy xuất trang chủ của một cửa hàng.

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 bài viết Tổng quan về OAuth 2.0.
UnclaimHomepage

rpc UnclaimHomepage(UnclaimHomepageRequest) returns (Homepage)

Huỷ xác nhận quyền sở hữu đối với trang chủ của cửa hàng. Để thực thi phương thức này, bạn cần có quyền quản trị.

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 bài viết Tổng quan về OAuth 2.0.
UpdateHomepage

rpc UpdateHomepage(UpdateHomepageRequest) returns (Homepage)

Cập nhật trang chủ của cửa hàng. Để thực thi phương thức này, bạn cần có quyền quản trị.

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 bài viết Tổng quan về OAuth 2.0.

OnlineReturnPolicyService

Dịch vụ này hỗ trợ việc quản lý chế độ thiết lập chính sách trả lại hàng do người bán đổi ý, bao gồm chính sách trả lại hàng cho cả quảng cáo và trang thông tin miễn phí

các chương trình. API này xác định mô hình tài nguyên sau đây:

[OnlineReturnPolicy][google.shopping.merchant.accounts.v1.OnlineReturnPolicy]

GetOnlineReturnPolicy

rpc GetOnlineReturnPolicy(GetOnlineReturnPolicyRequest) returns (OnlineReturnPolicy)

Xem chính sách trả lại hàng hiện có.

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 bài viết Tổng quan về OAuth 2.0.
ListOnlineReturnPolicies

rpc ListOnlineReturnPolicies(ListOnlineReturnPoliciesRequest) returns (ListOnlineReturnPoliciesResponse)

Liệt kê tất cả các chính sách trả lại hàng hiện tạ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 bài viết Tổng quan về OAuth 2.0.

ProgramsService

Dịch vụ quản lý chương trình.

Các chương trình cung cấp cơ chế để thêm chức năng vào tài khoản người bán. Một ví dụ điển hình là chương trình Trang thông tin miễn phí về sản phẩm. Chương trình này cho phép giới thiệu miễn phí sản phẩm tại cửa hàng của người bán trên Google.

Dịch vụ này cung cấp các phương thức để truy xuất quyền tham gia của người bán trong tất cả các chương trình hiện có, ngoài các phương thức để cho phép hoặc vô hiệu hoá việc tham gia mỗi chương trình một cách rõ ràng.

DisableProgram

rpc DisableProgram(DisableProgramRequest) returns (Program)

Vô hiệu hóa khả năng tham gia vào chương trình đã chỉ định cho tài khoản. Để thực thi phương thức này, bạn cần có quyền quản trị.

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 bài viết Tổng quan về OAuth 2.0.
EnableProgram

rpc EnableProgram(EnableProgramRequest) returns (Program)

Cho phép tham gia vào chương trình được chỉ định cho tài khoản. Để thực thi phương thức này, bạn cần có quyền quản trị.

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 bài viết Tổng quan về OAuth 2.0.
GetProgram

rpc GetProgram(GetProgramRequest) returns (Program)

Truy xuất chương trình được chỉ định cho tài khoản.

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 bài viết Tổng quan về OAuth 2.0.
ListPrograms

rpc ListPrograms(ListProgramsRequest) returns (ListProgramsResponse)

Truy xuất tất cả chương trình cho tài khoản.

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 bài viết Tổng quan về OAuth 2.0.

RegionsService

Quản lý cấu hình khu vực.

API này xác định mô hình tài nguyên sau đây:

  • Region
CreateRegion

rpc CreateRegion(CreateRegionRequest) returns (Region)

Tạo định nghĩa về khu vực trong tài khoản Merchant Center. Để thực thi phương thức này, bạn cần có quyền quản trị.

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 bài viết Tổng quan về OAuth 2.0.
DeleteRegion

rpc DeleteRegion(DeleteRegionRequest) returns (Empty)

Xoá định nghĩa về khu vực khỏi tài khoản Merchant Center. Để thực thi phương thức này, bạn cần có quyền quản trị.

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 bài viết Tổng quan về OAuth 2.0.
GetRegion

rpc GetRegion(GetRegionRequest) returns (Region)

Truy xuất khu vực được xác định trong tài khoản Merchant Center.

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 bài viết Tổng quan về OAuth 2.0.
ListRegions

rpc ListRegions(ListRegionsRequest) returns (ListRegionsResponse)

Liệt kê các khu vực trong tài khoản Merchant Center của bạn.

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 bài viết Tổng quan về OAuth 2.0.
UpdateRegion

rpc UpdateRegion(UpdateRegionRequest) returns (Region)

Cập nhật định nghĩa về khu vực trong tài khoản Merchant Center. Để thực thi phương thức này, bạn cần có quyền quản trị.

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 bài viết Tổng quan về OAuth 2.0.

ShippingSettingsService

Dịch vụ để lấy thông tin về chế độ cài đặt thông tin vận chuyển của phương thức cho mỗi phương thức Merchant API.

GetShippingSettings

rpc GetShippingSettings(GetShippingSettingsRequest) returns (ShippingSettings)

Truy xuất thông tin về chế độ cài đặt thông tin vận chuyển.

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 bài viết Tổng quan về OAuth 2.0.
InsertShippingSettings

rpc InsertShippingSettings(InsertShippingSettingsRequest) returns (ShippingSettings)

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. Để thực thi phương thức này, bạn cần có quyền quản trị.

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 bài viết Tổng quan về OAuth 2.0.

TermsOfServiceAgreementStateService

Dịch vụ hỗ trợ API TermsOfServiceAgreementState.

GetTermsOfServiceAgreementState

rpc GetTermsOfServiceAgreementState(GetTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

Trả về trạng thái của thoả thuận điều khoản dịch vụ.

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 bài viết Tổng quan về OAuth 2.0.
RetrieveForApplicationTermsOfServiceAgreementState

rpc RetrieveForApplicationTermsOfServiceAgreementState(RetrieveForApplicationTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

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.

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 bài viết Tổng quan về OAuth 2.0.

TermsOfServiceService

Dịch vụ hỗ trợ API TermsOfService.

AcceptTermsOfService

rpc AcceptTermsOfService(AcceptTermsOfServiceRequest) returns (Empty)

Chấp nhận một TermsOfService. Để thực thi phương thức này, bạn cần có quyền quản trị.

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 bài viết Tổng quan về OAuth 2.0.
GetTermsOfService

rpc GetTermsOfService(GetTermsOfServiceRequest) returns (TermsOfService)

Truy xuất TermsOfService liên kết với phiên bản đã cung cấp.

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 bài viết Tổng quan về OAuth 2.0.
RetrieveLatestTermsOfService

rpc RetrieveLatestTermsOfService(RetrieveLatestTermsOfServiceRequest) returns (TermsOfService)

Truy xuất phiên bản mới nhất của TermsOfService cho một kind và region_code 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 bài viết Tổng quan về OAuth 2.0.

UserService

Dịch vụ hỗ trợ API người dùng.

CreateUser

rpc CreateUser(CreateUserRequest) returns (User)

Tạo người dùng tài khoản Merchant Center. Để thực thi phương thức này, bạn cần có quyền quản trị.

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 bài viết Tổng quan về OAuth 2.0.
DeleteUser

rpc DeleteUser(DeleteUserRequest) returns (Empty)

Xoá người dùng tài khoản Merchant Center. Để thực thi phương thức này, bạn cần có quyền quản trị.

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 bài viết Tổng quan về OAuth 2.0.
GetUser

rpc GetUser(GetUserRequest) returns (User)

Truy xuất người dùng tài khoản Merchant Center.

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 bài viết Tổng quan về OAuth 2.0.
ListUsers

rpc ListUsers(ListUsersRequest) returns (ListUsersResponse)

Liệt kê tất cả người dùng của một tài khoản Merchant Center.

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 bài viết Tổng quan về OAuth 2.0.
UpdateUser

rpc UpdateUser(UpdateUserRequest) returns (User)

Cập nhật người dùng tài khoản Merchant Center. Để thực thi phương thức này, bạn cần có quyền quản trị.

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 bài viết Tổng quan về OAuth 2.0.

AcceptTermsOfServiceRequest

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

Trường
name

string

Bắt buộc. Tên tài nguyên của phiên bản điều khoản dịch vụ. Định dạng termsOfService/{version}
account

string

Bắt buộc. Tài khoản chấp nhận Điều khoản dịch vụ.
region_code

string

Bắt buộc. Mã vùng theo xác định của CLDR. Đây có thể là một quốc gia khi Điều khoản dịch vụ được áp dụng riêng cho quốc gia đó hoặc là 001 khi áp dụng trên toàn cầu.

Đã chấp nhận

Mô tả các điều khoản dịch vụ được chấp nhận.

Trường
terms_of_service

string

Trường termsOfService chấp nhận.
accepted_by

string

Tài khoản nơi việc chấp nhận được ghi lại. Đây có thể là chính tài khoản đó hoặc trong trường hợp có tài khoản phụ thì là tài khoản MCA.
valid_until

Date

Khi được đặt, chính sách này sẽ nêu rõ rằng TermsOfService (Điều khoản dịch vụ) được chấp nhận chỉ có hiệu lực cho đến cuối ngày này (theo giờ UTC). Bạn phải chấp nhận một thẻ mới trước thời điểm đó. Bạn có thể tìm thấy thông tin về TermsOfService bắt buộc trong thông báo Bắt buộc.

AccessRight

Quyền truy cập.

Enum
ACCESS_RIGHT_UNSPECIFIED Giá trị mặc định. Giá trị này chưa được sử dụng.
STANDARD Quyền truy cập thông thường.
ADMIN Quyền truy cập của quản trị viên.
PERFORMANCE_REPORTING Những người dùng có quyền này sẽ có quyền xem hiệu suất và thông tin chi tiết.

Tài khoản

Tài khoản.

Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của tài khoản. Định dạng accounts/{account}
account_id

int64

Chỉ có đầu ra. Mã tài khoản.
account_name

string

Bắt buộc. Tên tài khoản dễ đọc. Xem tên cửa hàng và tên doanh nghiệp để biết thêm thông tin.
adult_content

bool

Liệu tài khoản này có chứa nội dung người lớn hay không.
test_account

bool

Chỉ có đầu ra. Liệu đây có phải là tài khoản thử nghiệm hay không.
time_zone

TimeZone

Bắt buộc. Múi giờ của tài khoản.

Khi ghi, time_zone đặt cả reporting_time_zone và display_time_zone.

Đối với lượt đọc, time_zone luôn trả về display_time_zone. Nếu tài khoản của bạn không có display_time_zone, thì time_zone sẽ trống.
language_code

string

Bắt buộc. Mã ngôn ngữ BCP-47 của tài khoản, chẳng hạn như en-US hoặc sr-Latn.

AccountIssue

AccountIssue.

Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của vấn đề về tài khoản. Định dạng accounts/{account}/issues/{id}
title

string

Tiêu đề đã bản địa hoá của vấn đề.
severity

Severity

Mức độ nghiêm trọng tổng thể của vấn đề.
impacted_destinations[]

ImpactedDestination

Ảnh hưởng của vấn đề này đến nhiều trang đích.
detail

string

Thông tin chi tiết đã bản địa hoá thêm về vấn đề.
documentation_uri

string

Đường liên kết đến Trung tâm trợ giúp Merchant Center cung cấp thêm thông tin về vấn đề và cách khắc phục.

ImpactedDestination

Tác động của vấn đề đối với một đích đến.

Trường
impacts[]

Impact

Tác động (tiêu cực) đối với các khu vực đối với điểm đến cụ thể.
reporting_context

ReportingContextEnum

Ngữ cảnh báo cáo bị ảnh hưởng.

Mức độ tác động

Tác động của vấn đề đối với một khu vực.

Trường
region_code

string

Mã vùng CLDR là nơi xảy ra vấn đề này.
severity

Severity

Mức độ nghiêm trọng của vấn đề đối với điểm đến và khu vực.

Mức độ nghiêm trọng

Tất cả mức độ nghiêm trọng có thể xảy ra với vấn đề.

Enum
SEVERITY_UNSPECIFIED Chưa xác định được mức độ nghiêm trọng.
CRITICAL Vấn đề này khiến các mặt hàng không phân phát.
ERROR Vấn đề có thể ảnh hưởng đến các mặt hàng (trong tương lai) hoặc có thể là một chỉ báo về các vấn đề với mặt hàng.
SUGGESTION Vấn đề này là một đề xuất nhằm cải thiện.

AccountTax

Chế độ cài đặt thuế của tài khoản người bán. Tất cả các phương thức đều yêu cầu vai trò quản trị viên.

Trường
name

string

Giá trị nhận dạng. Tên của chế độ cài đặt thuế. Định dạng: "{account_tax.name=accounts/{account}}"
account

int64

Chỉ có đầu ra. Mã tài khoản chứa các chế độ cài đặt về thuế của tài khoản đó.
tax_rules[]

TaxRule

Quy tắc thuế. "Xác định quy tắc thuế trong từng khu vực. Sẽ không có thuế nào được nộp nếu một khu vực không có quy tắc."

Địa chỉ

Địa chỉ giao hàng của kho hàng.

Trường
street_address

string

Một phần cấp đường phố của địa chỉ. Ví dụ: 111w 31st Street.
city

string

Bắt buộc. Thành phố, thị trấn hoặc xã. Cũng có thể bao gồm các địa phương hoặc khu dân cư phụ thuộc (Ví dụ như vùng lân cận hoặc vùng ngoại ô).
administrative_area

string

Bắt buộc. Đơn vị hành chính cấp cao nhất của quốc gia. Ví dụ: một tiểu bang như California ("CA") hoặc một tỉnh như Quebec ("QC").
postal_code

string

Bắt buộc. Mã bưu chính hoặc ZIP (Ví dụ: "94043").
region_code

string

Bắt buộc. Mã quốc gia CLDR (Ví dụ: "US").

BusinessDayConfig

Ngày làm việc của kho hàng.

Trường
business_days[]

Weekday

Bắt buộc. Ngày làm việc thông thường. Không được để trống.

Ngày trong tuần

Enum
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

BusinessIdentity

Thu thập thông tin liên quan đến bản sắc của một doanh nghiệp.

Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của bản sắc doanh nghiệp. Định dạng accounts/{account}/businessIdentity
black_owned

IdentityAttribute

Không bắt buộc. Chỉ định xem doanh nghiệp có tự nhận là do người da đen sở hữu hay không. Trường không bắt buộc này sẽ chỉ dành cho những người bán có quốc gia của doanh nghiệp được đặt thành US. Quy định này cũng không áp dụng cho trang web thương mại hoặc người bán trên trang web thương mại.
women_owned

IdentityAttribute

Không bắt buộc. Cho biết doanh nghiệp đó có tự nhận là do phụ nữ sở hữu hay không. Trường không bắt buộc này sẽ chỉ dành cho những người bán có quốc gia của doanh nghiệp được đặt thành US. Quy định này cũng không áp dụng cho trang web thương mại hoặc người bán trên trang web thương mại.
veteran_owned

IdentityAttribute

Không bắt buộc. Chỉ định xem doanh nghiệp đó có tự nhận là do cựu chiến binh sở hữu hay không. Trường không bắt buộc này sẽ chỉ dành cho những người bán có quốc gia của doanh nghiệp được đặt thành US. Quy định này cũng không áp dụng cho trang web thương mại hoặc người bán trên trang web thương mại.
latino_owned

IdentityAttribute

Không bắt buộc. Chỉ định xem doanh nghiệp có tự nhận là do người Mỹ La-tinh sở hữu hay không. Trường không bắt buộc này sẽ chỉ dành cho những người bán có quốc gia của doanh nghiệp được đặt thành US. Quy định này cũng không áp dụng cho trang web thương mại hoặc người bán trên trang web thương mại.
small_business

IdentityAttribute

Không bắt buộc. Cho biết liệu doanh nghiệp có tự nhận mình là một doanh nghiệp nhỏ hay không. Trường không bắt buộc này sẽ chỉ dành cho những người bán có quốc gia của doanh nghiệp được đặt thành US. Quy tắc này cũng không áp dụng cho trang web thương mại.

IdentityAttribute

Tất cả thông tin liên quan đến thuộc tính nhận diện.

Trường
identity_declaration

IdentityDeclaration

Bắt buộc. Khai báo thông tin nhận dạng cho thuộc tính này.

IdentityDeclaration

Tất cả chế độ cài đặt có thể dùng liên quan đến việc khai báo thông tin nhận dạng.

Enum
IDENTITY_DECLARATION_UNSPECIFIED Giá trị mặc định cho biết không có lựa chọn nào được thực hiện.
SELF_IDENTIFIES_AS Cho biết tài khoản tương ứng với thuộc tính này.
DOES_NOT_SELF_IDENTIFY_AS Cho biết tài khoản không có thuộc tính này.

PromotionsConsent

Tất cả chế độ cài đặt có thể có liên quan đến chương trình khuyến mãi liên quan đến thông tin nhận dạng doanh nghiệp.

Enum

BusinessInfo

Thu thập thông tin liên quan đến một doanh nghiệp.

Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của thông tin doanh nghiệp. Định dạng: accounts/{account}/businessInfo
address

PostalAddress

Không bắt buộc. Địa chỉ của doanh nghiệp.
phone

PhoneNumber

Không bắt buộc. Số điện thoại của doanh nghiệp.
phone_verification_state

PhoneVerificationState

Chỉ có đầu ra. Trạng thái xác minh số điện thoại của doanh nghiệp.
customer_service

CustomerService

Không bắt buộc. Dịch vụ khách hàng của doanh nghiệp.

CarrierRate

Danh sách mức phí của hãng vận chuyển có thể tham khảo bằng main_table hoặc single_value.

Trường
name

string

Bắt buộc. Tên mức phí của hãng vận chuyển. Phải là duy nhất cho mỗi nhóm giá.
carrier

string

Bắt buộc. Dịch vụ của nhà mạng, chẳng hạn như "UPS" hoặc "Fedex".
carrier_service

string

Bắt buộc. Dịch vụ của nhà mạng, chẳng hạn như "ground" hoặc "2 days".
origin_postal_code

string

Bắt buộc. Điểm xuất phát vận chuyển cho mức phí của hãng vận chuyển này.
percentage_adjustment

string

Không bắt buộc. Cấp số nhân của đối tượng sửa đổi mức phí vận chuyển dưới dạng một số trong ký hiệu thập phân. Có thể là giá trị âm. Ví dụ: "5.4" tăng tỷ lệ thêm 5,4%, "-3" sẽ giảm tỷ lệ này xuống 3%.
flat_adjustment

Price

Không bắt buộc. Hệ số điều chỉnh mức phí vận chuyển bổ sung. Có thể là giá trị âm. Ví dụ: { "amount_micros": 1, "currency_code" : "USD" } cộng 1 đô la vào mức giá, { "amount_micros": -3, "currency_code" : "USD" } sẽ xoá 3 đô la khỏi mức giá.

ClaimHomepageRequest

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

Trường
name

string

Bắt buộc. Tên của trang chủ để xác nhận quyền sở hữu. Định dạng accounts/{account}/homepage

CreateAndConfigureAccountRequest

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

Trường
account

Account

Bắt buộc. Tài khoản cần tạo.
users[]

CreateUserRequest

Không bắt buộc. Người dùng cần thêm vào tài khoản.
service[]

AddAccountService

Không bắt buộc. Nếu được chỉ định, một dịch vụ tài khoản giữa tài khoản được tạo và tài khoản nhà cung cấp sẽ được khởi chạy trong quá trình tạo.
accept_terms_of_service

AcceptTermsOfService

Không bắt buộc. Điều khoản dịch vụ (ToS) cần được chấp nhận ngay khi tạo tài khoản.

AcceptTermsOfService

Tham chiếu đến tài nguyên trong Điều khoản dịch vụ.

Trường
name

string

Bắt buộc. Tên tài nguyên của phiên bản điều khoản dịch vụ.
region_code

string

Bắt buộc. Mã vùng theo xác định của CLDR. Đây có thể là một quốc gia khi Điều khoản dịch vụ được áp dụng riêng cho quốc gia đó hoặc là 001 nếu áp dụng trên toàn cầu.

AddAccountService

Hướng dẫn bổ sung để thêm các dịch vụ tài khoản trong quá trình tạo tài khoản.

Trường
Trường kết hợp service_type. Hiện tại, chúng tôi chỉ hỗ trợ loại tài khoản mẹ nhiều khách hàng. service_type chỉ có thể là một trong những trạng thái sau đây:
account_aggregation

Empty

Nhà cung cấp là trang web tổng hợp cho tài khoản.
provider

string

Không bắt buộc. Nhà cung cấp dịch vụ. Định dạng accounts/{account}

CreateRegionRequest

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

Trường
parent

string

Bắt buộc. Tài khoản để tạo khu vực. Định dạng accounts/{account}
region_id

string

Bắt buộc. Giá trị nhận dạng của khu vực, duy nhất trên tất cả các khu vực của cùng một tài khoản.
region

Region

Bắt buộc. Khu vực cần tạo.

CreateUserRequest

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

Trường
parent

string

Bắt buộc. Tên tài nguyên của tài khoản mà người dùng sẽ được tạo. Định dạng accounts/{account}
user_id

string

Bắt buộc. Địa chỉ email của người dùng (ví dụ: john.doe@gmail.com).
user

User

Bắt buộc. Người dùng cần tạo.

CustomerService

Thông tin về dịch vụ khách hàng.

Trường
uri

string

Không bắt buộc. URI nơi dịch vụ khách hàng có thể tìm thấy.
email

string

Không bắt buộc. Địa chỉ email để liên hệ với bộ phận dịch vụ khách hàng.
phone

PhoneNumber

Không bắt buộc. Số điện thoại để gọi cho dịch vụ khách hàng.

CutoffTime

Định nghĩa hạn chót nhận đơn hàng của ngày làm việc.

Trường
hour

int32

Bắt buộc. Giờ hạn chót nhận đơn hàng mà khách hàng phải đặt để xử lý trong cùng ngày.
minute

int32

Bắt buộc. Phút của hạn chót nhận đơn đặt hàng mà khách hàng phải đặt hàng để được xử lý trong cùng ngày.
time_zone

string

Bắt buộc. Giá trị nhận dạng múi giờ Ví dụ: "Châu Âu/Zurich".

DeleteAccountRequest

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

Trường
name

string

Bắt buộc. Tên của tài khoản cần xoá. Định dạng accounts/{account}

DeleteRegionRequest

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

Trường
name

string

Bắt buộc. Tên của khu vực cần xoá. Định dạng accounts/{account}/regions/{region}

DeleteUserRequest

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

Trường
name

string

Bắt buộc. Tên của người dùng cần xoá. Định dạng accounts/{account}/users/{email}

Bạn cũng có thể xoá người dùng tương ứng với phương thức gọi bằng cách sử dụng me thay vì địa chỉ email như trong accounts/{account}/users/me.

DeliveryTime

Thời gian bỏ ra cho các khía cạnh khác nhau từ lúc đặt hàng đến khi giao sản phẩm.

Trường
warehouse_based_delivery_times[]

WarehouseBasedDeliveryTime

Không bắt buộc. Cho biết thời gian giao hàng phải được tính theo từng kho hàng (vị trí nguồn gốc vận chuyển) dựa trên chế độ cài đặt của hãng vận chuyển đã chọn. Khi đặt chính sách này, bạn không được đặt trường nào khác liên quan đến thời gian vận chuyển trong [thời gian giao hàng][[google.shopping.content.bundles.Shippingsetting.deliveryTime].
min_transit_days

int32

Số ngày làm việc tối thiểu để vận chuyển. 0 có nghĩa là giao hàng trong cùng ngày, 1 có nghĩa là giao hàng vào ngày tiếp theo. Bạn phải đặt min_transit_days, max_transit_days hoặc transit_time_table, nhưng không được đặt cả hai.
max_transit_days

int32

Số ngày làm việc tối đa được dành cho quá trình vận chuyển. 0 có nghĩa là giao hàng trong cùng ngày, 1 có nghĩa là giao hàng vào ngày tiếp theo. Phải lớn hơn hoặc bằng min_transit_days.
cutoff_time

CutoffTime

Định nghĩa hạn chót nhận đơn hàng của ngày làm việc. Nếu bạn không thiết lập, hạn chót nhận đơn hàng sẽ được đặt mặc định là 8 giờ sáng theo giờ PST.
min_handling_days

int32

Số ngày làm việc tối thiểu phải bỏ ra trước khi đơn đặt hàng được vận chuyển. 0 có nghĩa là vận chuyển trong cùng ngày, 1 có nghĩa là ngày vận chuyển tiếp theo.
max_handling_days

int32

Số ngày làm việc tối đa đã bỏ ra trước khi đơn đặt hàng được vận chuyển. 0 có nghĩa là vận chuyển trong cùng ngày, 1 có nghĩa là ngày vận chuyển tiếp theo. Phải lớn hơn hoặc bằng min_handling_days.
transit_time_table

TransitTable

Bảng thời gian vận chuyển, số ngày làm việc đã vận chuyển dựa trên kích thước hàng và cột. Bạn có thể đặt min_transit_days, max_transit_days hoặc transit_time_table, nhưng không thể đặt cả hai.
handling_business_day_config

BusinessDayConfig

Những ngày làm việc mà đơn đặt hàng có thể được xử lý. Nếu bạn không cung cấp thông tin này, thì ngày làm việc từ thứ Hai đến thứ Sáu sẽ được giả định.
transit_business_day_config

BusinessDayConfig

Ngày làm việc mà đơn đặt hàng có thể được vận chuyển. Nếu bạn không cung cấp thông tin này, thì ngày làm việc từ thứ Hai đến thứ Sáu sẽ được giả định.

DisableProgramRequest

Yêu cầu thông báo cho phương thức DisableProgram.

Trường
name

string

Bắt buộc. Tên của chương trình vô hiệu hoá quyền tham gia đối với một tài khoản cụ thể. Định dạng accounts/{account}/programs/{program}

Khoảng cách

Bán kính giao hàng tối đa. Thuộc tính này chỉ bắt buộc đối với loại hình vận chuyển giao hàng tại địa phương.

Trường
value

int64

Giá trị số nguyên của khoảng cách.
unit

Unit

Đơn vị có thể khác nhau tuỳ theo quốc gia, đơn vị được tham số để bao gồm dặm và km.

Đơn vị

Đơn vị có thể khác nhau tuỳ theo quốc gia, đơn vị được tham số để bao gồm dặm và km.

Enum
UNIT_UNSPECIFIED Chưa chỉ định đơn vị
MILES Đơn vị tính bằng dặm
KILOMETERS Đơn vị tính bằng kilômét

EmailPreferences

Các loại thông báo mà người dùng đã chọn nhận / không nhận. Lựa chọn ưu tiên về email không bao gồm các thông báo bắt buộc vì người dùng không thể chọn không nhận.

Trường
name

string

Giá trị nhận dạng. Tên của EmailPreferences. Chỉ người dùng đã xác thực mới có thể dùng điểm cuối.
news_and_tips

OptInState

Không bắt buộc. Thông tin cập nhật về các tính năng mới, mẹo và các phương pháp hay nhất.

OptInState

Chọn sử dụng trạng thái của lựa chọn ưu tiên về email.

Enum
OPT_IN_STATE_UNSPECIFIED Chưa chỉ định trạng thái chọn sử dụng.
OPTED_OUT Người dùng đã chọn không nhận loại email này.
OPTED_IN Người dùng đã chọn nhận loại email này.
UNCONFIRMED Người dùng đã chọn nhận loại email này và email xác nhận đã được gửi, nhưng người dùng chưa xác nhận việc chọn sử dụng (chỉ áp dụng cho một số quốc gia nhất định).

EnableProgramRequest

Thông báo yêu cầu đối với phương thức EnabledProgram.

Trường
name

string

Bắt buộc. Tên của chương trình mà tài khoản cụ thể cho phép tham gia. Định dạng accounts/{account}/programs/{program}

GetAccountRequest

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

Trường
name

string

Bắt buộc. Tên tài khoản cần truy xuất. Định dạng accounts/{account}

GetAccountTaxRequest

Yêu cầu tải chế độ cài đặt thuế

Trường
name

string

Bắt buộc. Tên mà từ đó hệ thống sẽ truy xuất chế độ cài đặt thuế

GetBusinessIdentityRequest

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

Trường
name

string

Bắt buộc. Tên tài nguyên của bản sắc doanh nghiệp. Định dạng accounts/{account}/businessIdentity

GetBusinessInfoRequest

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

Trường
name

string

Bắt buộc. Tên tài nguyên của thông tin doanh nghiệp. Định dạng: accounts/{account}/businessInfo

GetEmailPreferencesRequest

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

Trường
name

string

Bắt buộc. Tên của tài nguyên EmailPreferences. Định dạng: accounts/{account}/users/{email}/emailPreferences

GetHomepageRequest

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

Trường
name

string

Bắt buộc. Tên của trang chủ cần truy xuất. Định dạng accounts/{account}/homepage

GetOnlineReturnPolicyRequest

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

Trường
name

string

Bắt buộc. Tên chính sách trả lại hàng cần truy xuất. Định dạng accounts/{account}/onlineReturnPolicies/{return_policy}

GetProgramRequest

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

Trường
name

string

Bắt buộc. Tên chương trình cần truy xuất. Định dạng accounts/{account}/programs/{program}

GetRegionRequest

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

Trường
name

string

Bắt buộc. Tên khu vực cần truy xuất. Định dạng accounts/{account}/regions/{region}

GetShippingSettingsRequest

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

Trường
name

string

Bắt buộc. Tên của chế độ cài đặt thông tin vận chuyển cần truy xuất. Định dạng accounts/{account}/shippingsetting

GetTermsOfServiceAgreementStateRequest

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

Trường
name

string

Bắt buộc. Tên tài nguyên của phiên bản điều khoản dịch vụ. Định dạng accounts/{account}/termsOfServiceAgreementState/{identifier}

GetTermsOfServiceRequest

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

Trường
name

string

Bắt buộc. Tên tài nguyên của phiên bản điều khoản dịch vụ. Định dạng termsOfService/{version}

GetUserRequest

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

Trường
name

string

Bắt buộc. Tên người dùng cần truy xuất. Định dạng accounts/{account}/users/{email}

Bạn cũng có thể truy xuất người dùng tương ứng với phương thức gọi bằng cách sử dụng me thay vì địa chỉ email như trong accounts/{account}/users/me.

Tiêu đề

Danh sách (không trống) bao gồm các tiêu đề của hàng hoặc cột của một bảng. Bạn phải đặt chính xác một trong các giá trị prices, weights, num_items, postal_code_group_names hoặc location.

Trường
prices[]

Price

Bắt buộc. Danh sách các giới hạn trên của giá đơn đặt hàng được bao gồm. Giá trị của mức giá cuối cùng có thể là vô hạn bằng cách đặt giá trị amount_micros = -1. Ví dụ: [{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}] cho các tiêu đề "<= $10", "<= $500" và "> $500". Tất cả giá trong một dịch vụ phải có cùng đơn vị tiền tệ. Không được để trống. Phải là số dương ngoại trừ -1. Chỉ có thể đặt nếu chưa đặt tất cả các trường khác.
weights[]

Weight

Bắt buộc. Danh sách các giới hạn trên đối với trọng số đơn đặt hàng. Giá trị của trọng số cuối cùng có thể là vô hạn bằng cách đặt giá trị amount_micros = -1. Ví dụ: [{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}] cho các tiêu đề "<= 10kg", "<= 50kg" và "> 50kg". Tất cả trọng số trong một dịch vụ phải có cùng đơn vị. Không được để trống. Phải là số dương ngoại trừ -1. Chỉ có thể đặt nếu chưa đặt tất cả các trường khác.
number_of_items[]

string

Bắt buộc. Danh sách bao gồm số lượng mục giới hạn trên. Giá trị cuối cùng có thể là "infinity". Ví dụ: ["10", "50", "infinity"] cho các tiêu đề "<= 10 mục", "<= 50 mục" và "> 50 mục". Không được để trống. Chỉ có thể đặt nếu chưa đặt tất cả các trường khác.
postal_code_group_names[]

string

Bắt buộc. Danh sách tên nhóm bưu chính. Giá trị cuối cùng có thể là "all other locations". Ví dụ: ["zone 1", "zone 2", "all other locations"]. Các nhóm mã bưu chính được giới thiệu phải khớp với quốc gia giao hàng của dịch vụ. Không được để trống. Chỉ có thể đặt nếu chưa đặt tất cả các trường khác.
locations[]

LocationIdSet

Bắt buộc. Danh sách các nhóm mã vị trí. Không được để trống. Chỉ có thể đặt nếu chưa đặt tất cả các trường khác.

Trang chủ

Trang chủ của một cửa hàng.

Trường
name

string

Giá trị nhận dạng. Tên tài nguyên trên trang chủ của cửa hàng. Định dạng accounts/{account}/homepage
claimed

bool

Chỉ có đầu ra. Liệu trang chủ có được xác nhận quyền sở hữu hay không. Xem https://support.google.com/merchants/answer/176793.
uri

string

Bắt buộc. URI (thường là một URL) của trang chủ cửa hàng.

InsertShippingSettingsRequest

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

Trường
parent

string

Bắt buộc. Tài khoản mà bạn sẽ chèn sản phẩm này. Định dạng: accounts/{account}
shipping_setting

ShippingSettings

Bắt buộc. Phiên bản mới của tài khoản.

ListAccountIssuesRequest

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

Trường
parent

string

Bắt buộc. Nhà xuất bản mẹ sở hữu tập hợp các vấn đề này. Định dạng accounts/{account}
page_size

int32

Không bắt buộc. Số lượng vấn đề tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không chỉ định, sẽ có tối đa 50 người dùng được trả về. Giá trị lớn nhất là 100; những giá trị lớn hơn 100 sẽ bị buộc thành 100
page_token

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi ListAccountIssues trước đó. Cung cấp mã này để 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 ListAccountIssues phải khớp với lệnh gọi đã cung cấp mã thông báo trang.
language_code

string

Không bắt buộc. Các vấn đề trong phản hồi sẽ có các trường mà con người có thể đọc được trong ngôn ngữ đã cho. Định dạng là BCP-47, chẳng hạn như en-US hoặc sr-Latn. Nếu bạn không cung cấp giá trị, en-US sẽ được sử dụng.
time_zone

TimeZone

Không bắt buộc. Múi giờ IANA dùng để bản địa hoá thời gian trong các trường mà con người có thể đọc được. Ví dụ: "America/Los_Angeles". Nếu bạn không đặt chính sách này, thì "America/Los_Angeles" sẽ được sử dụng.

ListAccountIssuesResponse

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

Trường
account_issues[]

AccountIssue

Các vấn đề của 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 page_token để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua thì sẽ không có trang tiếp theo.

ListAccountTaxRequest

Chỉ yêu cầu liệt kê tất cả chế độ cài đặt thuế trong tài khoản phụ cho người bán đưa ra yêu cầu. Phương thức này chỉ có thể được gọi trên tài khoản nhiều khách hàng. Nếu không, phương thức này sẽ trả về lỗi.

Trường
parent

string

Bắt buộc. Nhà xuất bản mẹ sở hữu khoản thuế tài khoản này. Định dạng: accounts/{account}
page_size

int32

Số lượng chế độ cài đặt thuế tối đa cần trả về trong phản hồi, dùng để phân trang.
page_token

string

Mã thông báo do yêu cầu trước đó trả về.

ListAccountTaxResponse

Phản hồi yêu cầu về danh sách thuế trong tài khoản Phương thức này chỉ có thể được gọi trên tài khoản nhiều khách hàng. Nếu không, phương thức này sẽ trả về lỗi.

Trường
account_taxes[]

AccountTax

Trang cài đặt thuế tài khoản
next_page_token

string

Mã thông báo để truy xuất trang tiếp theo của chế độ cài đặt thuế trong tài khoản.

ListAccountsRequest

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

Trường
page_size

int32

Không bắt buộc. Số lượng tài khoản tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không xác định, hệ thống sẽ trả về tối đa 250 tài khoản. Giá trị lớn nhất là 500; các giá trị lớn hơn 500 sẽ bị buộc thành 500.
page_token

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi ListAccounts trước đó. Cung cấp mã này để 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 ListAccounts phải khớp với lệnh gọi đã cung cấp mã thông báo trang.
filter

string

Không bắt buộc. Một bộ lọc không bắt buộc để chỉ trả về các tài khoản khớp với bộ lọc.

Dưới đây là một số ví dụ về bộ lọc hợp lệ:

  • accountName = "*store*" AND relationship(providerId = 123)
  • relationship(providerId = 123 AND service(type = "ACCOUNT_AGGREGATION"))
  • (accountName = "storeA") OR (accountName = "storeB")
  • relationship(service( handshakeState = "APPROVED" AND type = "ACCOUNT_MANAGEMENT"))
  • relationship(callerHasAccessToProvider() AND externalAccountId = "extAcctId" AND accountIdAlias = "alias")
  • (relationship(service(type = "ACCOUNT_MANAGEMENT") AND service(handshakeState = "PENDING"))) OR (accountName = "store" AND relationship(...))

Các bộ lọc ở cấp tài khoản có ngữ nghĩa sau:

  • accountName Trường này đề cập đến trường accountName của tài khoản.
  • relationship(...) Đây là mối quan hệ giữa tài khoản và một tài khoản khác. Trong hàm này, bạn có thể chỉ định thêm mối quan hệ này.

Các bộ lọc về cấp độ mối quan hệ có ngữ nghĩa sau:

  • providerId Đây là mã số của tài khoản là thành viên khác của mối quan hệ. Ví dụ: nếu bộ lọc phải giới hạn ở các tài khoản có mối quan hệ với tài khoản accounts/name/123 thì providerId sẽ được lọc là providerId = 123.
  • callerHasAccessToProvider() Điều này sẽ hạn chế tài khoản tạo ra thành các tài khoản có mối quan hệ với một tài khoản khác, trong đó người dùng gọi cũng có quyền truy cập vào thành viên khác của mối quan hệ (hoặc nhà cung cấp).
  • externalAccountId Mã này đề cập đến mã tài khoản bên ngoài được định cấu hình cho mối quan hệ.
  • accountIdAlias Đây là email đại diện của mã tài khoản được định cấu hình cho mối quan hệ.
  • service(...) Mục này đề cập đến một dịch vụ được cung cấp trong mối quan hệ. Lưu ý: Mối quan hệ giữa hai tài khoản có thể bao gồm nhiều dịch vụ.

Các bộ lọc ở cấp dịch vụ có ngữ nghĩa sau:

  • handshakeState Mục này đề cập đến trạng thái bắt tay của dịch vụ. Trong quá trình thiết lập một dịch vụ, đôi khi, trước tiên, dịch vụ cần phải được sự chấp thuận của các thành viên khác hoặc cả hai thành viên của mối quan hệ. Do đó, một dịch vụ có thể ở trạng thái PENDING hoặc APPROVED.
  • type Mục này cho biết loại dịch vụ. Các giá trị có thể sử dụng là:
    • ACCOUNT_MANAGEMENT Nhà cung cấp quản lý tài khoản.
    • ACCOUNT_AGGREGATION Nhà cung cấp là trang web tổng hợp của tài khoản.

Bộ lọc này tuân theo một phần nhỏ thông số kỹ thuật của bộ lọc AIP và ngữ pháp EBNF chính thức. Ngữ pháp cho bộ lọc này hạn chế và cụ thể hơn

filter
    : accountFilterDisj
    | accountFilterConj
    ;
accountFilterDisj
    : "(" accountFilterConj " OR " accountFilterConj ")"
    ;
accountFilterConj
    : accountFilter {" AND " accountFilter}
    ;
accountFilter
    : accountNameFilter | relationshipFn
    ;
accountNameFilter
    : "accountName" comparator value
    ;
relationshipFn
    : "relationship(" relationshipConj ")"
    ;
relationshipConj
    : relationshipFilter {" AND " relationshipFilter}
    ;
relationshipFilter
    : "providerId = " numValue
    | "callerHasAccessToProvider()"
    | "externalAccountId" comparator value
    | "accountIdAlias" comparator value
    | serviceFn
    ;
serviceFn
    : "service(" serviceConj ")"
    ;
serviceConj
    : serviceFilter {" AND " serviceFilter}
    ;
serviceFilter
    : handshakeStateFilter
    | typeFilter
    ;
handshakeStateFilter
    : "handshakeState = " value
    ;
typeFilter
    : "type = " value
    ;
comparator
    : " = " | " != "
    ;

Ngoài ra, các điều kiện sau đây áp dụng:

  • Mỗi trường liên kết có thể chỉ xuất hiện một lần (ví dụ: bạn chỉ có thể lọc trên accountName một lần ở cấp tài khoản hoặc chỉ có thể lọc cho providerId một lần ở mỗi cấp mối quan hệ).
  • Đối với các trường chuỗi (chẳng hạn như accountName hoặc accountIdAlias), bạn có thể biểu thị toán tử CONTAINS bằng cách đưa truy vấn vào *. Ví dụ: accountName = "*foo*" sẽ trả về mọi tài khoản có accountName chứa foo. Bạn có thể biểu thị toán tử NOT_CONTAINS theo cách trực giao bằng !=. Ví dụ: accountName != "*foo*" sẽ trả về tất cả tài khoản có accountName không chứa foo. Lưu ý: Bạn có thể tìm các tài khoản có accountName chứa ký tự dấu sao * bằng cách sử dụng ***.
  • Các khoảng trắng bổ sung sẽ bị bỏ qua.
  • Bạn phải đặt tất cả các giá trị trong dấu ngoặc kép (ngoại trừ các giá trị chỉ là số).
  • Nếu sử dụng dấu phân tách, liên từ ở mỗi bên phải sử dụng dấu ngoặc đơn ngay cả khi liên từ đó chỉ có một biểu thức duy nhất. Không được phép sử dụng dấu ngoặc đơn ở bất kỳ nơi nào khác ngoại trừ lệnh gọi hàm (chẳng hạn như relationship hoặc service). Điều này nhằm thể hiện rõ rằng liên từ liên kết mạnh hơn so với phân tách về mặt logic.

ListAccountsResponse

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

Trường
accounts[]

Account

Các tài khoản khớp với ListAccountsRequest.
next_page_token

string

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

ListOnlineReturnPoliciesRequest

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

Trường
parent

string

Bắt buộc. Tài khoản người bán đăng chính sách trả lại hàng. Định dạng accounts/{account}
page_size

int32

Không bắt buộc. Số lượng tài nguyên OnlineReturnPolicy tối đa cần trả về. Dịch vụ sẽ trả về ít hơn giá trị này nếu số lượng chính sách trả lại hàng của người bán cụ thể ít hơn pageSize. Giá trị mặc định là 10. Giá trị tối đa là 100; Nếu một giá trị cao hơn giá trị tối đa được chỉ định thì pageSize sẽ được mặc định là giá trị tối đa
page_token

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi ListOnlineReturnPolicies 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 ListOnlineReturnPolicies 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 đó.

ListOnlineReturnPoliciesResponse

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

Trường
online_return_policies[]

OnlineReturnPolicy

Chính sách trả lại hàng đã truy xuất.
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 trường này bị bỏ qua thì sẽ không có trang tiếp theo.

ListProgramsRequest

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

Trường
parent

string

Bắt buộc. Tên của tài khoản để truy xuất tất cả chương trình. Định dạng accounts/{account}
page_size

int32

Không bắt buộc. Số chương trình tối đa được trả về trong một phản hồi. Nếu bạn không chỉ định (hoặc 0), thì giá trị mặc định sẽ là 1000. Giá trị lớn nhất là 1000; các giá trị lớn hơn 1000 sẽ bị buộc thành 1000.
page_token

string

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

ListProgramsResponse

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

Trường
programs[]

Program

Các chương trình dành cho một tài khoản cụ thể.
next_page_token

string

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

ListRegionsRequest

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

Trường
parent

string

Bắt buộc. Tài khoản để liệt kê các khu vực. Định dạng accounts/{account}
page_size

int32

Không bắt buộc. Số lượng khu vực tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không chỉ định, hệ thống sẽ trả về tối đa 50 khu vực. Giá trị lớn nhất là 1000; các giá trị lớn hơn 1000 sẽ bị buộc thành 1000.
page_token

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi ListRegions trước đó. Cung cấp mã này để 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 ListRegions phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

ListRegionsResponse

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

Trường
regions[]

Region

Các khu vực của người bán đã chỉ định.
next_page_token

string

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

ListSubAccountsRequest

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

Trường
provider

string

Bắt buộc. Tài khoản của cha mẹ. Định dạng accounts/{account}
page_size

int32

Không bắt buộc. Số lượng tài khoản tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không xác định, hệ thống sẽ trả về tối đa 250 tài khoản. Giá trị lớn nhất là 500; các giá trị lớn hơn 500 sẽ bị buộc thành 500.
page_token

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi ListAccounts trước đó. Cung cấp mã này để 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 ListAccounts phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

ListSubAccountsResponse

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

Trường
accounts[]

Account

Những tài khoản mà tài khoản mẹ được chỉ định là đơn vị tập hợp.
next_page_token

string

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

ListUsersRequest

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

Trường
parent

string

Bắt buộc. Nhà xuất bản mẹ sở hữu tập hợp người dùng này. Định dạng: "accounts/{account}
page_size

int32

Không bắt buộc. Số người dùng tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không chỉ định, sẽ có tối đa 50 người dùng được trả về. Giá trị lớn nhất là 100; những giá trị lớn hơn 100 sẽ bị buộc thành 100
page_token

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi ListUsers trước đó. Cung cấp mã này để 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 ListUsers phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

ListUsersResponse

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

Trường
users[]

User

Người dùng trong 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 page_token để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua thì sẽ không có trang tiếp theo.

LocationIdSet

Danh sách các nhóm mã vị trí. Không được để trống. Chỉ có thể đặt nếu chưa đặt tất cả các trường khác.

Trường
location_ids[]

string

Bắt buộc. Một danh sách mã vị trí không trống. Tất cả các vị trí này phải thuộc cùng một loại vị trí (Ví dụ: tiểu bang).

MinimumOrderValueTable

Bảng giá trị đơn đặt hàng tối thiểu mỗi cửa hàng đối với cách thực hiện đơn hàng để đến lấy hàng.

Trường
store_code_set_with_movs[]

StoreCodeSetWithMov

Bắt buộc. Danh sách các bộ mã cửa hàng có cùng giá trị đơn đặt hàng tối thiểu (MOV). Cần có ít nhất hai tập hợp và tập cuối cùng phải để trống, biểu thị "MOV cho tất cả các cửa hàng khác". Mỗi mã cửa hàng chỉ có thể xuất hiện một lần trong tất cả các tập hợp. Tất cả giá trong một dịch vụ phải có cùng đơn vị tiền tệ.

StoreCodeSetWithMov

Danh sách các bộ mã cửa hàng có cùng giá trị đơn đặt hàng tối thiểu. Cần có ít nhất hai tập hợp và tập cuối cùng phải để trống, biểu thị "MOV cho tất cả các cửa hàng khác". Mỗi mã cửa hàng chỉ có thể xuất hiện một lần trong tất cả các tập hợp. Tất cả giá trong một dịch vụ phải có cùng đơn vị tiền tệ.

Trường
store_codes[]

string

Không bắt buộc. Danh sách các mã cửa hàng duy nhất hoặc để trống để nhận tất cả.
value

Price

Giá trị đặt hàng tối thiểu cho các cửa hàng nhất định.

OnlineReturnPolicy

Đối tượng Chính sách trả lại hàng trực tuyến. Thông tin này hiện được dùng để trình bày chính sách trả lại hàng cho các chương trình quảng cáo và trang thông tin miễn phí.

Trường
name

string

Giá trị nhận dạng. Tên của tài nguyên OnlineReturnPolicy. Định dạng: accounts/{account}/onlineReturnPolicies/{return_policy}
return_policy_id

string

Chỉ có đầu ra. Mã chính sách trả lại hàng do Google tạo.
label

string

Trường này thể hiện nhãn riêng biệt do người dùng xác định của chính sách trả lại hàng. Điều quan trọng cần lưu ý là bạn không thể sử dụng cùng một nhãn trong các chính sách trả lại hàng khác nhau cho cùng một quốc gia. Trừ phi sản phẩm chỉ định một thuộc tính nhãn cụ thể, các chính sách sẽ tự động được gắn nhãn là "mặc định". Để chỉ định chính sách trả lại hàng tuỳ chỉnh cho một số nhóm sản phẩm, hãy làm theo hướng dẫn trong nhãn Chính sách trả lại hàng. Nhãn có thể chứa tối đa 50 ký tự.
countries[]

string

Các quốc gia bán áp dụng chính sách trả lại hàng. Các giá trị phải là mã ISO 3166 hợp lệ gồm 2 chữ cái.
policy

Policy

Chính sách trả lại hàng.
restocking_fee

RestockingFee

Phí nhập lại hàng áp dụng cho tất cả các danh mục lý do trả lại hàng. Đây sẽ được coi là phí nhập lại hàng miễn phí nếu bạn chưa đặt giá trị này.
return_methods[]

ReturnMethod

Các phương thức trả lại hàng, thể hiện cách khách hàng có thể trả lại hàng. Giá trị này không được để trống trừ phi loại chính sách trả lại hàng là noReturns.
item_conditions[]

ItemCondition

Bạn không được để trống các điều kiện về mặt hàng được chấp nhận để trả lại hàng, trừ trường hợp loại chính sách trả lại hàng là "noReturns".
return_shipping_fee

ReturnShippingFee

Phí vận chuyển hàng trả lại. Bạn chỉ nên đặt khi khách hàng cần tải xuống và in nhãn trả lại hàng.
return_policy_uri

string

URI chính sách trả lại hàng. Google có thể sử dụng thông tin này để kiểm tra tính hợp lý của chính sách này. Đó phải là một URL hợp lệ.
accept_defective_only

bool

Trường này chỉ định liệu người bán chỉ chấp nhận sản phẩm lỗi khi trả lại hàng hay không và đây là trường bắt buộc.
process_refund_days

int32

Trường này chỉ định số ngày để người bán xử lý khoản tiền hoàn lại, trường này không bắt buộc.
accept_exchange

bool

Trường này chỉ định xem người bán có cho phép khách hàng trao đổi sản phẩm hay không. Đây là trường bắt buộc.

ItemCondition

Các điều kiện hiện có về mặt hàng.

Enum
ITEM_CONDITION_UNSPECIFIED Giá trị mặc định. Giá trị này chưa được sử dụng.
NEW Mới.
USED Đã qua sử dụng.

Policy

Các chính sách hiện có.

Trường
type

Type

Loại chính sách.
days

int64

Số ngày có thể trả lại mặt hàng sau khi giao hàng, trong đó một ngày được định nghĩa là 24 giờ sau dấu thời gian giao hàng. Bắt buộc đối với trường hợp trả lại hàng NUMBER_OF_DAYS_AFTER_DELIVERY.

Loại

Các loại chính sách trả lại hàng.

Enum
TYPE_UNSPECIFIED Giá trị mặc định. Giá trị này chưa được sử dụng.
NUMBER_OF_DAYS_AFTER_DELIVERY Số ngày mà hàng trả lại có hiệu lực sau khi giao hàng.
NO_RETURNS Không hỗ trợ trả lại hàng.
LIFETIME_RETURNS Vòng đời quay trở lại.

RestockingFee

Phí nhập lại hàng. Đây có thể là một khoản phí cố định hoặc một tỷ lệ phần trăm nhỏ.

Trường

Trường kết hợp type.

type chỉ có thể là một trong những trạng thái sau đây:
fixed_fee

Price

Phí nhập lại hàng cố định.
micro_percent

int32

Phần trăm tổng giá tính theo phần triệu. 15.000.000 đồng nghĩa là 15% của tổng giá trị hóa đơn.

ReturnMethod

Các phương thức trả về có thể sử dụng.

Enum
RETURN_METHOD_UNSPECIFIED Giá trị mặc định. Giá trị này chưa được sử dụng.
BY_MAIL Trả lại qua đường bưu điện.
IN_STORE Trả lại hàng tại cửa hàng.
AT_A_KIOSK Quay lại tại quầy.

ReturnShippingFee

Phí vận chuyển hàng trả lại. Đây có thể là một khoản phí cố định hoặc giá trị boolean cho biết khách hàng phải trả phí vận chuyển thực tế.

Trường
type

Type

Loại phí vận chuyển hàng trả lại.
fixed_fee

Price

Số tiền phí vận chuyển trả lại hàng cố định. Giá trị này chỉ áp dụng khi kiểu là FIXED. Chúng tôi sẽ coi phí vận chuyển hàng trả lại là miễn phí nếu loại là FIXED và bạn chưa đặt giá trị này.

Loại

Các loại phí vận chuyển trả lại hàng.

Enum
TYPE_UNSPECIFIED Giá trị mặc định. Giá trị này chưa được sử dụng.
FIXED Phí vận chuyển trả lại hàng là một giá trị cố định.
CUSTOMER_PAYING_ACTUAL_FEE Khách hàng sẽ trả phí vận chuyển hàng trả lại thực tế.

PhoneVerificationState

Trạng thái xác minh số điện thoại.

Enum
PHONE_VERIFICATION_STATE_UNSPECIFIED Giá trị mặc định. Giá trị này chưa được sử dụng.
PHONE_VERIFICATION_STATE_VERIFIED Điện thoại này đã được xác minh.
PHONE_VERIFICATION_STATE_UNVERIFIED Điện thoại này chưa được xác minh

Chương trình

Xác định việc tham gia một chương trình nhất định cho tài khoản được chỉ định.

Các chương trình cung cấp cơ chế để thêm chức năng vào tài khoản người bán. Một ví dụ điển hình là chương trình Trang thông tin miễn phí về sản phẩm. Chương trình này cho phép giới thiệu miễn phí sản phẩm tại cửa hàng của người bán trên Google.

Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của chương trình. Định dạng accounts/{account}/programs/{program}
documentation_uri

string

Chỉ có đầu ra. URL của trang trợ giúp Merchant Center mô tả chương trình.
state

State

Chỉ có đầu ra. Trạng thái tham gia của tài khoản trong chương trình.
active_region_codes[]

string

Chỉ có đầu ra. Các khu vực mà tài khoản đang tích cực tham gia chương trình. Khu vực đang hoạt động được định nghĩa là những khu vực đã đáp ứng tất cả các yêu cầu của chương trình ảnh hưởng đến các khu vực đó.

Mã vùng do CLDR xác định. Đây là quốc gia nơi chương trình được áp dụng riêng cho quốc gia đó hoặc 001 khi chương trình được áp dụng trên toàn cầu.
unmet_requirements[]

Requirement

Chỉ có đầu ra. Các yêu cầu mà tài khoản chưa đáp ứng đang ảnh hưởng đến việc tham gia chương trình.

Yêu cầu

Xác định một yêu cầu được chỉ định để tham gia chương trình.

Trường
title

string

Chỉ có đầu ra. Tên yêu cầu.
documentation_uri

string

Chỉ có đầu ra. URL của một trang trợ giúp mô tả yêu cầu.
affected_region_codes[]

string

Chỉ có đầu ra. Những khu vực hiện đang chịu ảnh hưởng của yêu cầu này chưa được đáp ứng.

Mã vùng do CLDR xác định. Đây là quốc gia nơi chương trình được áp dụng riêng cho quốc gia đó hoặc 001 khi chương trình được áp dụng trên toàn cầu.

Tiểu bang

Các trạng thái tài khoản có thể tham gia chương trình.

Enum
STATE_UNSPECIFIED Giá trị mặc định. Giá trị này chưa được sử dụng.
NOT_ELIGIBLE Tài khoản đó không đủ điều kiện tham gia chương trình.
ELIGIBLE Tài khoản đó đủ điều kiện tham gia chương trình.
ENABLED Chương trình này đã được bật cho tài khoản này.

RateGroup

Định nghĩa về nhóm mức phí vận chuyển. Chỉ mục cuối cùng được phép có applicable_shipping_labels trống, có nghĩa là "mọi thứ khác". applicable_shipping_labels khác không được chồng chéo.

Trường
applicable_shipping_labels[]

string

Bắt buộc. Danh sách nhãn vận chuyển xác định những sản phẩm được áp dụng nhóm giá này. Đây là sự phân tách: chỉ một trong các nhãn phải khớp thì nhóm giá mới được áp dụng. Chỉ được để trống đối với nhóm giá cuối cùng của một dịch vụ.
subtables[]

Table

Không bắt buộc. Danh sách các bảng phụ do main_table tham chiếu đến. Bạn chỉ có thể thiết lập nếu đã đặt main_table.
carrier_rates[]

CarrierRate

Không bắt buộc. Danh sách mức phí của hãng vận chuyển có thể tham khảo bằng main_table hoặc single_value.
single_value

Value

Giá trị của nhóm giá (Ví dụ: giá cố định $10). Chỉ có thể thiết lập nếu bạn chưa đặt main_table và subtables.
main_table

Table

Một bảng xác định nhóm giá, khi single_value không đủ biểu cảm. Bạn chỉ có thể thiết lập nếu chưa đặt single_value.
name

string

Không bắt buộc. Tên của nhóm giá. Nếu tập hợp phải là duy nhất trong dịch vụ vận chuyển.

Khu vực

Đại diện cho khu vực địa lý mà bạn có thể dùng làm mục tiêu với cả dịch vụ RegionalInventory và ShippingSettings. Bạn có thể xác định các khu vực dưới dạng tập hợp mã bưu chính hoặc sử dụng các mục tiêu địa lý được xác định trước ở một số quốc gia. Để biết thêm thông tin, hãy xem phần Thiết lập khu vực để biết thêm thông tin.

Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của khu vực. Định dạng accounts/{account}/regions/{region}
postal_code_area

PostalCodeArea

Không bắt buộc. Danh sách mã bưu chính xác định khu vực.
geotarget_area

GeoTargetArea

Không bắt buộc. Danh sách mục tiêu địa lý xác định khu vực khu vực.
regional_inventory_eligible

BoolValue

Chỉ có đầu ra. Cho biết khu vực có đủ điều kiện sử dụng trong cấu hình Kho hàng theo khu vực hay không.
shipping_eligible

BoolValue

Chỉ có đầu ra. Cho biết khu vực có đủ điều kiện sử dụng trong cấu hình Dịch vụ vận chuyển hay không.
display_name

string

Không bắt buộc. Tên hiển thị của khu vực.

GeoTargetArea

Danh sách mục tiêu địa lý xác định khu vực khu vực.

Trường
geotarget_criteria_ids[]

int64

Bắt buộc. Một danh sách mã vị trí không trống. Tất cả các vị trí đó phải thuộc cùng một loại vị trí (ví dụ: tiểu bang).

PostalCodeArea

Danh sách mã bưu chính xác định khu vực. Lưu ý: Bạn có thể truy cập tất cả các khu vực được xác định bằng mã bưu chính thông qua tài nguyên ShippingSettings.postalCodeGroups của tài khoản.

Trường
region_code

string

Bắt buộc. Mã lãnh thổ CLDR hoặc quốc gia áp dụng nhóm mã bưu chính.
postal_codes[]

PostalCodeRange

Bắt buộc. Một loạt mã bưu chính.

PostalCodeRange

Một loạt các mã bưu chính xác định khu vực của khu vực.

Trường
begin

string

Bắt buộc. Mã bưu chính hoặc mẫu của tiền tố biểu mẫu* biểu thị giới hạn dưới bao gồm của dải ô xác định khu vực. Giá trị mẫu: 94108, 9410*, 9*.
end

string

Không bắt buộc. Mã bưu chính hoặc mẫu có dạng prefix* cho biết giới hạn trên của dải ô xác định khu vực. Giá trị này phải có cùng độ dài như Không bắt buộc: nếu bạn không đặt, thì khu vực sẽ được xác định là tất cả các mã bưu chính khớp vớiPostalCodeTargetBegin.

Bắt buộc

Mô tả các điều khoản dịch vụ cần phải chấp nhận.

Trường
terms_of_service

string

Trường termsOfService cần phải được chấp nhận.
tos_file_uri

string

URL đầy đủ đến tệp điều khoản dịch vụ. Trường này giống với TermsOfService.file_uri, nó được thêm vào đây chỉ để thuận tiện.

RetrieveForApplicationTermsOfServiceAgreementStateRequest

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

Trường
parent

string

Bắt buộc. Tài khoản cần có Định dạng TermsOfServiceAgreementState: accounts/{account}

RetrieveLatestTermsOfServiceRequest

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

Trường
region_code

string

Mã vùng theo xác định của CLDR. Đây có thể là một quốc gia khi Điều khoản dịch vụ được áp dụng riêng cho quốc gia đó hoặc là 001 khi áp dụng trên toàn cầu.
kind

TermsOfServiceKind

Loại áp dụng phiên bản điều khoản dịch vụ này.

Hàng

Bao gồm một danh sách ô.

Trường
cells[]

Value

Bắt buộc. Danh sách các ô tạo thành hàng. Phải có độ dài bằng columnHeaders đối với bảng hai chiều, độ dài là 1 đối với bảng một chiều.

Dịch vụ

Dịch vụ vận chuyển.

Trường
delivery_countries[]

string

Bắt buộc. Mã lãnh thổ CLDR của các quốc gia áp dụng dịch vụ.
rate_groups[]

RateGroup

Không bắt buộc. Định nghĩa về nhóm mức phí vận chuyển. Chỉ mục cuối cùng được phép có applicable_shipping_labels trống, có nghĩa là "mọi thứ khác". applicable_shipping_labels khác không được chồng chéo.
loyalty_programs[]

LoyaltyProgram

Không bắt buộc. Chương trình khách hàng thân thiết chỉ được cung cấp dịch vụ vận chuyển này.
service_name

string

Bắt buộc. Tên dạng tự do của dịch vụ. Phải là duy nhất trong tài khoản đích.
active

bool

Bắt buộc. Giá trị boolean cho biết trạng thái hoạt động của dịch vụ vận chuyển.
currency_code

string

Mã CLDR của đơn vị tiền tệ áp dụng dịch vụ này. Phải khớp với giá của các mức giá trong các nhóm giá.
delivery_time

DeliveryTime

Bắt buộc. Thời gian bỏ ra cho các khía cạnh khác nhau từ lúc đặt hàng đến khi giao sản phẩm.
shipment_type

ShipmentType

Loại địa điểm mà dịch vụ này vận chuyển đơn đặt hàng đến.
minimum_order_value

Price

Giá trị đặt hàng tối thiểu cho dịch vụ này. Nếu được đặt, hãy cho biết rằng khách hàng sẽ phải chi tiêu ít nhất số tiền này. Tất cả giá trong một dịch vụ phải có cùng đơn vị tiền tệ. Không thể đặt giá trị này cùng vớiMinimum_order_value_table.
minimum_order_value_table

MinimumOrderValueTable

Bảng giá trị đơn đặt hàng tối thiểu mỗi cửa hàng đối với cách thực hiện đơn hàng để đến lấy hàng. Không thể đặt giá trị này cùng vớiminimum_order_value.
store_config

StoreConfig

Danh sách cửa hàng bán sản phẩm của bạn. Giá trị này chỉ hợp lệ đối với loại hình vận chuyển giao hàng tại địa phương.

LoyaltyProgram

Chương trình khách hàng thân thiết do người bán cung cấp.

Trường
loyalty_program_tiers[]

LoyaltyProgramTiers

Không bắt buộc. Bậc chương trình khách hàng thân thiết của dịch vụ vận chuyển này.
program_label

string

Đây là nhãn chương trình khách hàng thân thiết được thiết lập trong chế độ cài đặt chương trình khách hàng thân thiết trong Merchant Center. Thuộc tính phụ này giúp Google liên kết chương trình khách hàng thân thiết của bạn với các mặt hàng đủ điều kiện.

LoyaltyProgramTiers

Một tập hợp con chương trình khách hàng thân thiết của người bán.

Trường
tier_label

string

Thuộc tính phụ nhãn phân cấp [tier_label] phân biệt lợi ích theo cấp mặt hàng giữa từng cấp. Giá trị này cũng được đặt trong chế độ cài đặt chương trình trong Merchant Center. Đây là giá trị bắt buộc nếu bạn muốn thay đổi nguồn dữ liệu ngay cả khi chương trình khách hàng thân thiết của bạn chỉ có 1 bậc.

ShipmentType

Loại hình vận chuyển của dịch vụ vận chuyển.

Enum
SHIPMENT_TYPE_UNSPECIFIED Dịch vụ này không xác định loại hình vận chuyển.
DELIVERY Dịch vụ này giao hàng đến địa chỉ do khách hàng chọn.
LOCAL_DELIVERY Dịch vụ này giao hàng đến địa chỉ do khách hàng chọn. Đơn đặt hàng của bạn được vận chuyển từ một cửa hàng địa phương gần đó.
COLLECTION_POINT Dịch vụ này giao hàng đến địa chỉ do khách hàng chọn. Đơn đặt hàng được vận chuyển từ một điểm đến lấy hàng.

StoreConfig

Danh sách cửa hàng bán sản phẩm của bạn. Giá trị này chỉ hợp lệ đối với loại hình vận chuyển giao hàng tại địa phương.

Trường
store_codes[]

string

Không bắt buộc. Danh sách mã cửa hàng cung cấp dịch vụ giao hàng tại địa phương. Nếu trống, thì all_stores phải là giá trị true.
store_service_type

StoreServiceType

Cho biết liệu tất cả cửa hàng hoặc một số cửa hàng do người bán này đăng có cung cấp dịch vụ giao hàng tại địa phương hay không.
cutoff_config

CutoffConfig

Các cấu hình liên quan đến dịch vụ giao hàng tại địa phương sẽ kết thúc vào ngày đó.
service_radius

Distance

Bán kính giao hàng tối đa. Thuộc tính này chỉ bắt buộc đối với loại hình vận chuyển giao hàng tại địa phương.

CutoffConfig

Các cấu hình liên quan đến dịch vụ giao hàng tại địa phương sẽ kết thúc vào ngày đó.

Trường
local_cutoff_time

LocalCutoffTime

Thời gian kết thúc dịch vụ giao hàng tại địa phương trong ngày.
store_close_offset_hours

int64

Chỉ hợp lệ khi thực hiện đơn hàng giao tại địa phương. Biểu thị hạn chót nhận đơn hàng dưới dạng số giờ trước khi đóng cửa hàng. Loại trừ lẫn nhau với local_cutoff_time.
no_delivery_post_cutoff

bool

Người bán có thể chọn không hiển thị dịch vụ giao hàng tại địa phương trong vòng 1 ngày khi họ thiết lập dịch vụ vận chuyển thành giao hàng tại địa phương trong vòng n ngày. Ví dụ: Nếu dịch vụ vận chuyển xác định dịch vụ giao hàng cùng ngày và đã qua hạn chót nhận đơn đặt hàng, thì việc đặt trường này thành true sẽ dẫn đến việc trả lại mức phí dịch vụ vận chuyển đã tính là NO_DELIVERY_POST_CUTOFF. Trong ví dụ tương tự, việc thiết lập trường này thành false sẽ dẫn đến thời gian vận chuyển được tính toán là một ngày. Tính năng này chỉ áp dụng cho dịch vụ giao hàng tại địa phương.

LocalCutoffTime

Thời gian kết thúc dịch vụ giao hàng tại địa phương trong ngày.

Trường
hour

int64

Các đơn giao hàng theo giờ tại địa phương phải được đặt trước để xử lý trong cùng ngày.
minute

int64

Các đơn đặt hàng giao tại địa phương phải được đặt trước để xử lý trong cùng ngày.

StoreServiceType

Cho biết liệu tất cả cửa hàng hoặc một số cửa hàng do người bán đăng tải có cung cấp dịch vụ giao hàng tại địa phương hay không.

Enum
STORE_SERVICE_TYPE_UNSPECIFIED Không chỉ định loại dịch vụ cửa hàng.
ALL_STORES Cho biết liệu tất cả cửa hàng (hiện tại và tương lai) do người bán này đăng có cung cấp dịch vụ giao hàng tại địa phương hay không.
SELECTED_STORES Cho biết rằng chỉ những cửa hàng có trong danh sách store_codes mới đủ điều kiện giao hàng tại địa phương.

ShippingSettings

[chế độ cài đặt thông tin vận chuyển]((https://support.google.com/merchants/answer/6069284) của tài khoản người bán.

Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của chế độ cài đặt thông tin vận chuyển. Định dạng accounts/{account}/shippingSetting
services[]

Service

Không bắt buộc. Danh sách dịch vụ của tài khoản đích.
warehouses[]

Warehouse

Không bắt buộc. Danh sách các nhà kho có thể tham chiếu trong services.
etag

string

Bắt buộc. Trường này được dùng để tránh sự cố không đồng bộ. Đảm bảo rằng dữ liệu trong chế độ cài đặt thông tin vận chuyển không thay đổi giữa thời điểm nhận cuộc gọi và chèn cuộc gọi. Người dùng nên làm theo các bước sau:

  1. Đặt trường thẻ etag làm chuỗi trống để tạo chế độ cài đặt thông tin vận chuyển ban đầu.

  2. Sau lần tạo ban đầu, hãy gọi phương thức get để lấy thẻ etag và dữ liệu trong chế độ cài đặt thông tin vận chuyển hiện tại trước khi chèn cuộc gọi.

  3. Sửa đổi thành thông tin mong muốn về chế độ cài đặt thông tin vận chuyển.

  4. Phương pháp chèn cuộc gọi có thông tin về chế độ cài đặt thông tin vận chuyển mong muốn bằng etag có được ở bước 2.

  5. Nếu dữ liệu chế độ cài đặt thông tin vận chuyển thay đổi giữa bước 2 và bước 4. Yêu cầu chèn sẽ không thành công vì thẻ etag thay đổi mỗi khi dữ liệu trong chế độ cài đặt thông tin vận chuyển thay đổi. Người dùng nên lặp lại bước 2-4 với thẻ etag mới.

Bảng

Một bảng xác định nhóm giá, khi single_value không đủ biểu cảm.

Trường
rows[]

Row

Bắt buộc. Danh sách các hàng tạo thành bảng. Phải có cùng độ dài như row_headers.
name

string

Tên bảng. Bắt buộc đối với bảng phụ, bị bỏ qua đối với bảng chính.
row_headers

Headers

Bắt buộc. Tiêu đề của các hàng trong bảng.
column_headers

Headers

Tiêu đề các cột của bảng. Không bắt buộc: nếu bạn không đặt chính sách này, thì bảng chỉ có một phương diện.

TaxRule

Chuyển đổi loại chính

phần trăm micro : 100% = 1 000 000 và 1% = 10 000 không được là số âm.

Thông tin về mối liên hệ về thuế và các thông số liên quan áp dụng cho các đơn đặt hàng được giao đến khu vực thuộc phạm vi quản lý của một quản trị viên thuế. Nexus được tạo khi người bán đang kinh doanh trong khu vực do quản trị viên thuế quản lý (chỉ các tiểu bang tại Hoa Kỳ mới được hỗ trợ cấu hình mối liên hệ). Nếu người bán có mối liên hệ ở một tiểu bang của Hoa Kỳ, thì người bán cần phải nộp thuế cho tất cả các cơ quan thuế liên quan đến điểm đến vận chuyển. Mã tiếp theo : 8

Trường
region_code

string

Mã khu vực áp dụng quy tắc này
shipping_taxed

bool

Nếu bạn đặt chính sách này, phí vận chuyển sẽ được tính thuế (cùng mức thuế với sản phẩm) khi giao hàng đến khu vực của quản trị viên này. Chỉ có thể đặt cho các tiểu bang của Hoa Kỳ không có danh mục.
effective_time_period

Interval

Bắt buộc. Khoảng thời gian khi quy tắc này có hiệu lực. Nếu thời lượng bị thiếu trong giá trị hiệu_lực, thì thời lượng đó có kết thúc mở và kết thúc trong tương lai. Bắt đầu khoảng thời gian này và không bao gồm điểm kết thúc.
Trường kết hợp location. Mô tả vị trí thông qua phạm vi mã bưu chính hoặc id tiêu chí. location chỉ có thể là một trong những trạng thái sau đây:
location_id

int64

admin_id hoặc Standards_id của khu vực áp dụng quy tắc này.
post_code_range

TaxPostalCodeRange

Phạm vi mã bưu chính có áp dụng quy tắc này.
Trường kết hợp rate_calculation. Đây là cách tính thuế suất đối với các dịch vụ giao hàng đến khu vực của quản trị viên này. Chỉ có thể đặt ở các tiểu bang của Hoa Kỳ. rate_calculation chỉ có thể là một trong những trạng thái sau đây:
use_google_rate

bool

Mức phí phụ thuộc vào địa điểm giao hàng: nếu người bán có mối liên hệ tại tiểu bang tương ứng của Hoa Kỳ thì mức phí do các cơ quan chức năng có quyền tài phán đối với khu vực giao hàng tính thêm.
self_specified_rate_micros

int64

Tỷ lệ cố định được chỉ định bằng micro, trong đó 100% = 1_000_000. Phù hợp với các trạng thái dựa trên nguồn gốc.

TaxPostalCodeRange

Một loạt các mã bưu chính xác định khu vực.

Trường
start

string

Bắt buộc. Bắt đầu phạm vi mã bưu chính, cũng là điểm bắt đầu nhỏ nhất trong phạm vi.
end

string

Điểm cuối của phạm vi mã bưu chính. Giá trị này sẽ giống như giá trị bắt đầu nếu không được chỉ định.

TermsOfService

TermsOfService.

Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của phiên bản điều khoản dịch vụ. Định dạng termsOfService/{version}
region_code

string

Mã vùng theo xác định của CLDR. Đây là một quốc gia nơi Điều khoản dịch vụ được áp dụng riêng cho quốc gia đó hoặc là 001 khi cùng một TermsOfService có thể được ký ở bất cứ quốc gia nào. Tuy nhiên, xin lưu ý rằng khi ký Điều khoản dịch vụ áp dụng trên toàn cầu, chúng tôi vẫn kỳ vọng rằng một quốc gia cụ thể sẽ được cung cấp (phải là quốc gia của doanh nghiệp bán hàng hoặc quốc gia tham gia chương trình).
kind

TermsOfServiceKind

Loại áp dụng phiên bản điều khoản dịch vụ này.
external

bool

Phiên bản điều khoản dịch vụ này có phải là phiên bản bên ngoài hay không. Các phiên bản điều khoản dịch vụ bên ngoài chỉ có thể được đồng ý thông qua các quy trình bên ngoài chứ không được người bán trực tiếp đồng ý thông qua giao diện người dùng hoặc API.
file_uri

string

URI cho tệp điều khoản dịch vụ cần được hiển thị cho người dùng ký.

TermsOfServiceAgreementState

Tài nguyên này thể hiện trạng thái thoả thuận của một tài khoản và loại điều khoản dịch vụ nhất định. Trạng thái như sau:

  • Nếu người bán đã chấp nhận điều khoản dịch vụ: hệ thống sẽ điền trạng thái được chấp nhận, nếu không thì sẽ trống.
  • Nếu người bán phải ký điều khoản dịch vụ: hệ thống sẽ điền giá trị bắt buộc, nếu không sẽ trống.

Xin lưu ý rằng có thể có cả trạng thái bắt buộc và được chấp nhận. Trong trường hợp này, điều khoản dịch vụ của accepted sẽ có ngày hết hạn được đặt trong trường valid_until. Bạn cần chấp nhận các điều khoản dịch vụ của required trước ngày valid_until để tài khoản này có thể tiếp tục có một thoả thuận hợp lệ. Khi chấp nhận các điều khoản dịch vụ mới, chúng tôi yêu cầu Bên thứ ba hiển thị văn bản liên quan đến các điều khoản dịch vụ nhất định (URL dẫn đến tệp chứa văn bản đó được thêm vào thông báo Bắt buộc bên dưới dưới dạng tos_file_uri. Việc chấp nhận điều khoản dịch vụ trên thực tế được thực hiện bằng cách gọi lệnh gọi "chấp nhận" trên tài nguyên TermsOfService (Điều khoản dịch vụ).

Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của phiên bản điều khoản dịch vụ. Định dạng accounts/{account}/termsOfServiceAgreementState/{identifier}
region_code

string

Mã vùng theo xác định của https://cldr.unicode.org/. Đây là quốc gia áp dụng trạng thái hiện tại.
terms_of_service_kind

TermsOfServiceKind

Loại Điều khoản dịch vụ liên quan đến phiên bản cụ thể đó.
accepted

Accepted

Các điều khoản dịch vụ được chấp nhận thuộc loại này và cho mã vùng được liên kết
required

Required

Điều khoản dịch vụ bắt buộc

TermsOfServiceKind

Loại Điều khoản dịch vụ.

Enum
TERMS_OF_SERVICE_KIND_UNSPECIFIED Giá trị mặc định. Giá trị này chưa được sử dụng.
MERCHANT_CENTER Ứng dụng Merchant Center.

TransitTable

Bảng thời gian vận chuyển, số ngày làm việc đã vận chuyển dựa trên kích thước hàng và cột. Bạn có thể đặt min_transit_days, max_transit_days hoặc transit_time_table, nhưng không thể đặt cả hai.

Trường
postal_code_group_names[]

string

Bắt buộc. Danh sách tên khu vực Region.name . Giá trị cuối cùng có thể là "all other locations". Ví dụ: ["zone 1", "zone 2", "all other locations"]. Các nhóm mã bưu chính được giới thiệu phải khớp với quốc gia giao hàng của dịch vụ.
transit_time_labels[]

string

Bắt buộc. Danh sách nhãn thời gian vận chuyển. Giá trị cuối cùng có thể là "all other labels". Ví dụ: ["food", "electronics", "all other labels"].
rows[]

TransitTimeRow

Bắt buộc. Nếu chỉ có một nhóm phương diện postal_code_group_names hoặc transit_time_labels, thì sẽ có nhiều hàng, mỗi hàng sẽ có một giá trị cho phương diện đó. Nếu có hai phương diện, mỗi hàng tương ứng với một postal_code_group_names và các cột (giá trị) tương ứng với một transit_time_labels.

TransitTimeRow

Nếu chỉ có một nhóm phương diện postal_code_group_names hoặc transit_time_labels, thì sẽ có nhiều hàng, mỗi hàng sẽ có một giá trị cho phương diện đó. Nếu có hai phương diện, mỗi hàng tương ứng với một postal_code_group_names và các cột (giá trị) tương ứng với một transit_time_labels.

Trường
values[]

TransitTimeValue

Bắt buộc. Phạm vi thời gian vận chuyển (tối thiểu đến tối đa) tính theo ngày làm việc.

TransitTimeValue

Phạm vi thời gian vận chuyển (tối thiểu đến tối đa) tính theo ngày làm việc.

Trường
min_transit_days

int32

Phạm vi thời gian vận chuyển tối thiểu tính theo ngày làm việc. 0 có nghĩa là giao hàng trong cùng ngày, 1 có nghĩa là giao hàng vào ngày tiếp theo.
max_transit_days

int32

Phải lớn hơn hoặc bằng min_transit_days.

UnclaimHomepageRequest

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

Trường
name

string

Bắt buộc. Tên của trang chủ cần huỷ xác nhận. Định dạng accounts/{account}/homepage

UpdateAccountRequest

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

Trường
account

Account

Bắt buộc. Phiên bản mới của tài khoản.
update_mask

FieldMask

Bắt buộc. Danh sách trường đang được cập nhật.

UpdateAccountTaxRequest

Yêu cầu cập nhật chế độ cài đặt thuế

Trường
account_tax

AccountTax

Bắt buộc. Chế độ cài đặt thuế sẽ được cập nhật
update_mask

FieldMask

Danh sách các trường sẽ được cập nhật

UpdateBusinessIdentityRequest

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

Trường
business_identity

BusinessIdentity

Bắt buộc. Phiên bản mới của thông tin nhận dạng doanh nghiệp.
update_mask

FieldMask

Bắt buộc. Danh sách trường đang được cập nhật.

UpdateBusinessInfoRequest

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

Trường
business_info

BusinessInfo

Bắt buộc. Phiên bản mới của thông tin doanh nghiệp.
update_mask

FieldMask

Bắt buộc. Danh sách trường đang được cập nhật.

UpdateEmailPreferencesRequest

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

Trường
email_preferences

EmailPreferences

Bắt buộc. Tuỳ chọn email sẽ được cập nhật.
update_mask

FieldMask

Bắt buộc. Danh sách trường đang được cập nhật.

UpdateHomepageRequest

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

Trường
homepage

Homepage

Bắt buộc. Phiên bản mới của trang chủ.
update_mask

FieldMask

Bắt buộc. Danh sách trường đang được cập nhật.

UpdateRegionRequest

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

Trường
region

Region

Bắt buộc. Khu vực được cập nhật.
update_mask

FieldMask

Không bắt buộc. Mặt nạ trường được phân tách bằng dấu phẩy cho biết các trường cần cập nhật. Ví dụ: "displayName,postalCodeArea.regionCode"

UpdateUserRequest

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

Trường
user

User

Bắt buộc. Phiên bản mới của người dùng.

Bạn cũng có thể cập nhật người dùng tương ứng với phương thức gọi bằng cách sử dụng me thay vì địa chỉ email trong trường tên như trong accounts/{account}/users/me.
update_mask

FieldMask

Bắt buộc. Danh sách trường đang được cập nhật.

Người dùng

Người dùng.

Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của người dùng. Định dạng accounts/{account}/user/{user}
state

State

Chỉ có đầu ra. Trạng thái của người dùng.
access_rights[]

AccessRight

Không bắt buộc. Quyền truy cập mà người dùng có.

Tiểu bang

Các trạng thái có thể có của người dùng.

Enum
STATE_UNSPECIFIED Giá trị mặc định. Giá trị này chưa được sử dụng.
PENDING Người dùng đang chờ xác nhận. Ở trạng thái này, trước tiên, người dùng cần chấp nhận lời mời trước khi thực hiện các hành động khác.
VERIFIED Người dùng đã được xác minh.

Giá trị

Giá trị duy nhất của một nhóm giá hoặc giá trị của một ô trong bảng nhóm giá. Phải đặt chính xác một trong các giá trị no_shipping, flat_rate, price_percentage, carrier_rateName, subtable_name.

Trường
no_shipping

bool

Nếu đúng thì sản phẩm sẽ không thể được vận chuyển. Giá trị này phải là true khi đã đặt và chỉ có thể đặt nếu chưa đặt tất cả các trường khác.
flat_rate

Price

Mức phí cố định. Chỉ có thể đặt nếu chưa đặt tất cả các trường khác.
price_percentage

string

Tỷ lệ phần trăm của giá được biểu thị dưới dạng số bằng ký hiệu thập phân (Ví dụ: "5.4"). Chỉ có thể đặt nếu chưa đặt tất cả các trường khác.
carrier_rate

string

Tên của mức phí của hãng vận chuyển đề cập đến mức phí của hãng vận chuyển được xác định trong cùng một nhóm mức phí. Chỉ có thể đặt nếu chưa đặt tất cả các trường khác.
subtable

string

Tên của bảng phụ. Chỉ có thể đặt trong các ô của bảng (Ví dụ: không phải dành cho các giá trị đơn lẻ) và chỉ khi chưa đặt tất cả các trường khác.

Nhà kho

Kho hàng thực hiện đơn hàng, nơi lưu trữ và xử lý hàng tồn kho. Thẻ tiếp theo: 7

Trường
name

string

Bắt buộc. Tên kho hàng. Phải là duy nhất trong tài khoản.
shipping_address

Address

Bắt buộc. Địa chỉ giao hàng của kho hàng.
cutoff_time

WarehouseCutoffTime

Bắt buộc. Thời gian muộn nhất trong ngày mà đơn đặt hàng có thể được chấp nhận và bắt đầu xử lý. Các đơn đặt hàng sau đó sẽ được xử lý vào ngày tiếp theo. Thời gian này dựa trên mã bưu chính của kho hàng.
handling_days

int64

Bắt buộc. Số ngày cần thiết để kho hàng này đóng gói và vận chuyển một mặt hàng. Đây là giá trị ở cấp kho hàng nhưng có thể thay thế cho cấp mặt hàng dựa trên các thuộc tính của mặt hàng.
business_day_config

BusinessDayConfig

Ngày làm việc của kho hàng. Nếu bạn không đặt chính sách này, giá trị này sẽ là thứ Hai đến thứ Sáu theo mặc định.

WarehouseBasedDeliveryTime

Cho biết thời gian giao hàng phải được tính theo từng kho hàng (vị trí nguồn gốc vận chuyển) dựa trên chế độ cài đặt của hãng vận chuyển đã chọn. Khi đặt, bạn không được đặt trường nào khác liên quan đến thời gian vận chuyển trong delivery_time.

Trường
carrier

string

Bắt buộc. Nhà mạng, chẳng hạn như "UPS" hoặc "Fedex".
carrier_service

string

Bắt buộc. Dịch vụ của nhà mạng, chẳng hạn như "ground" hoặc "2 days". Tên dịch vụ phải có trong danh sách eddSupportedServices.
warehouse

string

Bắt buộc. Tên nhà kho. Thuộc tính này phải khớp với [warehouse][Shippingsetting.warehouses.name]

WarehouseCutoffTime

Thời gian muộn nhất trong ngày mà đơn đặt hàng có thể được chấp nhận và bắt đầu xử lý. Các đơn đặt hàng sau đó sẽ được xử lý vào ngày tiếp theo. Thời gian này dựa trên mã bưu chính của kho hàng.

Trường
hour

int32

Bắt buộc. Giờ của hạn chót nhận đơn đặt hàng mà kho hàng phải đặt hàng để xử lý trong cùng ngày. Giờ được dựa trên múi giờ của kho hàng.
minute

int32

Bắt buộc. Số phút của hạn chót nhận đơn đặt hàng mà kho hàng phải đặt hàng để xử lý trong cùng ngày. Phút dựa trên múi giờ của kho hàng.