インデックス
AccountIssueService(インターフェース)AccountsService(インターフェース)AutofeedSettingsService(インターフェース)BusinessIdentityService(インターフェース)BusinessInfoService(インターフェース)EmailPreferencesService(インターフェース)HomepageService(インターフェース)OnlineReturnPolicyService(インターフェース)ProgramsService(インターフェース)RegionsService(インターフェース)ShippingSettingsService(インターフェース)TermsOfServiceAgreementStateService(インターフェース)TermsOfServiceService(インターフェース)UserService(インターフェース)AcceptTermsOfServiceRequest(メッセージ)Accepted(メッセージ)AccessRight(列挙型)Account(メッセージ)AccountAggregation(メッセージ)AccountIssue(メッセージ)AccountIssue.ImpactedDestination(メッセージ)AccountIssue.ImpactedDestination.Impact(メッセージ)AccountIssue.Severity(列挙型)Address(メッセージ)AutofeedSettings(メッセージ)BusinessDayConfig(メッセージ)BusinessDayConfig.Weekday(列挙型)BusinessIdentity(メッセージ)BusinessIdentity.IdentityAttribute(メッセージ)BusinessIdentity.IdentityAttribute.IdentityDeclaration(列挙型)BusinessIdentity.PromotionsConsent(列挙型)BusinessInfo(メッセージ)CarrierRate(メッセージ)ClaimHomepageRequest(メッセージ)CreateAndConfigureAccountRequest(メッセージ)CreateAndConfigureAccountRequest.AddAccountService(メッセージ)CreateAndConfigureAccountRequest.AddUser(メッセージ)CreateRegionRequest(メッセージ)CreateUserRequest(メッセージ)CustomerService(メッセージ)CutoffTime(メッセージ)DeleteAccountRequest(メッセージ)DeleteRegionRequest(メッセージ)DeleteUserRequest(メッセージ)DeliveryTime(メッセージ)DisableProgramRequest(メッセージ)Distance(メッセージ)Distance.Unit(列挙型)EmailPreferences(メッセージ)EmailPreferences.OptInState(列挙型)EnableProgramRequest(メッセージ)GetAccountRequest(メッセージ)GetAutofeedSettingsRequest(メッセージ)GetBusinessIdentityRequest(メッセージ)GetBusinessInfoRequest(メッセージ)GetEmailPreferencesRequest(メッセージ)GetHomepageRequest(メッセージ)GetOnlineReturnPolicyRequest(メッセージ)GetProgramRequest(メッセージ)GetRegionRequest(メッセージ)GetShippingSettingsRequest(メッセージ)GetTermsOfServiceAgreementStateRequest(メッセージ)GetTermsOfServiceRequest(メッセージ)GetUserRequest(メッセージ)Headers(メッセージ)Homepage(メッセージ)InsertShippingSettingsRequest(メッセージ)ListAccountIssuesRequest(メッセージ)ListAccountIssuesResponse(メッセージ)ListAccountsRequest(メッセージ)ListAccountsResponse(メッセージ)ListOnlineReturnPoliciesRequest(メッセージ)ListOnlineReturnPoliciesResponse(メッセージ)ListProgramsRequest(メッセージ)ListProgramsResponse(メッセージ)ListRegionsRequest(メッセージ)ListRegionsResponse(メッセージ)ListSubAccountsRequest(メッセージ)ListSubAccountsResponse(メッセージ)ListUsersRequest(メッセージ)ListUsersResponse(メッセージ)LocationIdSet(メッセージ)MinimumOrderValueTable(メッセージ)MinimumOrderValueTable.StoreCodeSetWithMov(メッセージ)OnlineReturnPolicy(メッセージ)OnlineReturnPolicy.ItemCondition(列挙型)OnlineReturnPolicy.Policy(メッセージ)OnlineReturnPolicy.Policy.Type(列挙型)OnlineReturnPolicy.RestockingFee(メッセージ)OnlineReturnPolicy.ReturnMethod(列挙型)OnlineReturnPolicy.ReturnShippingFee(メッセージ)OnlineReturnPolicy.ReturnShippingFee.Type(列挙型)OnlineReturnPolicy.SeasonalOverride(メッセージ)PhoneVerificationState(列挙型)Program(メッセージ)Program.Requirement(メッセージ)Program.State(列挙型)RateGroup(メッセージ)Region(メッセージ)Region.GeoTargetArea(メッセージ)Region.PostalCodeArea(メッセージ)Region.PostalCodeArea.PostalCodeRange(メッセージ)Required(メッセージ)RetrieveForApplicationTermsOfServiceAgreementStateRequest(メッセージ)RetrieveLatestTermsOfServiceRequest(メッセージ)Row(メッセージ)Service(メッセージ)Service.LoyaltyProgram(メッセージ)Service.LoyaltyProgram.LoyaltyProgramTiers(メッセージ)Service.ShipmentType(列挙型)Service.StoreConfig(メッセージ)Service.StoreConfig.CutoffConfig(メッセージ)Service.StoreConfig.CutoffConfig.LocalCutoffTime(メッセージ)Service.StoreConfig.StoreServiceType(列挙型)ShippingSettings(メッセージ)Table(メッセージ)TermsOfService(メッセージ)TermsOfServiceAgreementState(メッセージ)TermsOfServiceKind(列挙型)TransitTable(メッセージ)TransitTable.TransitTimeRow(メッセージ)TransitTable.TransitTimeRow.TransitTimeValue(メッセージ)UnclaimHomepageRequest(メッセージ)UpdateAccountRequest(メッセージ)UpdateAutofeedSettingsRequest(メッセージ)UpdateBusinessIdentityRequest(メッセージ)UpdateBusinessInfoRequest(メッセージ)UpdateEmailPreferencesRequest(メッセージ)UpdateHomepageRequest(メッセージ)UpdateRegionRequest(メッセージ)UpdateUserRequest(メッセージ)User(メッセージ)User.State(列挙型)Value(メッセージ)Warehouse(メッセージ)WarehouseBasedDeliveryTime(メッセージ)WarehouseCutoffTime(メッセージ)
AccountIssueService
AccountIssueService API をサポートするサービス。
| ListAccountIssues |
|---|
|
Merchant Center アカウントのすべてのアカウントの問題を一覧表示します。
|
AccountsService
Accounts API をサポートするサービス。
| CreateAndConfigureAccount |
|---|
|
追加の構成を備えた単体の Merchant Center アカウントを作成します。リクエストを行ったユーザーを、新しいアカウントの管理者として追加します。
|
| DeleteAccount |
|---|
|
単独のアカウント、MCA、サブアカウントの種類に関係なく、指定したアカウントを削除します。MCA を削除すると、そのすべてのサブアカウントが削除されます。このメソッドを実行するには、管理者権限が必要です。削除は、アカウントが他のアカウントにサービスを提供しておらず、処理済みのオファーがない場合のみ成功します。これは
|
| GetAccount |
|---|
|
Merchant Center アカウントからアカウントを取得します。アカウントを挿入、更新、削除した後、変更が有効になるまでに数分かかることがあります。
|
| ListAccounts |
|---|
|
呼び出し元のユーザーがアクセスでき、ページサイズやフィルタなどのリクエストの制約に一致するアカウントを一覧表示します。表示されるのはその MCA のサブアカウントだけでなく、呼び出し元のユーザーがアクセスできるすべてのアカウント(他の MCA、リンク済みアカウント、単独のアカウントなど)です。フィルタを指定しない場合、ユーザーが直接追加されているアカウントが返されます。この方法は結果整合性があります。つまり、アカウントの作成や更新、アカウント間の関係の変更などの変更が、結果にすぐに反映されない場合があります。代わりに、これらの変更は短時間で伝播され、その後、更新された情報は関連する述語と一致するようになります。つまり、アカウント名で検索しても、述語を満たしていても、最近変更されたアカウントが返されないことがあります。
|
| ListSubAccounts |
|---|
|
特定のマルチクライアント アカウントのすべてのサブアカウントを一覧表示します。これは、より強力な
|
| UpdateAccount |
|---|
|
アカウントの種類(スタンドアロン、MCA、サブアカウント)に関係なく、アカウントを更新します。このメソッドを実行するには、管理者権限が必要です。
|
AutofeedSettingsService
自動フィード設定をサポートするサービス。
| GetAutofeedSettings |
|---|
|
アカウントの自動フィード設定を取得します。
|
| UpdateAutofeedSettings |
|---|
|
アカウントの自動フィード設定を更新します。
|
BusinessIdentityService
ビジネス ID API をサポートするサービス。
| GetBusinessIdentity |
|---|
|
アカウントのビジネス ID を取得します。
|
| UpdateBusinessIdentity |
|---|
|
アカウントのビジネス ID を更新します。このメソッドを実行するには、管理者権限が必要です。
|
BusinessInfoService
ビジネス情報 API をサポートするサービス。
| GetBusinessInfo |
|---|
|
アカウントのビジネス情報を取得します。
|
| UpdateBusinessInfo |
|---|
|
アカウントのビジネス情報を更新します。このメソッドを実行するには、管理者権限が必要です。
|
EmailPreferencesService
EmailPreferences API をサポートするサービス。
| GetEmailPreferences |
|---|
|
Merchant Center アカウントのユーザーのメール設定を返します。このサービスでは、認証されたユーザーのメール設定の取得と更新のみが許可されます。name=accounts/*/users/me/emailPreferences エイリアスを使用して、認証されたユーザーの設定を取得します。
|
| UpdateEmailPreferences |
|---|
|
Merchant Center アカウント ユーザーのメール設定を更新します。MCA ユーザーは、MCA のサブアカウントではなく MCA アカウントを指定する必要があります。 更新マスクで明示的に選択されていない設定は更新されません。 更新でオプトイン ステータス値に UNCONFIRMED を指定することは無効です。 name=accounts/*/users/me/emailPreferences エイリアスを使用して、認証されたユーザーの設定を更新します。
|
HomepageService
ストアのホームページの API をサポートするサービス。
| ClaimHomepage |
|---|
|
ショップのホームページを申請します。このメソッドを実行するには、管理者権限が必要です。 ホームページがすでに登録されている場合は、(販売者が登録から免除されている場合を除き、この免除は検証からも免除されます)、検証が再確認され、正常なレスポンスが返されます。所有権が確認できなくなった場合はエラーが返されますが、申し立ては取り消されません。失敗した場合は、標準のエラー メッセージが返されます。* PERMISSION_DENIED: ユーザーにこの MC アカウントに必要な権限がない。* FAILED_PRECONDITION: - アカウントが Merchant Center アカウントではない。- MC アカウントにホームページがない。- 申し立てが失敗した(この場合、エラー メッセージに詳細が含まれます)。
|
| GetHomepage |
|---|
|
ストアのホームページを取得します。
|
| UnclaimHomepage |
|---|
|
ショップのホームページの申し立てを取り消します。このメソッドを実行するには、管理者権限が必要です。
|
| UpdateHomepage |
|---|
|
ストアのホームページを更新します。このメソッドを実行するには、管理者権限が必要です。
|
OnlineReturnPolicyService
このサービスでは、広告と無料リスティングの両方の返品に関するポリシーを含む、販売者の購入者都合による返品に関するポリシーの設定を簡単に管理できます。
プログラムです。この API は、次のリソースモデルを定義します。
[OnlineReturnPolicy][google.shopping.merchant.accounts.v1.OnlineReturnPolicy]
| GetOnlineReturnPolicy |
|---|
|
特定の販売者の既存の返品に関するポリシーを取得します。
|
| ListOnlineReturnPolicies |
|---|
|
指定された販売者の既存の返品に関するポリシーをすべて一覧表示します。
|
ProgramsService
プログラム管理サービス。
プログラムは、販売者アカウントに機能を追加するためのメカニズムを提供します。典型的な例が、無料商品リスティング プログラムです。このプログラムでは、販売者の店舗の商品を Google の各種サービスに無料で表示できます。
このサービスは、利用可能なすべてのプログラムへの販売者の参加状況を取得するメソッドと、各プログラムへの参加を明示的に有効または無効にするメソッドを公開します。
| DisableProgram |
|---|
|
アカウントの指定したプログラムへの参加を無効にします。このメソッドを実行するには、管理者権限が必要です。
|
| EnableProgram |
|---|
|
アカウントで指定したプログラムへの参加を有効にします。このメソッドを実行するには、管理者権限が必要です。
|
| GetProgram |
|---|
|
アカウントの指定されたプログラムを取得します。
|
| ListPrograms |
|---|
|
アカウントのすべてのプログラムを取得します。
|
RegionsService
リージョン構成を管理します。
この API は、次のリソースモデルを定義します。
Region
| CreateRegion |
|---|
|
Merchant Center アカウントに地域の定義を作成します。このメソッドを実行するには、管理者権限が必要です。
|
| DeleteRegion |
|---|
|
Merchant Center アカウントから地域の定義を削除します。このメソッドを実行するには、管理者権限が必要です。
|
| GetRegion |
|---|
|
Merchant Center アカウントで定義された地域を取得します。
|
| ListRegions |
|---|
|
Merchant Center アカウントの地域を一覧表示します。
|
| UpdateRegion |
|---|
|
Merchant Center アカウントで地域の定義を更新します。このメソッドを実行するには、管理者権限が必要です。
|
ShippingSettingsService
Merchant API メソッドごとにメソッド呼び出しの送料設定情報を取得するサービス。
| GetShippingSettings |
|---|
|
配送設定情報を取得します。
|
| InsertShippingSettings |
|---|
|
販売者の配送設定を、配送リクエストの設定に置き換えます。このメソッドを実行するには、管理者権限が必要です。
|
TermsOfServiceAgreementStateService
TermsOfServiceAgreementState API をサポートするサービス。
| GetTermsOfServiceAgreementState |
|---|
|
利用規約の状態を返します。
|
| RetrieveForApplicationTermsOfServiceAgreementState |
|---|
|
アプリケーションの利用規約の同意の状態を取得します。
|
TermsOfServiceService
TermsOfService API をサポートするサービス。
| AcceptTermsOfService |
|---|
|
|
| GetTermsOfService |
|---|
|
指定されたバージョンに関連付けられている
|
| RetrieveLatestTermsOfService |
|---|
|
指定された
|
UserService
ユーザー API をサポートするサービス。
| CreateUser |
|---|
|
Merchant Center アカウントのユーザーを作成します。このメソッドを実行するには、管理者権限が必要です。
|
| DeleteUser |
|---|
|
Merchant Center アカウントのユーザーを削除します。このメソッドを実行するには、管理者権限が必要です。削除するユーザーは、そのアカウントの最後の管理者ユーザーにすることはできません。また、ビジネス マネージャーで管理されているユーザーは削除されません」
|
| GetUser |
|---|
|
Merchant Center アカウントのユーザーを取得します。
|
| ListUsers |
|---|
|
Merchant Center アカウントのすべてのユーザーを一覧表示します。
|
| UpdateUser |
|---|
|
Merchant Center アカウントのユーザーを更新します。このメソッドを実行するには、管理者権限が必要です。
|
AcceptTermsOfServiceRequest
AcceptTermsOfService メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。利用規約のバージョンのリソース名。形式: |
account |
必須。利用規約に同意するアカウント。 |
region_ |
必須。CLDR で定義されている地域コード。利用規約がその国にのみ適用される場合は国、グローバルに適用される場合は 001 です。 |
承認済み
同意した利用規約を説明します。
| フィールド | |
|---|---|
terms_ |
同意済みのtermsOfService。 |
accepted_ |
承認が記録されたアカウント。アカウント自体、またはサブアカウントの場合は MCA アカウントです。 |
valid_ |
設定すると、同意したTermsOfService は、この日付(UTC)の終了まで有効であると明記されます。期限までに新しいポリシーに同意する必要があります。必須の TermsOfService の情報は、[必須] メッセージに表示されます。 |
AccessRight
アクセス権。
| 列挙型 | |
|---|---|
ACCESS_RIGHT_UNSPECIFIED |
デフォルト値。この値は使用されません。 |
STANDARD |
標準のアクセス権。 |
ADMIN |
管理者アクセス権。 |
PERFORMANCE_REPORTING |
この権限を持つユーザーは、パフォーマンスと分析情報にアクセスできます。 |
アカウント
Account メッセージは、ショッピング広告内の販売者のアカウントを表します。商品データ、設定、Google のサービスや外部プロバイダとのやり取りを管理するための主なエンティティです。
アカウントは、単独で運用することも、マルチクライアント アカウント(MCA)の構造の一部として運用することもできます。MCA の設定では、親アカウントが複数のサブアカウントを管理します。
アカウントを設定するには、アカウント名、タイムゾーン、言語設定などの属性を構成する必要があります。
Account メッセージは、AccountRelationship、Homepage、BusinessInfo など、他の多くのリソースの親エンティティです。
| フィールド | |
|---|---|
name |
ID。アカウントのリソース名。形式: |
account_ |
出力専用。アカウントの ID。 |
account_ |
|
adult_ |
このアカウントにアダルト コンテンツが含まれているかどうか。 |
test_ |
出力専用。テスト アカウントかどうか。 |
time_ |
必須。アカウントのタイムゾーンです。 書き込み時に、 読み取りの場合、 |
language_ |
必須。アカウントの BCP-47 言語コード( |
AccountAggregation
この型にはフィールドがありません。
AccountAggregation ペイロード。
AccountIssue
| フィールド | |
|---|---|
name |
ID。アカウントの問題のリソース名。形式: |
title |
問題のローカライズされたタイトル。 |
severity |
問題の全体的な重大度。 |
impacted_ |
この問題がさまざまなデスティネーションに与える影響。 |
detail |
問題に関する地域別の詳細情報。 |
documentation_ |
問題とその解決方法について詳しく説明している Merchant Center ヘルプセンターへのリンク。 |
ImpactedDestination
問題がデスティネーションに及ぼす影響。
| フィールド | |
|---|---|
impacts[] |
特定の旅行先におけるさまざまな地域への(悪影響)。 |
reporting_ |
影響を受けるレポート コンテキスト。 |
影響
問題がリージョンに及ぼす影響。
| フィールド | |
|---|---|
region_ |
この問題が適用される CLDR 地域コード。 |
severity |
宛先とリージョンにおける問題の重大度。 |
重大度
考えられるすべての問題の重大度。
| 列挙型 | |
|---|---|
SEVERITY_UNSPECIFIED |
重大度は不明です。 |
CRITICAL |
この問題により、商品が配信されません。 |
ERROR |
この問題は、(将来的に)商品に影響する可能性があります。また、商品に関する問題の兆候である可能性もあります。 |
SUGGESTION |
問題は改善の提案です。 |
住所
倉庫の発送先住所。
| フィールド | |
|---|---|
street_ |
住所の番地部分。例: |
city |
必須。市、町、コミューン。郵便区画または地域の下位区分(町内や郊外など)も含めることができます。 |
administrative_ |
必須。国の最上位の行政区分。たとえば、カリフォルニア州(「CA」)やケベック州(「QC」)などです。 |
postal_ |
必須。郵便番号(例: 94043)。 |
region_ |
必須。CLDR 国コード(「US」など)。 |
AutofeedSettings
自動フィードの設定に関連する情報の収集。
| フィールド | |
|---|---|
name |
ID。自動フィード設定のリソース名。形式: |
enable_ |
必須。特定のアカウントの自動フィードによる商品クロール機能を有効または無効にします。自動フィード アカウントは、特定の条件を満たしている必要があります。この条件は |
eligible |
出力専用。販売者が自動フィードに登録する資格があるかどうかを判断します。 |
BusinessDayConfig
倉庫の営業日。
| フィールド | |
|---|---|
business_ |
必須。通常の営業日。空白にすることはできません。 |
平日
| 列挙型 | |
|---|---|
WEEKDAY_UNSPECIFIED |
|
MONDAY |
|
TUESDAY |
|
WEDNESDAY |
|
THURSDAY |
|
FRIDAY |
|
SATURDAY |
|
SUNDAY |
|
BusinessIdentity
ビジネスのアイデンティティに関連する情報の収集。
| フィールド | |
|---|---|
name |
ID。ビジネス ID のリソース名。形式: |
promotions_ |
必須。ID 属性をプロモーションに使用できるかどうか。 |
black_ |
省略可。ビジネスが黒人が所有または経営するビジネスであるかどうかを指定します。このオプション フィールドは、ビジネスの国が |
women_ |
省略可。ビジネスが女性が所有または経営するビジネスであるかどうかを指定します。このオプション フィールドは、ビジネスの国が |
veteran_ |
省略可。ビジネスが退役軍人が所有または経営するビジネスと自認しているかどうかを指定します。このオプション フィールドは、ビジネスの国が |
latino_ |
省略可。ビジネスがラティーノが所有または経営するビジネスと自認しているかどうかを指定します。このオプション フィールドは、ビジネスの国が |
small_ |
省略可。ビジネスが小規模ビジネスであるかどうかを指定します。このオプション フィールドは、ビジネスの国が |
IdentityAttribute
ID 属性に関連するすべての情報。
| フィールド | |
|---|---|
identity_ |
必須。この属性の ID の宣言。 |
IdentityDeclaration
アイデンティティの宣言に関するすべての設定。
| 列挙型 | |
|---|---|
IDENTITY_DECLARATION_UNSPECIFIED |
選択が行われなかったことを示すデフォルト値。 |
SELF_IDENTIFIES_AS |
アカウントが属性で識別されることを示します。 |
DOES_NOT_SELF_IDENTIFY_AS |
アカウントが属性を識別していないことを示します。 |
PromotionsConsent
ビジネス アイデンティティに関連するプロモーションに関するすべての設定。
| 列挙型 | |
|---|---|
PROMOTIONS_CONSENT_UNSPECIFIED |
選択が行われなかったことを示すデフォルト値。 |
PROMOTIONS_CONSENT_GIVEN |
アカウントがプロモーションにビジネス ID を使用することを許可したことを示します。 |
PROMOTIONS_CONSENT_DENIED |
アカウントがプロモーションにビジネス ID を使用することを許可していないことを示します。 |
BusinessInfo
BusinessInfo メッセージには、販売者のビジネスに関する重要な情報が含まれています。
このメッセージには、実店舗の住所、カスタマー サービスの連絡先、地域固有の ID などのビジネスの重要な詳細情報が含まれます。
| フィールド | |
|---|---|
name |
ID。ビジネス情報のリソース名。形式: |
address |
省略可。ビジネス拠点の住所。サポートされているフィールドは、 |
phone |
出力専用。ビジネスの電話番号。 |
phone_ |
出力専用。ビジネスの電話確認のステータス。 |
customer_ |
省略可。ビジネスのカスタマー サービス。 |
korean_ |
省略可。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 |
必須。運送業者の運賃の名前。レートグループごとに一意である必要があります。 |
carrier |
必須。携帯通信会社サービス( |
carrier_ |
必須。携帯通信会社サービス( |
origin_ |
必須。この運送業者の運賃の出発地。 |
percentage_ |
省略可。小数表記の数値として、配送料の乗数修飾子。負の値を指定できます。たとえば、 |
flat_ |
省略可。加算型の送料調整比。負の値を指定できます。たとえば、 |
ClaimHomepageRequest
ClaimHomepage メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。申し立てを行うホームページの名前。形式: |
overwrite |
省略可。このオプションを |
CreateAndConfigureAccountRequest
CreateAndConfigureAccount メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
account |
必須。作成するアカウント。 |
users[] |
省略可。アカウントに追加するユーザー。 このフィールドは非推奨であり、API がベータ版から進化すると存在しなくなります。代わりに |
user[] |
省略可。アカウントに追加するユーザー。 |
service[] |
必須。作成されるアカウントとプロバイダ アカウント間のアカウント サービスは、作成の一環として初期化されます。このようなサービスを少なくとも 1 つ指定する必要があります。現在、これらのうち 1 つを |
AddAccountService
アカウントの作成時にアカウント サービスを追加するための追加手順。
| フィールド | |
|---|---|
共用体フィールド service_type。追加するサービスタイプ。service_type は次のいずれかになります。 |
|
account_ |
プロバイダは、アカウントのアグリゲータです。サービスタイプ「アカウントの集計」のペイロード。 |
provider |
必須。サービスのプロバイダ。アカウント( |
AddUser
アカウントの作成時にユーザーを追加する手順。
| フィールド | |
|---|---|
user_ |
必須。ユーザーのメールアドレス(例: |
user |
省略可。追加するユーザーの詳細情報。現時点では、アクセス権のみを指定できます。 |
CreateRegionRequest
CreateRegion メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
parent |
必須。リージョンを作成するアカウント。形式: |
region_ |
必須。同じアカウントのすべてのリージョンで一意のリージョン ID。 |
region |
必須。作成するリージョン。 |
CreateUserRequest
CreateUser メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
parent |
必須。ユーザーを作成するアカウントのリソース名。形式: |
user_ |
必須。ユーザーのメールアドレス(例: |
user |
省略可。作成するユーザー。 |
CustomerService
カスタマー サービス情報。
| フィールド | |
|---|---|
uri |
省略可。カスタマー サービスにアクセスできる URI。 |
email |
省略可。カスタマー サービスに連絡できるメールアドレス。 |
phone |
省略可。カスタマー サービスに電話をかけることができる電話番号。 |
CutoffTime
営業日の締め切り時間の定義。
| フィールド | |
|---|---|
hour |
必須。同日に処理されるように注文を完了する必要がある締め切り時間の午後時間。 |
minute |
必須。同日に処理されるように注文を完了する必要がある締め切り時間の分単位。 |
time_ |
必須。タイムゾーン ID。たとえば「Europe/Zurich」など。 |
DeleteAccountRequest
DeleteAccount メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。削除するアカウントの名前。形式: |
force |
省略可。 |
DeleteRegionRequest
DeleteRegion メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。削除するリージョンの名前。形式: |
DeleteUserRequest
DeleteUser メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。削除するユーザーの名前。形式:
|
DeliveryTime
注文から商品の配送までのさまざまな段階で費やした時間。
| フィールド | |
|---|---|
warehouse_ |
省略可。選択した運送業者の設定に基づいて、倉庫(配送元)ごとにお届け日数を計算する必要があることを示します。設定する場合は、[delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] の他のお届け日数関連フィールドは設定しないでください。 |
min_ |
配送にかかる最短の営業日数。0 は当日配達、1 は翌日配達を意味します。 |
max_ |
配送にかかる最長の営業日数。0 は当日配達、1 は翌日配達を意味します。 |
cutoff_ |
営業日の締め切り時間の定義。設定しない場合、デフォルトの締め切り時間は午前 8 時(太平洋標準時)になります。 |
min_ |
注文が発送されるまでにかかる最小の営業日数。0 は当日発送、1 は翌日発送を意味します。「min_handling_days」と「max_handling_days」は、同時に設定するか、どちらも設定しない必要があります。 |
max_ |
注文が発送されるまでの最長の営業日数。0 は当日発送、1 は翌日発送を意味します。 |
transit_ |
お届け日数表: 行と列のディメンションに基づくお届けまでの営業日数。 |
handling_ |
注文を処理できる営業日。指定しない場合は、月曜日から金曜日の営業日とみなされます。 |
transit_ |
注文が配送される営業日数。指定しない場合は、月曜日から金曜日の営業日とみなされます。 |
DisableProgramRequest
DisableProgram メソッドのリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。指定したアカウントの参加を無効にするプログラムの名前。形式: |
距離
配達可能な範囲(半径)。これは、ローカル配送の配送タイプでのみ必須です。
| フィールド | |
|---|---|
value |
距離の整数値。 |
unit |
単位は国によって異なる場合があります。マイルとキロメートルが含まれるようにパラメータ化されています。 |
ユニット
単位は国によって異なる場合があります。マイルとキロメートルが含まれるようにパラメータ化されています。
| 列挙型 | |
|---|---|
UNIT_UNSPECIFIED |
単位が指定されていません |
MILES |
単位(マイル) |
KILOMETERS |
単位: キロメートル |
EmailPreferences
ユーザーがオプトインまたはオプトアウトした通知のカテゴリ。メールの設定には、ユーザーがオプトアウトできない必須のお知らせは含まれません。
| フィールド | |
|---|---|
name |
ID。EmailPreferences の名前。このエンドポイントは、認証されたユーザーに対してのみサポートされます。 |
news_ |
省略可。新機能、ヒント、ベスト プラクティスに関する最新情報。 |
OptInState
メール設定のオプトイン状態。
| 列挙型 | |
|---|---|
OPT_IN_STATE_UNSPECIFIED |
オプトイン ステータスが指定されていません。 |
OPTED_OUT |
お客様がこの種類のメールを受信しないように設定しています。 |
OPTED_IN |
ユーザーがこのタイプのメールの受信を有効にしている。 |
UNCONFIRMED |
お客様がこのタイプのメールの受信をオプトインし、確認メールが送信されたが、お客様がまだオプトインを確定していない(一部の国にのみ適用)。 |
EnableProgramRequest
EnableProgram メソッドのリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。特定のアカウントの参加を有効にするプログラムの名前。形式: |
GetAccountRequest
GetAccount メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。取得するアカウントの名前。形式: |
GetAutofeedSettingsRequest
GetAutofeedSettings メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。自動フィード設定のリソース名。形式: |
GetBusinessIdentityRequest
GetBusinessIdentity メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。ビジネス ID のリソース名。形式: |
GetBusinessInfoRequest
GetBusinessInfo メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。ビジネス情報のリソース名。形式: |
GetEmailPreferencesRequest
GetEmailPreferences メソッドのリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。 |
GetHomepageRequest
GetHomepage メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。取得するホームページの名前。形式: |
GetOnlineReturnPolicyRequest
GetOnlineReturnPolicy メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。取得する返品に関するポリシーの名前。形式: |
GetProgramRequest
GetProgram メソッドのリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。取得するプログラムの名前。形式: |
GetRegionRequest
GetRegion メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。取得するリージョンの名前。形式: |
GetShippingSettingsRequest
GetShippingSetting メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。取得する配送設定の名前。形式: |
GetTermsOfServiceAgreementStateRequest
GetTermsOfServiceAgreementState メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。利用規約のバージョンのリソース名。形式: |
GetTermsOfServiceRequest
GetTermsOfService メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。利用規約のバージョンのリソース名。形式: |
GetUserRequest
GetUser メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。取得するユーザーの名前。形式:
|
ヘッダー
テーブルの行または列ヘッダーの空ではないリスト。prices、weights、num_items、postal_code_group_names、location のいずれか 1 つを設定する必要があります。
| フィールド | |
|---|---|
prices[] |
必須。注文価格の上限(税込み)のリスト。価格の amount_micros を -1 に設定すると、最後の価格の値を無限大にすることができます。たとえば、 |
weights[] |
必須。注文重量の上限(含む)のリスト。最後の重みの値は、price amount_micros = -1 に設定することで無限にすることができます。たとえば、 |
number_ |
必須。アイテム数の上限(上限を含む)のリスト。最後の値は |
postal_ |
必須。郵便グループ名のリスト。最後の値は |
locations[] |
必須。位置情報 ID セットのリスト。空でないこと。他のすべてのフィールドが設定されていない場合にのみ設定できます。 |
ホームページ
Homepage メッセージは、システム内の販売者のストアのホームページを表します。
販売者のホームページは、ユーザーがショップを操作するプライマリ ドメインです。
ホームページは所有権の証明として申請して確認できるため、販売者はウェブサイトの確認が必要な機能を利用できるようになります。詳しくは、オンライン ショップの URL の確認方法をご覧ください。
| フィールド | |
|---|---|
name |
ID。ストアのホームページのリソース名。形式: |
claimed |
出力専用。ホームページが申請されているかどうか。https://support.google.com/merchants/answer/176793 をご覧ください。 |
uri |
必須。ショップのホームページの URI(通常は URL)。 |
InsertShippingSettingsRequest
InsertShippingSetting メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
parent |
必須。この商品を挿入するアカウント。形式: accounts/{account} |
shipping_ |
必須。アカウントの新しいバージョン。 |
ListAccountIssuesRequest
ListAccountIssues メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
parent |
必須。この問題のコレクションを所有する親。形式: |
page_ |
省略可。返される問題の最大数。サービスが返す値はこれよりも少ないことがあります。指定されていない場合は、最大で 50 人のユーザーが返されます。最大値は 100 です。100 を超える値は 100 に強制変換されます |
page_ |
省略可。前回の ページ分割を行う場合、 |
language_ |
省略可。レスポンス内の問題には、指定した言語の人間可読フィールドが含まれます。形式は BCP-47 です(例: |
time_ |
省略可。人間が読める形式のフィールドで時刻をローカライズするために使用される IANA タイムゾーン。例:「America/Los_Angeles」。設定しない場合、'America/Los_Angeles' が使用されます。 |
ListAccountIssuesResponse
ListAccountIssues メソッドに対するレスポンス メッセージ。
| フィールド | |
|---|---|
account_ |
指定したアカウントの問題。 |
next_ |
次のページを取得するために |
ListAccountsRequest
ListAccounts メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
page_ |
省略可。返されるアカウントの最大数。サービスが返す値はこれよりも少ないことがあります。指定されていない場合は、最大 250 個のアカウントが返されます。最大値は 500 です。500 を超える値は 500 に強制変換されます。 |
page_ |
省略可。前回の ページ分割を行う場合、 |
filter |
省略可。フィルタに一致するアカウントのみを返します。詳細については、フィルタ構文リファレンスをご覧ください。 |
ListAccountsResponse
ListAccounts メソッドに対するレスポンス メッセージ。
| フィールド | |
|---|---|
accounts[] |
|
next_ |
次のページを取得するために |
ListOnlineReturnPoliciesRequest
ListOnlineReturnPolicies メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
parent |
必須。返品ポリシーを表示する販売者のアカウント。形式: |
page_ |
省略可。返される |
page_ |
省略可。前回の ページネーションを行う場合、 |
ListOnlineReturnPoliciesResponse
ListOnlineReturnPolicies メソッドに対するレスポンス メッセージ。
| フィールド | |
|---|---|
online_ |
取得された返品に関するポリシー。 |
next_ |
次のページを取得するために |
ListProgramsRequest
ListPrograms メソッドのリクエスト メッセージ。
| フィールド | |
|---|---|
parent |
必須。すべてのプログラムを取得するアカウントの名前。形式: |
page_ |
省略可。1 回のレスポンスで返されるプログラムの最大数。指定しない場合(または 0 の場合)、デフォルトのサイズ 1,000 が使用されます。最大値は 1,000 です。1,000 を超える値は 1,000 に強制変換されます。 |
page_ |
省略可。前回の |
ListProgramsResponse
ListPrograms メソッドのレスポンス メッセージ。
| フィールド | |
|---|---|
programs[] |
指定したアカウントのプログラム。 |
next_ |
次のページを取得するために |
ListRegionsRequest
ListRegions メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
parent |
必須。リージョンを一覧表示するアカウント。形式: |
page_ |
省略可。返されるリージョンの最大数。サービスが返す値はこれよりも少ないことがあります。指定されていない場合は、最大で 50 個のリージョンが返されます。最大値は 1,000 です。1,000 を超える値は 1,000 に強制変換されます。 |
page_ |
省略可。前回の ページ分割を行う場合、 |
ListRegionsResponse
ListRegions メソッドに対するレスポンス メッセージ。
| フィールド | |
|---|---|
regions[] |
指定された販売者の地域。 |
next_ |
次のページを取得するために |
ListSubAccountsRequest
ListSubAccounts メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
provider |
必須。集計サービス プロバイダ。形式: |
page_ |
省略可。返されるアカウントの最大数。サービスが返す値はこれよりも少ないことがあります。指定されていない場合は、最大 250 個のアカウントが返されます。最大値は 500 です。500 を超える値は 500 に強制変換されます。 |
page_ |
省略可。前回の ページ分割を行う場合、 |
ListSubAccountsResponse
ListSubAccounts メソッドに対するレスポンス メッセージ。
| フィールド | |
|---|---|
accounts[] |
指定した親アカウントがアグリゲータであるアカウント。 |
next_ |
次のページを取得するために |
ListUsersRequest
ListUsers メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
parent |
必須。このユーザー コレクションを所有する親。形式: |
page_ |
省略可。返されるユーザーの最大数。サービスが返す値はこれよりも少ないことがあります。指定されていない場合は、最大で 50 人のユーザーが返されます。最大値は 100 です。100 を超える値は 100 に強制変換されます |
page_ |
省略可。前回の ページ分割を行う場合、 |
ListUsersResponse
ListUsers メソッドに対するレスポンス メッセージ。
| フィールド | |
|---|---|
users[] |
指定したアカウントのユーザー。 |
next_ |
次のページを取得するために |
LocationIdSet
位置情報 ID セットのリスト。空でないこと。他のすべてのフィールドが設定されていない場合にのみ設定できます。
| フィールド | |
|---|---|
location_ |
必須。地域 ID の空でないリスト。すべて同じ場所のタイプ(都道府県など)にする必要があります。 |
MinimumOrderValueTable
集荷フルフィルメント タイプのストアごとの最小注文額の表。
| フィールド | |
|---|---|
store_ |
必須。同じ最低注文額(MOV)を共有するストアコードセットのリスト。少なくとも 2 つのセットが必要です。最後のセットは空にする必要があります。これは「他のすべてのストアに対して MOV」を意味します。各ストアコードは、すべてのセットで 1 回だけ使用できます。1 つのサービス内のすべての価格は同じ通貨にする必要があります。 |
StoreCodeSetWithMov
同じ最低注文額を共有するストアコードセットのリスト。少なくとも 2 つのセットが必要です。最後のセットは空にする必要があります。これは「他のすべてのストアに対して MOV」を意味します。各ストアコードは、すべてのセットで 1 回だけ使用できます。1 つのサービス内のすべての価格は同じ通貨にする必要があります。
| フィールド | |
|---|---|
store_ |
省略可。一意の店舗コードのリスト。カテゴリ全体を指定する場合は空白にします。 |
value |
指定した店舗の最低注文額。 |
OnlineReturnPolicy
オンライン返品に関するポリシー オブジェクト。現在、広告と無料リスティング プログラムの返品に関するポリシーを表すために使用されています。
| フィールド | |
|---|---|
name |
ID。 |
return_ |
出力専用。Google が生成した返品に関するポリシー ID。 |
label |
必須。変更不可。このフィールドは、返品ポリシーの一意のユーザー定義ラベルを表します。同じ国で異なる返品に関するポリシーで同じラベルを使用することはできません。商品で特定のラベル属性が指定されていない限り、ポリシーには自動的に「default」というラベルが付けられます。特定の商品グループにカスタムの返品ポリシーを割り当てるには、返品ポリシーラベルの手順に沿って操作します。ラベルには最大 50 文字を含めることができます。 |
countries[] |
必須。変更不可。返品に関するポリシーが適用される販売先の国。値は、有効な 2 文字の ISO 3166 コードである必要があります。 |
policy |
返品に関するポリシー。 |
seasonal_ |
省略可。特定の期間に行われた注文に対する一般的なポリシーのオーバーライド。 |
restocking_ |
すべての返品理由カテゴリに適用される返品手数料。値が設定されていない場合、返品手数料は無料として扱われます。 |
return_ |
お客様が商品を返品できる返品方法。返品ポリシーのタイプが noReturns でない限り、この値は空にできません。 |
item_ |
返品が可能な商品の状態は、返品ポリシーのタイプが「noReturns」でない限り、空にできません。 |
return_ |
返品送料。お客様が返品ラベルをダウンロードして印刷する必要がある場合にのみ設定する必要があります。 |
return_ |
必須。返品に関するポリシーの URI。これは、Google がポリシーのサニティ チェックを行う際に使用されます。有効な URL を指定してください。 |
accept_ |
このフィールドは、販売者が返品として欠陥のある商品のみを受け付けるかどうかを指定します。このフィールドは必須です。 |
process_ |
このフィールドには、販売者が払い戻しを処理するまでに要する日数を指定します。このフィールドは省略可能です。 |
accept_ |
このフィールドは、販売者が商品の交換を許可するかどうかを指定します。このフィールドは必須です。 |
ItemCondition
使用可能な商品の状態。
| 列挙型 | |
|---|---|
ITEM_CONDITION_UNSPECIFIED |
デフォルト値。この値は使用されません。 |
NEW |
新規] をクリックします。 |
USED |
中古。 |
ポリシー
使用可能なポリシー。
| フィールド | |
|---|---|
type |
ポリシーの種類。 |
days |
商品のお届け後、返品が可能な日数。1 日は、お届け時のタイムスタンプから 24 時間後と定義されます。 |
タイプ
返品に関するポリシーの種類。
| 列挙型 | |
|---|---|
TYPE_UNSPECIFIED |
デフォルト値。この値は使用されません。 |
NUMBER_OF_DAYS_AFTER_DELIVERY |
配達後、返品が有効な日数。 |
NO_RETURNS |
返品できません。 |
LIFETIME_RETURNS |
無期限返品可能。 |
RestockingFee
払い戻し手数料。定額またはマイクロパーセンテージを指定できます。
| フィールド | |
|---|---|
共用体フィールド
|
|
fixed_ |
固定の返品手数料。 |
micro_ |
合計価格の割合(マイクロ単位)。15,000,000 は、合計金額の 15% が請求されることを意味します。 |
ReturnMethod
利用可能な返品方法。
| 列挙型 | |
|---|---|
RETURN_METHOD_UNSPECIFIED |
デフォルト値。この値は使用されません。 |
BY_MAIL |
郵送で返品する。 |
IN_STORE |
店舗で返品する。 |
AT_A_KIOSK |
キオスクにて返品する。 |
ReturnShippingFee
返品送料。これは、固定料金または、購入者が実際の送料を支払うことを示すブール値のいずれかです。
| フィールド | |
|---|---|
type |
必須。返品送料のタイプ。 |
fixed_ |
返品送料の金額を修正しました。この値は、type が |
タイプ
返品送料の種類。
| 列挙型 | |
|---|---|
TYPE_UNSPECIFIED |
デフォルト値。この値は使用されません。 |
FIXED |
返品送料は固定値です。 |
CUSTOMER_PAYING_ACTUAL_FEE |
実際の返品送料は購入者が負担します。 |
SeasonalOverride
次: 5
| フィールド | |
|---|---|
label |
必須。Merchant Center でこの季節限定のオーバーライドの表示名。 |
begin |
必須。この期間限定的な優先ルールが適用される期間を定義します。開始日と終了日は両方とも含める必要があります。日付は小数点形式(例: 20250115)で指定してください。期間限定的な優先ルールの日付は重複しないようにしてください。 |
end |
必須。期間限定的な優先ルールの終了日(指定日も期間に含む)。 |
policy |
必須。指定された期間の返品に関するポリシー。 |
PhoneVerificationState
スマートフォンの確認ステータス。
| 列挙型 | |
|---|---|
PHONE_VERIFICATION_STATE_UNSPECIFIED |
デフォルト値。この値は使用されません。 |
PHONE_VERIFICATION_STATE_VERIFIED |
スマートフォンが確認済みである。 |
PHONE_VERIFICATION_STATE_UNVERIFIED |
スマートフォンが未確認である |
プログラム
指定したアカウントの特定のプログラムへの参加を定義します。
プログラムは、販売者アカウントに機能を追加するためのメカニズムを提供します。典型的な例が、無料商品リスティング プログラムです。このプログラムでは、販売者の店舗の商品を Google の各種サービスに無料で表示できます。
| フィールド | |
|---|---|
name |
ID。プログラムのリソース名。形式: |
documentation_ |
出力専用。プログラムについて説明している Merchant Center ヘルプページの URL。 |
state |
出力専用。プログラムへのアカウントの参加状態。 |
active_ |
出力専用。アカウントがプログラムに積極的に参加している地域。アクティブなリージョンとは、そのリージョンに影響するすべてのプログラム要件が満たされているリージョンのことです。 地域コードは CLDR で定義されています。プログラムがその国にのみ適用される国か、プログラムが全世界に適用される場合は |
unmet_ |
出力専用。アカウントがまだ満たしていない要件で、プログラムへの参加に影響しているもの。 |
要件
プログラムへの参加に指定された要件を定義します。
| フィールド | |
|---|---|
title |
出力専用。要件の名前。 |
documentation_ |
出力専用。要件を説明するヘルプページの URL。 |
affected_ |
出力専用。現在、この要件が満たされていないリージョン。 地域コードは CLDR で定義されています。プログラムがその国にのみ適用される国か、プログラムが全世界に適用される場合は |
州
アカウントのプログラム参加の状態。
| 列挙型 | |
|---|---|
STATE_UNSPECIFIED |
デフォルト値。この値は使用されません。 |
NOT_ELIGIBLE |
アカウントがプログラムに参加する資格を有していない。 |
ELIGIBLE |
アカウントがプログラムへの参加資格を満たしている。 |
ENABLED |
アカウントでプログラムが有効になっている。 |
RateGroup
送料グループの定義。空の applicable_shipping_labels を指定できるのは最後のみです。これは「その他すべて」を意味します。他の applicable_shipping_labels は重ならないようにしてください。
| フィールド | |
|---|---|
applicable_ |
必須。この料金グループが適用される商品を定義する送料ラベルのリスト。これは排他的論理演算です。料金グループを適用するには、ラベルのいずれか 1 つが一致している必要があります。空にできるのは、サービスの最後の料金グループの場合のみです。 |
subtables[] |
省略可。 |
carrier_ |
省略可。 |
single_ |
料金グループの値(例: 定額料金 10 米ドル)。 |
main_ |
|
name |
省略可。レートグループの名前。設定する場合は、配送サービス内で一意にする必要があります。 |
地域
RegionalInventory サービスと ShippingSettings サービスの両方でターゲットとして使用できる地理的なリージョンを表します。地域は、郵便番号のコレクションとして定義できます。一部の国では、事前定義されたジオターゲットを使用して地域を定義することもできます。詳細については、リージョンを設定する をご覧ください。
| フィールド | |
|---|---|
name |
ID。リージョンのリソース名。形式: |
postal_ |
省略可。地域エリアを定義する郵便番号のリスト。 |
geotarget_ |
省略可。地域エリアを定義する地域ターゲティングのリスト。 |
regional_ |
出力専用。地域別の在庫構成で使用できるかどうかを示します。 |
shipping_ |
出力専用。地域が配送サービスの構成で使用できるかどうかを示します。 |
display_ |
省略可。リージョンの表示名。 |
GeoTargetArea
地域エリアを定義する地域ターゲティングのリスト。
| フィールド | |
|---|---|
geotarget_ |
必須。地域 ID の空でないリスト。すべて同じ場所のタイプ(都道府県など)にする必要があります。 |
PostalCodeArea
地域エリアを定義する郵便番号のリスト。注: 郵便番号を使用して定義されたすべての地域には、アカウントの ShippingSettings.postalCodeGroups リソースからアクセスできます。
| フィールド | |
|---|---|
region_ |
必須。CLDR 地域コードまたは郵便番号グループが適用される国。 |
postal_ |
必須。郵便番号の範囲。 |
PostalCodeRange
地域エリアを定義する郵便番号の範囲。
| フィールド | |
|---|---|
begin |
必須。郵便番号または、地域を定義する範囲の下限を示す接頭辞* 形式のパターン。値の例: |
end |
省略可。郵便番号、または地域を定義する範囲の上限を示す |
必須
同意が必要な利用規約を説明します。
| フィールド | |
|---|---|
terms_ |
同意が必要な termsOfService。 |
tos_ |
利用規約ファイルの完全な URL。このフィールドは TermsOfService.file_uri と同じです。便宜上ここに追加されています。 |
RetrieveForApplicationTermsOfServiceAgreementStateRequest
RetrieveForApplicationTermsOfServiceAgreementState メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
parent |
必須。TermsOfServiceAgreementState を取得するアカウント。形式: |
RetrieveLatestTermsOfServiceRequest
RetrieveLatestTermsOfService メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
region_ |
必須。CLDR で定義されている地域コード。利用規約がその国にのみ適用される場合は国、グローバルに適用される場合は 001 です。 |
kind |
必須。この利用規約のバージョンが適用される Kind。 |
行
セルのリストを指定します。
| フィールド | |
|---|---|
cells[] |
必須。行を構成するセルのリスト。2 次元テーブルの場合は |
サービス
配送サービス。
| フィールド | |
|---|---|
delivery_ |
必須。サービスが適用される国の CLDR 地域コード。 |
rate_ |
省略可。送料グループの定義。空の |
loyalty_ |
省略可。この配送サービスが限定されているポイント プログラム。 |
service_ |
必須。サービスの自由形式の名前。ターゲット アカウント内で一意にする必要があります。 |
active |
必須。配送サービスのアクティブなステータスを公開するブール値。 |
currency_ |
このサービスが適用される通貨の CLDR コード。料金グループの料金と一致している必要があります。 |
delivery_ |
必須。注文から商品の配送までのさまざまな段階で費やした時間。 |
shipment_ |
このサービスが注文を配送する場所のタイプ。 |
minimum_ |
このサービスの最低注文額。設定した場合、この金額以上を注文する必要があります。1 つのサービス内のすべての価格は同じ通貨にする必要があります。minimum_order_value_table と同時に設定することはできません。 |
minimum_ |
集荷フルフィルメント タイプのストアごとの最小注文額の表。minimum_order_value と同時に設定することはできません。 |
store_ |
商品の発送元となる店舗のリスト。これは、ローカル配送の配送タイプでのみ有効です。 |
LoyaltyProgram
販売者が提供するポイント プログラム。
| フィールド | |
|---|---|
loyalty_ |
省略可。この配送サービスのポイント プログラムの階層。 |
program_ |
これは、Merchant Center のポイント プログラム設定で設定するポイント プログラム ラベルです。このサブ属性を使用すると、貴社のポイント プログラムが対象の商品にマッピングされます。 |
LoyaltyProgramTiers
販売者ポイント プログラムのサブセット。
| フィールド | |
|---|---|
tier_ |
階層ラベル [tier_label] サブ属性は、商品単位の特典を階層間で区別します。この値は Merchant Center のプログラム設定でも設定されます。ポイント プログラムに階層が 1 つしかない場合でも、データソース変更の際は必須です。 |
ShipmentType
配送サービスの配送タイプ。
| 列挙型 | |
|---|---|
SHIPMENT_TYPE_UNSPECIFIED |
このサービスでは配送タイプが指定されていません。 |
DELIVERY |
このサービスでは、お客様が指定した住所宛てに注文商品を発送します。 |
LOCAL_DELIVERY |
このサービスでは、お客様が指定した住所宛てに注文商品を配送します。注文した商品が近くの店舗から発送される。 |
COLLECTION_POINT |
このサービスでは、お客様が指定した住所宛てに注文商品を配送します。注文が集荷所から発送されている。 |
StoreConfig
商品の発送元となる店舗のリスト。これは、ローカル配送の配送タイプでのみ有効です。
| フィールド | |
|---|---|
store_ |
省略可。地域配送を提供している店舗コードのリスト。空の場合は、 |
store_ |
この販売者が掲載しているすべての店舗、または一部の店舗で、地域別配送を提供しているかどうかを示します。 |
cutoff_ |
当日配達に関連する設定が終了します。 |
service_ |
配達可能な範囲(半径)。これは、ローカル配送の配送タイプでのみ必須です。 |
CutoffConfig
当日配達に関連する設定が終了します。
| フィールド | |
|---|---|
local_ |
当日ローカル配達が終了する時間。 |
store_ |
ローカル配送のフルフィルメントでのみ有効です。閉店時間までの時間数で指定します。 |
no_ |
販売者は、n 日以内の配達に設定されている配送サービスを利用している場合、n+1 日以内の配達を表示しないようにオプトアウトできます。たとえば、配送サービスで当日配達が定義されていて、締め切りを過ぎている場合、このフィールドを |
LocalCutoffTime
当日配達の終了時間。
| フィールド | |
|---|---|
hour |
当日配達の注文は、当日処理するために、この時間までに注文する必要があります。 |
minute |
当日配達の注文は、同日に処理されるように、午後 3 時までに注文する必要があります。 |
StoreServiceType
販売者が掲載したすべての店舗、または一部の店舗で、地域内配達を提供しているかどうかを示します。
| 列挙型 | |
|---|---|
STORE_SERVICE_TYPE_UNSPECIFIED |
店舗サービスタイプが指定されていません。 |
ALL_STORES |
この販売者が掲載しているすべての店舗(現在および今後)で、地域への配送を提供しているかどうかを示します。 |
SELECTED_STORES |
store_codes にリストされている店舗のみがローカル配送の対象であることを示します。 |
ShippingSettings
販売者のアカウントの配送設定。
| フィールド | |
|---|---|
name |
ID。配送設定のリソース名。形式: |
services[] |
省略可。ターゲット アカウントのサービス リスト。 |
warehouses[] |
省略可。 |
etag |
必須。このフィールドは、非同期の問題を回避するために使用されます。get 呼び出しと insert 呼び出しの間で配送設定データが変更されていないことを確認します。お客様は次の手順を行う必要があります。
|
表
single_value では十分に表現できない場合に、レートグループを定義するテーブル。
| フィールド | |
|---|---|
rows[] |
必須。テーブルを構成する行のリスト。 |
name |
テーブルの名前。サブテーブルでは必須ですが、メインテーブルでは無視されます。 |
row_ |
必須。テーブルの行のヘッダー。 |
column_ |
テーブルの列のヘッダー。省略可: 設定しない場合、テーブルにはディメンションが 1 つだけになります。 |
TermsOfService
TermsOfService メッセージは、特定の機能やサービスにアクセスするために販売者が同意する必要がある利用規約の特定のバージョンを表します(https://support.google.com/merchants/answer/160173) をご覧ください)。
このメッセージは、販売者がサービスの利用に必要な法的契約に同意することを確認するオンボーディング プロセスにおいて重要です。販売者は、RetrieveLatestTermsOfService を使用して特定の kind と region の最新の利用規約を取得し、必要に応じて AcceptTermsOfService を使用して同意できます。
| フィールド | |
|---|---|
name |
ID。利用規約のバージョンのリソース名。形式: |
region_ |
CLDR で定義されている地域コード。利用規約がその国にのみ適用される国か、どの国でも同じ |
kind |
この利用規約のバージョンが適用される Kind。 |
external |
この利用規約のバージョンが社外向けかどうか。外部利用規約のバージョンは、外部プロセスを通じてのみ同意できます。販売者が UI または API を通じて直接同意することはできません。 |
file_ |
署名するユーザーに表示する必要がある利用規約ファイルの URI。 |
TermsOfServiceAgreementState
このリソースは、特定のアカウントと利用規約の種類の同意状態を表します。状態は次のとおりです。
- 販売者が利用規約に同意している場合: [accepted] が入力されます。同意していない場合は空白になります。
- 販売者が利用規約に署名する必要がある場合は [必須] が入力されます。それ以外の場合は空白になります。
必須と承認済みの両方を指定できます。この場合、accepted 利用規約の valid_until フィールドに有効期限が設定されます。アカウントの有効な契約を継続するには、valid_until より前に required 利用規約に同意する必要があります。新しい利用規約に同意する際に、サードパーティは、該当する利用規約に関連付けられたテキストを表示する必要があります(テキストを含むファイルの URL は、以下の必須メッセージに tos_file_uri として追加されます。利用規約への実際の同意は、TermsOfService リソースで accept を呼び出すことによって行われます。
| フィールド | |
|---|---|
name |
ID。利用規約のバージョンのリソース名。形式: |
region_ |
https://cldr.unicode.org/ で定義されている地域コード。現在の状態が適用される国です。 |
terms_ |
特定のバージョンに関連付けられている利用規約の種類。 |
accepted |
この種類と関連する region_code の承認済み利用規約 |
required |
必要な利用規約 |
TermsOfServiceKind
TermsOfService の種類。
| 列挙型 | |
|---|---|
TERMS_OF_SERVICE_KIND_UNSPECIFIED |
デフォルト値。この値は使用されません。 |
MERCHANT_CENTER |
Merchant Center アプリケーション。 |
TransitTable
お届け日数表: 行と列のディメンションに基づくお届けまでの営業日数。min_transit_days、max_transit_days、transit_time_table のいずれかを設定できますが、両方は設定できません。
| フィールド | |
|---|---|
postal_ |
必須。リージョン名のリスト |
transit_ |
必須。お届け日数ラベルのリスト。最後の値は |
rows[] |
必須。 |
TransitTimeRow
postal_code_group_names または transit_time_labels のディメンション セットが 1 つしかない場合、そのディメンションの値が 1 つの行に複数存在します。ディメンションが 2 つある場合、各行は postal_code_group_names に対応し、列(値)は transit_time_labels に対応します。
| フィールド | |
|---|---|
values[] |
必須。お届け日数の範囲(最小 - 最大)(営業日数)。 |
TransitTimeValue
お届け日数の範囲(最小 - 最大)(営業日数)。
| フィールド | |
|---|---|
min_ |
最短の配送日数(営業日数)。0 は当日配達、1 は翌日配達を意味します。 |
max_ |
|
UnclaimHomepageRequest
UnclaimHomepage メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。所有権を放棄するホームページの名前。形式: |
UpdateAccountRequest
UpdateAccount メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
account |
必須。アカウントの新しいバージョン。 |
update_ |
省略可。更新されるフィールドのリスト。 次のフィールドがサポートされています(
|
UpdateAutofeedSettingsRequest
UpdateAutofeedSettings メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
autofeed_ |
必須。自動フィード設定の新しいバージョン。 |
update_ |
必須。更新されるフィールドのリスト。 |
UpdateBusinessIdentityRequest
UpdateBusinessIdentity メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
business_ |
必須。ビジネス アイデンティティの新しいバージョン。 |
update_ |
省略可。更新されるフィールドのリスト。 次のフィールドがサポートされています(
|
UpdateBusinessInfoRequest
UpdateBusinessInfo メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
business_ |
必須。新しいバージョンのビジネス情報。 |
update_ |
省略可。更新されるフィールドのリスト。 次のフィールドがサポートされています(
|
UpdateEmailPreferencesRequest
UpdateEmailPreferences メソッドのリクエスト メッセージ。
| フィールド | |
|---|---|
email_ |
必須。メール設定を更新します。 |
update_ |
必須。更新されるフィールドのリスト。 次のフィールドがサポートされています(
|
UpdateHomepageRequest
UpdateHomepage メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
homepage |
必須。新しいバージョンのホームページ。 |
update_ |
省略可。更新されるフィールドのリスト。 次のフィールドがサポートされています(
|
UpdateRegionRequest
UpdateRegion メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
region |
必須。更新されたリージョン。 |
update_ |
省略可。更新するフィールドを示すカンマ区切りのフィールド マスク。例: |
UpdateUserRequest
UpdateUser メソッドに対するリクエスト メッセージ。
| フィールド | |
|---|---|
user |
必須。ユーザーの新しいバージョン。
|
update_ |
省略可。更新されるフィールドのリスト。 次のフィールドがサポートされています(
|
ユーザー
User メッセージは、Merchant Center アカウントに関連付けられているユーザーを表します。これは、アカウント内のユーザー権限とアクセス権を管理するために使用されます。詳しくは、ユーザーとアクセスレベルに関するよくある質問をご覧ください。
| フィールド | |
|---|---|
name |
ID。ユーザーのリソース名。形式:
|
state |
出力専用。ユーザーの状態。 |
access_ |
省略可。ユーザーが持つアクセス権。 |
州
ユーザーが取り得る状態。
| 列挙型 | |
|---|---|
STATE_UNSPECIFIED |
デフォルト値。この値は使用されません。 |
PENDING |
ユーザーの確認が保留中です。この状態のユーザーは、他の操作を行う前にまず招待を承諾する必要があります。 |
VERIFIED |
ユーザーが確認済みであること。 |
値
料金グループの単一の値、または料金グループ テーブルのセルの値。no_shipping、flat_rate、price_percentage、carrier_rateName、subtable_name のいずれか 1 つを設定する必要があります。
| フィールド | |
|---|---|
no_ |
true の場合、商品は配送できません。設定時に true にする必要があります。他のすべてのフィールドが設定されていない場合にのみ設定できます。 |
flat_ |
定額料金。他のすべてのフィールドが設定されていない場合にのみ設定できます。 |
price_ |
小数表記の数値で表される料金の割合(例: |
carrier_ |
同じレートグループで定義された運送業者レートを参照する運送業者レートの名前。他のすべてのフィールドが設定されていない場合にのみ設定できます。 |
subtable |
サブテーブルの名前。テーブルのセルにのみ設定できます(単一値には設定できません)。また、他のすべてのフィールドが設定されていない場合にのみ設定できます。 |
倉庫
フルフィルメント ウェアハウス: 在庫を保管して処理します。
| フィールド | |
|---|---|
name |
必須。ウェアハウスの名前。アカウント内で一意にする必要があります。 |
shipping_ |
必須。倉庫の発送先住所。 |
cutoff_ |
必須。注文を受け入れて処理を開始できる最遅の時間。その後の注文は翌日に処理されます。所要時間は倉庫の郵便番号に基づきます。 |
handling_ |
必須。この倉庫で商品を梱包して発送するまでにかかる日数。これは倉庫単位ですが、商品アイテムの属性に基づいて商品単位でオーバーライドできます。 |
business_ |
倉庫の営業日。設定しない場合、デフォルトは月曜日から金曜日になります。 |
WarehouseBasedDeliveryTime
選択した運送業者の設定に基づいて、倉庫(配送元)ごとにお届け日数を計算する必要があることを示します。設定する場合は、delivery_time の他の配送時間関連フィールドは設定しないでください。
| フィールド | |
|---|---|
carrier |
必須。携帯通信会社( |
carrier_ |
必須。携帯通信会社サービス( |
warehouse |
必須。ウェアハウス名。これは [warehouse][ShippingSetting.warehouses.name] と一致する必要があります。 |
WarehouseCutoffTime
注文を受け入れて処理を開始できる最遅の時間。その後の注文は翌日に処理されます。所要時間は倉庫の郵便番号に基づきます。
| フィールド | |
|---|---|
hour |
必須。倉庫で当日中に処理されるように注文を完了する必要がある締め切り時間(時)。時間は倉庫のタイムゾーンに基づいています。 |
minute |
必須。倉庫で当日中に処理されるように注文を完了する必要がある締め切り時間(分単位)。分は倉庫のタイムゾーンに基づいています。 |