Merchant API

Программно управляйте своими учетными записями Merchant Center.

Сервис: traderapi.googleapis.com.

Для вызова этой службы мы рекомендуем использовать клиентские библиотеки Google. Если вашему приложению необходимо использовать собственные библиотеки для вызова этой службы, используйте следующую информацию при отправке запросов API.

Документ открытия

Документ обнаружения — это машиночитаемая спецификация для описания и использования REST API. Он используется для создания клиентских библиотек, плагинов IDE и других инструментов, взаимодействующих с API Google. Одна служба может предоставлять несколько документов обнаружения. Эта служба предоставляет следующие документы обнаружения:

Конечная точка службы

Конечная точка службы — это базовый URL-адрес, указывающий сетевой адрес службы API. Одна служба может иметь несколько конечных точек службы. Эта служба имеет следующую конечную точку службы, и все приведенные ниже URI относятся к этой конечной точке службы:

  • https://merchantapi.googleapis.com

Ресурс REST: report_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.

Ресурс 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: Notification_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: конверсии_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: account_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: account_v1beta.accounts.accounttax.

Методы
get GET /accounts/v1beta/{name=accounts/*/accounttax/*}
Возвращает налоговые правила, соответствующие условиям GetAccountTaxRequest.
list GET /accounts/v1beta/{parent=accounts/*}/accounttax
Перечисляет налоговые настройки дочерних аккаунтов только в вашем аккаунте Merchant Center.
patch PATCH /accounts/v1beta/{accountTax.name=accounts/*/accounttax/*}
Обновляет налоговые настройки учетной записи.

Ресурс REST: account_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: account_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: account_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: account_v1beta.accounts.issues .

Методы
list GET /accounts/v1beta/{parent=accounts/*}/issues
Перечисляет все проблемы с учетной записью Merchant Center.

Ресурс REST: account_v1beta.accounts.onlineReturnPolicies

Методы
get GET /accounts/v1beta/{name=accounts/*/onlineReturnPolicies/*}
Получает существующую политику возврата.
list GET /accounts/v1beta/{parent=accounts/*}/onlineReturnPolicies
Перечисляет все существующие политики возврата.

Ресурс REST: account_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: account_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: account_v1beta.accounts.shippingSettings

Методы
getShippingSettings GET /accounts/v1beta/{name=accounts/*/shippingSettings}
Получить информацию о настройках доставки.
insert POST /accounts/v1beta/{parent=accounts/*}/shippingSettings:insert
Замените настройку доставки продавца на настройку доставки запроса.

Ресурс REST: account_v1beta.accounts.termsOfServiceAgreementStates

Методы
get GET /accounts/v1beta/{name=accounts/*/termsOfServiceAgreementStates/*}
Возвращает состояние соглашения об условиях обслуживания.
retrieveForApplication GET /accounts/v1beta/{parent=accounts/*}/termsOfServiceAgreementStates:retrieveForApplication
Получает состояние соглашения для условий обслуживания приложения.

Ресурс REST: account_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: account_v1beta.termsOfService

Методы
accept GET /accounts/v1beta/{name=termsOfService/*}:accept
Принимает TermsOfService .
get GET /accounts/v1beta/{name=termsOfService/*}
Получает TermsOfService , связанные с предоставленной версией.
retrieveLatest GET /accounts/v1beta/termsOfService:retrieveLatest
Получает последнюю TermsOfService для заданного kind и region_code .