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 メソッドの便利なラッパーです。このメソッドは、relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION")) フィルタを使用して ListsAccounts を呼び出す場合と同じ結果を生成します。

認可スコープ

次の 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

ビジネス ID API をサポートするサービス。

GetBusinessIdentity

rpc GetBusinessIdentity(GetBusinessIdentityRequest) returns (BusinessIdentity)

アカウントのビジネス ID を取得します。

認可スコープ

次の OAuth スコープが必要です。

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

詳しくは、OAuth 2.0 の概要をご覧ください。

UpdateBusinessIdentity

rpc UpdateBusinessIdentity(UpdateBusinessIdentityRequest) returns (BusinessIdentity)

アカウントのビジネス ID を更新します。このメソッドを実行するには、管理者権限が必要です。

認可スコープ

次の OAuth スコープが必要です。

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

詳しくは、OAuth 2.0 の概要をご覧ください。

BusinessInfoService

ビジネス情報 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: ユーザーにこの MC アカウントに必要な権限がない。* FAILED_PRECONDITION: - アカウントが Merchant Center アカウントではない。- MC アカウントにホームページがない。- 申し立てが失敗した(この場合、エラー メッセージに詳細が含まれます)。

認可スコープ

次の 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)

指定された kindregion_codeTermsOfService の最新バージョンを取得します。

認可スコープ

次の 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 はこの日付(UTC)の終了日まで有効であると明記されます。期限までに新しいポリシーに同意する必要があります。必須の TermsOfService の情報は、[必須] メッセージに表示されます。

AccessRight

アクセス権。

列挙型
ACCESS_RIGHT_UNSPECIFIED デフォルト値。この値は使用されません。
STANDARD 標準のアクセス権。
ADMIN 管理者アクセス権。
PERFORMANCE_REPORTING この権限を持つユーザーは、パフォーマンスと分析情報にアクセスできます。

アカウント

Account メッセージは、ショッピング広告内の販売者のアカウントを表します。商品データ、設定、Google のサービスや外部プロバイダとのやり取りを管理するための主なエンティティです。

アカウントは、単独で運用することも、マルチクライアント アカウント(MCA)の構造の一部として運用することもできます。MCA の設定では、親アカウントが複数のサブアカウントを管理します。

アカウントを設定するには、アカウント名、タイムゾーン、言語設定などの属性を構成する必要があります。

Account メッセージは、AccountRelationshipHomepageBusinessInfo など、他の多くのリソースの親エンティティです。

フィールド
name

string

ID。アカウントのリソース名。形式: accounts/{account}

account_id

int64

出力専用。アカウントの ID。

account_name

string

必須。アカウントの人間が読める形式の名前。詳しくは、ショップ名ビジネスの名前をご覧ください。

adult_content

bool

このアカウントにアダルト コンテンツが含まれているかどうか。

test_account

bool

出力専用。テスト アカウントかどうか。

time_zone

TimeZone

必須。アカウントのタイムゾーンです。

書き込み時に、time_zonereporting_time_zonedisplay_time_zone の両方を設定します。

読み取りの場合、time_zone は常に display_time_zone を返します。アカウントに display_time_zone が存在しない場合、time_zone は空になります。

language_code

string

必須。アカウントの BCP-47 言語コードen-USsr-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。ビジネス 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

ID 属性に関連するすべての情報。

フィールド
identity_declaration

IdentityDeclaration

必須。この属性の ID の宣言。

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_codeaddress_linespostal_codeadministrative_arealocality のみです。他のフィールドはすべて無視されます。

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

必須。作成されるアカウントとプロバイダ アカウント間のアカウント サービスは、作成の一部として初期化されます。このようなサービスを少なくとも 1 つ指定する必要があります。現在、これらのうち 1 つを account_aggregation にする必要があります。つまり、この方法ではサブアカウントのみを作成でき、スタンドアロン アカウントを作成することはできません。追加の account_management サービスまたは product_management サービスが提供される場合があります。

