Merchant API

Merchant Center アカウントをプログラムで管理します。

サービス: merchantapi.googleapis.com

このサービスを呼び出すには、Google が提供するクライアント ライブラリを使用することをおすすめします。アプリケーションで独自のライブラリを使用してこのサービスを呼び出す必要がある場合は、API リクエストの際に次の情報を使用してください。

ディスカバリ ドキュメント

ディスカバリ ドキュメントは、REST API を記述して使用するための機械可読仕様です。クライアント ライブラリ、IDE プラグイン、Google API と連携するその他のツールのビルドに使用されます。1 つのサービスで複数のディスカバリ ドキュメントを提供できます。このサービスには、次のディスカバリ ドキュメントが用意されています。

サービス エンドポイント

サービス エンドポイントは、API サービスのネットワーク アドレスを指定するベース URL です。1 つのサービスに複数のサービス エンドポイントが存在することもあります。このサービスには次のサービス エンドポイントがあり、以下のすべての URI がこのサービス エンドポイントに関連しています。

  • https://merchantapi.googleapis.com

REST リソース: reports_v1beta.accounts.reports

メソッド
search POST /reports/v1beta/{parent=accounts/*}/reports:search
検索クエリで定義されたレポートを取得します。

REST リソース: quota_v1beta.accounts.quotas

メソッド
list GET /quota/v1beta/{parent=accounts/*}/quotas
Merchant Center アカウントのグループごとの 1 日の呼び出し割り当てと使用量のリスト。

REST リソース: promotions_v1beta.accounts.promotions

メソッド
get GET /promotions/v1beta/{name=accounts/*/promotions/*}
Merchant Center アカウントからプロモーションを取得します。
insert POST /promotions/v1beta/{parent=accounts/*}/promotions:insert
Merchant Center アカウントのプロモーションを挿入します。
list GET /promotions/v1beta/{parent=accounts/*}/promotions
Merchant Center アカウントのプロモーションが一覧表示されます。

REST リソース: products_v1beta.accounts.productInputs

メソッド
delete DELETE /products/v1beta/{name=accounts/*/productInputs/*}
Merchant Center アカウントから商品入力を削除します。
insert POST /products/v1beta/{parent=accounts/*}/productInputs:insert
Merchant Center アカウントに商品情報をアップロードします。

REST リソース: products_v1beta.accounts.products

メソッド
get GET /products/v1beta/{name=accounts/*/products/*}
処理された商品を Merchant Center アカウントから取得します。
list GET /products/v1beta/{parent=accounts/*}/products
Merchant Center アカウントにある処理済みの商品が一覧表示されます。

REST リソース: notifications_v1beta.accounts.notificationsubscriptions

メソッド
create POST /notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
販売者の通知サブスクリプションを作成します。
delete DELETE /notifications/v1beta/{name=accounts/*/notificationsubscriptions/*}
販売者の通知サブスクリプションを削除します。
get GET /notifications/v1beta/{name=accounts/*/notificationsubscriptions/*}
アカウントの通知の登録を取得します。
list GET /notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
販売者のすべての通知の登録を取得します。
patch PATCH /notifications/v1beta/{notificationSubscription.name=accounts/*/notificationsubscriptions/*}
販売者の既存の通知登録を更新します。

REST リソース: lfp_v1beta.accounts.lfpInventories

メソッド
insert POST /lfp/v1beta/{parent=accounts/*}/lfpInventories:insert
指定された販売アカウントに関する LfpInventory リソースを挿入します。

REST リソース: lfp_v1beta.accounts.lfpSales

メソッド
insert POST /lfp/v1beta/{parent=accounts/*}/lfpSales:insert
指定された販売者の LfpSale を挿入します。

REST リソース: lfp_v1beta.accounts.lfpStores

メソッド
delete DELETE /lfp/v1beta/{name=accounts/*/lfpStores/*}
対象の販売者の店舗を削除します。
get GET /lfp/v1beta/{name=accounts/*/lfpStores/*}
店舗に関する情報を取得します。
insert POST /lfp/v1beta/{parent=accounts/*}/lfpStores:insert
対象の販売者の店舗を挿入します。
list GET /lfp/v1beta/{parent=accounts/*}/lfpStores
ListLfpStoresRequest のフィルタで指定された対象販売者の店舗を一覧表示します。

REST リソース: inventories_v1beta.accounts.products.localInventories

メソッド
delete DELETE /inventories/v1beta/{name=accounts/*/products/*/localInventories/*}
指定された LocalInventory を販売アカウントの特定の商品から削除します。
insert POST /inventories/v1beta/{parent=accounts/*/products/*}/localInventories:insert
販売アカウントの商品に LocalInventory リソースを挿入します。
list GET /inventories/v1beta/{parent=accounts/*/products/*}/localInventories
販売アカウントにある特定の商品の LocalInventory リソースを一覧表示します。

REST リソース: inventories_v1beta.accounts.products.regionalInventories

メソッド
delete DELETE /inventories/v1beta/{name=accounts/*/products/*/regionalInventories/*}
販売アカウントの特定の商品から、指定された RegionalInventory リソースを削除します。
insert POST /inventories/v1beta/{parent=accounts/*/products/*}/regionalInventories:insert
販売アカウントの特定の商品に RegionalInventory を挿入します。
list GET /inventories/v1beta/{parent=accounts/*/products/*}/regionalInventories
販売アカウントにある特定の商品の RegionalInventory リソースを一覧表示します。

REST リソース: datasources_v1beta.accounts.dataSources

メソッド
create POST /datasources/v1beta/{parent=accounts/*}/dataSources
指定したアカウントの新しいデータソース設定を作成します。
delete DELETE /datasources/v1beta/{name=accounts/*/dataSources/*}
Merchant Center アカウントからデータソースを削除します。
fetch POST /datasources/v1beta/{name=accounts/*/dataSources/*}:fetch
Merchant Center アカウントのデータソースでデータをすぐに（取得スケジュール外であっても）取得します。
get GET /datasources/v1beta/{name=accounts/*/dataSources/*}
指定したアカウントのデータソース構成を取得します。
list GET /datasources/v1beta/{parent=accounts/*}/dataSources
指定したアカウントのデータソースの構成を一覧表示します。
patch PATCH /datasources/v1beta/{dataSource.name=accounts/*/dataSources/*}
既存のデータソース構成を更新します。

REST リソース: conversions_v1beta.accounts.conversionSources

メソッド
create POST /conversions/v1beta/{parent=accounts/*}/conversionSources
新しいコンバージョンの発生元を作成します。
delete DELETE /conversions/v1beta/{name=accounts/*/conversionSources/*}
既存のコンバージョンの発生元をアーカイブします。
get GET /conversions/v1beta/{name=accounts/*/conversionSources/*}
コンバージョンの発生元を取得します。
list GET /conversions/v1beta/{parent=accounts/*}/conversionSources
呼び出し元がアクセスできるコンバージョンの発生元のリストを取得します。
patch PATCH /conversions/v1beta/{conversionSource.name=accounts/*/conversionSources/*}
既存のコンバージョンの発生元の情報を更新します。
undelete POST /conversions/v1beta/{name=accounts/*/conversionSources/*}:undelete
アーカイブされたコンバージョンの発生元を再度有効にします。

REST リソース: accounts_v1beta.accounts

メソッド
createAndConfigure POST /accounts/v1beta/accounts:createAndConfigure
追加設定を行ったスタンドアロンの Merchant Center アカウントを作成します。
delete DELETE /accounts/v1beta/{name=accounts/*}
タイプ（スタンドアロン、MCA、サブアカウント）に関係なく、指定したアカウントを削除します。
get GET /accounts/v1beta/{name=accounts/*}
Merchant Center アカウントからアカウントを取得します。
list GET /accounts/v1beta/accounts
呼び出し元のユーザーがアクセスでき、ページサイズやフィルタなどのリクエストの制約に一致するアカウントを一覧表示します。
listSubaccounts GET /accounts/v1beta/{provider=accounts/*}:listSubaccounts
指定されたマルチクライアント アカウントのすべてのサブアカウントを一覧表示します。
patch PATCH /accounts/v1beta/{account.name=accounts/*}
種類（スタンドアロン、MCA、サブアカウント）に関係なく、アカウントを更新します。

REST リソース: accounts_v1beta.accounts.businessIdentity

メソッド
getBusinessIdentity GET /accounts/v1beta/{name=accounts/*/businessIdentity}
アカウントのビジネス アイデンティティを取得します。
updateBusinessIdentity PATCH /accounts/v1beta/{businessIdentity.name=accounts/*/businessIdentity}
アカウントのビジネス アイデンティティを更新します。

REST リソース: accounts_v1beta.accounts.businessInfo

メソッド
getBusinessInfo GET /accounts/v1beta/{name=accounts/*/businessInfo}
アカウントのビジネス情報を取得します。
updateBusinessInfo PATCH /accounts/v1beta/{businessInfo.name=accounts/*/businessInfo}
アカウントのビジネス情報を更新します。

REST リソース: accounts_v1beta.accounts.emailpreferences

メソッド
getEmailPreferences GET /accounts/v1beta/{name=accounts/*/users/*/emailPreferences}
Merchant Center アカウント ユーザーのメール設定を返します。
updateEmailPreferences PATCH /accounts/v1beta/{emailPreferences.name=accounts/*/users/*/emailPreferences}
Merchant Center アカウント ユーザーのメール設定を更新します。

REST リソース: accounts_v1beta.accounts.homepage

メソッド
claim POST /accounts/v1beta/{name=accounts/*/homepage}:claim
ショップのホームページの申請。
getHomepage GET /accounts/v1beta/{name=accounts/*/homepage}
ショップのホームページを取得します。
unclaim POST /accounts/v1beta/{name=accounts/*/homepage}:unclaim
ショップのホームページの申請を解除します。
updateHomepage PATCH /accounts/v1beta/{homepage.name=accounts/*/homepage}
ショップのホームページを更新します。

REST リソース: accounts_v1beta.accounts.issues

メソッド
list GET /accounts/v1beta/{parent=accounts/*}/issues
Merchant Center アカウントのすべての問題が一覧表示されます。

REST リソース: accounts_v1beta.accounts.onlineReturnPolicies

メソッド
get GET /accounts/v1beta/{name=accounts/*/onlineReturnPolicies/*}
既存の返品に関するポリシーを取得します。
list GET /accounts/v1beta/{parent=accounts/*}/onlineReturnPolicies
返品に関する既存のポリシーを一覧表示します。

REST リソース: accounts_v1beta.accounts.programs

メソッド
disable POST /accounts/v1beta/{name=accounts/*/programs/*}:disable
アカウントの指定されたプログラムへの参加を無効にする。
enable POST /accounts/v1beta/{name=accounts/*/programs/*}:enable
アカウントの指定されたプログラムへの参加を有効にします。
get GET /accounts/v1beta/{name=accounts/*/programs/*}
アカウントに指定されたプログラムを取得します。
list GET /accounts/v1beta/{parent=accounts/*}/programs
アカウントのすべてのプログラムを取得します。

REST リソース: accounts_v1beta.accounts.regions

メソッド
create POST /accounts/v1beta/{parent=accounts/*}/regions
Merchant Center アカウントで地域の定義を作成します。
delete DELETE /accounts/v1beta/{name=accounts/*/regions/*}
Merchant Center アカウントから地域の定義を削除します。
get GET /accounts/v1beta/{name=accounts/*/regions/*}
Merchant Center アカウントで定義されている地域を取得します。
list GET /accounts/v1beta/{parent=accounts/*}/regions
Merchant Center アカウントに登録されている地域が一覧表示されます。
patch PATCH /accounts/v1beta/{region.name=accounts/*/regions/*}
Merchant Center アカウントの地域の定義を更新します。

REST リソース: accounts_v1beta.accounts.shippingSettings

メソッド
getShippingSettings GET /accounts/v1beta/{name=accounts/*/shippingSettings}
配送設定の情報を取得します。
insert POST /accounts/v1beta/{parent=accounts/*}/shippingSettings:insert
販売者の送料設定を配送リクエストの設定に置き換えます。

REST リソース: accounts_v1beta.accounts.termsOfServiceAgreementStates

メソッド
get GET /accounts/v1beta/{name=accounts/*/termsOfServiceAgreementStates/*}
利用規約の状態を返します。
retrieveForApplication GET /accounts/v1beta/{parent=accounts/*}/termsOfServiceAgreementStates:retrieveForApplication
アプリケーションの利用規約に関する契約の状態を取得します。

REST リソース: accounts_v1beta.accounts.users

メソッド
create POST /accounts/v1beta/{parent=accounts/*}/users
Merchant Center アカウントのユーザーを作成します。
delete DELETE /accounts/v1beta/{name=accounts/*/users/*}
Merchant Center アカウントのユーザーを削除します。
get GET /accounts/v1beta/{name=accounts/*/users/*}
Merchant Center アカウントのユーザーを取得します。
list GET /accounts/v1beta/{parent=accounts/*}/users
Merchant Center アカウントのすべてのユーザーを一覧表示します。
patch PATCH /accounts/v1beta/{user.name=accounts/*/users/*}
Merchant Center アカウントのユーザーを更新します。

REST リソース: accounts_v1beta.termsOfService

メソッド
accept GET /accounts/v1beta/{name=termsOfService/*}:accept
TermsOfService を指定します。
get GET /accounts/v1beta/{name=termsOfService/*}
指定されたバージョンに関連付けられた TermsOfService を取得します。
retrieveLatest GET /accounts/v1beta/termsOfService:retrieveLatest
指定された kind と region_code の TermsOfService の最新バージョンを取得します。