Chỉ mục
AccountIssueService
(giao diện)AccountsService
(giao diện)AutofeedSettingsService
(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)AccountAggregation
(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)AutofeedSettings
(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.AddAccountService
(thông báo)CreateAndConfigureAccountRequest.AddUser
(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)GetAutofeedSettingsRequest
(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)OnlineReturnPolicy.SeasonalOverride
(thông báo)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)UpdateAutofeedSettingsRequest
(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ả 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 cho 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) 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ố
|
GetAccount |
---|
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.
|
ListAccounts |
---|
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.
|
ListSubAccounts |
---|
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
|
UpdateAccount |
---|
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.
|
AutofeedSettingsService
Dịch vụ hỗ trợ chế độ cài đặt tự động cấp dữ liệu.
GetAutofeedSettings |
---|
Truy xuất chế độ cài đặt nguồn cấp dữ liệu tự động của một tài khoản.
|
UpdateAutofeedSettings |
---|
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.
|
BusinessIdentityService
Dịch vụ hỗ trợ API danh tính doanh nghiệp.
GetBusinessIdentity |
---|
Truy xuất danh tính doanh nghiệp của một tài khoản.
|
UpdateBusinessIdentity |
---|
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.
|
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 một tài khoản.
|
UpdateBusinessInfo |
---|
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.
|
EmailPreferencesService
Dịch vụ hỗ trợ API EmailPreferences
.
GetEmailPreferences |
---|
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.
|
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 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.
|
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. 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).
|
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 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.
|
UpdateHomepage |
---|
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.
|
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 |
---|
Lấy chính sách trả lại hàng hiện có của một người bán cụ thể.
|
ListOnlineReturnPolicies |
---|
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ể.
|
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 |
---|
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.
|
EnableProgram |
---|
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.
|
GetProgram |
---|
Truy xuất chương trình đã 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 theo khu vực.
API này xác định mô hình tài nguyên sau:
Region
CreateRegion |
---|
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.
|
DeleteRegion |
---|
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.
|
GetRegion |
---|
Truy xuất một khu vực được xác định trong tài khoản Merchant Center của bạn.
|
ListRegions |
---|
Liệt kê các khu vực trong tài khoản Merchant Center.
|
UpdateRegion |
---|
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.
|
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 |
---|
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. Bạn cần có quyền quản trị để thực thi phương thức này.
|
TermsOfServiceAgreementStateService
Dịch vụ hỗ trợ API TermsOfServiceAgreementState
.
GetTermsOfServiceAgreementState |
---|
Trả về trạng thái của thoả thuận về điều khoản dịch vụ.
|
RetrieveForApplicationTermsOfServiceAgreementState |
---|
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.
|
TermsOfServiceService
Dịch vụ hỗ trợ API TermsOfService
.
AcceptTermsOfService |
---|
Chấp nhận
|
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. Bạn cần có quyền quản trị để thực thi phương thức này.
|
DeleteUser |
---|
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ý"
|
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. Bạn cần có quyền quản trị để thực thi phương thức này.
|
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 cần chấp nhận Điều khoản dịch vụ. |
region_ |
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_ |
termsOfService đã được chấp nhận. |
accepted_ |
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_ |
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 |
Giá trị nhận dạng. Tên tài nguyên của tài khoản. Định dạng |
account_ |
Chỉ có đầu ra. Mã của tài khoản. |
account_ |
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àng và tên doanh nghiệp để biết thêm thông tin. |
adult_ |
Tài khoản này có chứa nội dung người lớn hay không. |
test_ |
Chỉ có đầu ra. Liệu đây có phải là tài khoản thử nghiệm không. |
time_ |
Bắt buộc. Múi giờ của tài khoản. Khi ghi, Đối với các lượt đọc, |
language_ |
Bắt buộc. Mã ngôn ngữ BCP-47 của tài khoản, chẳng hạn như |
AccountAggregation
Loại này không có trường nào.
Trọng tải AccountAggregation
.
AccountIssue
Một 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_ |
Mức độ tác động của vấn đề này đối với nhiều đích đến. |
detail |
Thông tin chi tiết khác đã bản địa hoá về vấn đề này. |
documentation_ |
Đườ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[] |
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_ |
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_ |
Mã vùng CLDR nơi áp dụng vấn đề này. |
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_ |
Phần địa chỉ ở cấp đường phố. Ví dụ: |
city |
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_ |
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_ |
Bắt buộc. Mã bưu chính hoặc mã ZIP (Ví dụ: "94043"). |
region_ |
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 |
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: |
enable_ |
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 |
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_ |
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 |
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_ |
Bắt buộc. Liệu bạn có thể sử dụng các thuộc tính nhận dạng cho chương trình khuyến mãi hay không. |
black_ |
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 |
women_ |
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 |
veteran_ |
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 |
latino_ |
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 |
small_ |
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 |
IdentityAttribute
Tất cả thông tin liên quan đến một thuộc tính danh tính.
Trường | |
---|---|
identity_ |
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 | |
---|---|
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 đã đồng ý sử dụng danh tính doanh nghiệp của họ cho mục đích quảng bá. |
PROMOTIONS_CONSENT_DENIED |
Cho biết rằng tài khoản không đồng ý việc sử dụng danh tính doanh nghiệp của họ cho mục đích quảng bá. |
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 |
Giá trị nhận dạng. Tên tài nguyên của thông tin doanh nghiệp. Định dạng: |
address |
Không bắt buộc. Địa chỉ của doanh nghiệp. Chỉ hỗ trợ các trường |
phone |
Chỉ có đầu ra. Số điện thoại của doanh nghiệp. |
phone_ |
Chỉ có đầu ra. Trạng thái xác minh qua điện thoại của doanh nghiệp. |
customer_ |
Không bắt buộc. Bộ phận dịch vụ khách hàng của doanh nghiệp. |
korean_ |
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 |
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 |
Bắt buộc. Dịch vụ của nhà mạng, chẳng hạn như |
carrier_ |
Bắt buộc. Dịch vụ của nhà mạng, chẳng hạn như |
origin_ |
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_ |
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ụ: |
flat_ |
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ụ: |
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ủ cần xác nhận quyền sở hữu. Định dạng |
overwrite |
Không bắt buộc. Khi được đặt thành |
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 đượ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[] |
Không bắt buộc. Người dùng cần được thêm vào tài khoản. |
service[] |
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. |
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_ |
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 |
Bắt buộc. Nhà cung cấp dịch vụ. Tham chiếu đến một tài khoản như |
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_ |
Bắt buộc. Địa chỉ email của người dùng (ví dụ: |
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 |
Bắt buộc. Tài khoản để tạo khu vực. Định dạng |
region_ |
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 |
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_ |
Bắt buộc. Địa chỉ email của người dùng (ví dụ: |
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 |
Không bắt buộc. URI nơi có thể tìm thấy dịch vụ khách hàng. |
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 đế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 |
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 |
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_ |
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 |
Bắt buộc. Tên của tài khoản cần xoá. Định dạng |
force |
Không bắt buộc. Nếu bạn đặt thành |
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 dành cho nhiều khía cạnh từ khi đặt hàng đến khi giao sản phẩm.
Trường | |
---|---|
warehouse_ |
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_ |
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 |
max_ |
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 |
cutoff_ |
Đị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_ |
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_ |
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 |
transit_ |
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 |
handling_ |
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_ |
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 |
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 |
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 |
Giá trị số nguyên của khoảng cách. |
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 |
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_ |
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 |
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 |
GetAccountRequest
Thông báo yêu cầu cho phương thức GetAccount
.
Trường | |
---|---|
name |
Bắt buộc. Tên của tài khoản cần truy xuất. Định dạng |
GetAutofeedSettingsRequest
Thông báo yêu cầu cho phương thức GetAutofeedSettings
.
Trường | |
---|---|
name |
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 |
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 của thông tin doanh nghiệp. Định dạng: |
GetEmailPreferencesRequest
Yêu cầu thông báo 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 của 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 của 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 của 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 của 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 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[] |
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ụ: |
weights[] |
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ụ: |
number_ |
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à |
postal_ |
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 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 |
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 |
claimed |
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 |
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 |
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_ |
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. Phần tử mẹ sở hữu tập hợp vấn đề này. Định dạng |
page_ |
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_ |
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_ |
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ư |
time_ |
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_ |
Các vấn đề của tài khoản đã chỉ định. |
next_ |
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_ |
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_ |
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_ |
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 mà bạn muốn đăng chính sách trả lại hàng. Định dạng |
page_ |
Không bắt buộc. Số lượng tài nguyên |
page_ |
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_ |
Chính sách trả lại hàng được truy xuất. |
next_ |
Mã thông báo có thể được gửi dưới dạng |
ListProgramsRequest
Thông báo yêu cầu cho phương thức ListPrograms.
Trường | |
---|---|
parent |
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 |
page_ |
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_ |
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 cho tài khoản đã cho. |
next_ |
Một 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_ |
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_ |
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 được chỉ định. |
next_ |
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. Nhà cung cấp dịch vụ tổng hợp. Định dạng |
page_ |
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_ |
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ẹ nhất định là tài khoản tổng hợp. |
next_ |
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. Thành phần mẹ sở hữu tập hợp người dùng này. Định dạng |
page_ |
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_ |
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_ |
Mã thông báo có thể được gửi dưới dạng |
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_ |
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_ |
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_ |
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 |
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 |
Giá trị nhận dạng. Tên của tài nguyên |
return_ |
Chỉ có đầu ra. Mã chính sách trả lại hàng do Google tạo. |
label |
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[] |
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 |
Chính sách trả lại hàng. |
seasonal_ |
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_ |
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_ |
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_ |
Đ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_ |
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_ |
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_ |
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_ |
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_ |
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 |
Loại chính sách. |
days |
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ề |
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
|
|
fixed_ |
Phí nhập lại hàng cố định. |
micro_ |
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 |
Bắt buộc. Loại phí vận chuyển trả lại hàng. |
fixed_ |
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à |
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 |
Bắt buộc. Tên hiển thị của cơ chế ghi đè theo mùa này trong Merchant Center. |
begin |
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 |
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 |
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 |
Giá trị nhận dạng. Tên tài nguyên của chương trình. Định dạng |
documentation_ |
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_ |
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 |
unmet_ |
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 |
Chỉ có đầu ra. Tên yêu cầu. |
documentation_ |
Chỉ có đầu ra. URL của trang trợ giúp mô tả yêu cầu. |
affected_ |
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 |
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_ |
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[] |
Không bắt buộc. Danh sách các bảng con được |
carrier_ |
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 |
single_ |
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_ |
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 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ụ RegionalInventory
và ShippingSettings
. 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 |
Giá trị nhận dạng. Tên tài nguyên của khu vực. Định dạng |
postal_ |
Không bắt buộc. Danh sách mã bưu chính xác định khu vực. |
geotarget_ |
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_ |
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_ |
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_ |
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_ |
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_ |
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_ |
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 |
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ụ: |
end |
Không bắt buộc. Mã bưu chính hoặc mẫu ở dạng |
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_ |
termsOfService cần được chấp nhận. |
tos_ |
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 |
Bắt buộc. Tài khoản cần lấy định dạng TermsOfServiceAgreementState: |
RetrieveLatestTermsOfServiceRequest
Thông báo yêu cầu cho phương thức RetrieveLatestTermsOfService
.
Trường | |
---|---|
region_ |
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 |
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[] |
Bắt buộc. Danh sách các ô tạo nên hàng. Phải có cùng độ dài với |
Dịch vụ
Dịch vụ vận chuyển.
Trường | |
---|---|
delivery_ |
Bắt buộc. Mã lãnh thổ CLDR của những quốc gia áp dụng dịch vụ. |
rate_ |
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ó |
loyalty_ |
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_ |
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 |
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_ |
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_ |
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_ |
Loại địa điểm mà dịch vụ này vận chuyển đơn đặt hàng đến. |
minimum_ |
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_ |
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_ |
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_ |
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_ |
Đâ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_ |
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_ |
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_ |
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_ |
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_ |
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_ |
Thời điểm kết thúc dịch vụ giao hàng tại địa phương trong ngày. |
store_ |
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 |
no_ |
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 |
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 |
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 |
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 |
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 mục tiêu. |
warehouses[] |
Không bắt buộc. Danh sách các kho hàng có thể được tham chiếu trong |
etag |
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:
|
Bảng
Một bảng xác định nhóm giá, khi single_value
không đủ rõ ràng.
Trường | |
---|---|
rows[] |
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 |
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_ |
Bắt buộc. Tiêu đề của các hàng trong bảng. |
column_ |
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 kind
và region
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 |
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_ |
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 |
kind |
Loại áp dụng cho 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à 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 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 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. 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 |
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_ |
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_ |
Loại Điều khoản dịch vụ liên kết với phiên bản cụ thể. |
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 |
Đ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_ |
Bắt buộc. Danh sách tên khu vực |
transit_ |
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 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-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_ |
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_ |
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 quyền sở hữu. Đị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_ |
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ả
|
UpdateAutofeedSettingsRequest
Thông báo yêu cầu cho phương thức UpdateAutofeedSettings
.
Trường | |
---|---|
autofeed_ |
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_ |
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_ |
Bắt buộc. Phiên bản mới của thông tin nhận dạng doanh nghiệp. |
update_ |
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ả
|
UpdateBusinessInfoRequest
Thông báo yêu cầu cho phương thức UpdateBusinessInfo
.
Trường | |
---|---|
business_ |
Bắt buộc. Phiên bản mới của thông tin doanh nghiệp. |
update_ |
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ả
|
UpdateEmailPreferencesRequest
Thông báo yêu cầu cho phương thức UpdateEmailPreferences.
Trường | |
---|---|
email_ |
Bắt buộc. Cập nhật Lựa chọn ưu tiên về email. |
update_ |
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ả
|
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_ |
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ả
|
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ập nhật. |
update_ |
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_ |
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ả
|
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 |
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_ |
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_ |
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_ |
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_ |
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ụ: |
carrier_ |
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 |
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 |
Bắt buộc. Tên kho. Phải là duy nhất trong tài khoản. |
shipping_ |
Bắt buộc. Địa chỉ giao hàng của kho. |
cutoff_ |
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_ |
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_ |
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 |
Bắt buộc. Nhà mạng, chẳng hạn như |
carrier_ |
Bắt buộc. Dịch vụ của nhà mạng, chẳng hạn như |
warehouse |
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 |
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 |
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. |