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

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

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) hay tài khoản phụ. Việc xoá một Tài khoản nhiều khách hàng sẽ dẫn đến việc xoá tất cả tài khoản phụ của tài khoản đó. Bạn cần có quyền quản trị để thực thi phương thức này. Quá trình xoá chỉ thành công nếu tài khoản không cung cấp dịch vụ cho bất kỳ tài khoản nào khác và không có mặt hàng nào được xử lý. Bạn có thể sử dụng tham số force để ghi đè giá trị này.

Phạm vi uỷ quyền

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

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

Truy xuất một tài khoản từ tài khoản Merchant Center của bạn. Sau khi chèn, cập nhật hoặc xoá một tài khoản, có thể mất vài phút thì các thay đổi mớ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 OAuth 2.0 Overview.

ListAccounts

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

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 quy tắc 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. Đây không chỉ là danh sách các tài khoản phụ của một MCA, mà còn là tất cả cá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 được liên kết, tài khoản độc lập, v.v. Nếu không có bộ lọc nào được cung cấp, thì hàm này sẽ trả về các tài khoản mà người dùng được thêm trực tiếp vào. Phương thức này cuối cùng sẽ nhất quán, tức là các thay đổi như tạo, cập nhật tài khoản hoặc thay đổi mối quan hệ giữa các tài khoản có thể không xuất hiện ngay trong kết quả. Thay vào đó, những thay đổi này sẽ lan truyền trong một khoảng thời gian ngắn, sau đó thông tin đã cập nhật có thể khớp với các thuộc tính liên kết. Điều đó có nghĩa là việc tìm kiếm theo tên tài khoản có thể không trả về một tài khoản đã thay đổi gần đây, mặc dù tài khoản đó đáp ứng thuộc tính.

Phạm vi uỷ quyền

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

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

ListSubAccounts

rpc ListSubAccounts(ListSubAccountsRequest) returns (ListSubAccountsResponse)

Liệt kê tất cả tài khoản phụ cho một tài khoản nhiều khách hàng nhất định. Đây là 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ẽ tạo 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 OAuth 2.0 Overview.

UpdateAccount

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

Cập nhật một tài khoản bất kể loại tài khoản đó là: tài khoản độc lập, tài khoản nhiều khách hàng (MCA) hay tài khoản phụ. Bạn cần có quyền quản trị để thực thi phương thức này.

Phạm vi uỷ quyền

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

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

AutofeedSettingsService

Dịch vụ hỗ trợ chế độ cài đặt tự động cấp dữ liệu.

GetAutofeedSettings

rpc GetAutofeedSettings(GetAutofeedSettingsRequest) returns (AutofeedSettings)

Truy xuất chế độ cài đặt nguồn cấp dữ liệu tự động 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 OAuth 2.0 Overview.

UpdateAutofeedSettings

rpc UpdateAutofeedSettings(UpdateAutofeedSettingsRequest) returns (AutofeedSettings)

Cập nhật chế độ cài đặt nguồn cấp dữ liệu tự động 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 OAuth 2.0 Overview.

BusinessIdentityService

Dịch vụ hỗ trợ API danh tính doanh nghiệp.

GetBusinessIdentity

rpc GetBusinessIdentity(GetBusinessIdentityRequest) returns (BusinessIdentity)

Truy xuất danh tính 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 OAuth 2.0 Overview.

UpdateBusinessIdentity

rpc UpdateBusinessIdentity(UpdateBusinessIdentityRequest) returns (BusinessIdentity)

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

Phạm vi uỷ quyền

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

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

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

UpdateBusinessInfo

rpc UpdateBusinessInfo(UpdateBusinessInfoRequest) returns (BusinessInfo)

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

Phạm vi uỷ quyền

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

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

EmailPreferencesService

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

GetEmailPreferences

rpc GetEmailPreferences(GetEmailPreferencesRequest) returns (EmailPreferences)

Trả về lựa chọn ưu tiên về email của người dùng tài khoản Merchant Center. Dịch vụ này chỉ cho phép truy xuất và cập nhật lựa chọn ưu tiên về email cho người dùng đã xác thực. 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 OAuth 2.0 Overview.

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 nên chỉ định tài khoản MCA thay vì tài khoản phụ của MCA.

Những tuỳ chọ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.

Nội dung cập nhật không hợp lệ nếu chỉ định giá trị trạng thái chọn tham gia là CHƯA XÁC NHẬN.

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

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

Nếu trang chủ đã được xác nhận quyền sở hữu, thì hệ thống sẽ kiểm tra lại quy trình xác minh (trừ phi người bán được miễn xác nhận quyền sở hữu, đồng thời được miễn xác minh) và trả về phản hồi thành công. Nếu không thể xác minh quyền sở hữu 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ề một thông báo lỗi chuẩn: * PERMISSION_DENIED: người dùng không có các quyền cần thiết trên tài khoản MC này; * FAILED_PRECONDITION: – 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 OAuth 2.0 Overview.

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

UnclaimHomepage

rpc UnclaimHomepage(UnclaimHomepageRequest) returns (Homepage)

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

Phạm vi uỷ quyền

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

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

UpdateHomepage

rpc UpdateHomepage(UpdateHomepageRequest) returns (Homepage)

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

Phạm vi uỷ quyền

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

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

OnlineReturnPolicyService

Dịch vụ này hỗ trợ việc quản lý cấu hình chính sách trả lại hàng do người mua thay đổi ý định của người bán, bao gồm cả chính sách trả lại hàng cho cả quảng cáo và trang thông tin miễn phí

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

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

GetOnlineReturnPolicy

rpc GetOnlineReturnPolicy(GetOnlineReturnPolicyRequest) returns (OnlineReturnPolicy)

Lấy chính sách trả lại hàng hiện có của một người bán cụ thể.

Phạm vi uỷ quyền

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

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

ListOnlineReturnPolicies

rpc ListOnlineReturnPolicies(ListOnlineReturnPoliciesRequest) returns (ListOnlineReturnPoliciesResponse)

Liệt kê tất cả chính sách trả lại hàng hiện có của một người bán cụ thể.