AddAccountService

アカウントの作成時にアカウント サービスを追加するための追加手順。

フィールド
共用体フィールド service_type。追加するサービスタイプ。service_type は次のいずれかになります。
account_aggregation

AccountAggregation

プロバイダは、アカウントのアグリゲータです。サービスタイプ「アカウントの集計」のペイロード。

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}

accounts/{account}/users/me のようにメールアドレスではなく me を使用して、呼び出し元に対応するユーザーを削除することもできます。

DeliveryTime

注文から商品の配送までのさまざまな段階で費やされる時間。

フィールド
warehouse_based_delivery_times[]

WarehouseBasedDeliveryTime

省略可。選択した運送業者の設定に基づいて、倉庫(発送元)ごとにお届け日数を計算する必要があることを示します。設定する場合は、[delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] の他のお届け日数関連フィールドは設定しないでください。

min_transit_days

int32

配送にかかる最短の営業日数。0 は当日配達、1 は翌日配達を意味します。min_transit_daysmax_transit_daystransit_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_daysmax_transit_daystransit_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

必須。ビジネス ID のリソース名。形式: 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}

accounts/{account}/users/me のようにメールアドレスではなく me を使用して、呼び出し元に対応するユーザーを取得することもできます。

ヘッダー

テーブルの行または列のヘッダーの空ではないリスト。pricesweightsnum_itemspostal_code_group_nameslocation のいずれか 1 つを設定する必要があります。

フィールド
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 つのサービス内のすべての価格は同じ通貨にする必要があります。空でないこと。-1 を除き、正の数値を指定してください。他のすべてのフィールドが設定されていない場合にのみ設定できます。

weights[]

Weight

必須。注文重量の上限(含む)のリスト。最後の重みの値は、price 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 メッセージは、システム内の販売者のストアのホームページを表します。

販売者のホームページは、ユーザーがショップを操作するプライマリ ドメインです。

ホームページは所有権の証明として申請して確認できるため、販売者はウェブサイトの確認が必要な機能を利用できるようになります。詳しくは、オンライン ショップの URL の確認についてをご覧ください。

フィールド
name

string

ID。ストアのホームページのリソース名。形式: accounts/{account}/homepage

claimed

bool

出力専用。ホームページが申請されているかどうか。https://support.google.com/merchants/answer/176793 をご覧ください。

uri

string

必須。ショップのホームページの URI(通常は URL)。

InsertShippingSettingsRequest

InsertShippingSetting メソッドに対するリクエスト メッセージ。

フィールド
parent

string

必須。この商品を挿入するアカウント。形式: accounts/{account}

shipping_setting

ShippingSettings

必須。アカウントの新しいバージョン。

ListAccountIssuesRequest

ListAccountIssues メソッドに対するリクエスト メッセージ。

フィールド
parent

string

必須。この問題のコレクションを所有する親。形式: accounts/{account}

page_size

int32

省略可。返される問題の最大数。サービスが返す値はこれよりも少ないことがあります。指定されていない場合は、最大で 50 人のユーザーが返されます。最大値は 100 です。100 を超える値は 100 に強制変換されます

page_token

string

省略可。前回の ListAccountIssues 呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。

ページ分割を行う場合、ListAccountIssues に指定する他のすべてのパラメータは、ページトークンを提供した呼び出しと一致する必要があります。

language_code

string

