Merchant API

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

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

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

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

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

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

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

  • https://merchantapi.googleapis.com

Ресурс REST: review_v1beta.accounts.merchantReviews

Методы
delete DELETE /reviews/v1beta/{name=accounts/*/merchantReviews/*}
Удаляет отзыв продавца.
get GET /reviews/v1beta/{name=accounts/*/merchantReviews/*}
Получает отзыв продавца.
insert POST /reviews/v1beta/{parent=accounts/*}/merchantReviews:insert
Добавляет отзыв о вашей учетной записи Merchant Center.
list GET /reviews/v1beta/{parent=accounts/*}/merchantReviews
Перечисляет отзывы продавцов.

Ресурс REST: review_v1beta.accounts.productReviews.

Методы
delete DELETE /reviews/v1beta/{name=accounts/*/productReviews/*}
Удаляет отзыв о товаре.
get GET /reviews/v1beta/{name=accounts/*/productReviews/*}
Получает обзор продукта.
insert POST /reviews/v1beta/{parent=accounts/*}/productReviews:insert
Вставляет обзор продукта.
list GET /reviews/v1beta/{parent=accounts/*}/productReviews
Содержит обзоры продуктов.

Ресурс 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: datasources_v1beta.accounts.dataSources.fileUploads

Методы
get GET /datasources/v1beta/{name=accounts/*/dataSources/*/fileUploads/*}
Получает последнюю загруженную версию файла источника данных.

Ресурс 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

Методы
create And Configure 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
Перечисляет учетные записи, доступные вызывающему пользователю и соответствующие ограничениям запроса, таким как размер страницы или фильтры.
list Subaccounts GET /accounts/v1beta/{provider=accounts/*}:listSubaccounts
Перечислите все субсчета для данной многоклиентской учетной записи.
patch PATCH /accounts/v1beta/{account.name=accounts/*}
Обновляет учетную запись независимо от ее типа: автономная, MCA или суб-учетная запись.

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

Методы
get Autofeed Settings GET /accounts/v1beta/{name=accounts/*/autofeedSettings}
Получает настройки автоподачи учетной записи.
update Autofeed Settings PATCH /accounts/v1beta/{autofeedSettings.name=accounts/*/autofeedSettings}
Обновляет настройки автоподачи учетной записи.

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

Методы
get Business Identity GET /accounts/v1beta/{name=accounts/*/businessIdentity}
Получает бизнес-идентификатор учетной записи.
update Business Identity PATCH /accounts/v1beta/{businessIdentity.name=accounts/*/businessIdentity}
Обновляет бизнес-идентичность учетной записи.

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

Методы
get Business Info GET /accounts/v1beta/{name=accounts/*/businessInfo}
Получает деловую информацию об аккаунте.
update Business Info PATCH /accounts/v1beta/{businessInfo.name=accounts/*/businessInfo}
Обновляет бизнес-информацию учетной записи.

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

Методы
get Email Preferences GET /accounts/v1beta/{name=accounts/*/users/*/emailPreferences}
Возвращает настройки электронной почты для пользователя учетной записи Merchant Center.
update Email Preferences PATCH /accounts/v1beta/{emailPreferences.name=accounts/*/users/*/emailPreferences}
Обновляет настройки электронной почты для пользователя учетной записи Merchant Center.

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

Методы
claim POST /accounts/v1beta/{name=accounts/*/homepage}:claim
Утверждает домашнюю страницу магазина.
get Homepage GET /accounts/v1beta/{name=accounts/*/homepage}
Получает домашнюю страницу магазина.
unclaim POST /accounts/v1beta/{name=accounts/*/homepage}:unclaim
Отменяет права на домашнюю страницу магазина.
update Homepage 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

Методы
get Shipping Settings 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/*}
Возвращает состояние соглашения об условиях обслуживания.
retrieve For Application 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 связанные с предоставленной версией.
retrieve Latest GET /accounts/v1beta/termsOfService:retrieveLatest
Получает последнюю TermsOfService для заданного kind и region_code .