Phạm vi uỷ quyền

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

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

ProgramsService

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

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 về điều này là chương trình Trang thông tin miễn phí về sản phẩm, cho phép sản phẩm trong cửa hàng của người bán xuất hiện miễn phí trên Google.

Dịch vụ này hiển thị các phương thức để truy xuất hoạt động 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 để bật hoặc tắt rõ ràng hoạt động tham gia trong từng chương trình.

DisableProgram

rpc DisableProgram(DisableProgramRequest) returns (Program)

Tắt tính năng tham gia chương trình được chỉ định cho tài khoản. Bạn cần có quyền quản trị để thực thi phương thức này.

Phạm vi uỷ quyền

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

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

EnableProgram

rpc EnableProgram(EnableProgramRequest) returns (Program)

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

Phạm vi uỷ quyền

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

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

GetProgram

rpc GetProgram(GetProgramRequest) returns (Program)

Truy xuất chương trình đã 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 OAuth 2.0 Overview.

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

RegionsService

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

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

  • Region
CreateRegion

rpc CreateRegion(CreateRegionRequest) returns (Region)

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

Phạm vi uỷ quyền

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

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

DeleteRegion

rpc DeleteRegion(DeleteRegionRequest) returns (Empty)

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

Phạm vi uỷ quyền

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

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

GetRegion

rpc GetRegion(GetRegionRequest) returns (Region)

Truy xuất một khu vực được xác định 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 OAuth 2.0 Overview.

ListRegions

rpc ListRegions(ListRegionsRequest) returns (ListRegionsResponse)

Liệt kê các khu vực 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 OAuth 2.0 Overview.

UpdateRegion

rpc UpdateRegion(UpdateRegionRequest) returns (Region)

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

Phạm vi uỷ quyền

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

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

ShippingSettingsService

Dịch vụ để lấy thông tin chế độ cài đặt thông tin vận chuyển của lệnh gọi phương thức theo phương thức API người bán.

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

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

Phạm vi uỷ quyền

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

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

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

RetrieveForApplicationTermsOfServiceAgreementState

