Chỉ mục
AccountIssueService
(giao diện)AccountsService
(giao diện)BusinessIdentityService
(giao diện)BusinessInfoService
(giao diện)EmailPreferencesService
(giao diện)HomepageService
(giao diện)OnlineReturnPolicyService
(giao diện)ProgramsService
(giao diện)RegionsService
(giao diện)ShippingSettingsService
(giao diện)TermsOfServiceAgreementStateService
(giao diện)TermsOfServiceService
(giao diện)UserService
(giao diện)AcceptTermsOfServiceRequest
(thông báo)Accepted
(thông báo)AccessRight
(enum)Account
(thông báo)AccountIssue
(thông báo)AccountIssue.ImpactedDestination
(thông báo)AccountIssue.ImpactedDestination.Impact
(thông báo)AccountIssue.Severity
(enum)Address
(thông báo)BusinessDayConfig
(thông báo)BusinessDayConfig.Weekday
(enum)BusinessIdentity
(thông báo)BusinessIdentity.IdentityAttribute
(thông báo)BusinessIdentity.IdentityAttribute.IdentityDeclaration
(enum)BusinessIdentity.PromotionsConsent
(enum)BusinessInfo
(thông báo)CarrierRate
(thông báo)ClaimHomepageRequest
(thông báo)CreateAndConfigureAccountRequest
(thông báo)CreateAndConfigureAccountRequest.AcceptTermsOfService
(thông báo)CreateAndConfigureAccountRequest.AddAccountService
(thông báo)CreateRegionRequest
(thông báo)CreateUserRequest
(thông báo)CustomerService
(thông báo)CutoffTime
(thông báo)DeleteAccountRequest
(thông báo)DeleteRegionRequest
(thông báo)DeleteUserRequest
(thông báo)DeliveryTime
(thông báo)DisableProgramRequest
(thông báo)Distance
(thông báo)Distance.Unit
(enum)EmailPreferences
(thông báo)EmailPreferences.OptInState
(enum)EnableProgramRequest
(thông báo)GetAccountRequest
(thông báo)GetBusinessIdentityRequest
(thông báo)GetBusinessInfoRequest
(thông báo)GetEmailPreferencesRequest
(thông báo)GetHomepageRequest
(thông báo)GetOnlineReturnPolicyRequest
(thông báo)GetProgramRequest
(thông báo)GetRegionRequest
(thông báo)GetShippingSettingsRequest
(thông báo)GetTermsOfServiceAgreementStateRequest
(thông báo)GetTermsOfServiceRequest
(thông báo)GetUserRequest
(thông báo)Headers
(thông báo)Homepage
(thông báo)InsertShippingSettingsRequest
(thông báo)ListAccountIssuesRequest
(thông báo)ListAccountIssuesResponse
(thông báo)ListAccountsRequest
(thông báo)ListAccountsResponse
(thông báo)ListOnlineReturnPoliciesRequest
(thông báo)ListOnlineReturnPoliciesResponse
(thông báo)ListProgramsRequest
(thông báo)ListProgramsResponse
(thông báo)ListRegionsRequest
(thông báo)ListRegionsResponse
(thông báo)ListSubAccountsRequest
(thông báo)ListSubAccountsResponse
(thông báo)ListUsersRequest
(thông báo)ListUsersResponse
(thông báo)LocationIdSet
(thông báo)MinimumOrderValueTable
(thông báo)MinimumOrderValueTable.StoreCodeSetWithMov
(thông báo)OnlineReturnPolicy
(thông báo)OnlineReturnPolicy.ItemCondition
(enum)OnlineReturnPolicy.Policy
(thông báo)OnlineReturnPolicy.Policy.Type
(enum)OnlineReturnPolicy.RestockingFee
(thông báo)OnlineReturnPolicy.ReturnMethod
(enum)OnlineReturnPolicy.ReturnShippingFee
(thông báo)OnlineReturnPolicy.ReturnShippingFee.Type
(enum)PhoneVerificationState
(enum)Program
(thông báo)Program.Requirement
(thông báo)Program.State
(enum)RateGroup
(thông báo)Region
(thông báo)Region.GeoTargetArea
(thông báo)Region.PostalCodeArea
(thông báo)Region.PostalCodeArea.PostalCodeRange
(thông báo)Required
(thông báo)RetrieveForApplicationTermsOfServiceAgreementStateRequest
(thông báo)RetrieveLatestTermsOfServiceRequest
(thông báo)Row
(thông báo)Service
(thông báo)Service.LoyaltyProgram
(thông báo)Service.LoyaltyProgram.LoyaltyProgramTiers
(thông báo)Service.ShipmentType
(enum)Service.StoreConfig
(thông báo)Service.StoreConfig.CutoffConfig
(thông báo)Service.StoreConfig.CutoffConfig.LocalCutoffTime
(thông báo)Service.StoreConfig.StoreServiceType
(enum)ShippingSettings
(thông báo)Table
(thông báo)TermsOfService
(thông báo)TermsOfServiceAgreementState
(thông báo)TermsOfServiceKind
(enum)TransitTable
(thông báo)TransitTable.TransitTimeRow
(thông báo)TransitTable.TransitTimeRow.TransitTimeValue
(thông báo)UnclaimHomepageRequest
(thông báo)UpdateAccountRequest
(thông báo)UpdateBusinessIdentityRequest
(thông báo)UpdateBusinessInfoRequest
(thông báo)UpdateEmailPreferencesRequest
(thông báo)UpdateHomepageRequest
(thông báo)UpdateRegionRequest
(thông báo)UpdateUserRequest
(thông báo)User
(thông báo)User.State
(enum)Value
(thông báo)Warehouse
(thông báo)WarehouseBasedDeliveryTime
(thông báo)WarehouseCutoffTime
(thông báo)
AccountIssueService
Dịch vụ hỗ trợ API AccountIssueService
.
ListAccountIssues |
---|
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.
|
AccountsService
Dịch vụ hỗ trợ API Tài khoản.
CreateAndConfigureAccount |
---|
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.
|
DeleteAccount |
---|
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ị.
|
GetAccount |
---|
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.
|
ListAccounts |
---|
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.
|
ListSubAccounts |
---|
Liệt kê tất cả các tài khoản phụ của một tài khoản nhiều khách hàng cụ thể. Đây là một trình bao bọc tiện lợi cho phương thức
|
UpdateAccount |
---|
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ị.
|
BusinessIdentityService
Dịch vụ hỗ trợ API thông tin nhận dạng doanh nghiệp.
GetBusinessIdentity |
---|
Truy xuất thông tin nhận dạng doanh nghiệp của một tài khoản.
|
UpdateBusinessIdentity |
---|
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ị.
|
BusinessInfoService
Dịch vụ hỗ trợ API thông tin doanh nghiệp.
GetBusinessInfo |
---|
Truy xuất thông tin doanh nghiệp của tài khoản.
|
UpdateBusinessInfo |
---|
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ị.
|
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 |
---|
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.
|
UpdateEmailPreferences |
---|
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.
|
HomepageService
Dịch vụ hỗ trợ API cho trang chủ của cửa hàng.
ClaimHomepage |
---|
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ề một 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à một 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).
|
GetHomepage |
---|
Truy xuất trang chủ của một cửa hàng.
|
UnclaimHomepage |
---|
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ị.
|
UpdateHomepage |
---|
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ị.
|
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 |
---|
Xem chính sách trả lại hàng hiện có.
|
ListOnlineReturnPolicies |
---|
Liệt kê tất cả các chính sách trả lại hàng hiện tại.
|
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 |
---|
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ị.
|
EnableProgram |
---|
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ị.
|
GetProgram |
---|
Truy xuất chương trình được chỉ định cho tài khoản.
|
ListPrograms |
---|
Truy xuất tất cả chương trình cho tài khoản.
|
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 |
---|
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ị.
|
DeleteRegion |
---|
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ị.
|
GetRegion |
---|
Truy xuất khu vực được xác định trong tài khoản Merchant Center.
|
ListRegions |
---|
Liệt kê các khu vực trong tài khoản Merchant Center của bạn.
|
UpdateRegion |
---|
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ị.
|
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 |
---|
Truy xuất thông tin về chế độ cài đặt thông tin vận chuyển.
|
InsertShippingSettings |
---|
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ị.
|
TermsOfServiceAgreementStateService
Dịch vụ hỗ trợ API TermsOfServiceAgreementState
.
GetTermsOfServiceAgreementState |
---|
Trả về trạng thái của thoả thuận điều khoản dịch vụ.
|
RetrieveForApplicationTermsOfServiceAgreementState |
---|
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.
|
TermsOfServiceService
Dịch vụ hỗ trợ API TermsOfService
.
AcceptTermsOfService |
---|
Chấp nhận một
|
GetTermsOfService |
---|
Truy xuất
|
RetrieveLatestTermsOfService |
---|
Truy xuất phiên bản mới nhất của
|
UserService
Dịch vụ hỗ trợ API người dùng.
CreateUser |
---|
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ị.
|
DeleteUser |
---|
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ị.
|
GetUser |
---|
Truy xuất người dùng tài khoản Merchant Center.
|
ListUsers |
---|
Liệt kê tất cả người dùng của một tài khoản Merchant Center.
|
UpdateUser |
---|
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ị.
|
AcceptTermsOfServiceRequest
Thông báo yêu cầu cho phương thức AcceptTermsOfService
.
Trường | |
---|---|
name |
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 |
account |
Bắt buộc. Tài khoản chấp nhận Điều khoản dịch vụ. |
region_code |
Bắt buộc. Mã vùng như được xác định theo 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 |
Trường termsOfService chấp nhận. |
accepted_by |
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 |
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 |
Giá trị nhận dạng. Tên tài nguyên của tài khoản. Định dạng |
account_id |
Chỉ có đầu ra. Mã tài khoản. |
account_name |
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 |
Liệu tài khoản này có chứa nội dung người lớn hay không. |
test_account |
Chỉ có đầu ra. Liệu đây có phải là tài khoản thử nghiệm hay không. |
time_zone |
Bắt buộc. Múi giờ của tài khoản. Khi ghi, Đối với lượt đọc, |
language_code |
Bắt buộc. Mã ngôn ngữ BCP-47 của tài khoản, chẳng hạn như |
AccountIssue
Trường | |
---|---|
name |
Giá trị nhận dạng. Tên tài nguyên của vấn đề về tài khoản. Định dạng |
title |
Tiêu đề đã bản địa hoá của vấn đề. |
severity |
Mức độ nghiêm trọng tổng thể của vấn đề. |
impacted_destinations[] |
Ảnh hưởng của vấn đề này đến nhiều trang đích. |
detail |
Thông tin chi tiết đã bản địa hoá thêm về vấn đề. |
documentation_uri |
Đườ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[] |
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 |
Ngữ cảnh báo cáo bị ảnh hưởng. |
Tác động
Tác động của vấn đề đối với một khu vực.
Trường | |
---|---|
region_code |
Mã vùng CLDR là nơi xảy ra vấn đề này. |
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. |
Địa chỉ
Địa chỉ giao hàng của kho hàng.
Trường | |
---|---|
street_address |
Một phần cấp đường phố của địa chỉ. Ví dụ: |
city |
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 |
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 |
Bắt buộc. Mã bưu chính hoặc ZIP (Ví dụ: "94043"). |
region_code |
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[] |
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 |
Giá trị nhận dạng. Tên tài nguyên của bản sắc doanh nghiệp. Định dạng |
promotions_consent |
Không bắt buộc. Việc các thuộc tính nhận diện có thể được dùng cho hoạt động quảng bá hay không. |
black_owned |
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 |
women_owned |
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 |
veteran_owned |
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 |
latino_owned |
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 |
small_business |
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 |
IdentityAttribute
Tất cả thông tin liên quan đến thuộc tính nhận diện.
Trường | |
---|---|
identity_declaration |
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 | |
---|---|
PROMOTIONS_CONSENT_UNSPECIFIED |
Giá trị mặc định cho biết không có lựa chọn nào được thực hiện. |
PROMOTIONS_CONSENT_GIVEN |
Cho biết rằng tài khoản này đã đồng ý cho phép dùng thông tin nhận dạng doanh nghiệp của họ để quảng bá. |
PROMOTIONS_CONSENT_DENIED |
Cho biết rằng tài khoản này không đồng ý cho phép Google dùng thông tin nhận dạng doanh nghiệp của họ cho các hoạt động quảng bá. |
BusinessInfo
Thu thập thông tin liên quan đến một doanh nghiệp.
Trường | |
---|---|
name |
Giá trị nhận dạng. Tên tài nguyên trong thông tin doanh nghiệp. Định dạng: |
address |
Không bắt buộc. Địa chỉ của doanh nghiệp. |
phone |
Chỉ có đầu ra. Số điện thoại của doanh nghiệp. |
phone_verification_state |
Chỉ có đầu ra. Trạng thái xác minh số điện thoại của doanh nghiệp. |
customer_service |
Không bắt buộc. Dịch vụ khách hàng của doanh nghiệp. |
korean_business_registration_number |
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ố, phân tách bằng dấu gạch ngang theo định dạng: XXX-XX-XXXXX. |
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 |
Bắt buộc. Tên mức phí của hãng vận chuyển. Phải riêng biệt cho mỗi nhóm giá. |
carrier |
Bắt buộc. Dịch vụ của nhà mạng, chẳng hạn như |
carrier_service |
Bắt buộc. Dịch vụ của nhà mạng, chẳng hạn như |
origin_postal_code |
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 |
Không bắt buộc. Hệ số sửa đổi mức phí vận chuyển dạng nhân dưới dạng một số trong ký hiệu thập phân. Có thể là giá trị âm. Ví dụ: |
flat_adjustment |
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ụ: |
ClaimHomepageRequest
Thông báo yêu cầu cho phương thức ClaimHomepage
.
Trường | |
---|---|
name |
Bắt buộc. Tên của trang chủ để xác nhận quyền sở hữu. Định dạng |
CreateAndConfigureAccountRequest
Thông báo yêu cầu cho phương thức CreateAndConfigureAccount
.
Trường | |
---|---|
account |
Bắt buộc. Tài khoản cần tạo. |
users[] |
Không bắt buộc. Người dùng cần thêm vào tài khoản. |
service[] |
Bắt buộc. 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 động 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, chúng tôi chỉ hỗ trợ |
accept_terms_of_service |
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 |
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 |
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à |
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 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 |
Nhà cung cấp là trang web tổng hợp cho tài khoản. |
provider |
Không bắt buộc. Nhà cung cấp dịch vụ. Định dạng |
CreateRegionRequest
Thông báo yêu cầu cho phương thức CreateRegion
.
Trường | |
---|---|
parent |
Bắt buộc. Tài khoản để tạo khu vực. Định dạng |
region_id |
Bắt buộc. Giá trị nhận dạng của khu vực, duy nhất cho tất cả các khu vực của cùng một tài khoản. |
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 |
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 |
user_id |
Bắt buộc. Địa chỉ email của người dùng (ví dụ: |
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 |
Không bắt buộc. URI nơi dịch vụ khách hàng có thể tìm thấy. |
email |
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 |
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 |
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 |
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 |
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 |
Bắt buộc. Tên của tài khoản cần xoá. Định dạng |
DeleteRegionRequest
Thông báo yêu cầu cho phương thức DeleteRegion
.
Trường | |
---|---|
name |
Bắt buộc. Tên của khu vực cần xoá. Định dạng |
DeleteUserRequest
Thông báo yêu cầu cho phương thức DeleteUser
.
Trường | |
---|---|
name |
Bắt buộc. Tên của người dùng cần xoá. Định dạng 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 |
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[] |
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 |
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 |
max_transit_days |
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 |
cutoff_time |
Đị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 |
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 |
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 |
transit_time_table |
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 |
handling_business_day_config |
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 |
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 DisabledProgram.
Trường | |
---|---|
name |
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 |
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 |
Giá trị số nguyên của khoảng cách. |
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 |
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 |
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 tùy chọn 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 |
Bắt buộc. Tên của chương trình cho phép tham gia đối với tài khoản cụ thể. Định dạng |
GetAccountRequest
Thông báo yêu cầu cho phương thức GetAccount
.
Trường | |
---|---|
name |
Bắt buộc. Tên tài khoản cần truy xuất. Định dạng |
GetBusinessIdentityRequest
Thông báo yêu cầu cho phương thức GetBusinessIdentity
.
Trường | |
---|---|
name |
Bắt buộc. Tên tài nguyên của bản sắc doanh nghiệp. Định dạng |
GetBusinessInfoRequest
Thông báo yêu cầu cho phương thức GetBusinessInfo
.
Trường | |
---|---|
name |
Bắt buộc. Tên tài nguyên trong thông tin doanh nghiệp. Định dạng: |
GetEmailPreferencesRequest
Thông báo yêu cầu cho phương thức GetEmailPreferences.
Trường | |
---|---|
name |
Bắt buộc. Tên của tài nguyên |
GetHomepageRequest
Thông báo yêu cầu cho phương thức GetHomepage
.
Trường | |
---|---|
name |
Bắt buộc. Tên của trang chủ cần truy xuất. Định dạng |
GetOnlineReturnPolicyRequest
Thông báo yêu cầu cho phương thức GetOnlineReturnPolicy
.
Trường | |
---|---|
name |
Bắt buộc. Tên chính sách trả lại hàng cần truy xuất. Định dạng |
GetProgramRequest
Thông báo yêu cầu cho phương thức GetProgram.
Trường | |
---|---|
name |
Bắt buộc. Tên chương trình cần truy xuất. Định dạng |
GetRegionRequest
Thông báo yêu cầu cho phương thức GetRegion
.
Trường | |
---|---|
name |
Bắt buộc. Tên khu vực cần truy xuất. Định dạng |
GetShippingSettingsRequest
Thông báo yêu cầu cho phương thức GetShippingSetting
.
Trường | |
---|---|
name |
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 |
GetTermsOfServiceAgreementStateRequest
Thông báo yêu cầu cho phương thức GetTermsOfServiceAgreementState
.
Trường | |
---|---|
name |
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: |
GetTermsOfServiceRequest
Thông báo yêu cầu cho phương thức GetTermsOfService
.
Trường | |
---|---|
name |
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 |
GetUserRequest
Thông báo yêu cầu cho phương thức GetUser
.
Trường | |
---|---|
name |
Bắt buộc. Tên người dùng cần truy xuất. Định dạng 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 |
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[] |
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ụ: |
weights[] |
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ụ: |
number_of_items[] |
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à |
postal_code_group_names[] |
Bắt buộc. Danh sách tên nhóm bưu chính. Giá trị cuối cùng có thể là |
locations[] |
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 |
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 |
claimed |
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 |
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 |
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 |
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 |
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 |
page_size |
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ị tối đa là 100; các giá trị lớn hơn 100 sẽ bị buộc thành 100 |
page_token |
Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi Khi phân trang, tất cả các tham số khác được cung cấp cho |
language_code |
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ư |
time_zone |
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ì "Mỹ/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[] |
Các vấn đề của tài khoản được chỉ định. |
next_page_token |
Mã thông báo có thể được gửi dưới dạng |
ListAccountsRequest
Thông báo yêu cầu cho phương thức ListAccounts
.
Trường | |
---|---|
page_size |
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 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 bị buộc thành 500. |
page_token |
Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi Khi phân trang, tất cả các tham số khác được cung cấp cho |
filter |
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[] |
Các tài khoản khớp với |
next_page_token |
Mã thông báo có thể được gửi dưới dạng |
ListOnlineReturnPoliciesRequest
Thông báo yêu cầu cho phương thức ListOnlineReturnPolicies
.
Trường | |
---|---|
parent |
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 |
page_size |
Không bắt buộc. Số lượng tài nguyên |
page_token |
Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi Khi phân trang, tất cả các tham số khác được cung cấp cho |
ListOnlineReturnPoliciesResponse
Thông báo phản hồi cho phương thức ListOnlineReturnPolicies
.
Trường | |
---|---|
online_return_policies[] |
Chính sách trả lại hàng đã truy xuất. |
next_page_token |
Mã thông báo có thể được gửi dưới dạng |
ListProgramsRequest
Thông báo yêu cầu đối với phương thức ListPrograms.
Trường | |
---|---|
parent |
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 |
page_size |
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ị tối đa là 1000; các giá trị lớn hơn 1000 sẽ bị buộc thành 1000. |
page_token |
Không bắt buộc. Mã thông báo tiếp tục, nhận được từ lệnh gọi |
ListProgramsResponse
Thông báo phản hồi cho phương thức ListPrograms.
Trường | |
---|---|
programs[] |
Các chương trình dành cho một tài khoản cụ thể. |
next_page_token |
Mã thông báo có thể được gửi dưới dạng |
ListRegionsRequest
Thông báo yêu cầu cho phương thức ListRegions
.
Trường | |
---|---|
parent |
Bắt buộc. Tài khoản để liệt kê các khu vực. Định dạng |
page_size |
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ị lớn hơn 1000 sẽ bị buộc thành 1000. |
page_token |
Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi Khi phân trang, tất cả các tham số khác được cung cấp cho |
ListRegionsResponse
Thông báo phản hồi cho phương thức ListRegions
.
Trường | |
---|---|
regions[] |
Các khu vực của người bán đã chỉ định. |
next_page_token |
Mã thông báo có thể được gửi dưới dạng |
ListSubAccountsRequest
Thông báo yêu cầu cho phương thức ListSubAccounts
.
Trường | |
---|---|
provider |
Bắt buộc. Tài khoản của cha mẹ. Định dạng |
page_size |
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 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 bị buộc thành 500. |
page_token |
Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi Khi phân trang, tất cả các tham số khác được cung cấp cho |
ListSubAccountsResponse
Thông báo phản hồi cho phương thức ListSubAccounts
.
Trường | |
---|---|
accounts[] |
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 |
Mã thông báo có thể được gửi dưới dạng |
ListUsersRequest
Thông báo yêu cầu cho phương thức ListUsers
.
Trường | |
---|---|
parent |
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 |
page_size |
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ị tối đa là 100; các giá trị lớn hơn 100 sẽ bị buộc thành 100 |
page_token |
Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi Khi phân trang, tất cả các tham số khác được cung cấp cho |
ListUsersResponse
Thông báo phản hồi cho phương thức ListUsers
.
Trường | |
---|---|
users[] |
Người dùng trong tài khoản được chỉ định. |
next_page_token |
Mã thông báo có thể được gửi dưới dạng |
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[] |
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[] |
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[] |
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 |
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 |
Giá trị nhận dạng. Tên của tài nguyên |
return_policy_id |
Chỉ có đầu ra. Mã chính sách trả lại hàng do Google tạo. |
label |
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[] |
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 |
Chính sách trả lại hàng. |
restocking_fee |
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[] |
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[] |
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 |
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 |
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 |
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 |
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 |
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. |
Chính sách
Các chính sách hiện có.
Trường | |
---|---|
type |
Loại chính sách. |
days |
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 |
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
|
|
fixed_fee |
Phí nhập lại hàng cố định. |
micro_percent |
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 |
Loại phí vận chuyển hàng trả lại. |
fixed_fee |
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à |
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 |
Giá trị nhận dạng. Tên tài nguyên của chương trình. Định dạng |
documentation_uri |
Chỉ có đầu ra. URL của trang trợ giúp Merchant Center mô tả chương trình. |
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[] |
Chỉ có đầu ra. Những 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 là |
unmet_requirements[] |
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 |
Chỉ có đầu ra. Tên yêu cầu. |
documentation_uri |
Chỉ có đầu ra. URL của một trang trợ giúp mô tả yêu cầu. |
affected_region_codes[] |
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 là |
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[] |
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[] |
Không bắt buộc. Danh sách các bảng phụ do |
carrier_rates[] |
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 |
single_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 |
Một bảng xác định nhóm giá, khi |
name |
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 |
Giá trị nhận dạng. Tên tài nguyên của khu vực. Định dạng |
postal_code_area |
Không bắt buộc. Danh sách mã bưu chính xác định khu vực. |
geotarget_area |
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 |
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 |
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 |
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[] |
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 |
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[] |
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 |
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 ô quy định khu vực. Giá trị mẫu: |
end |
Không bắt buộc. Mã bưu chính hoặc mẫu có dạng |
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 |
Trường termsOfService cần phải được chấp nhận. |
tos_file_uri |
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ỉ để cho thuận tiện. |
RetrieveForApplicationTermsOfServiceAgreementStateRequest
Thông báo yêu cầu cho phương thức RetrieveForApplicationTermsOfServiceAgreementState
.
Trường | |
---|---|
parent |
Bắt buộc. Tài khoản cần có Định dạng TermsOfServiceAgreementState: |
RetrieveLatestTermsOfServiceRequest
Thông báo yêu cầu cho phương thức RetrieveLatestTermsOfService
.
Trường | |
---|---|
region_code |
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 |
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[] |
Bắt buộc. Danh sách các ô tạo thành hàng. Phải có độ dài bằng |
Dịch vụ
Dịch vụ vận chuyển.
Trường | |
---|---|
delivery_countries[] |
Bắt buộc. Mã lãnh thổ CLDR của các quốc gia áp dụng dịch vụ. |
rate_groups[] |
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ó |
loyalty_programs[] |
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 |
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 |
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 |
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 |
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 |
Loại địa điểm mà dịch vụ này vận chuyển đơn đặt hàng đến. |
minimum_order_value |
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 |
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 |
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[] |
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 |
Đâ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 |
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[] |
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ì |
store_service_type |
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 |
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 |
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 |
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 |
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 |
no_delivery_post_cutoff |
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 |
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 |
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 |
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 |
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 |
services[] |
Không bắt buộc. Danh sách dịch vụ của tài khoản đích. |
warehouses[] |
Không bắt buộc. Danh sách các nhà kho có thể tham chiếu trong |
etag |
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:
|
Bảng
Một bảng xác định nhóm giá, khi single_value
không đủ biểu cảm.
Trường | |
---|---|
rows[] |
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ư |
name |
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 |
Bắt buộc. Tiêu đề của các hàng trong bảng. |
column_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. |
TermsOfService
TermsOfService
.
Trường | |
---|---|
name |
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 |
region_code |
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à |
kind |
Loại áp dụng phiên bản điều khoản dịch vụ này. |
external |
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 |
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 |
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: |
region_code |
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 |
Loại Điều khoản dịch vụ liên quan đến phiên bản cụ thể đó. |
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 |
Đ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[] |
Bắt buộc. Danh sách tên khu vực |
transit_time_labels[] |
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à |
rows[] |
Bắt buộc. Nếu chỉ có một nhóm phương diện |
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[] |
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 |
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 |
Phải lớn hơn hoặc bằng |
UnclaimHomepageRequest
Thông báo yêu cầu cho phương thức UnclaimHomepage
.
Trường | |
---|---|
name |
Bắt buộc. Tên của trang chủ cần huỷ xác nhận. Định dạng |
UpdateAccountRequest
Thông báo yêu cầu cho phương thức UpdateAccount
.
Trường | |
---|---|
account |
Bắt buộc. Phiên bản mới của tài khoản. |
update_mask |
Bắt buộc. Danh sách 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 |
Bắt buộc. Phiên bản mới của thông tin nhận dạng doanh nghiệp. |
update_mask |
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 |
Bắt buộc. Phiên bản mới của thông tin doanh nghiệp. |
update_mask |
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 |
Bắt buộc. Tuỳ chọn email sẽ được cập nhật. |
update_mask |
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 |
Bắt buộc. Phiên bản mới của trang chủ. |
update_mask |
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 |
Bắt buộc. Khu vực được cập nhật. |
update_mask |
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ụ: |
UpdateUserRequest
Thông báo yêu cầu cho phương thức UpdateUser
.
Trường | |
---|---|
user |
Bắt buộc. Phiên bản mới của người dùng. Sử dụng |
update_mask |
Bắt buộc. Danh sách trường đang được cập nhật. |
Người dùng
Trường | |
---|---|
name |
Giá trị nhận dạng. Tên tài nguyên của người dùng. Định dạng Sử dụng |
state |
Chỉ có đầu ra. Trạng thái của người dùng. |
access_rights[] |
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 |
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 |
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 |
Tỷ lệ phần trăm của giá được biểu thị dưới dạng số trong ký hiệu thập phân (Ví dụ: |
carrier_rate |
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 |
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 |
Bắt buộc. Tên kho hàng. Phải là duy nhất trong tài khoản. |
shipping_address |
Bắt buộc. Địa chỉ giao hàng của kho hàng. |
cutoff_time |
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 |
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 |
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 |
Bắt buộc. Nhà mạng, chẳng hạn như |
carrier_service |
Bắt buộc. Dịch vụ của nhà mạng, chẳng hạn như |
warehouse |
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 |
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 |
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. |