省略可。レスポンス内の問題には、指定された言語で人が読めるフィールドが含まれます。形式は BCP-47 です(例: en-USsr-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 を超える値は 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 より少ない場合、サービスは 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

省略可。1 回のレスポンスで返されるプログラムの最大数。指定しない場合(または 0 の場合)、デフォルトのサイズ 1,000 が使用されます。最大値は 1,000 です。1,000 を超える値は 1,000 に強制変換されます。

page_token

string

省略可。前回の ListPrograms 呼び出しから受け取った継続トークン。次のページを取得するにはこれを指定します。

ListProgramsResponse

ListPrograms メソッドのレスポンス メッセージ。

フィールド
programs[]

Program

指定したアカウントのプログラム。

next_page_token

string

次のページを取得するために page_token として送信できるトークン。このフィールドを省略すると、後続のページはなくなります。

ListRegionsRequest

ListRegions メソッドに対するリクエスト メッセージ。

フィールド
parent

string

必須。リージョンを一覧表示するアカウント。形式: accounts/{account}

page_size

int32

省略可。返されるリージョンの最大数。サービスが返す値はこれよりも少ないことがあります。指定されていない場合は、最大で 50 個のリージョンが返されます。最大値は 1,000 です。1,000 を超える値は 1,000 に強制変換されます。

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 を超える値は 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 を超える値は 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)を共有するストアコードセットのリスト。少なくとも 2 つのセットが必要です。最後のセットは空にする必要があります。これは「他のすべてのストアに対して MOV」を意味します。各ストアコードは、すべてのセットで 1 回だけ使用できます。1 つのサービス内のすべての価格は同じ通貨にする必要があります。

StoreCodeSetWithMov

同じ最低注文額を共有するストアコードセットのリスト。少なくとも 2 つのセットが必要です。最後のセットは空にする必要があります。これは「他のすべてのストアに対して MOV」を意味します。各ストアコードは、すべてのセットで 1 回だけ使用できます。1 つのサービス内のすべての価格は同じ通貨にする必要があります。

フィールド
store_codes[]

string

省略可。一意の店舗コードのリスト。カテゴリ全体を指定する場合は空白にします。

value

Price

指定された店舗の最低注文額。

OnlineReturnPolicy

オンライン返品に関するポリシー オブジェクト。現在、広告と無料リスティング プログラムの返品に関するポリシーを表すために使用されています。

フィールド
name

string

ID。OnlineReturnPolicy リソースの名前。形式: accounts/{account}/onlineReturnPolicies/{return_policy}

return_policy_id

string

出力専用。Google が生成した返品に関するポリシー ID。

label

string

必須。このフィールドは、返品ポリシーの一意のユーザー定義ラベルを表します。同じ国で異なる返品に関するポリシーで同じラベルを使用することはできません。商品で特定のラベル属性が指定されていない限り、ポリシーには自動的に「default」というラベルが付けられます。特定の商品グループにカスタムの返品ポリシーを割り当てるには、返品ポリシーラベルの手順に沿って操作します。ラベルには最大 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 がポリシーのサニティ チェックを行う際に使用されます。有効な URL を指定してください。

accept_defective_only

bool

このフィールドは、販売者が返品として欠陥のある商品のみを受け付けるかどうかを指定します。このフィールドは必須です。

process_refund_days

int32

このフィールドには、販売者が払い戻しを処理するまでに要する日数を指定します。このフィールドは省略可能です。

accept_exchange

bool

このフィールドは、販売者が商品の交換を許可しているかどうかを指定します。このフィールドは必須です。

ItemCondition

使用可能な商品の状態。

列挙型
ITEM_CONDITION_UNSPECIFIED デフォルト値。この値は使用されません。
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

返品送料の金額を修正しました。この値は、type が 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 ヘルプページの URL。

state

State

出力専用。プログラムへのアカウントの参加状態。

active_region_codes[]

string

出力専用。アカウントがプログラムに積極的に参加している地域。アクティブなリージョンとは、そのリージョンに影響するすべてのプログラム要件が満たされているリージョンのことです。

地域コードは CLDR で定義されています。プログラムがその国にのみ適用される国か、プログラムが全世界に適用される場合は 001 です。

unmet_requirements[]

Requirement

出力専用。アカウントがまだ満たしていない要件で、プログラムへの参加に影響しているもの。

要件

プログラムへの参加に指定された要件を定義します。

フィールド
title

string

出力専用。要件の名前。

documentation_uri

string

出力専用。要件を説明するヘルプページの URL。

affected_region_codes[]

string

出力専用。現在、この要件が満たされていないリージョン。