rpc RetrieveForApplicationTermsOfServiceAgreementState(RetrieveForApplicationTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

Truy xuất trạng thái của thoả thuận về đ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 OAuth 2.0 Overview.

TermsOfServiceService

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

AcceptTermsOfService

rpc AcceptTermsOfService(AcceptTermsOfServiceRequest) returns (Empty)

Chấp nhận TermsOfService. Bạn cần có quyền quản trị để thực thi phương thức này.

Phạm vi uỷ quyền

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

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

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

RetrieveLatestTermsOfService

rpc RetrieveLatestTermsOfService(RetrieveLatestTermsOfServiceRequest) returns (TermsOfService)

Truy xuất phiên bản mới nhất của TermsOfService cho một kindregion_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 OAuth 2.0 Overview.

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

Phạm vi uỷ quyền

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

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

DeleteUser

rpc DeleteUser(DeleteUserRequest) returns (Empty)

Xoá người dùng tài khoản Merchant Center. Bạn cần có quyền quản trị để thực thi phương thức này. Người dùng cần xoá không được là người dùng quản trị viên cuối cùng của tài khoản đó. Ngoài ra, người dùng sẽ được bảo vệ khỏi việc bị xoá nếu người dùng đó do Trình quản lý doanh nghiệp quản lý"

Phạm vi uỷ quyền

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

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

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

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

UpdateUser

rpc UpdateUser(UpdateUserRequest) returns (User)

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

Phạm vi uỷ quyền

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

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

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 cần chấp nhận Điều khoản dịch vụ.

region_code

string

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

Đã chấp nhận

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

Trường
terms_of_service

string

termsOfService đã được chấp nhận.

accepted_by

string

Tài khoản ghi nhận trạng thái chấp nhận. Tài khoản này có thể là chính tài khoản đó hoặc trong trường hợp là tài khoản phụ, thì đó là tài khoản nhiều khách hàng.

valid_until

Date

Khi được đặt, thuộc tính này sẽ cho biết rằng TermsOfService đã chấp nhận chỉ có hiệu lực đến hết ngày này (theo giờ UTC). Bạn phải chấp nhận một yêu cầu mới trước thời điểm đó. Thông tin về TermsOfService bắt buộc có trong thông báo Required (Bắt buộc).

AccessRight

Quyền truy cập.

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

Tài khoản

Thông báo Account đại diện cho tài khoản của người bán trong quảng cáo Mua sắm. Đây là thực thể chính để quản lý dữ liệu sản phẩm, chế độ cài đặt và hoạt động tương tác với các dịch vụ của Google và nhà cung cấp bên ngoài.

Tài khoản có thể hoạt động dưới dạng pháp nhân độc lập hoặc là một phần của cấu trúc tài khoản nhiều khách hàng (MCA). Trong chế độ thiết lập tài khoản nhiều khách hàng (MCA), tài khoản chính quản lý nhiều tài khoản phụ.

Việc thiết lập tài khoản bao gồm việc định cấu hình các thuộc tính như tên tài khoản, múi giờ và lựa chọn ưu tiên về ngôn ngữ.

Thông báo Account là thực thể mẹ của nhiều tài nguyên khác, ví dụ: AccountRelationship, Homepage, BusinessInfo, v.v.

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

account_name

string

Bắt buộc. Tên tài khoản mà con người đọc được. Hãy xem phần tên cửa hàngtên doanh nghiệp để biết thêm thông tin.

adult_content

bool

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 không.

time_zone

TimeZone

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

Khi ghi, time_zone sẽ đặt cả reporting_time_zonedisplay_time_zone.

Đối với các lượt đọc, time_zone luôn trả về display_time_zone. Nếu display_time_zone không tồn tại cho tài khoản của bạn, 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.

AccountAggregation

Loại này không có trường nào.

Trọng tải AccountAggregation.

AccountIssue

Một 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

Mức độ tác động của vấn đề này đối với nhiều đích đến.

detail

string

Thông tin chi tiết khác đã bản địa hoá về vấn đề này.

documentation_uri

string

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

ImpactedDestination

Mức độ ảnh hưởng của vấn đề đối với một đích đến.

Trường
impacts[]

Impact

Mức tác động (tiêu cực) của nhiều khu vực đối với đích đến nhất định.

reporting_context

ReportingContextEnum

Bối cảnh báo cáo bị ảnh hưởng.

Tác động

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

Trường
region_code

string

Mã vùng CLDR nơi áp dụng vấn đề này.

severity

Severity

Mức độ nghiêm trọng của vấn đề trên đích đến và khu vực.

Mức độ nghiêm trọng

Tất cả mức độ nghiêm trọng có thể có của vấn đề.

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

Địa chỉ

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

Trường
street_address

string

Phần địa chỉ ở cấp đường phố. Ví dụ: 111w 31st Street.

city

string

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

administrative_area

string

Bắt buộc. Phân khu 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 mã ZIP (Ví dụ: "94043").

region_code

string

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

AutofeedSettings

Tập hợp thông tin liên quan đến chế độ cài đặt nguồn cấp dữ liệu tự động.

Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của chế độ cài đặt nguồn cấp dữ liệu tự động. Định dạng: accounts/{account}/autofeedSettings.

enable_products

bool

Bắt buộc. Bật hoặc tắt tính năng thu thập dữ liệu sản phẩm thông qua nguồn cấp dữ liệu tự động cho tài khoản nhất định. Tài khoản nguồn cấp dữ liệu tự động phải đáp ứng một số điều kiện. Bạn có thể kiểm tra các điều kiện này thông qua trường eligible. Tài khoản đó không được là trang web thương mại. Khi bạn bật nguồn cấp dữ liệu tự động lần đầu tiên, các sản phẩm thường xuất hiện ngay lập tức. Khi bạn bật lại, có thể mất đến 24 giờ thì sản phẩm mới xuất hiện.

eligible

bool

Chỉ có đầu ra. Xác định xem người bán có đủ điều kiện để đăng ký nguồn cấp dữ liệu tự động hay không.

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

Tập hợp thông tin liên quan đến danh tính 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 màu sở hữu hay không. Trường không bắt buộc này chỉ dành cho những người bán có quốc gia kinh doanh được đặt thành US. Chính sách 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. Chỉ định xem 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 chỉ dành cho những người bán có quốc gia kinh doanh được đặt thành US. Chính sách 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 chỉ dành cho những người bán có quốc gia kinh doanh được đặt thành US. Chính sách 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ỹ Latinh sở hữu hay không. Trường không bắt buộc này chỉ dành cho những người bán có quốc gia kinh doanh được đặt thành US. Chính sách 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. Chỉ định xem doanh nghiệp có tự nhận là doanh nghiệp nhỏ hay không. Trường không bắt buộc này chỉ dành cho những người bán có quốc gia kinh doanh được đặt thành US. Điều khoản 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 một thuộc tính danh tính.

Trường
identity_declaration

IdentityDeclaration

Bắt buộc. Nội dung khai báo danh tính cho thuộc tính này.

IdentityDeclaration

Tất cả chế độ cài đặt có thể áp dụng liên quan đến việc khai báo danh tính.

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 được xác định bằng thuộc tính.
DOES_NOT_SELF_IDENTIFY_AS Cho biết tài khoản không xác định được thuộc tính.

PromotionsConsent

Tất cả chế độ cài đặt có thể áp dụng đối với các chương trình khuyến mãi liên quan đến danh tính doanh nghiệp.

Enum

BusinessInfo

Thông báo BusinessInfo chứa thông tin thiết yếu về hoạt động kinh doanh của người bán.

Thông báo này ghi lại các thông tin chi tiết chính về doanh nghiệp, chẳng hạn như địa chỉ thực tế, thông tin liên hệ của bộ phận dịch vụ khách hàng và giá trị nhận dạng theo khu vực.

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. Chỉ hỗ trợ các trường region_code, address_lines, postal_code, administrative_arealocality. Tất cả các trường khác đều bị bỏ qua.

phone

PhoneNumber

Chỉ có đầu ra. 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 qua điện thoại của doanh nghiệp.

customer_service

CustomerService

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

korean_business_registration_number

string

Không bắt buộc. Số chứng nhận đăng ký kinh doanh tại Hàn Quốc gồm 10 chữ số, được phân tách bằng dấu gạch ngang theo định dạng: XXX-XX-XXXXX.

CarrierRate

Danh sách mức giá của nhà mạng mà main_table hoặc single_value có thể tham chiếu đến. Các dịch vụ của hãng vận chuyển được hỗ trợ được xác định tại https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.

Trường
name

string

Bắt buộc. Tên của mức giá của hãng vận chuyển. Phải là mã riêng biệ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 của dịch vụ vận chuyển theo mức giá của hãng vận chuyển này.

percentage_adjustment

string

Không bắt buộc. Hệ số mức phí vận chuyển theo hệ số nhân dưới dạng số ở dạng thập phân. Có thể là số âm. Ví dụ: "5.4" tăng tỷ lệ 5,4%, "-3" giảm tỷ lệ 3%.

flat_adjustment

Price

Không bắt buộc. Công cụ sửa đổi mức phí vận chuyển. Có thể là số âm. Ví dụ: { "amount_micros": 1, "currency_code" : "USD" } thêm 1 đô la vào giá, { "amount_micros": -3, "currency_code" : "USD" } xoá 3 đô la khỏi 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ủ cần xác nhận quyền sở hữu. Định dạng accounts/{account}/homepage

overwrite

bool

Không bắt buộc. Khi được đặt thành true, tuỳ chọn này sẽ xoá mọi thông báo xác nhận quyền sở hữu hiện có trên trang web được yêu cầu và thay thế bằng thông báo xác nhận quyền sở hữu của tài khoản gửi yêu cầu.

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[]
(deprecated)

CreateUserRequest

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

Trường này không còn được dùng nữa và sẽ không tồn tại sau khi API phát triển ra khỏi giai đoạn thử nghiệm. Thay vào đó, hãy sử dụng trường user.

user[]

AddUser

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

service[]

AddAccountService

Bắt buộc. Dịch vụ tài khoản giữa tài khoản cần tạo và tài khoản nhà cung cấp được khởi chạy trong quá trình tạo. Bạn cần cung cấp ít nhất một dịch vụ như vậy. Hiện tại, bạn chỉ có thể tạo tài khoản phụ chứ không thể tạo tài khoản độc lập thông qua phương thức này.account_aggregation Có thể cung cấp thêm các dịch vụ account_management hoặc product_management.

AddAccountService

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

Trường
Trường hợp hợp nhất service_type. Loại dịch vụ cần thêm. service_type chỉ có thể là một trong những loại sau:
account_aggregation

AccountAggregation

Nhà cung cấp là một trang web tổng hợp cho tài khoản. Trọng tải cho loại dịch vụ Tổng hợp tài khoản.

provider

string

Bắt buộc. Nhà cung cấp dịch vụ. Tham chiếu đến một tài khoản như providers/123 hoặc một nhà cung cấp dịch vụ nổi tiếng (một trong hai providers/GOOGLE_ADS hoặc providers/GOOGLE_BUSINESS_PROFILE).

AddUser

Hướng dẫn thêm người dùng vào tài khoản trong quá trình tạo.

Trường
user_id

string

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

user

User

Không bắt buộc. Thông tin chi tiết về người dùng cần thêm. Hiện tại, bạn chỉ có thể chỉ định quyền truy cập.

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

Không 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 có thể tìm thấy dịch vụ khách hàng.

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 đến dịch vụ khách hàng.

CutoffTime

Định nghĩa về thời điểm cắt giảm trong ngày làm việc.

Trường
hour

int32

Bắt buộc. Giờ của thời hạn đặt hàng mà khách hàng phải đặt hàng để đơn đặt hàng được xử lý trong cùng ngày.

minute

int32

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

time_zone

string

Bắt buộc. Mã 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}

