Package google.shopping.merchant.accounts.v1beta

索引

AccountIssueService

支援 AccountIssueService API 的服務。

ListAccountIssues

rpc ListAccountIssues(ListAccountIssuesRequest) returns (ListAccountIssuesResponse)

列出 Merchant Center 帳戶的所有帳戶問題。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

AccountsService

支援 Accounts API 的服務。

CreateAndConfigureAccount

rpc CreateAndConfigureAccount(CreateAndConfigureAccountRequest) returns (Account)

建立獨立 Merchant Center 帳戶，並設定其他選項。將提出要求的使用者新增為新帳戶的管理員。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
DeleteAccount

rpc DeleteAccount(DeleteAccountRequest) returns (Empty)

刪除指定帳戶，無論其類型為獨立帳戶、MCA 或子帳戶皆可。刪除 MCA 會導致所有子帳戶一併刪除。執行這個方法需要管理員存取權。只有在帳戶未為任何其他帳戶提供服務，且沒有已處理的商品時，刪除作業才會成功。您可以使用 force 參數覆寫這項設定。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

從 Merchant Center 帳戶擷取帳戶。插入、更新或刪除帳戶後，變更可能需要幾分鐘才會生效。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
ListAccounts

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

列出呼叫使用者可存取的帳戶，並符合要求的限制條件，例如頁面大小或篩選器。這項作業不僅會列出 MCA 的子帳戶，還會列出呼叫使用者可存取的所有帳戶，包括其他 MCA、已連結帳戶、獨立帳戶等等。如果未提供篩選器，則會傳回使用者直接加入的帳戶。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
ListSubAccounts

rpc ListSubAccounts(ListSubAccountsRequest) returns (ListSubAccountsResponse)

列出指定多重客戶帳戶的所有子帳戶。這是針對功能更強大的 ListAccounts 方法所提供的方便包裝函式。這個方法會產生與以下篩選器呼叫 ListsAccounts 相同的結果：relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION"))

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
UpdateAccount

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

無論帳戶類型為獨立帳戶、MCA 或子帳戶，都可以更新帳戶。執行這個方法需要管理員存取權。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

AutofeedSettingsService

支援自動動態饋給設定的服務。

GetAutofeedSettings

rpc GetAutofeedSettings(GetAutofeedSettingsRequest) returns (AutofeedSettings)

擷取帳戶的自動動態饋給設定。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
UpdateAutofeedSettings

rpc UpdateAutofeedSettings(UpdateAutofeedSettingsRequest) returns (AutofeedSettings)

更新帳戶的自動動態饋給設定。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

BusinessIdentityService

支援 business identity API 的服務。

GetBusinessIdentity

rpc GetBusinessIdentity(GetBusinessIdentityRequest) returns (BusinessIdentity)

擷取帳戶的商家身分。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
UpdateBusinessIdentity

rpc UpdateBusinessIdentity(UpdateBusinessIdentityRequest) returns (BusinessIdentity)

更新帳戶的商家身分。執行這個方法需要管理員存取權。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

BusinessInfoService

支援 Business Info API 的服務。

GetBusinessInfo

rpc GetBusinessInfo(GetBusinessInfoRequest) returns (BusinessInfo)

擷取帳戶的商家資訊。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
UpdateBusinessInfo

rpc UpdateBusinessInfo(UpdateBusinessInfoRequest) returns (BusinessInfo)

更新帳戶的商家資訊。執行這個方法需要管理員存取權。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

EmailPreferencesService

支援 EmailPreferences API 的服務。

GetEmailPreferences

rpc GetEmailPreferences(GetEmailPreferencesRequest) returns (EmailPreferences)

傳回 Merchant Center 帳戶使用者的電子郵件接收設定。這項服務只允許擷取及更新已驗證使用者的電子郵件偏好設定。使用 name=accounts/*/users/me/emailPreferences 別名，即可取得已驗證使用者的偏好設定。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
UpdateEmailPreferences

rpc UpdateEmailPreferences(UpdateEmailPreferencesRequest) returns (EmailPreferences)

更新 Merchant Center 帳戶使用者的電子郵件接收設定。MCA 使用者應指定 MCA 帳戶，而非 MCA 的子帳戶。

未在更新遮罩中明確選取的偏好設定不會更新。

更新中指定 UNCONFIRMED 的啟用狀態值無效。

使用 name=accounts/*/users/me/emailPreferences 別名，為已驗證的使用者更新偏好設定。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

HomepageService

支援商店首頁 API 的服務。

ClaimHomepage

rpc ClaimHomepage(ClaimHomepageRequest) returns (Homepage)

聲明擁有商店首頁。執行這個方法需要管理員存取權。

如果已聲明主頁，系統會重新檢查驗證 (除非商家可免除聲明，這也表示可免除驗證)，並傳回成功回應。如果無法再驗證擁有權，系統會傳回錯誤，但不會清除版權聲明。如果失敗，系統會傳回標準錯誤訊息：* PERMISSION_DENIED：使用者沒有這個 Merchant Center 帳戶的必要權限；* FAILED_PRECONDITION：- 帳戶不是 Merchant Center 帳戶；- Merchant Center 帳戶沒有首頁；- 聲明失敗 (在這種情況下，錯誤訊息會包含更多詳細資料)。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
GetHomepage

rpc GetHomepage(GetHomepageRequest) returns (Homepage)

擷取商店的首頁。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
UnclaimHomepage

rpc UnclaimHomepage(UnclaimHomepageRequest) returns (Homepage)

取消聲明商店首頁。執行這個方法需要管理員存取權。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
UpdateHomepage

rpc UpdateHomepage(UpdateHomepageRequest) returns (Homepage)

更新商店的首頁。執行這個方法需要管理員存取權。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

OnlineReturnPolicyService

這項服務可協助管理商家退貨政策設定，包括廣告和免費產品資訊的退貨政策

計畫。這個 API 定義了下列資源模型：

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

GetOnlineReturnPolicy

rpc GetOnlineReturnPolicy(GetOnlineReturnPolicyRequest) returns (OnlineReturnPolicy)

取得特定商家的現有退貨政策。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
ListOnlineReturnPolicies

rpc ListOnlineReturnPolicies(ListOnlineReturnPoliciesRequest) returns (ListOnlineReturnPoliciesResponse)

列出指定商家的所有現有退貨政策。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

ProgramsService

用於管理計畫的服務。

計畫提供一種機制，可在商家帳戶中新增功能。典型例子就是免費產品資訊計畫，可讓商家商店的產品在 Google 各項服務中免費顯示。

除了提供明確啟用或停用參與各個計畫的方法外，這項服務還會公開方法，用於擷取商家參與所有可用計畫的資訊。

DisableProgram

rpc DisableProgram(DisableProgramRequest) returns (Program)

停用帳戶參與指定計畫的權限。執行這個方法需要管理員存取權。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
EnableProgram

rpc EnableProgram(EnableProgramRequest) returns (Program)

為帳戶啟用參與指定計畫的功能。執行這個方法需要管理員存取權。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
GetProgram

rpc GetProgram(GetProgramRequest) returns (Program)

擷取帳戶的指定節目。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
ListPrograms

rpc ListPrograms(ListProgramsRequest) returns (ListProgramsResponse)

擷取帳戶的所有節目。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

RegionsService

管理地區設定。

這個 API 定義了下列資源模型：

  • Region
CreateRegion

rpc CreateRegion(CreateRegionRequest) returns (Region)

在 Merchant Center 帳戶中建立區域定義。執行這個方法需要管理員存取權。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
DeleteRegion

rpc DeleteRegion(DeleteRegionRequest) returns (Empty)

從 Merchant Center 帳戶中刪除區域定義。執行這個方法需要管理員存取權。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
GetRegion

rpc GetRegion(GetRegionRequest) returns (Region)

擷取 Merchant Center 帳戶中定義的區域。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
ListRegions

rpc ListRegions(ListRegionsRequest) returns (ListRegionsResponse)

列出 Merchant Center 帳戶中的區域。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
UpdateRegion

rpc UpdateRegion(UpdateRegionRequest) returns (Region)