地域コードは CLDR で定義されています。プログラムがその国にのみ適用される国か、プログラムが全世界に適用される場合は 001 です。

アカウントのプログラム参加の状態。

列挙型
STATE_UNSPECIFIED デフォルト値。この値は使用されません。
NOT_ELIGIBLE アカウントがプログラムに参加する資格を有していない。
ELIGIBLE アカウントがプログラムへの参加資格を満たしている。
ENABLED アカウントでプログラムが有効になっている。

RateGroup

送料グループの定義。空の applicable_shipping_labels を指定できるのは最後のみです。これは「その他すべて」を意味します。他の applicable_shipping_labels は重ならないようにしてください。

フィールド
applicable_shipping_labels[]

string

必須。この料金グループが適用される商品を定義する送料ラベルのリスト。これは排他的論理演算です。料金グループを適用するには、ラベルのいずれか 1 つが一致している必要があります。空にできるのは、サービスの最後の料金グループの場合のみです。

subtables[]

Table

省略可。main_table が参照するサブテーブルのリスト。main_table が設定されている場合にのみ設定できます。

carrier_rates[]

CarrierRate

省略可。main_table または single_value で参照できる携帯通信会社の料金のリスト。

single_value

Value

料金グループの値(例: 定額料金 10 米ドル)。main_tablesubtables が設定されていない場合にのみ設定できます。

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

必須。郵便番号または、地域を定義する範囲の下限を含む形式の接頭辞* のパターン。値の例: 941089410*9*

end

string

省略可。郵便番号、または地域を定義する範囲の上限を示す prefix* 形式のパターン。郵便番号範囲の開始値と同じ長さにする必要があります。郵便番号範囲の開始値が郵便番号の場合は、郵便番号範囲の終了値も郵便番号にする必要があります。郵便番号範囲の開始値がパターンの場合は、郵便番号範囲の終了値も同じ接頭辞の長さのパターンにする必要があります。省略可: 設定しない場合、postalCodeRangeBegin に一致するすべての郵便番号がエリアとして定義されます。

必須

同意が必要な利用規約を説明します。

フィールド
terms_of_service

string

同意が必要な termsOfService

tos_file_uri

string

利用規約ファイルの完全な URL。このフィールドは TermsOfService.file_uri と同じです。便宜上ここに追加されています。

RetrieveForApplicationTermsOfServiceAgreementStateRequest

RetrieveForApplicationTermsOfServiceAgreementState メソッドに対するリクエスト メッセージ。

フィールド
parent

string

必須。TermsOfServiceAgreementState を取得するアカウント。形式: accounts/{account}

RetrieveLatestTermsOfServiceRequest

RetrieveLatestTermsOfService メソッドに対するリクエスト メッセージ。

フィールド
region_code

string

必須。CLDR で定義されている地域コード。利用規約がその国にのみ適用される場合は国、グローバルに適用される場合は 001 です。

kind

TermsOfServiceKind

必須。この利用規約のバージョンが適用される Kind。

セルのリストを指定します。

フィールド
cells[]

Value

必須。行を構成するセルのリスト。2 次元テーブルの場合は columnHeaders と同じ長さ、1 次元テーブルの場合は長さが 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

このサービスの最低注文額。設定した場合、ユーザーは少なくともこの金額の購入が必要になります。1 つのサービス内のすべての価格は同じ通貨にする必要があります。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 のポイント プログラム設定で設定するポイント プログラム ラベルです。このサブ属性を使用すると、貴社のポイント プログラムが対象の商品にマッピングされます。

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 に設定すると、計算される配送時間は 1 日になります。地域限定の配送のみです。

LocalCutoffTime

当日ローカル配達が終了する時間。

フィールド
hour

int64

当日配達の注文は、当日処理するために、この時間までに注文する必要があります。

minute

int64