force

bool

Không bắt buộc. Nếu bạn đặt thành true, tài khoản sẽ bị xoá ngay cả khi tài khoản đó cung cấp dịch vụ cho các tài khoản khác hoặc đã xử lý ưu đãi.

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 dành cho nhiều khía cạnh từ khi đặ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 (vị trí xuất phát của lô hàng) dựa trên chế độ cài đặt của hãng vận chuyển đã chọn. Khi bạn đặt thuộc tính này, bạn không được đặt bất kỳ 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 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 để vận chuyển. 0 có nghĩa là giao hàng 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 về thời điểm cắt giảm trong ngày làm việc. Nếu bạn không định cấu hình, thì thời gian cắt sẽ mặc định là 8:00 sáng theo Giờ chuẩn Thái Bình Dương.

min_handling_days

int32

Số ngày làm việc tối thiểu trước khi đơn đặt hàng được vận chuyển. 0 có nghĩa là vận chuyển cùng ngày, 1 có nghĩa là vận chuyển vào ngày tiếp theo. Bạn phải đặt hoặc không đặt "min_handling_days" và "max_handling_days" cùng một lúc.

max_handling_days

int32

Số ngày làm việc tối đa trước khi đơn đặt hàng được vận chuyển. 0 có nghĩa là vận chuyển cùng ngày, 1 có nghĩa là vận chuyển vào ngày tiếp theo. Phải lớn hơn hoặc bằng min_handling_days. Bạn phải đặt hoặc không đặt "min_handling_days" và "max_handling_days" cùng một lúc.

transit_time_table

TransitTable

Bảng thời gian vận chuyển, số ngày làm việc trong quá trình vận chuyển dựa trên phương diện 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 được đặ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, hệ thống sẽ giả định là từ thứ Hai đến thứ Sáu.

transit_business_day_config

BusinessDayConfig

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

DisableProgramRequest

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

Trường
name

string

Bắt buộc. Tên của chương trình mà bạn muốn tắt chế độ tham gia cho tài khoản nhất định. Định dạng accounts/{account}/programs/{program}

Khoảng cách

Bán kính giao hàng tối đa. Thông tin này chỉ bắt buộc đối với loại lô hàng 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, được tham số hoá để bao gồm dặm và kilômét.

Đơn vị

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

Enum
UNIT_UNSPECIFIED Đơn vị không được chỉ định
MILES Đơn vị tính là dặm
KILOMETERS Đơn vị tính bằng kilômét

EmailPreferences

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

Trường
name

string

Giá trị nhận dạng. Tên của EmailPreferences. Điểm cuối chỉ được hỗ trợ cho người dùng đã xác thực.

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 hay và các phương pháp hay nhất.

OptInState

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

Enum
OPT_IN_STATE_UNSPECIFIED Chưa chỉ định trạng thái chọn tham gia.
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 nhận (chỉ áp dụng cho một số quốc gia).

EnableProgramRequest

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

Trường
name

string

Bắt buộc. Tên của chương trình mà bạn muốn bật tính năng tham gia cho tài khoản nhất định. Đị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 của tài khoản cần truy xuất. Định dạng accounts/{account}

GetAutofeedSettingsRequest

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

Trường
name

string

Bắt buộc. Tên tài nguyên của chế độ cài đặt nguồn cấp dữ liệu tự động. Định dạng accounts/{account}/autofeedSettings

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

Yêu cầu thông báo 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 của 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 của 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 của 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} Định dạng giá trị nhận dạng là: {TermsOfServiceKind}-{country}

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 của 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 gồm các tiêu đề hàng hoặc cột cho 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á bao gồm cả thuế cho đơn đặt hàng. Giá trị của giá cuối cùng có thể là vô hạn bằng cách đặt price amount_micros = -1. Ví dụ: [{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}] đại diện 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 bạn 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 bao gồm cả trọng số đơn đặt hàng. Giá trị của trọng số cuối cùng có thể là vô cực bằng cách đặt price amount_micros = -1. Ví dụ: [{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}] đại diện cho các tiêu đề "<= 10kg", "<= 50kg" và "> 50kg". Tất cả cá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 bạn chưa đặt tất cả các trường khác.

number_of_items[]

string

