Индекс
-
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
(сообщение)
АккаунтПроблемаСервис
Сервис для поддержки API AccountIssueService
.
ListAccountIssues |
---|
Перечисляет все проблемы с учетной записью Merchant Center.
|
Служба учета
Сервис для поддержки API учетных записей.
Создать и настроить учетную запись |
---|
Создает отдельный аккаунт Merchant Center с дополнительной настройкой. Добавляет пользователя, отправляющего запрос, в качестве администратора новой учетной записи.
|
Удалить аккаунт |
---|
Удаляет указанную учетную запись независимо от ее типа: автономная, MCA или суб-учетная запись. Удаление MCA приводит к удалению всех его субсчетов. Для выполнения этого метода требуется доступ администратора. Удаление будет успешным только в том случае, если учетная запись не предоставляет услуги какой-либо другой учетной записи и не имеет обработанных предложений. Вы можете использовать параметр
|
Получить аккаунт |
---|
Получает учетную запись из вашей учетной записи Merchant Center. После добавления, обновления или удаления учетной записи может пройти несколько минут, прежде чем изменения вступят в силу.
|
Список аккаунтов |
---|
Перечисляет учетные записи, доступные вызывающему пользователю и соответствующие ограничениям запроса, таким как размер страницы или фильтры. Это не просто список субсчетов MCA, но и всех учетных записей, к которым у вызывающего пользователя есть доступ, включая другие MCA, связанные учетные записи, автономные учетные записи и так далее. Если фильтр не указан, он возвращает учетные записи, в которые непосредственно добавлен пользователь. Этот метод в конечном итоге является последовательным, то есть такие изменения, как создание, обновление учетной записи или изменение отношений между учетными записями, могут не сразу отображаться в результатах. Вместо этого эти изменения распространяются в течение короткого периода, после чего обновленная информация может соответствовать связанным предикатам. Это означает, что поиск по имени учетной записи может не вернуть недавно измененную учетную запись, даже если она удовлетворяет предикату.
|
Список субсчетов |
---|
Перечислите все субсчета для данной многоклиентской учетной записи. Это удобная оболочка для более мощного метода
|
ОбновитьАккаунт |
---|
Обновляет учетную запись независимо от ее типа: автономная, MCA или суб-учетная запись. Для выполнения этого метода требуется доступ администратора.
|
Настройки автоподачиСервис
Сервис для поддержки настройки автоподачи .
Получить настройки автоподачи |
---|
Получает настройки автоподачи учетной записи.
|
Обновить настройки автоподачи |
---|
Обновляет настройки автоподачи учетной записи.
|
БизнесИдентичностьСервис
Сервис для поддержки API бизнес-идентификации .
GetBusinessIdentity |
---|
Получает бизнес-идентификатор учетной записи.
|
ОбновлениеBusinessIdentity |
---|
Обновляет бизнес-идентичность учетной записи. Для выполнения этого метода требуется доступ администратора.
|
БизнесИнфоСервис
Сервис для поддержки API бизнес-информации.
GetBusinessInfo |
---|
Получает деловую информацию об аккаунте.
|
ОбновлениеBusinessInfo |
---|
Обновляет бизнес-информацию учетной записи. Для выполнения этого метода требуется доступ администратора.
|
Настройки электронной почтыСервис
Сервис для поддержки API EmailPreferences
.
Получить настройки электронной почты |
---|
Возвращает настройки электронной почты для пользователя учетной записи Merchant Center. Эта служба позволяет получать и обновлять настройки электронной почты только для аутентифицированного пользователя. Используйте псевдоним name=accounts/*/users/me/emailPreferences, чтобы получить настройки для аутентифицированного пользователя.
|
Обновить настройки электронной почты |
---|
Обновляет настройки электронной почты для пользователя учетной записи Merchant Center. Пользователи MCA должны указать учетную запись MCA, а не дополнительную учетную запись MCA. Настройки, которые не выбраны явно в маске обновления, не будут обновлены. Для обновлений недопустимо указывать значение статуса подписки НЕПОДТВЕРЖДЕНО. Используйте псевдоним name=accounts/*/users/me/emailPreferences, чтобы обновить настройки для аутентифицированного пользователя.
|
ГлавнаяСервис
Сервис для поддержки API главной страницы магазина.
ПретензияГлавная страница |
---|
Утверждает домашнюю страницу магазина. Для выполнения этого метода требуется доступ администратора. Если домашняя страница уже заявлена, проверка будет перепроверена (если только продавец не освобожден от подачи заявки, что также освобождается от проверки) и будет получен успешный ответ. Если право собственности больше не может быть подтверждено, будет возвращена ошибка, но не будет удалена претензия. В случае неудачи будет возвращено каноническое сообщение об ошибке: * PERMISSION_DENIED: у пользователя нет необходимых разрешений для этой учетной записи MC; * FAILED_PRECONDITION: — Аккаунт не является аккаунтом Merchant Center; - У аккаунта MC нет домашней страницы; - заявка не удалась (в этом случае сообщение об ошибке будет содержать более подробную информацию).
|
Получить домашнюю страницу |
---|
Получает домашнюю страницу магазина.
|
Отменить требованиеДомашняя страница |
---|
Отменяет права на домашнюю страницу магазина. Для выполнения этого метода требуется доступ администратора.
|
Обновить домашнюю страницу |
---|
Обновляет домашнюю страницу магазина. Для выполнения этого метода требуется доступ администратора.
|
ОнлайнReturnPolicyService
Услуга упрощает управление конфигурацией политики возврата продавца, охватывающей политику возврата как для рекламы, так и для бесплатных объявлений.
программы. Этот API определяет следующую модель ресурсов:
[OnlineReturnPolicy][google.shopping.merchant.accounts.v1.OnlineReturnPolicy]
GetOnlineReturnPolicy |
---|
Получает существующую политику возврата для данного продавца.
|
ListOnlineReturnPolicies |
---|
Перечисляет все существующие правила возврата для данного продавца.
|
ПрограммыСервис
Сервис для управления программами.
Программы предоставляют механизм добавления функциональности к торговым счетам. Типичным примером этого является программа бесплатных списков товаров , которая позволяет бесплатно показывать товары из магазина продавца в Google.
Эта служба предоставляет методы для получения информации об участии продавца во всех доступных программах, а также методы явного включения или отключения участия в каждой программе.
Отключить программу |
---|
Отключить участие в указанной программе для аккаунта. Для выполнения этого метода требуется доступ администратора.
|
Включить программу |
---|
Разрешить участие в указанной программе для аккаунта. Для выполнения этого метода требуется доступ администратора.
|
Получить программу |
---|
Извлекает указанную программу для учетной записи.
|
Список программ |
---|
Получает все программы для учетной записи.
|
РегионыСервис
Управляет конфигурацией регионов.
Этот API определяет следующую модель ресурсов:
-
Region
СоздатьРегион |
---|
Создает определение региона в вашей учетной записи Merchant Center. Для выполнения этого метода требуется доступ администратора.
|
Удалитьрегион |
---|
Удаляет определение региона из вашей учетной записи Merchant Center. Для выполнения этого метода требуется доступ администратора.
|
Получить регион |
---|
Получает регион, определенный в вашей учетной записи Merchant Center.
|
Список регионов |
---|
Перечисляет регионы в вашем аккаунте Merchant Center.
|
Обновитьрегион |
---|
Обновляет определение региона в вашей учетной записи Merchant Center. Для выполнения этого метода требуется доступ администратора.
|
ДоставкаНастройкиСервис
Служба для получения информации о настройках доставки вызова метода для каждого метода Merchant API.
Получить настройки доставки |
---|
Получить информацию о настройках доставки.
|
Вставить параметры доставки |
---|
Замените настройку доставки продавца на настройку доставки запроса. Для выполнения этого метода требуется доступ администратора.
|
Условия обслуживанияСоглашениеStateService
Сервис для поддержки API- TermsOfServiceAgreementState
.
GetTermsOfServiceAgreementState |
---|
Возвращает состояние соглашения об условиях обслуживания.
|
ПолучитьForApplicationTermsOfServiceAgreementState |
---|
Получает состояние соглашения для условий обслуживания приложения.
|
Условия обслуживанияСервис
Сервис для поддержки API TermsOfService
.
ПринятьУсловия обслуживания |
---|
Принимает
|
Получить условия обслуживания |
---|
Получает
|
Получить последние условия обслуживания |
---|
Получает последнюю
|
Пользовательская служба
Сервис для поддержки пользовательского API.
Создать пользователя |
---|
Создает пользователя учетной записи Merchant Center. Для выполнения этого метода требуется доступ администратора.
|
УдалитьПользователя |
---|
Удаляет пользователя аккаунта Merchant Center. Для выполнения этого метода требуется доступ администратора. Пользователь, которого нужно удалить, не может быть последним администратором этой учетной записи. Также пользователь защищен от удаления, если им управляет Бизнес-Менеджер"
|
GetUser |
---|
Получает пользователя учетной записи Merchant Center.
|
Список пользователей |
---|
Список всех пользователей аккаунта Merchant Center.
|
ОбновитьПользователя |
---|
Обновляет пользователя учетной записи Merchant Center. Для выполнения этого метода требуется доступ администратора.
|
ПринятьУсловияОбслуживанияЗапрос
Сообщение запроса для метода AcceptTermsOfService
.
Поля | |
---|---|
name | Необходимый. Имя ресурса версии условий обслуживания. Формат: |
account | Необходимый. Учетная запись, для которой необходимо принять Условия обслуживания. |
region_ code | Необходимый. Код региона, определенный CLDR . Это либо страна, если Условия обслуживания применяются конкретно к этой стране, либо 001, если они применяются во всем мире. |
Принял
Описывает принятые условия обслуживания.
Поля | |
---|---|
terms_ of_ service | Принятые условия обслуживания . |
accepted_ by | Счет, на котором был зафиксирован акцепт. Это может быть сама учетная запись или, в случае субсчетов, учетная запись MCA. |
valid_ until | Если он установлен, он указывает, что принятые Условия обслуживания действительны только до конца этой даты (в формате UTC). До этого момента необходимо принять новый. Информация о необходимых Условиях обслуживания находится в обязательном сообщении. |
Право доступа
Право доступа.
Перечисления | |
---|---|
ACCESS_RIGHT_UNSPECIFIED | Значение по умолчанию. Это значение не используется. |
STANDARD | Стандартные права доступа. |
ADMIN | Права доступа администратора. |
PERFORMANCE_REPORTING | Пользователи с этим правом имеют доступ к данным о производительности и аналитике. |
Счет
Сообщение Account
представляет учетную запись продавца в товарных объявлениях. Это основной объект для управления данными о продуктах, настройками и взаимодействием со службами Google и внешними поставщиками.
Учетные записи могут работать как отдельные объекты или быть частью структуры многоклиентской учетной записи (MCA). При настройке MCA родительская учетная запись управляет несколькими дополнительными учетными записями.
Создание учетной записи включает настройку таких атрибутов, как имя учетной записи, часовой пояс и языковые предпочтения.
Сообщение Account
является родительской сущностью для многих других ресурсов, например AccountRelationship
, Homepage
, BusinessInfo
и т. д.
Поля | |
---|---|
name | Идентификатор. Имя ресурса учетной записи. Формат: |
account_ id | Только вывод. Идентификатор учетной записи. |
account_ name | Необходимый. Понятное имя учетной записи. Для получения дополнительной информации см. название магазина и название компании . |
adult_ content | Содержит ли этот аккаунт контент для взрослых. |
test_ account | Только вывод. Является ли это тестовым аккаунтом. |
time_ zone | Необходимый. Часовой пояс аккаунта. При записи При чтении |
language_ code | Необходимый. Языковой код учетной записи BCP-47 , например |
Агрегация счетов
Этот тип не имеет полей.
Полезная нагрузка AccountAggregation
.
Проблема с аккаунтом
Поля | |
---|---|
name | Идентификатор. Имя ресурса проблемы с учетной записью. Формат: |
title | Локализованное название выпуска. |
severity | Общая серьезность проблемы. |
impacted_ destinations[] | Влияние этой проблемы на различные направления. |
detail | Дополнительная локализованная информация о проблеме. |
documentation_ uri | Ссылка на Справочный центр Merchant Center, где можно получить дополнительную информацию о проблеме и способах ее устранения. |
Затронутое место назначения
Влияние проблемы на пункт назначения.
Поля | |
---|---|
impacts[] | (Негативное) влияние различных регионов на данный пункт назначения. |
reporting_ context | Затронутый контекст отчетности. |
Влияние
Влияние проблемы на регион.
Поля | |
---|---|
region_ code | Код региона CLDR , к которому относится эта проблема. |
severity | Серьезность вопроса по пункту назначения и региону. |
Серьезность
Все возможные степени серьезности проблемы.
Перечисления | |
---|---|
SEVERITY_UNSPECIFIED | Тяжесть неизвестна. |
CRITICAL | Из-за этой проблемы предложения не обслуживаются. |
ERROR | Эта проблема может повлиять на предложения (в будущем) или может быть индикатором проблем с предложениями. |
SUGGESTION | Проблема заключается в предложении по улучшению. |
Адрес
Адрес доставки склада.
Поля | |
---|---|
street_ address | Часть адреса на уровне улицы. Например: |
city | Необходимый. Город, поселок или коммуна. Может также включать зависимые населенные пункты или микрорайоны (например, районы или пригороды). |
administrative_ area | Необходимый. Высшее административное подразделение страны. Например, такой штат, как Калифорния («Калифорния»), или такая провинция, как Квебек («Квебек»). |
postal_ code | Необходимый. Почтовый индекс или почтовый индекс (например, «94043»). |
region_ code | Необходимый. Код страны CLDR (например, «США»). |
Настройки автоподачи
Сбор информации, связанной с настройками автоподачи .
Поля | |
---|---|
name | Идентификатор. Имя ресурса настроек автоподачи. Формат: |
enable_ products | Необходимый. Включает или отключает сканирование продуктов через автоподачу для данной учетной записи. Аккаунты с автоподачей должны соответствовать определенным условиям , которые можно проверить в |
eligible | Только вывод. Определяет, имеет ли продавец право на регистрацию в автофиде. |
БизнесДеньКонфигурация
Рабочие дни склада.
Поля | |
---|---|
business_ days[] | Необходимый. Обычные рабочие дни. Не может быть пустым. |
Будний день
Перечисления | |
---|---|
WEEKDAY_UNSPECIFIED | |
MONDAY | |
TUESDAY | |
WEDNESDAY | |
THURSDAY | |
FRIDAY | |
SATURDAY | |
SUNDAY |
БизнесИдентификация
Сбор информации, связанной с идентификацией бизнеса .
Поля | |
---|---|
name | Идентификатор. Имя ресурса бизнес-идентичности. Формат: |
promotions_ consent | Необходимый. Могут ли атрибуты идентичности использоваться для рекламных акций. |
black_ owned | Необязательный. Указывает, идентифицирует ли компания себя как принадлежащую чернокожим. Это необязательное поле будет доступно только для продавцов, для которых в качестве страны деятельности выбрана |
women_ owned | Необязательный. Указывает, идентифицирует ли компания себя как принадлежащую женщинам. Это необязательное поле будет доступно только для продавцов, для которых в качестве страны деятельности выбрана |
veteran_ owned | Необязательный. Указывает, идентифицирует ли компания себя как принадлежащую ветеранам. Это необязательное поле будет доступно только для продавцов, для которых в качестве страны деятельности выбрана |
latino_ owned | Необязательный. Указывает, идентифицирует ли компания себя как принадлежащую латиноамериканцам. Это необязательное поле будет доступно только для продавцов, для которых в качестве страны деятельности выбрана |
small_ business | Необязательный. Указывает, идентифицирует ли компания себя как малый бизнес. Это необязательное поле будет доступно только для продавцов, для которых в качестве страны деятельности выбрана |
ИдентитиАтрибут
Вся информация, относящаяся к атрибуту идентификации.
Поля | |
---|---|
identity_ declaration | Необходимый. Объявление идентичности для этого атрибута. |
Декларация удостоверения
Все возможные настройки касательно декларации личности.
Перечисления | |
---|---|
IDENTITY_DECLARATION_UNSPECIFIED | Значение по умолчанию, указывающее, что выбор не был сделан. |
SELF_IDENTIFIES_AS | Указывает, что учетная запись идентифицируется с помощью атрибута. |
DOES_NOT_SELF_IDENTIFY_AS | Указывает, что учетная запись не идентифицируется с помощью атрибута. |
АкцииСогласие
Все возможные настройки по акциям, связанным с фирменным стилем.
Перечисления | |
---|---|
PROMOTIONS_CONSENT_UNSPECIFIED | Значение по умолчанию, указывающее, что выбор не был сделан. |
PROMOTIONS_CONSENT_GIVEN | Указывает, что аккаунт дал согласие на использование его бизнес-идентичности для рекламных акций. |
PROMOTIONS_CONSENT_DENIED | Указывает, что учетная запись не давала согласия на использование своей деловой информации для рекламных акций. |
БизнесИнформация
Сообщение BusinessInfo
содержит важную информацию о бизнесе продавца.
В этом сообщении содержатся ключевые сведения о бизнесе, такие как физический адрес, контакты службы поддержки клиентов и идентификаторы для конкретного региона.
Поля | |
---|---|
name | Идентификатор. Имя ресурса с информацией о компании. Формат: |
address | Необязательный. Адрес предприятия. Поддерживаются только поля |
phone | Только вывод. Телефон предприятия. |
phone_ verification_ state | Только вывод. Состояние проверки телефона. |
customer_ service | Необязательный. Обслуживание клиентов бизнеса. |
korean_ business_ registration_ number | Необязательный. 10-значный регистрационный номер корейской компании, разделенный дефисами, в формате: XXX-XX-XXXXX. |
Стоимость доставки
Список тарифов операторов связи, на которые можно ссылаться с помощью 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 . - и только для нас .
Поля | |
---|---|
name | Необходимый. Название тарифа перевозчика. Должно быть уникальным для каждой группы тарифов. |
carrier | Необходимый. Служба доставки, например |
carrier_ service | Необходимый. Транспортная услуга, например |
origin_ postal_ code | Необходимый. Место доставки по этому тарифу перевозчика. |
percentage_ adjustment | Необязательный. Мультипликативный модификатор стоимости доставки в виде числа в десятичной записи. Может быть отрицательным. Например, |
flat_ adjustment | Необязательный. Дополнительный модификатор стоимости доставки. Может быть отрицательным. Например, |
ПретензияГлавная страницаЗапрос
Сообщение запроса для метода ClaimHomepage
.
Поля | |
---|---|
name | Необходимый. Название главной страницы, на которую нужно заявить права. Формат: |
overwrite | Необязательный. Если установлено значение |
CreateAndConfigureAccountRequest
Сообщение запроса для метода CreateAndConfigureAccount
.
Поля | |
---|---|
account | Необходимый. Учетная запись, которую необходимо создать. |
users[] | Необязательный. Пользователи, которые будут добавлены в учетную запись. Это поле устарело и не будет существовать после выхода API из бета-версии. Вместо этого используйте поле |
user[] | Необязательный. Пользователи, которые будут добавлены в учетную запись. |
service[] | Необходимый. Служба учетных записей между создаваемой учетной записью и учетной записью поставщика инициализируется как часть создания. Необходимо предоставить хотя бы одну такую услугу. В настоящее время одним из них должен быть |
Аддаккаунтсервице
Дополнительные инструкции по добавлению услуг учетной записи во время создания учетной записи.
Поля | |
---|---|
Поле объединения service_type . Тип добавляемой услуги. service_type может быть только одним из следующих: | |
account_ aggregation | Провайдер является агрегатором аккаунта. Полезная нагрузка для типа услуги «Агрегация учетных записей». |
provider | Необходимый. Поставщик услуги. Либо ссылка на учетную запись, например, |
ДобавитьПользователя
Инструкция по добавлению пользователя в аккаунт при создании.
Поля | |
---|---|
user_ id | Необходимый. Адрес электронной почты пользователя (например, |
user | Необязательный. Информация о пользователе, который будет добавлен. На данный момент можно указать только права доступа. |
CreateRegionRequest
Сообщение запроса для метода CreateRegion
.
Поля | |
---|---|
parent | Необходимый. Учетная запись, для которой необходимо создать регион. Формат: |
region_ id | Необходимый. Идентификатор региона, уникальный для всех регионов одной учетной записи. |
region | Необходимый. Регион для создания. |
Создать запрос пользователя
Сообщение запроса для метода CreateUser
.
Поля | |
---|---|
parent | Необходимый. Имя ресурса учетной записи, для которой будет создан пользователь. Формат: |
user_ id | Необходимый. Адрес электронной почты пользователя (например, |
user | Необязательный. Пользователь, которого необходимо создать. |
Обслуживание клиентов
Информация об обслуживании клиентов.
Поля | |
---|---|
uri | Необязательный. URI, по которому можно найти службу поддержки клиентов. |
email | Необязательный. Адрес электронной почты, по которому можно связаться со службой поддержки клиентов. |
phone | Необязательный. Номер телефона, по которому можно позвонить в службу поддержки клиентов. |
Время отсечки
Определение срока окончания рабочих дней.
Поля | |
---|---|
hour | Необходимый. Крайний час, до которого необходимо разместить заказ, чтобы он был обработан в тот же день. |
minute | Необходимый. Минута крайнего времени, до которой необходимо разместить заказ для обработки в тот же день. |
time_ zone | Необходимый. Идентификатор часового пояса . Например, «Европа/Цюрих». |
Удалениеаккаунтреквеста
Сообщение запроса для метода DeleteAccount
.
Поля | |
---|---|
name | Необходимый. Имя учетной записи, которую необходимо удалить. Формат: |
force | Необязательный. Если установлено значение |
Удалитьрегионзапрос
Сообщение запроса для метода DeleteRegion
.
Поля | |
---|---|
name | Необходимый. Название региона, который нужно удалить. Формат: |
Удалить пользовательский запрос
Сообщение запроса для метода DeleteUser
.
Поля | |
---|---|
name | Необходимый. Имя пользователя, которого требуется удалить. Формат: Также можно удалить пользователя, соответствующего вызывающему абоненту, используя |
Срок поставки
Время, потраченное на различные аспекты от заказа до доставки товара.
Поля | |
---|---|
warehouse_ based_ delivery_ times[] | Необязательный. Указывает, что время доставки должно рассчитываться для каждого склада (места отправления) на основе настроек выбранного перевозчика. Если этот параметр установлен, никакое другое поле, связанное со временем доставки, в [время доставки][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] не должно быть установлено. |
min_ transit_ days | Минимальное количество рабочих дней, потраченных в пути. 0 означает доставку в тот же день, 1 означает доставку на следующий день. Должны быть установлены либо |
max_ transit_ days | Максимальное количество рабочих дней, потраченных в пути. 0 означает доставку в тот же день, 1 означает доставку на следующий день. Должно быть больше или равно |
cutoff_ time | Определение срока окончания рабочих дней. Если это не настроено, время окончания будет установлено по умолчанию в 8 утра по тихоокеанскому стандартному времени. |
min_ handling_ days | Минимальное количество рабочих дней, потраченных до отправки заказа. 0 означает отправку в тот же день, 1 означает отправку на следующий день. «min_handling_days» и «max_handling_days» должны быть установлены или не установлены одновременно. |
max_ handling_ days | Максимальное количество рабочих дней, потраченных до отправки заказа. 0 означает отправку в тот же день, 1 означает отправку на следующий день. Должно быть больше или равно |
transit_ time_ table | Таблица времени доставки: количество рабочих дней, потраченных в пути, на основе измерений строк и столбцов. Можно установить либо |
handling_ business_ day_ config | Рабочие дни, в течение которых могут обрабатываться заказы. Если не указано иное, будут считаться рабочие дни с понедельника по пятницу. |
transit_ business_ day_ config | Рабочие дни, в течение которых заказы могут находиться в пути. Если не указано иное, будут считаться рабочие дни с понедельника по пятницу. |
Отключитьпрограммный запрос
Сообщение запроса для метода DisableProgram.
Поля | |
---|---|
name | Необходимый. Название программы, участие в которой можно отключить для данного аккаунта. Формат: |
Расстояние
Максимальный радиус доставки. Это требуется только для типа доставки «местная доставка».
Поля | |
---|---|
value | Целое значение расстояния. |
unit | Единицы могут различаться в зависимости от страны, они включают мили и километры. |
Единица
Единицы могут различаться в зависимости от страны, они включают мили и километры.
Перечисления | |
---|---|
UNIT_UNSPECIFIED | Единица измерения не указана |
MILES | Единица в милях |
KILOMETERS | Единица измерения в километрах |
Настройки электронной почты
Категории уведомлений, которые пользователь включил/от которых отказался. Настройки электронной почты не включают обязательные объявления, поскольку пользователи не могут отказаться от них.
Поля | |
---|---|
name | Идентификатор. Имя EmailPreferences. Конечная точка поддерживается только для аутентифицированного пользователя. |
news_ and_ tips | Необязательный. Обновления о новых функциях, советы и рекомендации. |
Оптинстате
Выбрать состояние предпочтений электронной почты.
Перечисления | |
---|---|
OPT_IN_STATE_UNSPECIFIED | Статус подписки не указан. |
OPTED_OUT | Пользователь отказался от получения писем этого типа. |
OPTED_IN | Пользователь дал согласие на получение этого типа электронного письма. |
UNCONFIRMED | Пользователь дал согласие на получение этого типа электронного письма, и письмо с подтверждением было отправлено, но пользователь еще не подтвердил свое согласие (применимо только к определенным странам). |
EnableProgramRequest
Сообщение запроса для метода EnableProgram.
Поля | |
---|---|
name | Необходимый. Название программы, в которой разрешено участие для данного аккаунта. Формат: |
GetAccountRequest
Сообщение запроса для метода GetAccount
.
Поля | |
---|---|
name | Необходимый. Имя учетной записи, которую необходимо получить. Формат: |
Запрос GetAutofeedSettings
Сообщение запроса для метода GetAutofeedSettings
.
Поля | |
---|---|
name | Необходимый. Имя ресурса настроек автоподачи. Формат: |
GetBusinessIdentityRequest
Сообщение запроса для метода GetBusinessIdentity
.
Поля | |
---|---|
name | Необходимый. Имя ресурса бизнес-идентичности. Формат: |
GetBusinessInfoRequest
Сообщение запроса для метода GetBusinessInfo
.
Поля | |
---|---|
name | Необходимый. Имя ресурса с информацией о компании. Формат: |
Получить адрес электронной почтыЗапрос настроек
Сообщение запроса для метода GetEmailPreferences.
Поля | |
---|---|
name | Необходимый. Имя ресурса |
Получить домашнюю страницуЗапрос
Сообщение запроса для метода GetHomepage
.
Поля | |
---|---|
name | Необходимый. Название домашней страницы для извлечения. Формат: |
GetonlinereturnpolicyRequest
Запросить сообщение для метода GetOnlineReturnPolicy
.
Поля | |
---|---|
name | Необходимый. Название политики возврата для извлечения. Формат: |
GetProgramRequest
Запросить сообщение для метода GetProgram.
Поля | |
---|---|
name | Необходимый. Название программы для извлечения. Формат: |
GetRegionRequest
Запросить сообщение о методе GetRegion
.
Поля | |
---|---|
name | Необходимый. Название региона для извлечения. Формат: |
GetShipSettingSrequest
Запросить сообщение о методе GetShippingSetting
.
Поля | |
---|---|
name | Необходимый. Название настройки доставки для извлечения. Формат: |
GettermsofserviceAgreementStateRequest
Запросить сообщение для метода GetTermsOfServiceAgreementState
.
Поля | |
---|---|
name | Необходимый. Название ресурса версии Условий службы. Формат: |
GettermsofserviceRequest
Запросить сообщение для метода GetTermsOfService
.
Поля | |
---|---|
name | Необходимый. Название ресурса версии Условий службы. Формат: |
GetuserRequest
Запросить сообщение для метода GetUser
.
Поля | |
---|---|
name | Необходимый. Имя пользователя для извлечения. Format: Также возможно получить пользователя, соответствующего вызывающему абоненту, используя |
Заголовки
Непустые списка заголовков строки или столбцов для таблицы. Один из prices
, weights
, num_items
, postal_code_group_names
или location
должно быть установлено.
Поля | |
---|---|
prices[] | Необходимый. Список инклюзивных цены заказа в верхних границах. Стоимость последней цены может быть бесконечной, установив сумму цены_micros = -1. Например |
weights[] | Необходимый. Список инклюзивного заказа веса верхних границ. Значением последнего веса может быть бесконечность, установив сумму цены_micros = -1. Например |
number_ of_ items[] | Необходимый. Список инклюзивного количества элементов верхних границ. Последнее значение может быть |
postal_ code_ group_ names[] | Необходимый. Список названий почтовых групп. Последнее значение может быть |
locations[] | Необходимый. Список наборов идентификаторов местоположения. Должен быть непустым. Может быть установлен только в том случае, если все другие поля не установлены. |
Домашняя страница
Сообщение Homepage
представляет домашнюю страницу магазина торговца в системе.
Домашняя страница продавца является основным доменом, где клиенты взаимодействуют со своим магазином.
Домашняя страница может быть претендована и проверена как доказательство владения и позволяет продавцу разблокировать функции, которые требуют проверенного веб -сайта. Для получения дополнительной информации см. Понимание проверки URL -интернет -магазина .
Поля | |
---|---|
name | Идентификатор. Название ресурса домашней страницы магазина. Формат: |
claimed | Только вывод. Заявлена ли домашняя страница. См. Https://support.google.com/merchants/answer/176793 . |
uri | Необходимый. URI (обычно URL) домашней страницы магазина. |
INSERTSHIPPINGSTTYTINGSREQUEST
Запросите сообщение о методе InsertShippingSetting
.
Поля | |
---|---|
parent | Необходимый. Учетная запись, в которую будет вставлен этот продукт. Формат: учетные записи/{учетная запись} |
shipping_ setting | Необходимый. Новая версия учетной записи. |
ListAccountissrequest
Запросить сообщение о методе ListAccountIssues
.
Поля | |
---|---|
parent | Необходимый. Родитель, которому принадлежит этот набор вопросов. Формат: |
page_ size | Необязательный. Максимальное количество проблем для возврата. Служба может вернуть меньше этого значения. В случае отсутствия указания, не более 50 пользователей будут возвращены. Максимальное значение составляет 100; Значения выше 100 будут принуждены к 100 |
page_ token | Необязательный. Токен страницы, полученный из предыдущего вызова При страничном языке все остальные параметры, предоставленные для |
language_ code | Необязательный. Проблемы в ответе будут иметь читаемые на человеке поля на данном языке. Формат- BCP-47 , такой как |
time_ zone | Необязательный. Временный пояс Ианы использовался для локализации времени в читаемых людях. Например, «Америка/Лос -Ангелес». Если не будет установлено, будет использоваться «Америка/Лос -Ангелес». |
ListAccountissEresponse
Ответ Сообщение для метода ListAccountIssues
.
Поля | |
---|---|
account_ issues[] | Проблемы с указанной учетной записи. |
next_ page_ token | Токен, который можно отправить в качестве |
ListAccountsRequest
Запросить сообщение для метода ListAccounts
.
Поля | |
---|---|
page_ size | Необязательный. Максимальное количество счетов для возврата. Служба может вернуть меньше этого значения. В случае неопределенности, не более 250 учетных записей возвращаются. Максимальное значение составляет 500; Значения выше 500 принуждаются до 500. |
page_ token | Необязательный. Токен страницы, полученный из предыдущего вызова При нанесении на страницу все остальные параметры, предоставленные для |
filter | Необязательный. Возврат только учетные записи, которые соответствуют фильтру . Для получения более подробной информации см. Справочник синтаксиса фильтра . |
ListAccountsResponse
Ответное сообщение для метода ListAccounts
.
Поля | |
---|---|
accounts[] | Счета, соответствующие |
next_ page_ token | Токен, который можно отправить в качестве |
ListOnlinerTurnpoliciesRequest
Запросить сообщение для метода ListOnlineReturnPolicies
.
Поля | |
---|---|
parent | Необходимый. Аккаунт продавца, для которого можно перечислить политики возврата. Формат: |
page_ size | Необязательный. Максимальное количество ресурсов |
page_ token | Необязательный. Токен страницы, полученный от предыдущего звонка При нанесении на страницу все остальные параметры, предоставленные для |
ListOnlineReturnPoliciesResponse
Ответное сообщение для метода ListOnlineReturnPolicies
.
Поля | |
---|---|
online_ return_ policies[] | Полученные политики возврата. |
next_ page_ token | Токен, который можно отправить в виде |
ListProgramSrequest
Запросить сообщение для метода списков.
Поля | |
---|---|
parent | Необходимый. Название учетной записи, для которой можно получить все программы. Формат: |
page_ size | Необязательный. Максимальное количество программ для возврата за один ответ. Если не указано (или 0), используется размер по умолчанию 1000. Максимальное значение составляет 1000; Значения выше 1000 будут принуждены к 1000. |
page_ token | Необязательный. Токен продолжения, полученный от предыдущего вызова |
ListProgramSresponse
Ответное сообщение для метода списков.
Поля | |
---|---|
programs[] | Программы для данной учетной записи. |
next_ page_ token | Токен, который можно отправить как |
Listregionsrequest
Запросить сообщение для метода ListRegions
.
Поля | |
---|---|
parent | Необходимый. Учетная запись для перечисления регионов для. Формат: |
page_ size | Необязательный. Максимальное количество регионов для возврата. Служба может вернуть меньше этого значения. В случае не указанного, не более 50 регионов будут возвращены. Максимальное значение составляет 1000; Значения выше 1000 будут принуждены к 1000. |
page_ token | Необязательный. Токен страницы, полученный от предыдущего звонка При нанесении на страницу все остальные параметры, предоставленные |
Listregionsresponse
Ответное сообщение для метода ListRegions
.
Поля | |
---|---|
regions[] | Регионы от указанного торговца. |
next_ page_ token | Токен, который можно отправить в качестве |
ListsubaccountsRequest
Запросить сообщение о методе ListSubAccounts
.
Поля | |
---|---|
provider | Необходимый. Поставщик услуг агрегации. Формат: |
page_ size | Необязательный. Максимальное количество счетов для возврата. Служба может вернуть меньше этого значения. В случае неопределенности, не более 250 учетных записей возвращаются. Максимальное значение составляет 500; Значения выше 500 принуждаются до 500. |
page_ token | Необязательный. Токен страницы, полученный из предыдущего вызова При нанесении на страницу все остальные параметры, предоставленные для |
ListSubacCountsResponse
Ответное сообщение для метода ListSubAccounts
.
Поля | |
---|---|
accounts[] | Учетные записи, для которых данная родительская учетная запись является агрегатором. |
next_ page_ token | Токен, который можно отправить в качестве |
ListUsersRequest
Запросить сообщение о методе ListUsers
.
Поля | |
---|---|
parent | Необходимый. Родитель, который владеет этой коллекцией пользователей. Формат: |
page_ size | Необязательный. Максимальное количество пользователей для возврата. Служба может вернуть меньше этого значения. В случае отсутствия указания, не более 50 пользователей будут возвращены. Максимальное значение составляет 100; Значения выше 100 будут принуждены к 100 |
page_ token | Необязательный. Токен страницы, полученный от предыдущего звонка При нанесении на страницу все остальные параметры, предоставленные для |
ListUsersResponse
Ответное сообщение для метода ListUsers
.
Поля | |
---|---|
users[] | Пользователи из указанной учетной записи. |
next_ page_ token | Токен, который можно отправить в качестве |
LocationIdset
Список наборов идентификаторов местоположения. Должен быть непустым. Может быть установлен только в том случае, если все другие поля не установлены.
Поля | |
---|---|
location_ ids[] | Необходимый. Непустые списка идентификаторов местоположения . Все они должны быть одного типа местоположения (например, состояние). |
Минимальный экземпляр
Таблица с минимальными значениями заказа в магазине для типа выполнения пикапа.
Поля | |
---|---|
store_ code_ set_ with_ movs[] | Необходимый. Список кодов хранилища наборов, совместимых с тем же минимальным значением заказа (MOV). По крайней мере два набора требуются, и последний должен быть пустым, что означает «MOV для всех других магазинов». Каждый код магазина может отображаться только один раз по всем наборам. Все цены в рамках услуги должны иметь одинаковую валюту. |
Storecodesetwithmov
Список кодов хранилища наборов, обмениваясь тем же минимальным значением заказа. По крайней мере два набора требуются, и последний должен быть пустым, что означает «MOV для всех других магазинов». Каждый код магазина может отображаться только один раз по всем наборам. Все цены в рамках услуги должны иметь одинаковую валюту.
Поля | |
---|---|
store_ codes[] | Необязательный. Список уникальных кодов магазинов или пустые для улова All. |
value | Минимальное значение заказа для данных магазинов. |
Onlinereturnpolicy
Объект политики онлайн -возврата . В настоящее время это используется для представления политик возврата для рекламы и бесплатных программ списков.
Поля | |
---|---|
name | Идентификатор. Название ресурса |
return_ policy_ id | Только вывод. Идентификатор политики возврата, сгенерированный Google. |
label | Необходимый. Неизменен. Это поле представляет уникальную пользовательскую метку политики возврата. Важно отметить, что один и тот же ярлык не может быть использован в различных политиках возврата для одной страны. Если продукт не указан конкретный атрибут метки, политики будут автоматически помечены как «по умолчанию». Чтобы назначить пользовательскую политику возврата определенным группам продуктов, следуйте инструкциям, представленным на метке политики возврата . Этикетка может содержать до 50 символов. |
countries[] | Необходимый. Неизменен. Страны продажи, где применяется политика возврата. Значения должны быть действительным 2 буквенным кодом ISO 3166. |
policy | Политика возврата. |
seasonal_ overrides[] | Необязательный. Переопределения в общую политику для заказов, размещенных в течение определенного набора интервалов времени. |
restocking_ fee | Плата за заполнение, которая применяется ко всем категориям возврата причин. Это будет рассматриваться как бесплатная плата за пополнение, если значение не установлено. |
return_ methods[] | Методы возврата того, как клиенты могут вернуть товар. Это значение требуется, чтобы не быть пустым, если тип политики возврата не является нортернсом. |
item_ conditions[] | Условия элемента, принятые для возврата, не должны быть пустыми, если не тип политики возврата «нортернс». |
return_ shipping_ fee | Плата за возврат доставки. Следует установить только тогда, когда клиент должен загрузить и распечатать этикетку return. |
return_ policy_ uri | Необходимый. Политика возврата URI. Это может использовать Google для проверки здравомыслия на политику. Это должен быть действительный URL. |
accept_ defective_ only | В этом поле указывается, принимает ли продавец только дефектные продукты для возврата, и это поле требуется. |
process_ refund_ days | В поле указывается количество дней, которые требуются торговцам для обработки возвратов, поле не является обязательным. |
accept_ exchange | В этом поле указывается, позволяет ли торговцу обменять продукты, это поле требуется. |
Itemcondition
Доступные условия.
Перечисления | |
---|---|
ITEM_CONDITION_UNSPECIFIED | Значение по умолчанию. Это значение не используется. |
NEW | Новый. |
USED | Использовал. |
Политика
Доступные политики.
Поля | |
---|---|
type | Тип политики. |
days | Количество дней предметов может быть возвращено после доставки, где один день определяется как 24 часа после метки времени доставки. Требуется для |
Тип
Возврат типы политики.
Перечисления | |
---|---|
TYPE_UNSPECIFIED | Значение по умолчанию. Это значение не используется. |
NUMBER_OF_DAYS_AFTER_DELIVERY | Количество дней, в течение которых возврат действителен после доставки. |
NO_RETURNS | Никаких возвратов. |
LIFETIME_RETURNS | Время жизни возвращается. |
Resprockfee
Плата за заполнение. Это может быть фиксированная плата или микро процента.
Поля | |
---|---|
| |
fixed_ fee | Исправленная плата за заполнение. |
micro_ percent | Процент общей цены в микрос. 15 000 000 означает 15% от общей цены будет взиматься. |
Returnmethod
Доступные методы возврата.
Перечисления | |
---|---|
RETURN_METHOD_UNSPECIFIED | Значение по умолчанию. Это значение не используется. |
BY_MAIL | Вернуться по почте. |
IN_STORE | Вернуться в магазин. |
AT_A_KIOSK | Вернуться в киоск. |
Returnshippingfee
Плата за возврат доставки. Это может быть либо фиксированная плата, либо логический, чтобы указать, что клиент оплачивает фактическую стоимость доставки.
Поля | |
---|---|
type | Необходимый. Тип возврата платы за доставку. |
fixed_ fee | Фиксированная сумма плата за доставку. Это значение применимо только тогда, когда тип |
Тип
Возврат типы платы за доставку.
Перечисления | |
---|---|
TYPE_UNSPECIFIED | Значение по умолчанию. Это значение не используется. |
FIXED | Плата за возврат доставки является фиксированной стоимостью. |
CUSTOMER_PAYING_ACTUAL_FEE | Клиенты заплатят фактическую плату за доставку. |
Seasonaloverride
Далее: 5
Поля | |
---|---|
label | Необходимый. Отображение названия этого сезонного переопределения в торговом центре. |
begin | Необходимый. Определяет диапазон дат, когда применяется этот сезонный переопределение. Оба начинаются и конец являются включительно и должны быть в десятичном формате даты, пример 20250115. Даты сезонных переопределения не должны перекрываться. |
end | Необходимый. Сезонная дата окончания переопределения (включительно). |
policy | Необходимый. Политика возврата для данного диапазона дат. |
PhoneVerificationState
Состояние проверки телефона.
Перечисления | |
---|---|
PHONE_VERIFICATION_STATE_UNSPECIFIED | Значение по умолчанию. Это значение не используется. |
PHONE_VERIFICATION_STATE_VERIFIED | Телефон проверен. |
PHONE_VERIFICATION_STATE_UNVERIFIED | Телефон не выверлен |
Программа
Определяет участие в данной программе для указанной учетной записи.
Программы предоставляют механизм для добавления функциональности к торговым учетным записям. Типичным примером этого является бесплатная программа списков продуктов , которая позволяет бесплатно показать продукты из магазина торговца.
Поля | |
---|---|
name | Идентификатор. Название ресурса программы. Формат: |
documentation_ uri | Только вывод. URL -адрес страницы справки центрального центра, описывающего программу. |
state | Только вывод. Состояние участия в программе. |
active_ region_ codes[] | Только вывод. Регионы, в которых учетная запись активно участвует в программе. Активные регионы определяются как те, где все требования к программе, влияющие на регионы, были выполнены. Региональные коды определены Cldr . Это либо страна, где программа применяется конкретно к этой стране, либо |
unmet_ requirements[] | Только вывод. Требования, которые учетная запись еще не удовлетворена, которые влияют на участие в программе. |
Требование
Определяет требование, указанное для участия в программе.
Поля | |
---|---|
title | Только вывод. Название требования. |
documentation_ uri | Только вывод. URL -адрес справки страницы, описывающей требование. |
affected_ region_ codes[] | Только вывод. Регионы, которые в настоящее время влияют на это требование, не выполняются. Региональные коды определены Cldr . Это либо страна, где программа применяется конкретно к этой стране, либо |
Состояние
Возможное участие в программе утверждает учетную запись.
Перечисления | |
---|---|
STATE_UNSPECIFIED | Значение по умолчанию. Это значение не используется. |
NOT_ELIGIBLE | Учетная запись не имеет права участвовать в программе. |
ELIGIBLE | Учетная запись имеет право участвовать в программе. |
ENABLED | Программа включена для учетной записи. |
Rapgroup
Определения группы погрузки. Только последнему разрешено иметь пустую applicable_shipping_labels
, что означает «все остальное». Другое applicable_shipping_labels
не должно перекрываться.
Поля | |
---|---|
applicable_ shipping_ labels[] | Необходимый. Список маркировки доставки , определяющие продукты, к которым применяется эта группа. Это дизъюнкция: только один из ярлыков должен соответствовать применению группы ставок. Может быть пустым только для последней ставки группы услуги. |
subtables[] | Необязательный. Список подтабильных аппаратов, упомянутых |
carrier_ rates[] | Необязательный. Список ставок перевозчиков, на которые можно упомянуть |
single_ value | Стоимость группы ставок (например, фиксированная ставка $ 10). Может быть установлен только в случае установки |
main_ table | Таблица, определяющая группу скоростей, когда |
name | Необязательный. Название группы ставок. Если набор должен быть уникальным в рамках службы доставки. |
Область
Представляет географическую область, которую вы можете использовать в качестве цели, как с RegionalInventory
услугами, так и ShippingSettings
. Вы можете определить регионы как коллекции либо почтовых кодов, либо, в некоторых странах, используя предопределенные геотаржеты. Для получения дополнительной информации см. Настройки регионов для получения дополнительной информации.
Поля | |
---|---|
name | Идентификатор. Название ресурса региона. Формат: |
postal_ code_ area | Необязательный. Список почтовых кодов, которые определяют область региона. |
geotarget_ area | Необязательный. Список геотаргетов, который определяет район. |
regional_ inventory_ eligible | Только вывод. Указывает, имеет ли область право на использование в региональной конфигурации инвентаризации. |
shipping_ eligible | Только вывод. Указывает, имеет ли право использовать для использования в конфигурации служб доставки. |
display_ name | Необязательный. Отображаемое название региона. |
Geotargetarea
Список геотаргетов, который определяет район.
Поля | |
---|---|
geotarget_ criteria_ ids[] | Необходимый. Непустые списка идентификаторов местоположения . Все они должны быть одного типа местоположения (например, состояние). |
Почталкодереа
Список почтовых кодов, которые определяют область региона. ПРИМЕЧАНИЕ. Все области, определенные с использованием почтовых кодов, доступны через ресурс ShippingSettings.postalCodeGroups
.
Поля | |
---|---|
region_ code | Необходимый. Код территории CLDR или страна, к которой применяется группа почтового кода. |
postal_ codes[] | Необходимый. Диапазон почтовых кодов. |
Почтовая кодераж
Диапазон почтовых кодов, которые определяют область региона.
Поля | |
---|---|
begin | Необходимый. Почтовый код или шаблон префикса формы*, обозначающий инклюзивную нижнюю границу диапазона, определяющую область. Примеры значения: |
end | Необязательный. Почтовый код или шаблон |
Необходимый
Описывает условия обслуживания, которые необходимо принять.
Поля | |
---|---|
terms_ of_ service | Условия , которые необходимо принять. |
tos_ file_ uri | Полный URL -адрес Условия службы. Это поле такое же, как и термины service.file_uri , он добавляется здесь только для удобства. |
RetiveForApplicationTersOfServiceAgreementStateRequest
Запросить сообщение для метода RetrieveForApplicationTermsOfServiceAgreementState
.
Поля | |
---|---|
parent | Необходимый. Аккаунт, для которой можно получить термины ForsegeagreementState Format: |
RetrievelatesttermsofserviceRequest
Запросить сообщение о методе RetrieveLatestTermsOfService
.
Поля | |
---|---|
region_ code | Необходимый. Код региона, как определено CLDR . Это либо страна, когда TOS применяется конкретно к этой стране, либо 001, когда она применяется во всем мире. |
kind | Необходимый. К настоящему Условию Сервисной версии применяются. |
Ряд
Включите список ячеек.
Поля | |
---|---|
cells[] | Необходимый. Список ячеек, которые составляют ряд. Должен иметь такую же длину, что и |
Услуга
Служба доставки.
Поля | |
---|---|
delivery_ countries[] | Необходимый. Кодекс территории CLDR стран, к которым применяется услуга. |
rate_ groups[] | Необязательный. Определения группы погрузки. Только последнему разрешено иметь пустую |
loyalty_ programs[] | Необязательный. Программы лояльности, на которые ограничена эта служба доставки. |
service_ name | Необходимый. Свободная форма название сервиса. Должен быть уникальным в целевой учетной записи. |
active | Необходимый. Логический разоблачение активного статуса службы доставки. |
currency_ code | CLDR -код валюты, к которой применяется эта служба. Должен соответствовать ценам в группах тарифов. |
delivery_ time | Необходимый. Время, проведенное в различных аспектах, от заказа до доставки продукта. |
shipment_ type | Тип локаций. Этот сервис отправляет заказы. |
minimum_ order_ value | Минимальное значение заказа для этой услуги. Если установлено, указывает, что клиенты должны будут потратить как минимум эту сумму. Все цены в рамках услуги должны иметь одинаковую валюту. Не может быть установлен вместе с minimum_order_value_table. |
minimum_ order_ value_ table | Таблица с минимальными значениями заказа в магазине для типа выполнения пикапа. Не может быть установлен вместе с minimum_order_value. |
store_ config | Список магазинов, из которых доставляются ваши продукты. Это действительно только для местного типа доставки. |
Программа лояльности
Программа лояльности, предоставленная торговцем.
Поля | |
---|---|
loyalty_ program_ tiers[] | Необязательный. Уровень программы лояльности этой услуги доставки. |
program_ label | Это метка программы лояльности, установленного в настройках программы лояльности в торговом центре. Этот суб-атрибут позволяет Google отображать вашу программу лояльности с подходящими предложениями. |
Лояльность -программы
Подмножество программы лояльности продавцов.
Поля | |
---|---|
tier_ label | Суб-атрибут Tier Label [tier_label] различает преимущества уровня между каждым уровнем. Это значение также установлено в настройках вашей программы в торговом центре и требуется для изменений источника данных, даже если ваша программа лояльности имеет только 1 уровень. |
ShipmentType
Тип отгрузки услуги доставки.
Перечисления | |
---|---|
SHIPMENT_TYPE_UNSPECIFIED | Эта услуга не указала тип отгрузки. |
DELIVERY | Этот сервис отправляет заказы по адресу, выбранному клиентом. |
LOCAL_DELIVERY | Этот сервис отправляет заказы по адресу, выбранному клиентом. Заказ поставляется из местного магазина рядом. |
COLLECTION_POINT | Этот сервис отправляет заказы по адресу, выбранному клиентом. Заказ поставляется из точки сбора. |
StoreConfig
Список магазинов, из которых доставляются ваши продукты. Это действительно только для местного типа доставки.
Поля | |
---|---|
store_ codes[] | Необязательный. Список кодов магазинов, которые обеспечивают локальную доставку. Если пустые, то |
store_ service_ type | Указывает, предоставляют ли все магазины или выбранные магазины, перечисленные этим продавцом. |
cutoff_ config | Конфигурации, связанные с локальной доставкой заканчиваются за день. |
service_ radius | Максимальный радиус доставки. Это требуется только для местного типа доставки. |
Cutoffconfig
Конфигурации, связанные с локальной доставкой заканчиваются за день.
Поля | |
---|---|
local_ cutoff_ time | Время, когда местная доставка заканчивается на день. |
store_ close_ offset_ hours | Действительно только с местным исполнением доставки. Представляет время отсечения как количество часов до закрытия магазина. Взаимно эксклюзив с |
no_ delivery_ post_ cutoff | Торговцы могут отказаться от того, чтобы показать локальную доставку n+1 день, когда у них есть служба доставки, настроенная на локальную доставку N Day. Например, если служба доставки определяет доставку в тот же день, и она пройдет после отсечения, установив это поле для |
Localcutofftime
Время, когда местная доставка заканчивается на день.
Поля | |
---|---|
hour | Часы местные заказы на доставку должны быть размещены для обработки в тот же день. |
minute | Минутные местные заказы на доставку должны быть размещены для обработки в тот же день. |
StoreserviceType
Указывает, предоставляют ли все магазины или выбранные магазины, перечисленные торговцем, предоставляют локальную доставку.
Перечисления | |
---|---|
STORE_SERVICE_TYPE_UNSPECIFIED | Не указал тип обслуживания магазина. |
ALL_STORES | Указывает, обеспечивают ли все магазины, текущие и будущие, перечисленные этим продавцом, предоставляют локальную доставку. |
SELECTED_STORES | Указывает, что только магазины, перечисленные в store_codes имеют право на местную доставку. |
Переключатели
Настройка доставки торговой учетной записи.
Поля | |
---|---|
name | Идентификатор. Имя ресурса настройки доставки. Формат: |
services[] | Необязательный. Список услуг целевой учетной записи. |
warehouses[] | Необязательный. Список складов, которые можно упомянуть в |
etag | Необходимый. Это поле используется для избегания асинхронной проблемы. Убедитесь, что настройки доставки не изменились между вызовом и вставкой. Пользователь должен сделать следующие шаги:
|
Стол
Таблица, определяющая группу скоростей, когда single_value
недостаточно выразительна.
Поля | |
---|---|
rows[] | Необходимый. Список рядов, которые составляют таблицу. Должен иметь ту же длину, что и |
name | Название таблицы. Требуется для подтабов, игнорируется для основной таблицы. |
row_ headers | Необходимый. Заголовки рядов. |
column_ headers | Заголовки столбцов таблицы. Необязательно: если не установлено, то таблица имеет только одно измерение. |
Термины
TermsOfService
сообщения представляют собой конкретную версию Условий службы, которые продавцы должны принять для доступа к определенным функциям или услугам (см. Https://support.google.com/merchants/answer/160173) .
Это сообщение важно для процесса адаптации, гарантируя, что торговцы соглашаются с необходимыми юридическими соглашениями для использования услуги. Торговцы могут извлечь последние условия обслуживания для данного kind
и region
через RetrieveLatestTermsOfService
и принять их по мере необходимости через AcceptTermsOfService
.
Поля | |
---|---|
name | Идентификатор. Название ресурса версии Условий службы. Формат: |
region_ code | Код региона, как определено CLDR . Это либо страна, где TOS применяется конкретно к этой стране, либо |
kind | К настоящему Условию Сервисной версии применяются. |
external | Являются ли эти условия версии сервиса внешней. Внешние условия версий обслуживания могут быть согласованы только через внешние процессы, а не непосредственно торговцем через пользовательский интерфейс или API. |
file_ uri | URI для условий обслуживания файла, которые необходимо отобразить для подписания пользователей. |
Термины ServiceAgreementState
Этот ресурс представляет состояние соглашения для данной учетной записи и условия обслуживания. Государство выглядит следующим образом:
- Если продавец принял условия обслуживания: принято будет заполнено, в противном случае он будет пустым
- Если продавец должен подписать условия обслуживания: требуется заполнен, в противном случае он будет пустым.
Обратите внимание, что как требуемые , так и принятые могут присутствовать. В этом случае accepted
Условия Услуг будут иметь дату истечения срока действия, установленную в поле valive_until . required
Условия Услуг должны быть приняты перед valid_until
, чтобы учетная запись продолжала иметь действительное соглашение. При принятии новых условий служб мы ожидаем, что 3PS отобразит текст, связанный с данными Условиями Соглашения об обслуживании (URL -адрес для файла, содержащего текст, добавляется в требуемом сообщении ниже как TOS_FILE_URI . Фактическое принятие Условий обслуживания выполнено Позвонив принять на термины ресурса.
Поля | |
---|---|
name | Идентификатор. Название ресурса версии Условий службы. FORMAT: |
region_ code | Код региона, как определено https://cldr.unicode.org/ . Это страна, к которой применяется нынешнее состояние. |
terms_ of_ service_ kind | Условия обслуживания, связанные с конкретной версией. |
accepted | Принятые условия обслуживания такого рода и для связанного региона_кода |
required | Требуемые условия обслуживания |
Термины ServiceKind
Термины вида.
Перечисления | |
---|---|
TERMS_OF_SERVICE_KIND_UNSPECIFIED | Значение по умолчанию. Это значение не используется. |
MERCHANT_CENTER | Торговый центр применение. |
Презирается
Таблица транзита, количество рабочих дней, проведенных в пути, на основе размеров строк и столбцов. Либо min_transit_days
, max_transit_days
или transit_time_table
может быть установлен, но не оба.
Поля | |
---|---|
postal_ code_ group_ names[] | Необходимый. Список зон региона |
transit_ time_ labels[] | Необходимый. Список меток транзита. Последним значением может быть |
rows[] | Необходимый. Если есть только один набор измерений |
Транзитмер
Если есть только один набор измерений postal_code_group_names
или transit_time_labels
, есть несколько строк с одним значением для этого измерения. Если есть два измерения, каждая строка соответствует postal_code_group_names
и столбцам (значения) с transit_time_labels
.
Поля | |
---|---|
values[] | Необходимый. Время транзита (MIN-MAX) в рабочие дни. |
TransittimeValue
Время транзита (MIN-MAX) в рабочие дни.
Поля | |
---|---|
min_ transit_ days | Минимальный транзитный диапазон в рабочие дни. 0 означает доставку в тот же день, 1 означает доставку на следующий день. |
max_ transit_ days | Должен быть больше или равен |
UnclehomepageRequest
Запросить сообщение о методе UnclaimHomepage
.
Поля | |
---|---|
name | Необходимый. Название домашней страницы невостребовано. Формат: |
UpdateAccountRequest
Запросить сообщение для метода UpdateAccount
.
Поля | |
---|---|
account | Необходимый. Новая версия учетной записи. |
update_ mask | Необязательный. Список областей обновляется. Поддерживаются следующие поля (как в
|
UpdateautofeedSettingSrequest
Запросить сообщение для метода UpdateAutofeedSettings
.
Поля | |
---|---|
autofeed_ settings | Необходимый. Новая версия настройки AutoFeed. |
update_ mask | Необходимый. Список областей обновляется. |
UpdateBusinessIdentityRequest
Запросить сообщение для метода UpdateBusinessIdentity
.
Поля | |
---|---|
business_ identity | Необходимый. Новая версия бизнес -личности. |
update_ mask | Необязательный. Список областей обновляется. Поддерживаются следующие поля (как в
|
UpdateBusinessInforeQuest
Запросить сообщение для метода UpdateBusinessInfo
.
Поля | |
---|---|
business_ info | Необходимый. Новая версия информации о бизнесе. |
update_ mask | Необязательный. Список областей обновляется. Поддерживаются следующие поля (как в
|
UpdateMailPreferencesRequest
Запросить сообщение для метода UpdateMailPreferences.
Поля | |
---|---|
email_ preferences | Необходимый. Настройки электронной почты должны быть обновлены. |
update_ mask | Необходимый. Список областей обновляется. Поддерживаются следующие поля (как в
|
UpdateHomePageRequest
Запросить сообщение о методе UpdateHomepage
.
Поля | |
---|---|
homepage | Необходимый. Новая версия домашней страницы. |
update_ mask | Необязательный. Список областей обновляется. Поддерживаются следующие поля (как в
|
UpdateRegionRequest
Запросить сообщение для метода UpdateRegion
.
Поля | |
---|---|
region | Необходимый. Обновленный регион. |
update_ mask | Необязательный. Полевая маска, разделенная запятыми, указывающая на обновление поля. Пример: |
UpdateUserRequest
Запросить сообщение для метода UpdateUser
.
Поля | |
---|---|
user | Необходимый. Новая версия пользователя. Use |
update_ mask | Необязательный. List of fields being updated. The following fields are supported (in both
|
Пользователь
The User
message represents a user associated with a Merchant Center account. It is used to manage user permissions and access rights within the account. For more information, see Frequently asked questions about people and access levels .
Поля | |
---|---|
name | Идентификатор. The resource name of the user. Format: Use |
state | Output only. The state of the user. |
access_ rights[] | Необязательный. The access rights the user has. |
Состояние
The possible states of a user.
Перечисления | |
---|---|
STATE_UNSPECIFIED | Default value. This value is unused. |
PENDING | The user is pending confirmation. In this state, the user first needs to accept the invitation before performing other actions. |
VERIFIED | The user is verified. |
Ценить
The single value of a rate group or the value of a rate group table's cell. Exactly one of no_shipping
, flat_rate
, price_percentage
, carrier_rateName
, subtable_name
must be set.
Поля | |
---|---|
no_ shipping | If true, then the product can't be shipped. Must be true when set, can only be set if all other fields are not set. |
flat_ rate | A flat rate. Can only be set if all other fields are not set. |
price_ percentage | A percentage of the price represented as a number in decimal notation (For example, |
carrier_ rate | The name of a carrier rate referring to a carrier rate defined in the same rate group. Can only be set if all other fields are not set. |
subtable | The name of a subtable. Can only be set in table cells (For example, not for single values), and only if all other fields are not set. |
Склад
A fulfillment warehouse, which stores and handles inventory.
Поля | |
---|---|
name | Необходимый. The name of the warehouse. Must be unique within account. |
shipping_ address | Необходимый. Shipping address of the warehouse. |
cutoff_ time | Необходимый. The latest time of day that an order can be accepted and begin processing. Later orders will be processed in the next day. The time is based on the warehouse postal code. |
handling_ days | Необходимый. The number of days it takes for this warehouse to pack up and ship an item. This is on the warehouse level, but can be overridden on the offer level based on the attributes of an item. |
business_ day_ config | Business days of the warehouse. If not set, will be Monday to Friday by default. |
WarehouseBasedDeliveryTime
Indicates that the delivery time should be calculated per warehouse (shipping origin location) based on the settings of the selected carrier. When set, no other transit time related field in delivery_time
should be set.
Поля | |
---|---|
carrier | Необходимый. Carrier, such as |
carrier_ service | Необходимый. Carrier service, such as |
warehouse | Необходимый. Warehouse name. This should match [warehouse][ShippingSetting.warehouses.name] |
WarehouseCutoffTime
The latest time of day that an order can be accepted and begin processing. Later orders will be processed in the next day. The time is based on the warehouse postal code.
Поля | |
---|---|
hour | Необходимый. Hour of the cutoff time until which an order has to be placed to be processed in the same day by the warehouse. Hour is based on the timezone of warehouse. |
minute | Необходимый. Minute of the cutoff time until which an order has to be placed to be processed in the same day by the warehouse. Minute is based on the timezone of warehouse. |