当日配達の注文は、同日に処理されるように、午後 3 時までに注文する必要があります。

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 呼び出しと insert 呼び出しの間で配送設定データが変更されていないことを確認します。お客様は次の手順を行う必要があります。

  1. 最初の配送設定の作成時に etag フィールドを空の文字列に設定。

  2. 最初に作成した後、get メソッドを呼び出して etag と現在の配送設定データを取得してから、insert を呼び出します。

  3. 必要な配送設定情報に変更します。

  4. ステップ 2 で取得した etag を使用して、目的の配送設定情報で insert メソッドを呼び出します。

  5. 手順 2 と手順 4 の間で配送設定データが変更された場合。送料設定データが変更されるたびに etag が変更されるため、挿入リクエストは失敗します。新しい etag を使用して、手順 2 ~ 4 を繰り返します。

single_value では十分に表現できない場合に、レートグループを定義するテーブル。

フィールド
rows[]

Row

必須。テーブルを構成する行のリスト。row_headers と同じ長さにする必要があります。

name

string

テーブルの名前。サブテーブルでは必須ですが、メインテーブルでは無視されます。

row_headers

Headers

必須。テーブルの行のヘッダー。

column_headers

Headers

テーブルの列のヘッダー。省略可: 設定しない場合、テーブルにはディメンションが 1 つだけになります。

TermsOfService

TermsOfService メッセージは、特定の機能やサービスにアクセスするために販売者が同意する必要がある利用規約の特定のバージョンを表します(https://support.google.com/merchants/answer/160173) をご覧ください)。

このメッセージは、販売者がサービスの利用に必要な法的契約に同意することを確認するためのオンボーディング プロセスにおいて重要です。販売者は、RetrieveLatestTermsOfService を使用して特定の kindregion の最新の利用規約を取得し、必要に応じて AcceptTermsOfService を使用して同意できます。

フィールド
name

string

ID。利用規約のバージョンのリソース名。形式: termsOfService/{version}

region_code

string

CLDR で定義されている地域コード。利用規約がその国にのみ適用される国か、001(同じ TermsOfService がどの国でも署名できる場合)です。ただし、世界中で適用される利用規約に署名する場合は、特定の国(販売者のビジネス拠点の国またはプログラムに参加している国)を指定する必要があります。

kind

TermsOfServiceKind

この利用規約のバージョンが適用される Kind。

external

bool

この利用規約のバージョンが社外向けかどうか。外部利用規約のバージョンは、外部プロセスを通じてのみ同意できます。販売者が UI または API を通じて直接同意することはできません。

file_uri

string

署名するユーザーに表示する必要がある利用規約ファイルの URI。

TermsOfServiceAgreementState

このリソースは、特定のアカウントと利用規約の種類の同意状態を表します。状態は次のとおりです。

  • 販売者が利用規約に同意している場合: [accepted] が入力されます。同意していない場合は空白になります
  • 販売者が利用規約に署名する必要がある場合は [必須] が入力されます。それ以外の場合は空白になります。

必須承認済みの両方を指定できます。この場合、accepted 利用規約の valid_until フィールドに有効期限が設定されます。アカウントの有効な契約を継続するには、valid_until より前に required 利用規約に同意する必要があります。新しい利用規約に同意する際に、サードパーティは、特定の利用規約に関連付けられたテキストを表示する必要があります(テキストを含むファイルの URL は、以下の必須メッセージに tos_file_uri として追加されます。利用規約の実際の承認は、TermsOfService リソースで accept を呼び出すことによって行われます。

フィールド
name

string

ID。利用規約のバージョンのリソース名。形式: accounts/{account}/termsOfServiceAgreementState/{identifier} 識別子の形式は {TermsOfServiceKind}-{country} です。識別子の例: MERCHANT_CENTER-US

region_code

string

https://cldr.unicode.org/ で定義されている地域コード。現在の状態が適用される国です。

terms_of_service_kind

TermsOfServiceKind

特定のバージョンに関連付けられている利用規約の種類。

accepted

Accepted

この種類と関連する region_code の承認済み利用規約

required

Required

必要な利用規約

TermsOfServiceKind

TermsOfService の種類。

列挙型
TERMS_OF_SERVICE_KIND_UNSPECIFIED デフォルト値。この値は使用されません。
MERCHANT_CENTER Merchant Center アプリケーション。

TransitTable

お届け日数表: 行と列のディメンションに基づくお届けまでの営業日数。min_transit_daysmax_transit_daystransit_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 のディメンション セットが 1 つしかない場合、そのディメンションの値が 1 つの行に複数存在します。ディメンションが 2 つある場合、各行は postal_code_group_names に対応し、列(値)は transit_time_labels に対応します。

TransitTimeRow

postal_code_group_names または transit_time_labels のディメンション セットが 1 つしかない場合、そのディメンションの値が 1 つの行に複数存在します。ディメンションが 2 つある場合、各行は 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_caselowerCamelCase の両方でサポートされています)。

  • 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_caselowerCamelCase の両方でサポートされています)。

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