Bắt buộc. Danh sách các giới hạn trên bao gồm số lượng mục. Giá trị cuối cùng có thể là "infinity". Ví dụ: ["10", "50", "infinity"] đại diện 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 bạn 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 tham chiế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 bạn chưa đặt tất cả các trường khác.

locations[]

LocationIdSet

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

Trang chủ

Thông báo Homepage đại diện cho trang chủ cửa hàng của người bán trong hệ thống.

Trang chủ của người bán là miền chính nơi khách hàng tương tác với cửa hàng của họ.

Trang chủ có thể được xác nhận quyền sở hữu và xác minh làm bằng chứng về quyền sở hữu, đồng thời cho phép người bán sử dụng các tính năng yêu cầu trang web đã được xác minh. Để biết thêm thông tin, hãy xem bài viết Tìm hiểu về quy trình xác minh URL của cửa hàng trực tuyến.

Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của 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. Hãy xem https://support.google.com/merchants/answer/176793.

uri

string

Bắt buộc. URI (thường là URL) của trang chủ của 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à sản phẩm này sẽ được chèn vào. Đị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. Phần tử mẹ sở hữu tập hợp vấn đề này. Định dạng accounts/{account}

page_size

int32

Không bắt buộc. Số 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 không chỉ định, hệ thống sẽ trả về tối đa 50 người dùng. Giá trị tối đa là 100; các giá trị trên 100 sẽ được ép 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 giá trị 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 bằng 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

string

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, hệ thống sẽ sử dụng "America/Los_Angeles".

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 đã 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 bạn bỏ qua trường này, thì sẽ không có trang tiếp theo.

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 không chỉ định, hệ thống sẽ trả về tối đa 250 tài khoản. Giá trị tối đa là 500; các giá trị trên 500 sẽ được chuyển đổi 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 giá trị 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. Chỉ trả về những tài khoản khớp với bộ lọc. Để biết thêm thông tin chi tiết, hãy xem tài liệu tham khảo về cú pháp bộ lọc.

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 bạn bỏ qua trường này, 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 mà bạn muố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 nhất định ít hơn pageSize. Giá trị mặc định là 10. Giá trị tối đa là 100; Nếu bạn chỉ định một giá trị cao hơn giá trị tối đa, thì pageSize sẽ mặc định là giá trị tối đa

page_token

string

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 được 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 bạn bỏ qua trường này, 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 cầ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ố lượng chương trình tối đa cần trả về trong một phản hồi. Nếu không được chỉ định (hoặc 0), hệ thống sẽ sử dụng kích thước mặc định là 1000. Giá trị tối đa là 1000; các giá trị trên 1000 sẽ được chuyển đổi 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 giá trị 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 cho tài khoản đã cho.

next_page_token

string

Một 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 bạn bỏ qua trường này, 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ị tối đa là 1000; các giá trị trên 1000 sẽ được chuyển đổi 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 giá trị 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 đượ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 bạn bỏ qua trường này, 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. Nhà cung cấp dịch vụ tổng hợp. Định dạng providers/{providerId}

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 không chỉ định, hệ thống sẽ trả về tối đa 250 tài khoản. Giá trị tối đa là 500; các giá trị trên 500 sẽ được chuyển đổi 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 giá trị 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ẹ nhất định là tài khoản tổng 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 bạn bỏ qua trường này, 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. Thành phầ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 không chỉ định, hệ thống sẽ trả về tối đa 50 người dùng. Giá trị tối đa là 100; các giá trị trên 100 sẽ được ép 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 giá trị 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 bạn bỏ qua trường này, thì sẽ không có trang tiếp theo.

LocationIdSet

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

Trường
location_ids[]

string

Bắt buộc. Danh sách mã vị trí không trống. Tất cả đều 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 theo cửa hàng cho loại phương thức thực hiện đơn hàng là đến lấy hàng.

Trường
store_code_set_with_movs[]

StoreCodeSetWithMov

Bắt buộc. Danh sách các nhóm mã cửa hàng có cùng giá trị đơn đặt hàng tối thiểu (MOV). Bạn phải có ít nhất hai tập hợp và tập hợp cuối cùng phải trống, nghĩa là "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 trên tất cả các bộ. 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 nhóm mã cửa hàng có cùng giá trị đơn đặt hàng tối thiểu. Bạn phải có ít nhất hai tập hợp và tập hợp cuối cùng phải trống, nghĩa là "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 trên tất cả các bộ. 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 mã cửa hàng duy nhất hoặc để trống cho mã tổng hợp.

value

Price

Giá trị đơn đặ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ên mạng. Mã này hiện được dùng để thể hiện chính sách trả lại hàng cho quảng cáo và chương trình 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

Bắt buộc. Không thể thay đổi. Trường này đại diện cho nhãn duy nhất do người dùng xác định của chính sách trả lại hàng. Xin lưu ý rằng bạn không thể sử dụng cùng một nhãn trong nhiều chính sách trả lại hàng 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ể, 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 phần 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

Bắt buộc. Không thể thay đổi. Quốc gia bán áp dụng chính sách trả lại hàng. Giá trị phải là mã ISO 3166 gồm 2 chữ cái hợp lệ.

policy

Policy

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

seasonal_overrides[]

SeasonalOverride

Không bắt buộc. Trường hợp ngoại lệ đối với chính sách chung cho các đơn đặt hàng được đặt trong một khoảng thời gian cụ thể.

restocking_fee

RestockingFee

Phí nhập kho lại áp dụng cho tất cả danh mục lý do trả lại hàng. Giá trị này sẽ được coi là phí nhập kho miễn phí nếu bạn không đặt giá trị.

return_methods[]

ReturnMethod

Phương thức trả lại hàng mà khách hàng có thể sử dụng để trả lại mặt hàng. Bạn phải điền giá trị này, trừ phi loại chính sách trả lại hàng là noReturns.

item_conditions[]

ItemCondition

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

return_shipping_fee

ReturnShippingFee

Phí vận chuyển trả lại hàng. 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

Bắt buộc. 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. Đó phải là một URL hợp lệ.

accept_defective_only

bool

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

process_refund_days

int32