更新 Merchant Center 帳戶中的區域定義。執行這個方法需要管理員存取權。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

ShippingSettingsService

服務，可依 Merchant API 方法取得方法呼叫運送設定資訊。

GetShippingSettings

rpc GetShippingSettings(GetShippingSettingsRequest) returns (ShippingSettings)

擷取運送設定資訊。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
InsertShippingSettings

rpc InsertShippingSettings(InsertShippingSettingsRequest) returns (ShippingSettings)

將商家的運送設定替換為要求運送設定。執行這個方法需要管理員存取權。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

TermsOfServiceAgreementStateService

支援 TermsOfServiceAgreementState API 的服務。

GetTermsOfServiceAgreementState

rpc GetTermsOfServiceAgreementState(GetTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

傳回服務條款協議的狀態。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
RetrieveForApplicationTermsOfServiceAgreementState

rpc RetrieveForApplicationTermsOfServiceAgreementState(RetrieveForApplicationTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

擷取應用程式服務條款的同意狀態。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

TermsOfServiceService

支援 TermsOfService API 的服務。

AcceptTermsOfService

rpc AcceptTermsOfService(AcceptTermsOfServiceRequest) returns (Empty)

接受 TermsOfService。執行這個方法需要管理員存取權。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
GetTermsOfService

rpc GetTermsOfService(GetTermsOfServiceRequest) returns (TermsOfService)

擷取與提供版本相關聯的 TermsOfService。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
RetrieveLatestTermsOfService

rpc RetrieveLatestTermsOfService(RetrieveLatestTermsOfServiceRequest) returns (TermsOfService)

針對指定的 kind 和 region_code，擷取 TermsOfService 的最新版本。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

UserService

支援使用者 API 的服務。

CreateUser

rpc CreateUser(CreateUserRequest) returns (User)

建立 Merchant Center 帳戶使用者。執行這個方法需要管理員存取權。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
DeleteUser

rpc DeleteUser(DeleteUserRequest) returns (Empty)

刪除 Merchant Center 帳戶使用者。執行這個方法需要管理員存取權。刪除的使用者不得是該帳戶的最後一位管理員。此外，如果使用者由商家管理工具管理，則不會遭到刪除。」

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
GetUser

rpc GetUser(GetUserRequest) returns (User)

擷取 Merchant Center 帳戶使用者。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
ListUsers

rpc ListUsers(ListUsersRequest) returns (ListUsersResponse)

列出 Merchant Center 帳戶的所有使用者。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
UpdateUser

rpc UpdateUser(UpdateUserRequest) returns (User)

更新 Merchant Center 帳戶使用者。執行這個方法需要管理員存取權。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

AcceptTermsOfServiceRequest

AcceptTermsOfService 方法的要求訊息。

欄位
name

string

必要欄位。服務條款版本的資源名稱。格式：termsOfService/{version}
account

string

必要欄位。接受《服務條款》的帳戶。
region_code

string

必要欄位。CLDR 定義的區域代碼。如果條款僅適用於特定國家/地區，則為該國家/地區；如果適用於全球，則為 001。

已接受

說明已接受的服務條款。

欄位
terms_of_service

string

已接受的 termsOfService。
accepted_by

string

接受邀請的帳戶。這可以是帳戶本身，或是子帳戶的話，則為 MCA 帳戶。
valid_until

Date

設定後，系統會指出已接受的 TermsOfService 僅在該日期 (以世界標準時間為準) 結束前有效。屆時必須接受新的政策。您可以在「Required」訊息中找到必要的 TermsOfService 資訊。

AccessRight

存取權。

列舉
ACCESS_RIGHT_UNSPECIFIED 預設值。此值未使用。
STANDARD 標準存取權。
ADMIN 管理員存取權。
PERFORMANCE_REPORTING 擁有這項權限的使用者可以存取成效和洞察資料。

帳戶

Account 訊息代表購物廣告中的商家帳戶。這是用來管理產品資料、設定，以及與 Google 服務和外部供應商互動的實體。

帳戶可以做為獨立實體運作，也可以是多重客戶帳戶 (MCA) 結構的一部分。在 MCA 設定中，上層帳戶會管理多個子帳戶。

建立帳戶時，需要設定帳戶名稱、時區和語言偏好等屬性。

Account 訊息是許多其他資源的父項實體，例如 AccountRelationship、Homepage、BusinessInfo 等。

欄位
name

string

ID。帳戶的資源名稱。格式：accounts/{account}
account_id

int64

僅供輸出。帳戶 ID。
account_name

string

必要欄位。使用者可解讀的帳戶名稱。詳情請參閱「商店名稱」和「商家名稱」。
adult_content

bool

帳戶是否含有成人內容。
test_account

bool

僅供輸出。是否為測試帳戶。
time_zone

TimeZone

必要欄位。帳戶時區。

在寫入時，time_zone 會同時設定 reporting_time_zone 和 display_time_zone。

對於讀取作業，time_zone 一律會傳回 display_time_zone。如果您的帳戶中沒有 display_time_zone，time_zone 會是空白。
language_code

string

必要欄位。帳戶的 BCP-47 語言代碼，例如 en-US 或 sr-Latn。

AccountAggregation

這個類型沒有任何欄位。

AccountAggregation 酬載。

AccountIssue

AccountIssue。

欄位
name

string

ID。帳戶問題的資源名稱。格式：accounts/{account}/issues/{id}
title

string

問題的本地化標題。
severity

Severity

問題的整體嚴重程度。
impacted_destinations[]

ImpactedDestination

這個問題對各種目的地的影響。
detail

string

問題的其他本地化詳細資料。
documentation_uri

string

連結至 Merchant Center 說明中心，提供有關問題的詳細資訊和修正方式。

ImpactedDestination

問題對目的地的影響。

欄位
impacts[]

Impact

各區域對指定目的地的 (負面) 影響。
reporting_context

ReportingContextEnum

受影響的報表內容。

影響

問題對區域的影響。

欄位
region_code

string

這個問題適用的 CLDR 區域代碼。
severity

Severity

問題對目的地和區域的影響程度。

嚴重性

所有可能的問題嚴重程度。

列舉
SEVERITY_UNSPECIFIED 嚴重性不明。
CRITICAL 導致商品無法放送。
ERROR 這個問題可能會影響 (未來的) 產品資訊，或是可能代表產品資訊有問題。
SUGGESTION 問題是改善建議。

地址

倉庫的運送地址。

欄位
street_address

string

地址的街道層級部分。例如 111w 31st Street。
city

string

必要欄位。城市、鄉鎮或社區。也可能包含從屬地區或次區域 (例如社區或郊區)。
administrative_area

string

必要欄位。國家/地區的最上層行政區劃分。例如加州 (「CA」) 或魁北克省 (「QC」)。
postal_code

string

必要欄位。郵遞區號 (例如「94043」)。
region_code

string

必要欄位。CLDR 國家/地區代碼 (例如「US」)。

AutofeedSettings

收集與自動動態饋給設定相關的資訊。

欄位
name

string

ID。自動動態饋給設定的資源名稱。格式：accounts/{account}/autofeedSettings。
enable_products

bool

必要欄位。啟用或停用指定帳戶的自動動態饋給產品檢索功能。自動動態饋給帳戶必須符合特定條件，您可以透過 eligible 欄位進行檢查。帳戶不得是市集。第一次啟用自動動態饋給時，產品通常會立即顯示。重新啟用後，產品最多可能需要 24 小時才會顯示。
eligible

bool

僅供輸出。判斷商家是否符合自動動態饋給的註冊資格。

BusinessDayConfig

倉庫的工作天。

欄位
business_days[]

Weekday

必要欄位。正常營業日。不得留空。

平日

列舉
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

BusinessIdentity

收集與商家身分相關的資訊。

欄位
name

string

ID。商家身分的資源名稱。格式：accounts/{account}/businessIdentity
black_owned

IdentityAttribute

選用設定。指定商家是否自認為黑人經營的商家。這個選用欄位僅適用於商家，且商家所在國家/地區必須設為 US。也不適用於市集或市集賣家。
women_owned

IdentityAttribute

選用設定。指定商家是否為女性經營。這個選用欄位僅適用於商家，且商家所在國家/地區必須設為 US。也不適用於市集或市集賣家。
veteran_owned

IdentityAttribute

選用設定。指定商家是否為退伍軍人經營的商家。這個選用欄位僅適用於商家，且商家所在國家/地區必須設為 US。也不適用於市集或市集賣家。
latino_owned

IdentityAttribute

選用設定。指定商家是否自認為拉丁裔人經營。這個選用欄位僅適用於商家，且商家所在國家/地區必須設為 US。也不適用於市集或市集賣家。
small_business

IdentityAttribute

選用設定。指定商家是否自認為小型商家。這個選用欄位僅適用於商家，且商家所在國家/地區必須設為 US。也不適用於市集。

IdentityAttribute

與身分屬性相關的所有資訊。

欄位
identity_declaration

IdentityDeclaration

必要欄位。此屬性的身分宣告。

IdentityDeclaration

所有可能的宣告身分設定。

列舉
IDENTITY_DECLARATION_UNSPECIFIED 預設值，表示未選取任何項目。
SELF_IDENTIFIES_AS 表示帳戶與屬性相符。
DOES_NOT_SELF_IDENTIFY_AS 表示帳戶不符合該屬性。

PromotionsConsent

與商家身分相關的所有宣傳活動設定。

列舉

BusinessInfo

BusinessInfo 訊息包含商家業務的必要資訊。

這則訊息會擷取實體地址、客服聯絡人和區域專屬 ID 等重要商家詳細資料。

欄位
name

string

ID。商家資訊的資源名稱。格式：accounts/{account}/businessInfo
address

PostalAddress

選用設定。商家地址。僅支援 region_code、address_lines、postal_code、administrative_area 和 locality 欄位。系統會忽略所有其他欄位。
phone

PhoneNumber

僅供輸出。商家的電話號碼。
phone_verification_state

PhoneVerificationState

僅供輸出。商家電話驗證狀態。
customer_service

CustomerService

選用設定。商家的客戶服務。
korean_business_registration_number

string

選用設定。10 位數的韓國商業登記號碼，以連字號分隔，格式為：XXX-XX-XXXXX。

CarrierRate

可由 main_table 或 single_value 參照的電信費率清單。支援的運送服務定義請參閱 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。

欄位
name

string

必要欄位。運送業者費率的名稱。每個費率群組的名稱皆不得重複。
carrier

string

必要欄位。電信服務，例如 "UPS" 或 "Fedex"。
carrier_service

string

必要欄位。電信服務，例如 "ground" 或 "2 days"。
origin_postal_code

string

必要欄位。這個運送公司費率的運送起點。
percentage_adjustment

string

選用設定。以小數表示的運費乘數。可為負數。例如 "5.4" 會將費率提高 5.4%，"-3" 則會將費率調降 3%。
flat_adjustment

Price

選用設定。加總運費調節係數。可為負數。舉例來說，{ "amount_micros": 1, "currency_code" : "USD" } 會將費率提高 $1 美元，{ "amount_micros": -3, "currency_code" : "USD" } 則會將費率降低 $3 美元。

ClaimHomepageRequest

ClaimHomepage 方法的要求訊息。

欄位
name

string

必要欄位。要聲明的首頁名稱。格式：accounts/{account}/homepage
overwrite

bool

選用設定。如果設為 true，這個選項會移除要求網站上的任何現有聲明，並以提出要求的帳戶聲明取代。

CreateAndConfigureAccountRequest

CreateAndConfigureAccount 方法的要求訊息。

欄位
account

Account

必要欄位。要建立的帳戶。
users[]

CreateUserRequest

選用設定。要新增至帳戶的使用者。
service[]

AddAccountService

必要欄位。在建立帳戶的過程中，系統會初始化要建立的帳戶和供應商帳戶之間的帳戶服務。您必須提供至少一項這類服務。目前這兩者中必須有一個是 account_aggregation，也就是說，您只能透過這個方法建立子帳戶，而不能建立獨立帳戶。可能會提供額外的 account_management 或 product_management 服務。

AddAccountService

建立帳戶時新增帳戶服務的其他操作說明。

欄位
聯集欄位 service_type。要新增的服務類型。service_type 只能是下列其中一項：
account_aggregation

AccountAggregation

供應商是帳戶的集結網站業者。服務類型「Account Aggregation」的酬載。
provider

string

必要欄位。服務供應商。格式：accounts/{account}

CreateRegionRequest

CreateRegion 方法的要求訊息。

欄位
parent

string

必要欄位。要建立地區的帳戶。格式：accounts/{account}
region_id

string

必要欄位。區域的 ID，在同一帳戶的所有區域中不重複。
region

Region

必要欄位。要建立的區域。

CreateUserRequest

CreateUser 方法的要求訊息。

欄位
parent

string

必要欄位。系統將為使用者建立的帳戶資源名稱。格式：accounts/{account}
user_id

string

必要欄位。使用者的電子郵件地址 (例如 john.doe@gmail.com)。
user

User

必要欄位。要建立的使用者。

CustomerService

客戶服務資訊。

欄位
uri

string

選用設定。可找到客戶服務的 URI。
email

string

選用設定。可用於聯絡客戶服務的電子郵件地址。
phone

PhoneNumber

選用設定。可撥打至客戶服務團隊的電話號碼。

CutoffTime

工作天截止時間定義。

欄位
hour

int32

必要欄位。截止時間的指定小時，訂單必須在截止時間前下單，才能在當天處理。
minute

int32

必要欄位。訂單截止時間的最後幾分鐘，訂單必須在這個時間前下單，才能在當天處理。
time_zone

string

必要欄位。時區 ID，例如「Europe/Zurich」。

DeleteAccountRequest

DeleteAccount 方法的要求訊息。

欄位
name

string

必要欄位。要刪除的帳戶名稱。格式：accounts/{account}
force

bool

選用設定。如果設為 true，即使帳戶為其他帳戶提供服務或已處理優惠，系統仍會刪除該帳戶。

DeleteRegionRequest

DeleteRegion 方法的要求訊息。

欄位
name

string

必要欄位。要刪除的區域名稱。格式：accounts/{account}/regions/{region}

DeleteUserRequest

DeleteUser 方法的要求訊息。

欄位
name

string

必要欄位。要刪除的使用者名稱。格式：accounts/{account}/users/{email}

您也可以使用 me 而非 accounts/{account}/users/me 中的電子郵件地址，刪除呼叫端對應的使用者。

DeliveryTime

從下單到產品送達，各個環節所需的時間。

欄位
warehouse_based_delivery_times[]

WarehouseBasedDeliveryTime

選用設定。表示系統應根據所選貨運公司的設定，為每個倉庫 (運送原點位置) 計算送達時間。設定後，[delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] 中不應再設定其他運送時間相關欄位。
min_transit_days

int32

運送過程中所需的最短工作天數。0 代表當天到貨，1 代表次日到貨。必須設定 min_transit_days、max_transit_days 或 transit_time_table，但不能同時設定。
max_transit_days

int32

運送過程中所需的最長工作天數。0 代表當天到貨，1 代表次日到貨。必須大於或等於 min_transit_days。
cutoff_time

CutoffTime

工作天截止時間定義。如果未設定，截止時間預設為太平洋標準時間上午 8 點。
min_handling_days

int32

訂單出貨前所需的最少工作天數。0 代表當天出貨，1 代表次日出貨。請同時設定或不設定「min_handling_days」和「max_handling_days」。
max_handling_days

int32

訂單出貨前所需的最大工作天數。0 代表當天出貨，1 代表次日出貨。必須大於或等於 min_handling_days。請同時設定或不設定「min_handling_days」和「max_handling_days」。
transit_time_table

TransitTable

運送時間表格：根據列和欄維度，計算運送所需的工作天數。您可以設定 min_transit_days、max_transit_days 或 transit_time_table，但不能同時設定兩者。
handling_business_day_config

BusinessDayConfig

訂單可處理的工作天數。如未提供，系統會假設週一至週五為工作日。
transit_business_day_config

BusinessDayConfig

訂單可能處於運送中的工作天數。如未提供，系統會假設週一至週五為工作日。

DisableProgramRequest

針對 DisableProgram 方法的要求訊息。

欄位
name

string

必要欄位。要為指定帳戶停用參與的計畫名稱。格式：accounts/{account}/programs/{program}

距離

最大運送範圍半徑。這項屬性僅適用於店面運送貨件類型。

欄位
value

int64

距離的整數值。
unit

Unit

單位可能因國家/地區而異，但參數會包含英里和公里。

單位

單位可能因國家/地區而異，但參數會包含英里和公里。

列舉
UNIT_UNSPECIFIED 未指定單位
MILES 以英里為單位
KILOMETERS 以公里為單位

EmailPreferences

使用者選擇接收 / 停止接收的通知類別。電子郵件偏好設定不包含重大公告，因為使用者無法選擇拒收這類通知。

欄位
name

string

ID。EmailPreferences 的名稱。這個端點僅支援已驗證的使用者。
news_and_tips

OptInState

選用設定。新功能、提示和最佳做法的最新消息。

OptInState

電子郵件偏好設定的選擇加入狀態。

列舉
OPT_IN_STATE_UNSPECIFIED 未指定啟用狀態。
OPTED_OUT 使用者已選擇不接收這類電子郵件。
OPTED_IN 使用者已選擇接收這類電子郵件。
UNCONFIRMED 使用者已選擇接收這類電子郵件，且確認電子郵件已寄出，但使用者尚未確認選擇加入 (僅適用於特定國家/地區)。

EnableProgramRequest

EnableProgram 方法的要求訊息。

欄位
name

string

必要欄位。要為指定帳戶啟用參與的計畫名稱。格式：accounts/{account}/programs/{program}

GetAccountRequest

GetAccount 方法的要求訊息。

欄位
name

string

必要欄位。要擷取的帳戶名稱。格式：accounts/{account}

GetAutofeedSettingsRequest

GetAutofeedSettings 方法的要求訊息。

欄位
name

string

必要欄位。自動動態饋給設定的資源名稱。格式：accounts/{account}/autofeedSettings

GetBusinessIdentityRequest

GetBusinessIdentity 方法的要求訊息。

欄位
name

string

必要欄位。商家身分的資源名稱。格式：accounts/{account}/businessIdentity

GetBusinessInfoRequest

GetBusinessInfo 方法的要求訊息。

欄位
name

string

必要欄位。商家資訊的資源名稱。格式：accounts/{account}/businessInfo

GetEmailPreferencesRequest

GetEmailPreferences 方法的要求訊息。

欄位
name

string

必要欄位。EmailPreferences 資源的名稱。格式：accounts/{account}/users/{email}/emailPreferences

GetHomepageRequest

GetHomepage 方法的要求訊息。

欄位
name

string

必要欄位。要擷取的首頁名稱。格式：accounts/{account}/homepage

GetOnlineReturnPolicyRequest

GetOnlineReturnPolicy 方法的要求訊息。

欄位
name

string

必要欄位。要擷取的退貨政策名稱。格式：accounts/{account}/onlineReturnPolicies/{return_policy}

GetProgramRequest

GetProgram 方法的要求訊息。

欄位
name

string

必要欄位。要擷取的節目名稱。格式：accounts/{account}/programs/{program}

GetRegionRequest

GetRegion 方法的要求訊息。

欄位
name

string

必要欄位。要擷取的區域名稱。格式：accounts/{account}/regions/{region}

GetShippingSettingsRequest

GetShippingSetting 方法的要求訊息。

欄位
name

string

必要欄位。要擷取的運送設定名稱。格式：accounts/{account}/shippingsetting

GetTermsOfServiceAgreementStateRequest

GetTermsOfServiceAgreementState 方法的要求訊息。

欄位
name

string

必要欄位。服務條款版本的資源名稱。格式：accounts/{account}/termsOfServiceAgreementState/{identifier} ID 格式為：{TermsOfServiceKind}-{country}

GetTermsOfServiceRequest

GetTermsOfService 方法的要求訊息。

欄位
name

string

必要欄位。服務條款版本的資源名稱。格式：termsOfService/{version}

GetUserRequest

GetUser 方法的要求訊息。

欄位
name

string

必要欄位。要擷取的使用者名稱。格式：accounts/{account}/users/{email}

您也可以使用 me 來擷取呼叫端對應的使用者，而非 accounts/{account}/users/me 中的電子郵件地址。

標頭

表格的資料列或欄標題非空白清單。必須設定 prices、weights、num_items、postal_code_group_names 或 location 其中一個值。

欄位
prices[]

Price

必要欄位。包含訂單價格上限的清單。只要將價格 amount_micros = -1，最後價格的值即可設為無限。例如 [{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}] 代表標頭「<= $10", "<= $500" 和 "> $500"。服務中的所有價格都必須使用相同的貨幣。不得空白。必須為正數，但 -1 除外。只有在所有其他欄位未設定時，才能設定此欄位。
weights[]

Weight

必要欄位。包含訂單重量上限的清單。只要將價格 amount_micros = -1，最後一個權重值就能設為無限。例如 [{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}] 代表標頭「<= 10kg」、「<= 50kg」和「> 50kg」。服務中的所有重量都必須使用相同的單位。不得空白。必須為正數，但 -1 除外。只有在所有其他欄位未設定時，才能設定此欄位。
number_of_items[]

string

必要欄位。包含項目上限數量的清單。最後一個值可以是 "infinity"。例如 ["10", "50", "infinity"] 代表標頭「<= 10 個項目」、「<= 50 個項目」和「> 50 個項目」。不得空白。只有在所有其他欄位未設定時，才能設定此欄位。
postal_code_group_names[]

string

必要欄位。郵政區域名稱清單。最後一個值可以是 "all other locations"。範例：["zone 1", "zone 2", "all other locations"]。所指的郵遞區號群組必須與服務的運送國家/地區相符。不得空白。只有在所有其他欄位未設定時，才能設定此欄位。
locations[]

LocationIdSet

必要欄位。地區 ID 集合的清單。不得空白。只有在所有其他欄位未設定時，才能設定此欄位。

首頁

Homepage 訊息代表系統中的商家商店首頁。

商家的首頁是消費者與商店互動的主要網域。

商家可以聲明首頁的擁有權並完成驗證，做為擁有權的證明，並且可使用需要經過驗證的網站才能使用的功能。詳情請參閱「瞭解網路商店網址驗證」。

欄位
name

string

ID。商店首頁的資源名稱。格式：accounts/{account}/homepage
claimed

bool

僅供輸出。是否已聲明首頁的擁有權。請參閱 https://support.google.com/merchants/answer/176793。
uri

string

必要欄位。商店首頁的 URI (通常是網址)。

InsertShippingSettingsRequest

InsertShippingSetting 方法的要求訊息。

欄位
parent

string

必要欄位。要插入此產品的帳戶。格式：accounts/{account}
shipping_setting

ShippingSettings

必要欄位。帳戶的新版本。

ListAccountIssuesRequest

ListAccountIssues 方法的要求訊息。

欄位
parent

string

必要欄位。這個問題集合的父項。格式：accounts/{account}
page_size

int32

選用設定。要傳回的問題數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多將傳回 50 位使用者。許可的最大值為 100；超出的數值將一律指定為 100
page_token

string

選用設定。從先前 ListAccountIssues 呼叫收到的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 ListAccountIssues 的所有其他參數須與提供網頁權杖的呼叫相符。
language_code

string

選用設定。回應中的「issues」會包含使用指定語言的欄位，方便使用者閱讀。格式為 BCP-47，例如 en-US 或 sr-Latn。如未提供值，系統會使用 en-US。
time_zone

string

選用設定。IANA 時區，用於在可讀取的欄位中本地化時間。例如「America/Los_Angeles」。如未設定，系統會使用「America/Los_Angeles」。

ListAccountIssuesResponse

ListAccountIssues 方法的回應訊息。

欄位
account_issues[]

AccountIssue

指定帳戶的問題。
next_page_token

string

可做為 page_token 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

ListAccountsRequest

ListAccounts 方法的要求訊息。

欄位
page_size

int32

選用設定。要傳回的帳戶數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多會傳回 250 個帳戶。許可的最大值為 500；超出的數值將一律指定為 500。
page_token

string

選用設定。從先前 ListAccounts 呼叫收到的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 ListAccounts 的所有其他參數須與提供網頁權杖的呼叫相符。
filter

string

選用設定。只會傳回符合篩選器的帳戶。詳情請參閱篩選器語法參考資料。

ListAccountsResponse

ListAccounts 方法的回應訊息。

欄位
accounts[]

Account

與 ListAccountsRequest 相符的帳戶。
next_page_token

string

可做為 page_token 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

ListOnlineReturnPoliciesRequest

ListOnlineReturnPolicies 方法的要求訊息。

欄位
parent

string

必要欄位。要列出退貨政策的商家帳戶。格式：accounts/{account}
page_size

int32

選用設定。要傳回的 OnlineReturnPolicy 資源數量上限。如果指定商家的退貨政策數量少於 pageSize，服務傳回的數量會少於這個值。預設值為 10。最大值為 100；如果指定的值高於最大值，pageSize 預設為最大值
page_token

string

選用設定。從先前 ListOnlineReturnPolicies 呼叫收到的網頁權杖。提供頁面符記即可擷取後續網頁。

進行分頁時，提供至 ListOnlineReturnPolicies 的所有其他參數須與提供網頁權杖的呼叫相符。在先前要求的回應中，權杖會以 nextPageToken 的形式傳回。

ListOnlineReturnPoliciesResponse

ListOnlineReturnPolicies 方法的回應訊息。

欄位
online_return_policies[]

OnlineReturnPolicy

擷取的退貨政策。
next_page_token

string

可做為 pageToken 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

ListProgramsRequest

ListPrograms 方法的要求訊息。

欄位
parent

string

必要欄位。要擷取所有計畫的帳戶名稱。格式：accounts/{account}
page_size

int32

選用設定。單一回應中傳回的節目數量上限。如果未指定 (或為 0)，系統會使用預設大小 1000。許可的最大值為 1000；超出的數值將一律指定為 1000。
page_token

string

選用設定。接收自先前 ListPrograms 呼叫的續行權杖。提供此項目即可擷取後續網頁。

ListProgramsResponse

ListPrograms 方法的回應訊息。

欄位
programs[]

Program

指定帳戶的計畫。
next_page_token

string

可做為 page_token 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

ListRegionsRequest

ListRegions 方法的要求訊息。

欄位
parent

string

必要欄位。要列出地區的帳戶。格式：accounts/{account}
page_size

int32

選用設定。要傳回的區域數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多將傳回 50 個區域。許可的最大值為 1000；超出的數值將一律指定為 1000。
page_token

string

選用設定。從先前 ListRegions 呼叫收到的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 ListRegions 的所有其他參數須與提供網頁權杖的呼叫相符。

ListRegionsResponse

ListRegions 方法的回應訊息。

欄位
regions[]

Region

指定商家的區域。
next_page_token

string

可做為 page_token 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

ListSubAccountsRequest

ListSubAccounts 方法的要求訊息。

欄位
provider

string

必要欄位。上層帳戶。格式：accounts/{account}
page_size

int32

選用設定。要傳回的帳戶數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多會傳回 250 個帳戶。許可的最大值為 500；超出的數值將一律指定為 500。
page_token

string

選用設定。從先前 ListAccounts 呼叫收到的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 ListAccounts 的所有其他參數須與提供網頁權杖的呼叫相符。

ListSubAccountsResponse

ListSubAccounts 方法的回應訊息。

欄位
accounts[]

Account

指定上層帳戶是匯入帳戶的帳戶。
next_page_token

string

可做為 page_token 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

ListUsersRequest

ListUsers 方法的要求訊息。

欄位
parent

string

必要欄位。擁有此使用者集合的父項。格式：accounts/{account}
page_size

int32

選用設定。要傳回的使用者人數上限。服務傳回的產品數量可能會少於這個值。如未指定，最多將傳回 50 位使用者。許可的最大值為 100；超出的數值將一律指定為 100
page_token

string

選用設定。從先前 ListUsers 呼叫收到的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 ListUsers 的所有其他參數須與提供網頁權杖的呼叫相符。

ListUsersResponse

ListUsers 方法的回應訊息。

欄位
users[]

User

指定帳戶中的使用者。
next_page_token

string

可做為 page_token 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

LocationIdSet

地區 ID 集合的清單。不得空白。只有在所有其他欄位未設定時，才能設定此欄位。

欄位
location_ids[]

string

必要欄位。非空白的地區 ID 清單。這些位置都必須屬於相同的位置類型 (例如州/省)。

MinimumOrderValueTable

下表列出自取出貨類型每間商店的最低訂單價值。

欄位
store_code_set_with_movs[]

StoreCodeSetWithMov

必要欄位。共用相同最低訂單價值 (MOV) 的商店代碼組合清單。至少需要兩個集合，且最後一個集合必須為空白，代表「MOV for all other stores」。每個商家代碼只能出現在所有集合中一次。服務中的所有價格都必須使用相同的貨幣。

StoreCodeSetWithMov

共用相同最低訂單價值的商店代碼組合清單。至少需要兩個集合，且最後一個集合必須為空白，代表「MOV for all other stores」。每個商家代碼只能出現在所有集合中一次。服務中的所有價格都必須使用相同的貨幣。

欄位
store_codes[]

string

選用設定。清單內含專屬商店代碼，或空白 (用於萬用)。
value

Price

指定商店的最低訂單價值。

OnlineReturnPolicy

線上退貨政策物件。目前用於代表廣告和免費產品資訊計畫的退貨政策。

欄位
name

string

ID。OnlineReturnPolicy 資源的名稱。格式：accounts/{account}/onlineReturnPolicies/{return_policy}
return_policy_id

string

僅供輸出。Google 產生的退貨政策 ID。
label

string

必要欄位。這個欄位代表退貨政策的使用者定義標籤，請注意，同一個國家/地區的不同退貨政策中，不得使用相同的標籤。除非產品指定特定標籤屬性，否則政策會自動標示為「預設」。如要為特定產品群組指派自訂退貨政策，請按照「退貨政策標籤」中的說明操作。標籤長度上限為 50 個半形字元。
countries[]

string

必要欄位。退貨政策適用的銷售國家/地區。值必須是有效的 2 個字母 ISO 3166 代碼。
policy

Policy

退貨政策。
restocking_fee

RestockingFee

適用於所有退貨原因類別的重新進貨費用。如果未設定值，系統會將其視為免費的退貨處理費。
return_methods[]

ReturnMethod

消費者可用來退回商品的退貨方式。除非退貨政策類型為 noReturns，否則這個值不得空白。
item_conditions[]

ItemCondition

除非退貨政策類型為「noReturns」，否則接受退貨的商品狀態不得為空白。
return_shipping_fee

ReturnShippingFee

退貨運費。只有在客戶需要下載及列印退貨標籤時，才應設定此屬性。
return_policy_uri

string

必要欄位。退貨政策的 URI。Google 可使用這項資訊對政策進行合理性檢查。必須是有效的網址。
accept_defective_only

bool

這個欄位可指定商家是否只接受瑕疵產品的退貨，且為必要欄位。
process_refund_days

int32

這個欄位可指定商家處理退款所需的天數，為選用欄位。
accept_exchange

bool

這個欄位用來指定商家是否允許消費者換貨，為必填欄位。

ItemCondition

可用的商品狀況。

列舉
ITEM_CONDITION_UNSPECIFIED 預設值。此值未使用。
NEW New.
USED 已使用。

政策

可用的政策。

欄位
type

Type

政策類型。
days

int64

商品送達後可退回的天數，其中 1 天定義為送達時間戳記後的 24 小時。NUMBER_OF_DAYS_AFTER_DELIVERY 退貨必填。

類型

退貨政策類型。

列舉
TYPE_UNSPECIFIED 預設值。此值未使用。
NUMBER_OF_DAYS_AFTER_DELIVERY 產品送達後，消費者可申請退貨的天數。
NO_RETURNS 無法退貨。
LIFETIME_RETURNS 終身退貨。

RestockingFee

重新進貨費用。這可以是固定費用或微小百分比。

欄位

聯集欄位 type。

type 只能是下列其中一項：
fixed_fee

Price

固定的重新進貨費用。
micro_percent

int32

總價格的百分比，以百萬分之一為單位。15,000,000 代表系統會收取總價的 15%。

ReturnMethod

可用的退貨方式。

列舉
RETURN_METHOD_UNSPECIFIED 預設值。此值未使用。
BY_MAIL 郵寄退回。
IN_STORE 在實體商店退貨。
AT_A_KIOSK 在資訊站辦理退貨。

ReturnShippingFee

退貨運費。這可以是固定費用，也可以是布林值，用來表示消費者支付實際運費。

欄位
type

Type

必要欄位。退貨運費類型。
fixed_fee

Price

固定退貨運費金額。這個值僅適用於類型為 FIXED 的情況。如果類型為 FIXED 且未設定這個值，我們會將退貨運費視為免費。

類型

退貨運費類型。

列舉
TYPE_UNSPECIFIED 預設值。此值未使用。
FIXED 退貨運費為固定值。
CUSTOMER_PAYING_ACTUAL_FEE 消費者將支付實際退貨運費。

PhoneVerificationState

電話驗證狀態。

列舉
PHONE_VERIFICATION_STATE_UNSPECIFIED 預設值。此值未使用。
PHONE_VERIFICATION_STATE_VERIFIED 電話已驗證。
PHONE_VERIFICATION_STATE_UNVERIFIED 手機未經過驗證

計畫

定義指定帳戶參與特定計畫的情況。

計畫提供一種機制，可在商家帳戶中新增功能。典型例子就是免費產品資訊計畫，可讓商家商店的產品在 Google 各項服務中免費顯示。

欄位
name

string

ID。程式的資源名稱。格式：accounts/{account}/programs/{program}
documentation_uri

string

僅供輸出。說明這項計畫的 Merchant Center 說明頁面網址。
state

State

僅供輸出。帳戶在計畫中的參與狀態。
active_region_codes[]

string

僅供輸出。帳戶積極參與計畫的區域。我們將「有效區域」定義為已符合所有影響該區域的計畫規定的區域。

區域代碼由 CLDR 定義。這個值可以是指特定國家/地區 (指的是該計畫僅適用於該國家/地區)，或是 001 (指的是該計畫適用於全球)。
unmet_requirements[]

Requirement

僅供輸出。帳戶尚未符合的條件，導致無法參與計畫。

需求

定義加入計畫的必要條件。

欄位
title

string

僅供輸出。需求名稱。
documentation_uri

string

僅供輸出。說明規定的說明頁面網址。
affected_region_codes[]

string

僅供輸出。目前因未符合這項規定而受到影響的區域。

區域代碼由 CLDR 定義。這個值可以是指特定國家/地區 (指的是該計畫僅適用於該國家/地區)，或是 001 (指的是該計畫適用於全球)。

州

帳戶可能的計畫參與狀態。

列舉
STATE_UNSPECIFIED 預設值。此值未使用。
NOT_ELIGIBLE 帳戶不符合參與計畫的資格。
ELIGIBLE 帳戶符合參與計畫的資格。
ENABLED 帳戶已啟用這項計畫。

RateGroup

運送費率群組定義。只有最後一個群組可以有空白的 applicable_shipping_labels，代表「其他所有」群組。其他 applicable_shipping_labels 不得重疊。

欄位
applicable_shipping_labels[]

string

必要欄位。運送標籤清單，定義這個費率群組適用的產品。這是一個選項：只要任一標籤相符，系統就會套用費率群組。只有服務的最後一個費率群組可以為空白。
subtables[]

Table

選用設定。main_table 參照的子表清單。必須設定 main_table 才可設定。
carrier_rates[]

CarrierRate

選用設定。可由 main_table 或 single_value 參照的電信費率清單。
single_value

Value

費率群組的值 (例如 $10 美元的固定費率)。只有在未設定 main_table 和 subtables 時才能設定。
main_table

Table

當 single_value 無法充分表達時，定義費率群組的表格。只有在未設定 single_value 時才能設定。
name

string

選用設定。費率群組名稱。在運送服務中不得重複。

區域

代表可用於 RegionalInventory 和 ShippingSettings 服務的目標地理區域。您可以將區域定義為郵遞區號集合，或是在部分國家/地區使用預先定義的地理目標。詳情請參閱「設定地區 」一文。

欄位
name

string

ID。區域的資源名稱。格式：accounts/{account}/regions/{region}
postal_code_area

PostalCodeArea

選用設定。定義區域範圍的郵遞區號清單。
geotarget_area

GeoTargetArea

選用設定。定義區域範圍的地理目標清單。
regional_inventory_eligible

BoolValue

僅供輸出。指出區域是否可用於區域商品目錄設定。
shipping_eligible

BoolValue

僅供輸出。指出該區域是否可用於運送服務設定。
display_name

string

選用設定。區域的顯示名稱。

GeoTargetArea

定義區域範圍的地理目標清單。

欄位
geotarget_criteria_ids[]

int64

必要欄位。非空白的地區 ID 清單。這些位置都必須屬於相同的位置類型 (例如州/省)。

PostalCodeArea

定義區域範圍的郵遞區號清單。注意：所有使用郵遞區號定義的區域都可以透過帳戶的 ShippingSettings.postalCodeGroups 資源存取。

欄位
region_code

string

必要欄位。CLDR 地域代碼，或郵遞區號群組適用的國家/地區。
postal_codes[]

PostalCodeRange

必要欄位。郵遞區號範圍。

PostalCodeRange

定義區域範圍的郵遞區號。

欄位
begin

string

必要欄位。郵遞區號或前置碼* 的格式模式，表示定義區域範圍的包含下限。範例值：94108、9410*、9*。
end

string

選用設定。郵遞區號或 prefix* 形式的模式，表示定義區域範圍的上限。長度必須與 postalCodeRangeBegin 相同：如果 postalCodeRangeBegin 是郵遞區號，postalCodeRangeEnd 也必須是郵遞區號；如果 postalCodeRangeBegin 是模式，postalCodeRangeEnd 也必須是長度相同的前置碼模式。選用：如果未設定，則該區域的定義為與 postalCodeRangeBegin 相符的所有郵遞區號。

必填

說明必須接受的服務條款。

欄位
terms_of_service

string

需要接受的 termsOfService。
tos_file_uri

string

服務條款檔案的完整網址。這個欄位與 TermsOfService.file_uri 相同，只是為了方便起見而新增。

RetrieveForApplicationTermsOfServiceAgreementStateRequest

RetrieveForApplicationTermsOfServiceAgreementState 方法的要求訊息。

欄位
parent

string

必要欄位。要取得「TermsOfServiceAgreementState」格式的帳戶：accounts/{account}

RetrieveLatestTermsOfServiceRequest

RetrieveLatestTermsOfService 方法的要求訊息。

欄位
region_code

string

必要欄位。CLDR 定義的區域代碼。如果條款僅適用於特定國家/地區，則為該國家/地區；如果適用於全球，則為 001。
kind

TermsOfServiceKind

必要欄位。這個服務條款版本適用的類型。

列

請附上儲存格清單。

欄位
cells[]

Value

必要欄位。組成該列的儲存格清單。必須與 columnHeaders 的長度相同 (二維表格)，長度為 1 (一維表格)。

服務

運送服務。

欄位
delivery_countries[]

string

必要欄位。服務適用的國家/地區 CLDR 地域代碼。
rate_groups[]

RateGroup

選用設定。運送費率群組定義。只有最後一個群組可以有空白的 applicable_shipping_labels，代表「其他所有」群組。其他 applicable_shipping_labels 不得重疊。
loyalty_programs[]

LoyaltyProgram

選用設定。這項運送服務僅適用於哪些會員方案？
service_name

string

必要欄位。服務的自由格式名稱。在目標帳戶中不得重複。
active

bool

必要欄位。布林值，用於公開運送服務的有效狀態。
currency_code

string

這項服務適用的貨幣 CLDR 代碼。必須與費率群組中的價格相符。
delivery_time

DeliveryTime

必要欄位。從下單到產品送達，各個環節所需的時間。
shipment_type

ShipmentType

這項服務運送訂單的地區類型。
minimum_order_value

Price

這項服務的最低訂單價值。如果已設定，表示顧客必須至少消費這個金額。服務中的所有價格都必須使用相同的貨幣。無法與 minimum_order_value_table 一同設定。
minimum_order_value_table

MinimumOrderValueTable

下表列出自取出貨類型每間商店的最低訂單價值。無法與 minimum_order_value 一併設定。
store_config

StoreConfig

產品運送商店清單。這項功能僅適用於店面運送貨件類型。

LoyaltyProgram

商家提供的會員方案。

欄位
loyalty_program_tiers[]

LoyaltyProgramTiers

選用設定。這項運送服務的會員方案等級。
program_label

string

你在 Merchant Center 會員方案中所設定的會員方案標籤。Google 會根據這項子屬性將你的會員方案對應至符合資格的商品。

LoyaltyProgramTiers

商家會員方案的子集。

欄位
tier_label

string

會員等級標籤 [tier_label] 子屬性可用於區分不同會員等級的商品層級福利。你也會在 Merchant Center 會員方案中設定這項屬性值；即使會員方案只有 1 個等級，變更資料來源時你也必須提供這個屬性值。

ShipmentType

運送服務的貨件類型。

列舉
SHIPMENT_TYPE_UNSPECIFIED 這項服務未指定運送類型。
DELIVERY 這項服務會將訂單運送至消費者選擇的地址。
LOCAL_DELIVERY 這項服務會將訂單運送至消費者選擇的地址。訂單會從附近的當地商店出貨。
COLLECTION_POINT 這項服務會將訂單運送至消費者選擇的地址。訂購商品會從集貨地點出貨。

StoreConfig

產品運送商店清單。這項功能僅適用於店面運送貨件類型。

欄位
store_codes[]

string

選用設定。提供當地運送服務的商店代碼清單。如果為空白，則 all_stores 必須為 true。
store_service_type

StoreServiceType

指出商家列出的所有商店或特定商店是否提供當地運送服務。
cutoff_config

CutoffConfig

當天結束的本機提交相關設定。
service_radius

Distance

最大運送範圍半徑。這項屬性僅適用於店面運送貨件類型。

CutoffConfig

當天結束的本機提交相關設定。

欄位
local_cutoff_time

LocalCutoffTime

當天店面到貨服務結束的時間。
store_close_offset_hours

int64

僅適用於當地出貨服務。以商店打烊前幾小時的數量代表截止時間。與 local_cutoff_time 互斥。
no_delivery_post_cutoff

bool

如果商家已將運送服務設為 n 天店到店運送，就能選擇不顯示 n+1 天店到店運送服務。舉例來說，如果運送服務定義為當天到貨，且已超過截止時間，將這個欄位設為 true 會導致計算的運送服務費率傳回 NO_DELIVERY_POST_CUTOFF。在同一個範例中，將這個欄位設為 false 會導致計算出的運送時間為一天。這項功能僅適用於店面運送。

LocalCutoffTime

當天店面到貨服務結束的時間。

欄位
hour

int64

當天處理的店到店配送訂單必須在指定時間前下單。
minute

int64

訂單必須在當天處理的訂單截止時間前下單，才能在當天處理。

StoreServiceType

指出商家列出的所有商店或特定商店是否提供當地運送服務。

列舉
STORE_SERVICE_TYPE_UNSPECIFIED 未指定商店服務類型。
ALL_STORES 指出商家目前和未來列出的所有商店是否提供本地運送服務。
SELECTED_STORES 表示只有 store_codes 中列出的商店符合店面運送資格。

ShippingSettings

商家帳戶的運送設定。

欄位
name

string

ID。運送設定的資源名稱。格式：accounts/{account}/shippingSetting
services[]

Service

選用設定。目標帳戶的服務清單。
warehouses[]

Warehouse

選用設定。可在 services 中參照的倉庫清單。
etag

string

必要欄位。這個欄位可用於避免非同步問題。請確認在呼叫 get 和插入呼叫之間，運送設定資料不會變更。使用者應採取下列步驟：

  1. 在建立初始運送設定時，將 etag 欄位設為空字串。

  2. 初始建立後，請先呼叫 get 方法取得 etag 和目前的運送設定資料，再呼叫 insert。

  3. 修改為所需的運送設定資訊。

  4. 使用從步驟 2 取得的 etag，搭配所需的運送設定資訊呼叫插入方法。

  5. 如果在步驟 2 和步驟 4 之間，運送設定資料有變更，插入要求會失敗，因為每次運送設定資料變更時，etag 都會變更。使用者應使用新的 etag 重複執行步驟 2 至 4。

資料表

當 single_value 無法充分表達時，定義費率群組的表格。

欄位
rows[]

Row

必要欄位。構成資料表的資料列清單。必須與 row_headers 的長度相同。
name

string

資料表名稱。子表格必填，主表格則忽略。
row_headers

Headers

必要欄位。表格列的標題。
column_headers

Headers

表格欄的標題。選用：如果未設定，則資料表只有一個維度。

TermsOfService

TermsOfService 訊息代表商家必須接受的特定服務條款版本，才能存取特定功能或服務 (請參閱 https://support.google.com/merchants/answer/160173)。

這則訊息對於新手上路流程至關重要，可確保商家同意使用服務所需的法律協議。商家可以透過 RetrieveLatestTermsOfService 擷取特定 kind 和 region 的最新服務條款，並透過 AcceptTermsOfService 接受必要的條款。

欄位
name

string

ID。服務條款版本的資源名稱。格式：termsOfService/{version}
region_code

string

CLDR 定義的區域代碼。這可以是適用於特定國家/地區的條款，或是 001，當相同的 TermsOfService 可在任何國家/地區簽署時。不過請注意，在簽署適用於全球的服務條款時，您仍須提供特定國家/地區 (應為商家所在國家/地區或參與計畫的國家/地區)。
kind

TermsOfServiceKind

這個服務條款版本適用的類型。
external

bool

這個《服務條款》版本是否為外部版本。外部服務條款版本只能透過外部程序同意，商家不得直接透過 UI 或 API 同意。
file_uri

string

服務條款檔案的 URI，需要向簽署使用者顯示。

TermsOfServiceAgreementState

這個資源代表特定帳戶和服務條款類型的協議狀態。狀態如下：

  • 如果商家已接受服務條款，系統會填入「已接受」，否則會留空
  • 如果商家必須簽署服務條款，系統會填入「required」；否則會留空。

請注意，required 和 accepted 都可能出現在同一行。在這種情況下，accepted 服務條款的到期日會設在 valid_until 欄位中。required 服務條款必須在 valid_until 前接受，帳戶才能繼續擁有有效的合約。接受新服務條款時，我們希望第三方顯示與特定服務條款協議相關聯的文字 (包含文字的檔案網址已在下方必要訊息中加入，做為 tos_file_uri)。您可以對 TermsOfService 資源呼叫 accept，實際接受服務條款。

欄位
name

string

ID。服務條款版本的資源名稱。格式：accounts/{account}/termsOfServiceAgreementState/{identifier} ID 格式為：{TermsOfServiceKind}-{country} 例如：MERCHANT_CENTER-US
region_code

string

根據 https://cldr.unicode.org/ 定義的區碼。這是目前狀態適用的國家/地區。
terms_of_service_kind

TermsOfServiceKind

與特定版本相關聯的服務條款類型。
accepted

Accepted

已接受的這類服務條款，以及相關聯的 region_code
required

Required

必要的服務條款

TermsOfServiceKind

服務條款類型。

列舉
TERMS_OF_SERVICE_KIND_UNSPECIFIED 預設值。此值未使用。
MERCHANT_CENTER Merchant Center 應用程式。

TransitTable

運送時間表格：根據列和欄維度，計算運送所需的工作天數。您可以設定 min_transit_days、max_transit_days 或 transit_time_table，但不能同時設定兩者。

欄位
postal_code_group_names[]

string

必要欄位。區域名稱清單 Region.name。最後一個值可以是 "all other locations"。範例：["zone 1", "zone 2", "all other locations"]。所指的郵遞區號群組必須與服務的運送國家/地區相符。
transit_time_labels[]

string

必要欄位。運送時間標籤清單。最後一個值可以是 "all other labels"。範例：["food", "electronics", "all other labels"]。
rows[]

TransitTimeRow

必要欄位。如果只有一個 postal_code_group_names 或 transit_time_labels 維度集，則會有多個資料列，每個資料列都包含該維度的一個值。如果有兩個維度，每個資料列都會對應至 postal_code_group_names，而資料欄 (值) 則會對應至 transit_time_labels。

TransitTimeRow

如果只有一個 postal_code_group_names 或 transit_time_labels 維度集，則會有多個資料列，每個資料列都包含該維度的一個值。如果有兩個維度，每個資料列都會對應至 postal_code_group_names，而資料欄 (值) 則會對應至 transit_time_labels。

欄位
values[]

TransitTimeValue

必要欄位。運送時間範圍 (最小至最大)，以工作天為單位。

TransitTimeValue

運送時間範圍 (最小至最大)，以工作天為單位。

欄位
min_transit_days

int32

最短運送時間範圍 (以工作天為單位)。0 代表當天到貨，1 代表次日到貨。
max_transit_days

int32

必須大於或等於 min_transit_days。

UnclaimHomepageRequest

UnclaimHomepage 方法的要求訊息。

欄位
name

string

必要欄位。要取消宣稱的首頁名稱。格式：accounts/{account}/homepage

UpdateAccountRequest

UpdateAccount 方法的要求訊息。

欄位
account

Account

必要欄位。帳戶的新版本。
update_mask

FieldMask

選用設定。要更新的欄位清單。

系統支援下列欄位 (snake_case 和 lowerCamelCase 皆適用)：

  • account_name
  • adult_content
  • language_code
  • time_zone

UpdateAutofeedSettingsRequest

UpdateAutofeedSettings 方法的要求訊息。

欄位
autofeed_settings

AutofeedSettings

必要欄位。新版自動動態饋給設定。
update_mask

FieldMask

必要欄位。要更新的欄位清單。

UpdateBusinessIdentityRequest

UpdateBusinessIdentity 方法的要求訊息。

欄位
business_identity

BusinessIdentity

必要欄位。商家身分的新版本。
update_mask

FieldMask

選用設定。要更新的欄位清單。

系統支援下列欄位 (snake_case 和 lowerCamelCase 皆適用)：

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

UpdateBusinessInfoRequest

UpdateBusinessInfo 方法的要求訊息。

欄位
business_info

BusinessInfo

必要欄位。新版商家資訊。
update_mask

FieldMask

選用設定。要更新的欄位清單。

系統支援下列欄位 (snake_case 和 lowerCamelCase 皆適用)：

  • address
  • customer_service
  • korean_business_registration_number

UpdateEmailPreferencesRequest

UpdateEmailPreferences 方法的要求訊息。

欄位
email_preferences

EmailPreferences

必要欄位。要更新的電子郵件接收設定。
update_mask

FieldMask

必要欄位。要更新的欄位清單。

系統支援下列欄位 (snake_case 和 lowerCamelCase 皆適用)：

  • news_and_tips

UpdateHomepageRequest

UpdateHomepage 方法的要求訊息。

欄位
homepage

Homepage

必要欄位。新版首頁。
update_mask

FieldMask

選用設定。要更新的欄位清單。

系統支援下列欄位 (snake_case 和 lowerCamelCase 皆適用)：

  • uri

UpdateRegionRequest

UpdateRegion 方法的要求訊息。

欄位
region

Region

必要欄位。更新後的區域。
update_mask

FieldMask

選用設定。以半形逗號分隔的欄位遮罩，用於指定要更新的欄位。範例："displayName,postalCodeArea.regionCode"。

UpdateUserRequest

UpdateUser 方法的要求訊息。

欄位
user

User

必要欄位。使用者的新版本。

使用 me 來表示自己的電子郵件地址，例如 accounts/{account}/users/me。
update_mask

FieldMask

選用設定。要更新的欄位清單。

系統支援下列欄位 (snake_case 和 lowerCamelCase 皆適用)：

  • access_rights

使用者

User 訊息代表與 Merchant Center 帳戶相關聯的使用者。用於管理帳戶中的使用者權限和存取權。詳情請參閱使用者和存取層級的常見問題。

欄位
name

string

ID。使用者的資源名稱。格式：accounts/{account}/user/{email}

使用 me 來表示自己的電子郵件地址，例如 accounts/{account}/users/me。
state

State

僅供輸出。使用者的狀態。
access_rights[]

AccessRight

選用設定。使用者擁有的存取權。

州

使用者的可能狀態。

列舉
STATE_UNSPECIFIED 預設值。此值未使用。
PENDING 使用者尚未確認。在這個狀態下，使用者必須先接受邀請，才能執行其他動作。
VERIFIED 使用者已通過驗證。

值

費率群組的單一值，或費率群組表格儲存格的值。必須明確設為 no_shipping、flat_rate、price_percentage、carrier_rateName 或 subtable_name 其中之一。

欄位
no_shipping

bool

如果為 true，則表示產品無法運送。設定時必須設為 true，且只能在所有其他欄位未設定的情況下設定。
flat_rate

Price

固定費率。只有在所有其他欄位未設定時，才能設定此欄位。
price_percentage

string

以小數表示的價格百分比 (例如 "5.4")。只有在未設定所有其他欄位時，才能設定此欄位。
carrier_rate

string

運送公司費率的名稱，指的是同一個費率群組中定義的運送公司費率。只有在所有其他欄位未設定時，才能設定此欄位。
subtable

string

子表格的名稱。只能在表格儲存格中設定 (例如，不能用於單一值)，且只有在所有其他欄位都未設定的情況下才能設定。

Warehouse

出貨倉庫，用於儲存及處理商品目錄。

欄位
name

string

必要欄位。倉庫名稱。在帳戶中不得重複。
shipping_address

Address

必要欄位。倉庫的運送地址。
cutoff_time

WarehouseCutoffTime

必要欄位。訂單可接受及開始處理的最後時間。後續訂單會在隔天處理。時間會根據倉庫的郵遞區號計算。
handling_days

int64

必要欄位。這個倉庫裝箱及出貨商品所需的天數。這是在倉庫層級，但可以根據商品屬性，在商品層級覆寫。
business_day_config

BusinessDayConfig

倉庫的工作天數。如果未設定，預設值為週一至週五。

WarehouseBasedDeliveryTime

表示系統應根據所選貨運公司的設定，為每個倉庫 (運送原點位置) 計算送達時間。設定後，delivery_time 中不得再設定其他與運送時間相關的欄位。

欄位
carrier

string

必要欄位。載具，例如 "UPS" 或 "Fedex"。支援的電信業者
carrier_service

string

必要欄位。電信服務，例如 "ground" 或 "2 days"。服務名稱必須列在 eddSupportedServices 清單中。
warehouse

string

必要欄位。倉儲名稱。這個值應與 [warehouse][ShippingSetting.warehouses.name] 相符

WarehouseCutoffTime

訂單可接受及開始處理的最後時間。後續訂單會在隔天處理。時間會根據倉庫的郵遞區號計算。

欄位
hour

int32

必要欄位。截止時間的指定小時，即訂單必須在截止時間前下單，才能在當天由倉庫處理。小時以倉庫所在的時區為準。
minute

int32

必要欄位。截止時間的最後幾分鐘，訂單必須在這個時間前下單，才能在當天由倉庫處理。分鐘是根據倉庫的時區計算。