UpdateBusinessInfoRequest

UpdateBusinessInfo メソッドに対するリクエスト メッセージ。

フィールド
business_info

BusinessInfo

必須。新しいバージョンのビジネス情報。

update_mask

FieldMask

省略可。更新されるフィールドのリスト。

次のフィールドがサポートされています(snake_caselowerCamelCase の両方でサポートされています)。

  • address
  • customer_service
  • korean_business_registration_number

UpdateEmailPreferencesRequest

UpdateEmailPreferences メソッドのリクエスト メッセージ。

フィールド
email_preferences

EmailPreferences

必須。メール設定を更新します。

update_mask

FieldMask

必須。更新されるフィールドのリスト。

次のフィールドがサポートされています(snake_caselowerCamelCase の両方でサポートされています)。

  • news_and_tips

UpdateHomepageRequest

UpdateHomepage メソッドに対するリクエスト メッセージ。

フィールド
homepage

Homepage

必須。新しいバージョンのホームページ。

update_mask

FieldMask

省略可。更新されるフィールドのリスト。

次のフィールドがサポートされています(snake_caselowerCamelCase の両方でサポートされています)。

  • uri

UpdateRegionRequest

UpdateRegion メソッドに対するリクエスト メッセージ。

フィールド
region

Region

必須。更新されたリージョン。

update_mask

FieldMask

省略可。更新するフィールドを示すカンマ区切りのフィールド マスク。例: "displayName,postalCodeArea.regionCode"

UpdateUserRequest

UpdateUser メソッドに対するリクエスト メッセージ。

フィールド
user

User

必須。ユーザーの新しいバージョン。

me は、自分のメールアドレスを参照します(例: accounts/{account}/users/me)。

update_mask

FieldMask

省略可。更新されるフィールドのリスト。

次のフィールドがサポートされています(snake_caselowerCamelCase の両方でサポートされています)。

  • 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_shippingflat_rateprice_percentagecarrier_rateNamesubtable_name のいずれか 1 つを設定する必要があります。

フィールド
no_shipping

bool

true の場合、商品は配送できません。設定時に true にする必要があります。他のすべてのフィールドが設定されていない場合にのみ設定できます。

flat_rate

Price

定額料金。他のすべてのフィールドが設定されていない場合にのみ設定できます。

price_percentage

string

小数表記の数値で表される料金の割合(例: "5.4")。他のすべてのフィールドが設定されていない場合にのみ設定できます。

carrier_rate

string

同じレートグループで定義された運送業者レートを参照する運送業者レートの名前。他のすべてのフィールドが設定されていない場合にのみ設定できます。

subtable

string

サブテーブルの名前。テーブルのセルにのみ設定できます(単一値には設定できません)。また、他のすべてのフィールドが設定されていない場合にのみ設定できます。

倉庫

フルフィルメント ウェアハウス: 在庫を保管して処理します。

フィールド
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

必須。倉庫で当日中に処理されるように注文を完了する必要がある締め切り時間(分単位)。分は倉庫のタイムゾーンに基づいています。