Trường này chỉ định số ngày mà người bán cần để xử lý các khoản tiền hoàn lại. Trường này là 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 đổi sản phẩm hay không. Đây là trường bắt buộc.

ItemCondition

Tình trạng của mặt hàng hiện có.

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

Chính sách

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

Trường
type

Type

Loại chính sách.

days

int64

Số ngày mà khách hàng có thể trả lại mặt hàng sau khi giao hàng, trong đó một ngày được xác định là 24 giờ sau dấu thời gian giao hàng. Bắt buộc đối với các giá trị trả về 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 không được sử dụng.
NUMBER_OF_DAYS_AFTER_DELIVERY Số ngày mà khách hàng có thể trả lại hàng sau khi giao hàng.
NO_RETURNS Không hỗ trợ trả lại hàng.
LIFETIME_RETURNS Cho phép trả lại hàng trọn đời.

RestockingFee

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

Trường

Trường hợp hợp nhất type.

type chỉ có thể là một trong những loại sau:

fixed_fee

Price

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

micro_percent

int32

Tỷ lệ phần trăm trong tổng giá tính theo micro. 15.000.000 có nghĩa là bạn sẽ bị tính phí 15% tổng giá.

ReturnMethod

Các phương thức trả về có sẵn.

Enum
RETURN_METHOD_UNSPECIFIED Giá trị mặc định. Giá trị này không đượ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 Trả lại tại quầy.

ReturnShippingFee

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

Trường
type

Type

Bắt buộc. Loại phí vận chuyển trả lại hàng.

fixed_fee

Price

Số tiền cố định của phí vận chuyển trả lại. Giá trị này chỉ áp dụng khi loại là FIXED. Chúng tôi sẽ coi phí vận chuyển trả lại hàng là miễn phí nếu loại là FIXED và bạn không đặ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 không được sử dụng.
FIXED Phí vận chuyển trả lại là một giá trị cố định.
CUSTOMER_PAYING_ACTUAL_FEE Khách hàng sẽ trả phí vận chuyển trả lại hàng thực tế.

SeasonalOverride

Tiếp theo: 5

Trường
label

string

Bắt buộc. Tên hiển thị của cơ chế ghi đè theo mùa này trong Merchant Center.

begin

Date

Bắt buộc. Xác định phạm vi ngày áp dụng giá trị thay thế theo mùa này. Cả ngày bắt đầu và ngày kết thúc đều phải có cả hai mốc và phải ở định dạng ngày thập phân, ví dụ: 20250115. Ngày của các ngoại lệ theo mùa không được trùng lặp.

end

Date

Bắt buộc. ngày kết thúc ngoại lệ theo mùa (bao gồm cả ngày này).

policy

Policy

Bắt buộc. Chính sách trả lại hàng cho phạm vi ngày đã cho.

PhoneVerificationState

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

Enum
PHONE_VERIFICATION_STATE_UNSPECIFIED Giá trị mặc định. Giá trị này không được sử dụng.
PHONE_VERIFICATION_STATE_VERIFIED Điện thoại đã được xác minh.
PHONE_VERIFICATION_STATE_UNVERIFIED Điện thoại 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.

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 về điều này là chương trình Trang thông tin miễn phí về sản phẩm, cho phép sản phẩm trong cửa hàng của người bán xuất hiện miễn phí 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 xác định 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 khu vực đó.

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

unmet_requirements[]

Requirement

Chỉ có đầu ra. Những yêu cầu mà tài khoản chưa đáp ứng và đ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ụ thể để 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 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 việc không đáp ứng yêu cầu này.

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

Tiểu bang

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

Enum
STATE_UNSPECIFIED Giá trị mặc định. Giá trị này không được sử dụng.
NOT_ELIGIBLE Tài khoản này 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 đã được bật cho tài khoản.

RateGroup

Định nghĩa nhóm mức phí vận chuyển. Chỉ phần tử cuối cùng được phép có applicable_shipping_labels trống, nghĩa là "mọi phần tử 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 áp dụng cho nhóm mức phí này. Đây là một câu lệnh loại trừ: chỉ cần một trong các nhãn khớp thì nhóm mức giá mới áp dụng. Chỉ có thể để trống đối với nhóm mức 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 con được main_table tham chiếu đến. Chỉ có thể đặt nếu bạn đặt main_table.

carrier_rates[]

CarrierRate

Không bắt buộc. Danh sách mức giá của nhà mạng có thể được tham chiếu bằng main_table hoặc single_value.

single_value

Value

Giá trị của nhóm giá (Ví dụ: giá cố định 10 USD). Chỉ có thể đặt nếu bạn không đặt main_tablesubtables.

main_table

Table

Một bảng xác định nhóm giá, khi single_value không đủ rõ ràng. Chỉ có thể đặt nếu bạn không đặt single_value.

name

string

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

Khu vực

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

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 các mục tiêu theo địa lý xác định 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 các mục tiêu theo địa lý xác định khu vực.

Trường
geotarget_criteria_ids[]

int64

Bắt buộc. Danh sách mã vị trí không trống. Tất cả các địa điểm này phải thuộc cùng một loại địa điểm (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 vào 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 cho nhóm mã bưu chính.

postal_codes[]

PostalCodeRange

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

PostalCodeRange

Một phạm vi mã bưu chính xác định 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ị ví dụ: 94108, 9410*, 9*.

end

string

Không bắt buộc. Mã bưu chính hoặc mẫu ở dạng prefix* biểu thị giới hạn trên bao gồm của dải xác định khu vực. Chuỗi này phải có cùng độ dài với postalCodeRangeBegin: nếu postalCodeRangeBegin là mã bưu chính thì postalCodeRangeEnd cũng phải là mã bưu chính; nếu postalCodeRangeBegin là mẫu thì postalCodeRangeEnd phải là mẫu có cùng độ dài tiền tố. Không bắt buộc: nếu bạn không đặt, thì khu vực được xác định là tất cả mã bưu chính khớp với postalCodeRangeBegin.

Bắt buộc

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

Trường
terms_of_service

string

termsOfService cần được chấp nhận.

tos_file_uri

string

URL đầy đủ của tệp điều khoản dịch vụ. Trường này giống với TermsOfService.file_uri, chỉ được thêm vào đây để 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 lấy đị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

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

kind

TermsOfServiceKind

Bắt buộc. Loại áp dụng cho phiên bản điều khoản dịch vụ này.

Hàng

Bao gồm danh sách các ô.

Trường
cells[]

Value

Bắt buộc. Danh sách các ô tạo nên hàng. Phải có cùng độ dài với 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 những quốc gia áp dụng dịch vụ.

rate_groups[]

RateGroup

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

loyalty_programs[]

LoyaltyProgram

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

service_name

string

Bắt buộc. Tên dịch vụ ở dạng tuỳ ý. Phải là duy nhất trong tài khoản mục tiêu.

active

bool

Bắt buộc. Một boolean cho thấy trạng thái đang 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 cho dịch vụ này. Phải khớp với giá trong các nhóm giá.

delivery_time

DeliveryTime

Bắt buộc. Thời gian dành cho nhiều khía cạnh từ khi đặ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ị đơn đặt hàng tối thiểu cho dịch vụ này. Nếu được đặt, thuộc tính này cho biết 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 cùng với minimum_order_value_table.

minimum_order_value_table

MinimumOrderValueTable

Bảng giá trị đơn đặt hàng tối thiểu theo cửa hàng cho loại phương thức thực hiện đơn hàng là đến lấy hàng. Không thể đặt cùng với minimum_order_value.

store_config

StoreConfig

Danh sách các cửa hàng phân phối sản phẩm của bạn. Trường này chỉ hợp lệ cho loại lô hàng 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 trong 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 mà bạn 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 phần của 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 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 cấp.

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 chỉ định loại lô hàng.
DELIVERY Dịch vụ này vận chuyển đơn đặt hàng đến địa chỉ do khách hàng chọn.
LOCAL_DELIVERY Dịch vụ này vận chuyển đơn đặt hàng đến địa chỉ do khách hàng chọn. Đơn đặt hàng được vận chuyển từ một cửa hàng địa phương ở gần bạn.
COLLECTION_POINT Dịch vụ này vận chuyển đơn đặt 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ác cửa hàng phân phối sản phẩm của bạn. Trường này chỉ hợp lệ cho loại lô hàng 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à true.

store_service_type

StoreServiceType

Cho biết liệu tất cả cửa hàng hay một số cửa hàng mà 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 trong ngày.

service_radius

Distance

Bán kính giao hàng tối đa. Thông tin này chỉ bắt buộc đối với loại lô hàng 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 trong ngày.

Trường
local_cutoff_time

LocalCutoffTime

Thời điểm 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 phương thức thực hiện đơn hàng là giao hàng tại địa phương. Biểu thị thời gian cắt giảm dưới dạng số giờ trước khi cửa hàng đóng cửa. 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 n+1 ngày khi họ thiết lập dịch vụ vận chuyển là giao hàng tại địa phương trong n ngày. Ví dụ: nếu dịch vụ vận chuyển xác định giao hàng cùng ngày và đã quá hạn chót, thì việc đặt trường này thành true sẽ khiến mức phí dịch vụ vận chuyển được tính toán trả về NO_DELIVERY_POST_CUTOFF. Trong cùng ví dụ này, việc đặt trường này thành false sẽ dẫn đến thời gian vận chuyển được tính là một ngày. Lựa chọn này chỉ dành cho dịch vụ giao hàng tại địa phương.

LocalCutoffTime

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

Trường
hour

int64

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

minute

int64

Bạn phải đặt đơn hàng giao hàng tại địa phương trong vòng vài phút để đơn hàng được xử lý trong cùng ngày.

StoreServiceType

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

Enum
STORE_SERVICE_TYPE_UNSPECIFIED Chưa chỉ định loại dịch vụ tại cửa hàng.
ALL_STORES Cho biết liệu tất cả cửa hàng (hiện tại và trong tương lai) mà 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 liệt kê trong 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 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 mục tiêu.

warehouses[]

Warehouse

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

etag

string

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

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

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

  3. Sửa đổi thành thông tin cài đặt phí vận chuyển mà bạn muốn.

  4. Gọi phương thức chèn với thông tin chế độ cài đặt thông tin vận chuyển mong muốn cùng với etag thu được từ 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ì etag thay đổi mỗi khi dữ liệu 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 etag mới.

Bảng

Một bảng xác định nhóm giá, khi single_value không đủ rõ ràng.

Trường
rows[]

Row

Bắt buộc. Danh sách các hàng tạo nên bảng. Phải có cùng độ dài với 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ủa các cột trong bảng. Không bắt buộc: nếu không được đặt, bảng sẽ chỉ có một phương diện.

TermsOfService

Thông báo TermsOfService đại diện cho một phiên bản cụ thể của điều khoản dịch vụ mà người bán phải chấp nhận để sử dụng một số tính năng hoặc dịch vụ (xem https://support.google.com/merchants/answer/160173).

Thông báo này rất quan trọng trong quy trình làm quen, giúp đảm bảo rằng người bán đồng ý với các thoả thuận pháp lý cần thiết để sử dụng dịch vụ. Người bán có thể truy xuất điều khoản dịch vụ mới nhất cho một kindregion nhất định thông qua RetrieveLatestTermsOfService, đồng thời chấp nhận các điều khoản đó nếu cần thông qua AcceptTermsOfService.

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 do CLDR xác định. Đây là quốc gia mà Điều khoản dịch vụ áp dụng riêng cho quốc gia đó hoặc 001 khi bạn có thể ký cùng một TermsOfService ở bất kỳ quốc gia nào. Tuy nhiên, xin lưu ý rằng khi ký Thoả thuận dịch vụ áp dụng trên toàn cầu, bạn vẫn phải cung cấp một quốc gia cụ thể (đây phải là quốc gia nơi doanh nghiệp của người bán hoạt động hoặc quốc gia tham gia chương trình).

kind

TermsOfServiceKind

Loại áp dụng cho 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à bên ngoài hay không. Người bán chỉ có thể đồng ý với các phiên bản điều khoản dịch vụ bên ngoài thông qua các quy trình bên ngoài chứ không thể đồng ý trực tiếp 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 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 cho 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ụ: đã chấp nhận sẽ được điền, nếu không thì trường này sẽ trống
  • Nếu người bán phải ký thoả thuận dịch vụ: bắt buộc sẽ được điền, nếu không thì trường này sẽ trống.

Xin lưu ý rằng bạn có thể sử dụng cả giá trị bắt buộcđượ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. Tài khoản cần chấp nhận điều khoản dịch vụ required trước valid_until để tiếp tục có thoả thuận hợp lệ. Khi chấp nhận điều khoản dịch vụ mới, chúng tôi muốn bên thứ ba hiển thị văn bản liên kết với thoả thuận điều khoản dịch vụ nhất định (url đế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. Bạn có thể chấp nhận điều khoản dịch vụ bằng cách gọi accept trên tài nguyên 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: accounts/{account}/termsOfServiceAgreementState/{identifier} Định dạng giá trị nhận dạng là: {TermsOfServiceKind}-{country} Ví dụ: giá trị nhận dạng có thể là: MERCHANT_CENTER-US

region_code

string

Mã vùng do https://cldr.unicode.org/ xác định. Đâ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 kết với phiên bản cụ thể.

accepted

Accepted

Điều khoản dịch vụ đã chấp nhận của loại này và cho region_code được liên kết

required

Required

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

TermsOfServiceKind

Loại TermsOfService.

Enum
TERMS_OF_SERVICE_KIND_UNSPECIFIED Giá trị mặc định. Giá trị này không đượ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 trong quá trình vận chuyển dựa trên phương diện 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 được đặ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 tham chiế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 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 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-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-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 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 quyền sở hữu. Đị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

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

Các trường sau đây được hỗ trợ (trong cả snake_caselowerCamelCase):

  • account_name
  • adult_content
  • language_code
  • time_zone

UpdateAutofeedSettingsRequest

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

Trường
autofeed_settings

AutofeedSettings

Bắt buộc. Phiên bản mới của chế độ cài đặt nguồn cấp dữ liệu tự động.

update_mask

FieldMask

Bắt buộc. Danh sách các trường đang đượ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

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

Các trường sau đây được hỗ trợ (trong cả snake_caselowerCamelCase):

  • black_owned
  • latino_owned
  • promotions_consent
  • small_business
  • veteran_owned
  • women_owned

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

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

Các trường sau đây được hỗ trợ (trong cả snake_caselowerCamelCase):

  • address
  • customer_service
  • korean_business_registration_number

UpdateEmailPreferencesRequest

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

Trường
email_preferences

EmailPreferences

Bắt buộc. Cập nhật Lựa chọn ưu tiên về email.

update_mask

FieldMask

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

Các trường sau đây được hỗ trợ (trong cả snake_caselowerCamelCase):

  • news_and_tips

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

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

Các trường sau đây được hỗ trợ (trong cả snake_caselowerCamelCase):

  • uri

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

Sử dụng me để tham chiếu đến địa chỉ email của riêng bạn, ví dụ: accounts/{account}/users/me.

update_mask

FieldMask

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

Các trường sau đây được hỗ trợ (trong cả snake_caselowerCamelCase):

  • access_rights

Người dùng

Thông báo User đại diện cho một người dùng được liên kết với một tài khoản Merchant Center. Thuộc tính này dùng để quản lý quyền của người dùng và quyền truy cập trong tài khoản. Để biết thêm thông tin, hãy xem bài viết Câu hỏi thường gặp về người dùng và cấp truy cập.

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/{email}

Sử dụng me để tham chiếu đến địa chỉ email của riêng bạn, ví dụ: accounts/{account}/users/me.

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 không đượ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 ô trong bảng nhóm giá. Bạn 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 giá trị là đúng, thì sản phẩm không thể được vận chuyển. Phải là true khi được đặt, chỉ có thể đặt nếu tất cả các trường khác đều không được đặt.

flat_rate

Price

Mức phí cố định. Chỉ có thể đặt nếu bạn 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ố theo ký hiệu thập phân (ví dụ: "5.4"). Bạn chỉ có thể đặt giá trị này nếu không đặt tất cả các trường khác.

carrier_rate

string

Tên của mức giá của hãng vận chuyển đề cập đến mức giá của hãng vận chuyển được xác định trong cùng một nhóm giá. Chỉ có thể đặt nếu bạn 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 ô bảng (ví dụ: không phải cho các giá trị đơn lẻ) và chỉ khi tất cả các trường khác chưa được đặt.

Nhà kho

Kho thực hiện đơn hàng, nơi lưu trữ và xử lý khoảng không quảng cáo.

Trường
name

string

Bắt buộc. Tên kho. 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.

cutoff_time

WarehouseCutoffTime

Bắt buộc. Thời điểm muộn nhất trong ngày mà bạn có thể chấp nhận và bắt đầu xử lý đơn đặt hàng. 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.

handling_days

int64

Bắt buộc. Số ngày cần thiết để kho này đóng gói và vận chuyển một mặt hàng. Giá này ở cấp kho, nhưng có thể được ghi đè ở cấp mặt hàng dựa trên các thuộc tính của một 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, thì theo mặc định, ngày bắt đầu sẽ là thứ Hai đến thứ Sáu.

WarehouseBasedDeliveryTime

Cho biết thời gian giao hàng phải được tính theo từng kho (vị trí xuất phát của lô hàng) dựa trên chế độ cài đặt của hãng vận chuyển đã chọn. Khi đặt trường 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 delivery_time.

Trường
carrier

string

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

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 của dịch vụ phải có trong danh sách eddSupportedServices.

warehouse

string

Bắt buộc. Tên kho. Giá trị này phải khớp với [warehouse][ShippingSetting.warehouses.name]

WarehouseCutoffTime

Thời điểm muộn nhất trong ngày mà bạn có thể chấp nhận và bắt đầu xử lý đơn đặt hàng. 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.

Trường
hour

int32

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

minute

int32

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