Package google.shopping.css.v1

Индекс

AccountLabelsService

Управляет метками учетных записей Merchant Center и CSS.

CreateAccountLabel

rpc CreateAccountLabel( CreateAccountLabelRequest ) returns ( AccountLabel )

Создает новую метку, не привязанную ни к одной учетной записи.

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Для получения более подробной информации см.OAuth 2.0 Overview .

DeleteAccountLabel

rpc DeleteAccountLabel( DeleteAccountLabelRequest ) returns ( Empty )

Удаляет метку и удаляет её из всех учетных записей, к которым она была привязана.

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Для получения более подробной информации см.OAuth 2.0 Overview .

ListAccountLabels

rpc ListAccountLabels( ListAccountLabelsRequest ) returns ( ListAccountLabelsResponse )

Отображает список меток, принадлежащих учетной записи.

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Для получения более подробной информации см.OAuth 2.0 Overview .

UpdateAccountLabel

rpc UpdateAccountLabel( UpdateAccountLabelRequest ) returns ( AccountLabel )

Обновляет метку.

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Для получения более подробной информации см.OAuth 2.0 Overview .

Служба учета

Сервис для управления информацией об учетных записях CSS/MC.

Получить аккаунт

rpc GetAccount( GetAccountRequest ) returns ( Account )

Получает доступ к одной учетной записи CSS/MC по идентификатору.

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Для получения более подробной информации см.OAuth 2.0 Overview .

ListChildAccounts

rpc ListChildAccounts( ListChildAccountsRequest ) returns ( ListChildAccountsResponse )

Выводит список всех учетных записей, объединенных указанным идентификатором учетной записи CSS, и при необходимости фильтрует по идентификатору метки и имени учетной записи.

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Для получения более подробной информации см.OAuth 2.0 Overview .

UpdateLabels

rpc UpdateLabels( UpdateAccountLabelsRequest ) returns ( Account )

Обновляет метки, присвоенные учетным записям CSS/MC доменом CSS.

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Для получения более подробной информации см.OAuth 2.0 Overview .

CssProductInputsService

Сервис для использования ресурса CssProductInput. Этот сервис помогает добавлять/обновлять/удалять товары, отображаемые в CSS.

DeleteCssProductInput

rpc DeleteCssProductInput( DeleteCssProductInputRequest ) returns ( Empty )

Удаляет поле ввода "Товар" из вашего аккаунта CSS Center.

После удаления может пройти несколько минут, прежде чем введенные данные станут недоступны.

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Для получения более подробной информации см.OAuth 2.0 Overview .

InsertCssProductInput

rpc InsertCssProductInput( InsertCssProductInputRequest ) returns ( CssProductInput )

Загружает объект CssProductInput в вашу учетную запись CSS Center. Если поле ввода с теми же параметрами contentLanguage, identity, feedLabel и feedId уже существует, этот метод заменяет существующую запись.

После добавления, обновления или удаления поля ввода CSS Product может потребоваться несколько минут, прежде чем обработанный CSS Product будет получен.

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Для получения более подробной информации см.OAuth 2.0 Overview .

UpdateCssProductInput

rpc UpdateCssProductInput( UpdateCssProductInputRequest ) returns ( CssProductInput )

Обновляет существующее поле ввода CSS Product в вашем аккаунте CSS Center.

После добавления, обновления или удаления CSS-элемента "Товар" может потребоваться несколько минут, прежде чем обработанный CSS-элемент "Товар" будет получен.

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Для получения более подробной информации см.OAuth 2.0 Overview .

CssProductsService

Сервис для получения и отображения CSS-продуктов (внутри системы это называется агрегированными предложениями).

GetCssProduct

rpc GetCssProduct( GetCssProductRequest ) returns ( CssProduct )

Получает обработанный CSS-продукт из вашей учетной записи CSS Center. После добавления, обновления или удаления данных о продукте может потребоваться несколько минут, прежде чем будет получен обновленный конечный продукт.

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Для получения более подробной информации см.OAuth 2.0 Overview .

ListCssProducts

rpc ListCssProducts( ListCssProductsRequest ) returns ( ListCssProductsResponse )

Отображает список обработанных CSS-продуктов в вашей учетной записи CSS Center. Ответ может содержать меньше элементов, чем указано в pageSize. Используйте pageToken для определения наличия дополнительных элементов для запроса.

После добавления, обновления или удаления поля ввода товара в формате CSS может потребоваться несколько минут, прежде чем будет получен обновленный и обработанный товар в формате CSS.

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Для получения более подробной информации см.OAuth 2.0 Overview .

QuotaService

Сервис для получения информации о квоте вызовов методов для каждого метода CSS API.

ListQuotaGroups

rpc ListQuotaGroups( ListQuotaGroupsRequest ) returns ( ListQuotaGroupsResponse )

Отображает суточную квоту звонков и объем использования по группам для вашей учетной записи CSS Center.

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Для получения более подробной информации см.OAuth 2.0 Overview .

Счет

Информация об учетной записи CSS/MC.

Поля
name

string

Название ресурса-метки. Формат: accounts/{account}

full_name

string

Только для вывода. Неизменяемый. Полное имя учетной записи CSS/MC.

label_ids[]

int64

Идентификаторы меток, созданные вручную и присвоенные учетной записи CSS/MC родительской учетной записью CSS.

automatic_label_ids[]

int64

Идентификаторы меток, автоматически создаваемые и присваиваемые учетной записи MC центром CSS.

account_type

AccountType

Только вывод. Тип этой учетной записи.

display_name

string

Краткое отображаемое имя учетной записи CSS/MC.

homepage_uri

string

Только для вывода. Неизменяемый. Домашняя страница учетной записи CSS/MC.

parent

string

Родительский ресурс учетной записи CSS/MC. Группа CSS для доменов CSS; домен CSS для учетных записей MC. Возвращается только в том случае, если у пользователя есть доступ к родительской учетной записи. Примечание: для суб-учетных записей MC это также домен CSS, являющийся родительским ресурсом учетной записи MCA, поскольку мы фактически сглаживаем иерархию.

Тип учетной записи

Тип учетной записи.

Перечисления
ACCOUNT_TYPE_UNSPECIFIED Тип учетной записи неизвестен.
CSS_GROUP Учетная запись группы CSS.
CSS_DOMAIN Учетная запись домена CSS.
MC_PRIMARY_CSS_MCA Основной аккаунт MC CSS MCA.
MC_CSS_MCA Аккаунт MC CSS MCA.
MC_MARKETPLACE_MCA Аккаунт MC Marketplace MCA.
MC_OTHER_MCA MC Другой счет MCA.
MC_STANDALONE Автономный аккаунт MC.
MC_MCA_SUBACCOUNT Субсчет MC MCA.

AccountLabel

Метка, присвоенная доменом CSS или группой CSS одному из своих дочерних аккаунтов.

Поля
name

string

Идентификатор. Имя ресурса метки. Формат: accounts/{account}/labels/{label}

label_id

int64

Только вывод. Идентификатор метки.

account_id

int64

Только для вывода. Идентификатор учетной записи, к которой относится эта метка.

label_type

LabelType

Только для вывода. Тип этой метки.

display_name

string

Отображаемое название этой метки.

description

string

Описание данной этикетки.

Тип метки

Тип метки.

Перечисления
LABEL_TYPE_UNSPECIFIED Тип метки неизвестен.
MANUAL Указывает на то, что метка была создана вручную.
AUTOMATIC Указывает на то, что метка была создана автоматически с помощью CSS Center.

Атрибуты

Атрибуты для CSS-кода товара.

Поля
low_price

Price

Низкая цена продукта CSS.

high_price

Price

Высокая цена продукта CSS.

headline_offer_price

Price

Цена продукта CSS, указанная в заголовке.

headline_offer_shipping_price

Price

Цена продукта CSS, указанная в заголовке.

product_types[]

string

Категории товара (отформатированы в соответствии со спецификацией данных о товарах ).

size_types[]

string

Крой изделия. Он может использоваться для обозначения комбинированных типов размеров для предметов одежды. Можно указать максимум два типа размеров (см. тип размера ).

product_details[]

ProductDetail

Технические характеристики или дополнительная информация о продукте.

product_weight

ProductWeight

Вес продукта в указанных единицах. Значение должно быть в диапазоне от 0 (без учета НДС) до 2000 (включительно).

product_length

ProductDimension

Длина изделия в указанных единицах. Значение должно быть в диапазоне от 0 (включительно) до 3000 (включительно).

product_width

ProductDimension

Ширина изделия в указанных единицах. Значение должно быть в диапазоне от 0 (включительно) до 3000 (включительно).

product_height

ProductDimension

Высота изделия в указанных единицах. Значение должно находиться в диапазоне от 0 (включительно) до 3000 (включительно).

product_highlights[]

string

Пункты списка, описывающие наиболее важные особенности продукта.

certifications[]

Certification

Список сертификатов, заявленных CSS для данного продукта.

expiration_date

Timestamp

Дата, до которой срок действия элемента должен истечь, указана при добавлении в формате ISO 8601. Фактическая дата истечения срока действия отображается в productstatuses как googleExpirationDate и может быть раньше, если expirationDate находится слишком далеко в будущем. Примечание: удаление элемента может занять более 2 дней с момента истечения срока действия.

included_destinations[]

string

Список направлений, которые следует включить для этой цели (соответствует отмеченным флажкам в Merchant Center). Направления по умолчанию всегда включаются, если иное не указано в excludedDestinations .

excluded_destinations[]

string

Список направлений, которые следует исключить для этой целевой аудитории (соответствует неотмеченным флажкам в Merchant Center).

headline_offer_installment

HeadlineOfferInstallment

Количество и сумма платежей по товару.

headline_offer_subscription_cost

HeadlineOfferSubscriptionCost

Количество периодов (месяцев или лет) и сумма оплаты за период за товар, имеющий соответствующий договор подписки.

cpp_ads_redirect

string

Позволяет рекламодателям переопределять URL-адрес товара при его показе в контексте товарной рекламы.

number_of_offers

int64

Количество товаров CSS.

headline_offer_condition

string

Условия основного предложения.

title

string

Название товара.

description

string

Описание товара.

brand

string

Характеристики, связанные с товаром.[14-36] Бренд товара.

mpn

string

Номер детали производителя ( MPN ) изделия.

gtin

string

Глобальный торговый идентификационный номер ( GTIN ) товара.

google_product_category

string

Категория товара, присвоенная Google (см. таксономию товаров Google ). При запросе товаров это поле будет содержать значение, предоставленное пользователем. В настоящее время нет возможности восстановить автоматически присвоенные категории товаров Google через API.

adult

bool

Установите значение true, если товар предназначен для взрослых.

multipack

int64

Количество одинаковых товаров в мультиупаковке, определенной продавцом.

is_bundle

bool

Является ли товар набором, определенным продавцом. Набор — это пользовательская группа различных товаров, продаваемых продавцом по единой цене.

age_group

string

Целевая возрастная группа товара.

color

string

Цвет изделия.

gender

string

Целевой пол для данного товара.

material

string

Материал, из которого изготовлено изделие.

pattern

string

Узор изделия (например, в горошек).

size

string

Размер товара. Допускается только одно значение. Для вариантов с разными размерами добавьте отдельный товар для каждого размера с одинаковым значением itemGroupId (см. [https://support.google.com/merchants/answer/6324492](определение размера)).

size_system

string

Система, в которой указывается размер. Рекомендуется для предметов одежды.

item_group_id

string

Общий идентификатор для всех вариантов одного и того же продукта.

pause

string

Публикация данной статьи временно приостановлена.

custom_label_0

string

Пользовательская метка 0 для пользовательской группировки товаров в торговой кампании.

custom_label_1

string

Пользовательская метка 1 для пользовательской группировки товаров в торговой кампании.

custom_label_2

string

Пользовательская метка 2 для пользовательской группировки товаров в торговой кампании.

custom_label_3

string

Пользовательская метка 3 для пользовательской группировки товаров в торговой кампании.

custom_label_4

string

Пользовательская метка 4 для пользовательской группировки товаров в торговой кампании.

review_count

int64

Количество отзывов о товаре. Обязательно для заполнения, если указана rating . Это поле предназначено для будущей функции и пока не используется.

min_rating

int64

Минимальный рейтинг продукта. Обязательно, если rating указан. Это поле предназначено для будущей функции и пока не используется.

max_rating

int64

Максимальный рейтинг продукта. Обязательно, если rating указан. Это поле предназначено для будущей функции и пока не используется.

rating

double

Средний рейтинг товара. Значение должно находиться в диапазоне [ min_rating , max_rating ] включительно. При отображении на странице товара этот рейтинг нормализуется по шкале [1, 5] с одним десятичным знаком. Если указаны, review_count , min_rating и max_rating также обязательны. Это поле предназначено для будущей функции и пока не используется.

Сертификация

Сертификация продукта. Используйте атрибут `this` для описания сертификатов, таких как рейтинги энергоэффективности, связанных с продуктом.

Поля
name

string

Название сертификата. В настоящее время наиболее распространенным является "EPREL", обозначающее сертификаты энергоэффективности в базе данных Европейского реестра энергетической маркировки ЕС (EPREL).

authority

string

Орган или сертификационный орган, ответственный за выдачу сертификата. В настоящее время наиболее распространенным значением для энергетических этикеток в ЕС является «EC» или «European_Commission».

code

string

Код сертификации. Например, для сертификата EPREL по ссылке https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456 код — 123456. Этот код необходим для получения европейской энергетической маркировки.

CreateAccountLabelRequest

Сообщение запроса для метода 'CreateAccountLanel'.

Поля
parent

string

Обязательно. Родительский аккаунт. Формат: accounts/{account}

account_label

AccountLabel

Обязательно. Метка для создания.

CssProduct

Обработанный CSS-продукт.

Поля
name

string

Название CSS-продукта. Формат: "accounts/{account}/cssProducts/{css_product}"

raw_provided_id

string

Только для вывода. Ваш уникальный исходный идентификатор продукта.

content_language

string

Только для вывода. Двухбуквенный код языка ISO 639-1 для данного продукта.

feed_label

string

Только вывод. Маркировка продукта в фиде.

attributes

Attributes

Только вывод. Список атрибутов продукта.

custom_attributes[]

CustomAttribute

Только вывод. Список пользовательских (предоставляемых CSS) атрибутов. Также может использоваться для отправки любого атрибута спецификации фида в его общем виде (например, { "name": "size type", "value": "regular" } ). Это полезно для отправки атрибутов, которые явно не отображаются в API, например, дополнительных атрибутов, используемых для функции «Купить в Google».

css_product_status

CssProductStatus

Только вывод. Статус продукта, проблемы проверки данных, то есть информация о продукте, вычисленная асинхронно.

CssProductInput

Этот ресурс представляет собой входные данные, которые вы отправляете для CSS-продукта, а не обработанный CSS-продукт, который вы видите в CSS Center, в товарных объявлениях или на других платформах Google.

Поля
name

string

Идентификатор. Название поля ввода CSS Product. Формат: accounts/{account}/cssProductInputs/{css_product_input} , где последний раздел css_product_input состоит из 3 частей: contentLanguage~feedLabel~offerId. Пример: accounts/123/cssProductInputs/de~DE~rawProvidedId123

final_name

string

Только вывод. Название обработанного CSS-продукта. Формат: accounts/{account}/cssProducts/{css_product}

raw_provided_id

string

Обязательно. Ваш уникальный идентификатор для CSS-продукта. Он одинаков как для входных данных CSS-продукта, так и для обработанного CSS-продукта. Мы допускаем только идентификаторы, содержащие буквы и цифры, подчеркивания и дефисы. Подробности см. в спецификации фида продуктов .

content_language

string

Обязательно. Двухбуквенный код языка ISO 639-1 для продукта CSS.

feed_label

string

Обязательно. Метка фида для товара CSS. Метка фида синонимична "целевой стране" и поэтому всегда должна быть допустимым кодом региона. Например: 'DE' для Германии, 'FR' для Франции.

freshness_time
(deprecated)

Timestamp

УСТАРЕВШЕЕ. Используйте expiration_date вместо него. Представляет собой существующую версию (актуальность) продукта CSS, что позволяет сохранить правильный порядок при одновременном внесении нескольких обновлений.

В этом поле нельзя указывать будущее время.

Если этот параметр задан, обновление предотвращается, если в нашей системе уже существует более новая версия элемента (то есть время последнего обновления существующих товаров CSS позже, чем время актуальности, установленное при обновлении). Если обновление всё же происходит, время последнего обновления устанавливается равным этому времени актуальности.

Если параметр не задан, обновление не будет предотвращено, и время последнего обновления по умолчанию будет соответствовать времени получения этого запроса API CSS.

Если выполнение операции будет предотвращено, будет выброшено исключение "прервано".

attributes

Attributes

Список атрибутов продукта в CSS.

custom_attributes[]

CustomAttribute

Список пользовательских (предоставляемых CSS) атрибутов. Его также можно использовать для отправки любого атрибута спецификации фида в его общем виде (например: { "name": "size type", "value": "regular" } ). Это полезно для отправки атрибутов, которые явно не отображаются в API, например, дополнительных атрибутов, используемых для функции «Купить в Google».

CssProductStatus

Статус CSS-продукта, проблемы проверки данных, то есть информация о CSS-продукте, вычисляемая асинхронно.

Поля
destination_statuses[]

DestinationStatus

Целевые пункты назначения продукта.

item_level_issues[]

ItemLevelIssue

Список всех проблем, связанных с продуктом.

creation_date

Timestamp

Дата создания изделия в формате ISO 8601 .

last_update_date

Timestamp

Дата последнего обновления данного элемента в формате ISO 8601 .

google_expiration_date

Timestamp

Дата истечения срока годности товара, в формате ISO 8601 .

Статус назначения

Статус назначения продукта.

Поля
destination

string

Название пункта назначения

approved_countries[]

string

Список кодов стран (ISO 3166-1 alpha-2), в которых одобрен продукт CSS.

pending_countries[]

string

Список кодов стран (ISO 3166-1 alpha-2), в которых продукт CSS ожидает утверждения.

disapproved_countries[]

string

Список кодов стран (ISO 3166-1 alpha-2), в которых продукт CSS не одобрен.

ItemLevelIssue

ItemLevelIssue — это статус товара.

Поля
code

string

Код ошибки, вызвавшей проблему.

servability

string

Как эта проблема влияет на отображение продукта CSS.

resolution

string

Может ли продавец решить эту проблему?

attribute

string

Название атрибута, если проблема вызвана одним атрибутом.

destination

string

Место назначения, к которому относится данный вопрос.

description

string

Краткое описание проблемы на английском языке.

detail

string

Подробное описание проблемы на английском языке.

documentation

string

URL веб-страницы, которая поможет решить эту проблему.

applicable_countries[]

string

Список кодов стран (ISO 3166-1 alpha-2), к которым относится данная проблема, связанная с продуктом CSS.

DeleteAccountLabelRequest

Сообщение запроса для метода 'DeleteAccountLabel'.

Поля
name

string

Обязательно. Название удаляемой метки. Формат: accounts/{account}/labels/{label}

DeleteCssProductInputRequest

Сообщение запроса для метода DeleteCssProductInput.

Поля
name

string

Обязательно. Имя ресурса ввода CSS-кода продукта для удаления. Формат: accounts/{account}/cssProductInputs/{css_product_input}, где последний раздел css_product_input состоит из 3 частей: contentLanguage~feedLabel~offerId. Пример: accounts/123/cssProductInputs/de~DE~rawProvidedId123

supplemental_feed_id

int64

Идентификатор дополнительного фида Content API. Это поле не должно быть задано, если действие применяется к основному фиду. Если поле задано, то действие с продуктом применяется к дополнительному фиду, а не к основному фиду Content API.

GetAccountRequest

Сообщение запроса для метода GetAccount .

Поля
name

string

Обязательно. Название управляемой учетной записи CSS/MC. Формат: accounts/{account}

parent

string

Необязательно. Требуется только при получении информации об учетной записи MC. CSS-домен, являющийся родительским ресурсом учетной записи MC. Формат: accounts/{account}

GetCssProductRequest

Сообщение запроса для метода GetCssProduct .

Поля
name

string

Обязательно. Название продукта CSS, который необходимо получить. Формат: accounts/{account}/cssProducts/{css_product}

ЗаголовокПредложениеРассрочка

Сообщение, обозначающее рассрочку.

Поля
months

int64

Количество платежей, которые должен внести покупатель.

amount

Price

Сумма, которую покупатель должен платить ежемесячно.

downpayment

Price

Сумма первоначального взноса, которую должен внести покупатель.

ЗаголовокПредложениеСтоимостьПодписки

Стоимость подписки на продукт.

Поля
period

SubscriptionPeriod

Тип периода подписки. Поддерживаемые значения: * " month " * " year "

period_length

int64

Количество периодов подписки, за которые покупатель должен заплатить.

amount

Price

Сумма, которую покупатель должен заплатить за каждый период подписки.

InsertCssProductInputRequest

Сообщение запроса для метода InsertCssProductInput.

Поля
parent

string

Обязательно. Укажите учетную запись, куда будет вставлен этот CSS-товар. Формат: accounts/{account}

css_product_input

CssProductInput

Обязательно. CSS-код поля "Продукт" для вставки.

feed_id
(deprecated)

int64

Необязательно. УСТАРЕВШЕЕ. Идентификатор фида не требуется для товаров CSS. Основной или дополнительный идентификатор фида. Если товар CSS уже существует и предоставленный идентификатор фида отличается, товар CSS будет перемещен в новый фид. Примечание: на данный момент для товаров CSS не требуется указывать идентификаторы фидов, поскольку мы создаем фиды на лету. Поддержка дополнительных фидов для товаров CSS пока отсутствует.

ListAccountLabelsRequest

Сообщение запроса для метода ListAccountLabels .

Поля
parent

string

Обязательно. Родительский аккаунт. Формат: accounts/{account}

page_size

int32

Максимальное количество возвращаемых меток. Сервис может вернуть меньше этого значения. Если значение не указано, будет возвращено не более 50 меток. Максимальное значение — 1000; значения выше 1000 будут преобразованы в 1000.

page_token

string

Токен страницы, полученный из предыдущего вызова ListAccountLabels . Укажите его, чтобы получить следующую страницу.

При постраничной навигации все остальные параметры, передаваемые в ListAccountLabels , должны соответствовать вызову, который предоставил токен страницы.

ListAccountLabelsResponse

Ответное сообщение для метода ListAccountLabels .

Поля
account_labels[]

AccountLabel

Метки из указанного аккаунта.

next_page_token

string

Токен, который можно отправить в качестве page_token для получения следующей страницы. Если это поле опущено, последующих страниц не будет.

ListChildAccountsRequest

Сообщение запроса для метода ListChildAccounts .

Поля
parent

string

Обязательно. Родительская учетная запись. Должна быть группой CSS или доменом. Формат: accounts/{account}

page_size

int32

Необязательно. Максимальное количество возвращаемых учетных записей. Сервис может вернуть меньше этого значения. Если не указано, будет возвращено не более 50 учетных записей. Максимальное значение — 100; значения выше 100 будут преобразованы в 100.

page_token

string

Необязательный параметр. Токен страницы, полученный из предыдущего вызова ListChildAccounts . Укажите его, чтобы получить следующую страницу.

При постраничной навигации все остальные параметры, передаваемые в ListChildAccounts , должны соответствовать вызову, который предоставил токен страницы.

label_id

int64

Если этот параметр задан, будут возвращены только учетные записи MC с указанным идентификатором метки.

full_name

string

Если этот параметр задан, будут возвращены только учетные записи MC с указанным именем (с учетом регистра).

ListChildAccountsResponse

Ответное сообщение для метода ListChildAccounts .

Поля
accounts[]

Account

Учетные записи CSS/MC, возвращенные для указанной родительской учетной записи CSS.

next_page_token

string

Токен, который можно отправить в качестве page_token для получения следующей страницы. Если это поле опущено, последующих страниц не будет.

ListCssProductsRequest

Сообщение запроса для метода ListCssProducts.

Поля
parent

string

Обязательно. Учетная запись/домен, для которого нужно вывести список обработанных CSS-продуктов. Формат: accounts/{account}

page_size

int32

Максимальное количество возвращаемых CSS-товаров. Сервис может вернуть меньшее значение. Максимальное значение — 1000; значения свыше 1000 будут преобразованы в 1000. Если значение не указано, будет возвращено максимальное количество CSS-товаров.

page_token

string

Токен страницы, полученный из предыдущего вызова ListCssProducts . Укажите его, чтобы получить следующую страницу.

При использовании постраничной навигации все остальные параметры, передаваемые функции ListCssProducts должны соответствовать вызову, который предоставил токен страницы.

ListCssProductsResponse

Ответное сообщение для метода ListCssProducts.

Поля
css_products[]

CssProduct

Обработанные CSS-продукты из указанного аккаунта. Это ваши обработанные CSS-продукты после применения правил и дополнительных фидов.

next_page_token

string

Токен, который можно отправить в качестве page_token для получения следующей страницы. Если это поле опущено, последующих страниц не будет.

ListQuotaGroupsRequest

Сообщение запроса для метода ListQuotaGroups.

Поля
parent

string

Обязательно. Учетная запись CSS, которой принадлежит коллекция квот на методы и ресурсы. В большинстве случаев это домен CSS. Формат: accounts/{account}

page_size

int32

Необязательный параметр. Максимальное количество квот, возвращаемых в ответе, используется для постраничной навигации. По умолчанию — 500; значения выше 1000 будут преобразованы в 1000.

page_token

string

Необязательный параметр. Токен (если предоставлен) для получения следующей страницы. Все остальные параметры должны соответствовать исходному вызову, предоставившему токен страницы.

ListQuotaGroupsResponse

Ответное сообщение для метода ListMethodGroups.

Поля
quota_groups[]

QuotaGroup

Методы, текущее использование квоты и лимиты для каждой группы. Квота распределяется между всеми методами в группе. Группы отсортированы в порядке убывания на основе quota_usage .

next_page_token

string

Токен, который можно отправить в качестве page_token для получения следующей страницы. Если это поле опущено, последующих страниц не будет.

Подробности метода

Подробное описание каждого метода приведено в CSS API.

Поля
method

string

Только вывод. Название метода, например cssproductsservice.listcssproducts .

version

string

Только вывод. Версия API, к которой относится метод.

subapi

string

Только вывод. Под-API, к которому относится метод. В CSS API это всегда css .

path

string

Только вывод. Путь к методу, например, v1/cssproductsservice.listcssproducts .

Информация о товаре

Подробная информация о товаре.

Поля
section_name

string

Заголовок раздела используется для группировки набора сведений о продукте.

attribute_name

string

Название товара и его характеристики.

attribute_value

string

Ценность деталей продукта.

Размер продукта

Габариты изделия.

Поля
value

double

Обязательно. Значение параметра представлено в виде числа. Максимальная точность значения — четыре знака после запятой.

unit

string

Обязательно. Единицы измерения. Допустимые значения: * in * cm

Вес продукта

Вес товара.

Поля
value

double

Обязательно. Вес должен быть представлен числом. Максимальная точность значения веса — четыре знака после запятой.

unit

string

Обязательно. Единица измерения веса. Допустимые значения: * g * kg * oz * lb

QuotaGroup

Информация о группе методов в CSS API. Квота распределяется между всеми методами в группе. Даже если ни один из методов в группе не используется, возвращается информация о группе.

Поля
name

string

Идентификатор. Имя ресурса группы квот. Формат: accounts/{account}/quotas/{group}. Пример: accounts/12345678/quotas/css-products-insert Примечание: Часть {group} не гарантирует следование определенному шаблону.

quota_usage

int64

Только вывод. Текущее использование квоты, то есть количество вызовов методов группы, уже совершенных за данный день. Ежедневные лимиты квоты сбрасываются в 12:00 по UTC.

quota_limit

int64

Только вывод. Максимально допустимое количество звонков в день для данной группы.

quota_minute_limit

int64

Только вывод. Максимальное количество звонков в минуту, разрешенное для группы.

method_details[]

MethodDetails

Только вывод. Список всех методов, к которым применяется групповая квота.

Период подписки

Срок действия подписки на продукт.

Перечисления
SUBSCRIPTION_PERIOD_UNSPECIFIED Указывает на то, что период подписки не указан.
MONTH Указывает, что период подписки составляет месяц.
YEAR Указывает, что период подписки составляет год.

UpdateAccountLabelRequest

Сообщение запроса для метода UpdateAccountLabel .

Поля
account_label

AccountLabel

Обязательно. Обновленная метка. Все поля должны быть заполнены.

UpdateAccountLabelsRequest

Сообщение запроса для метода UpdateLabels .

Поля
name

string

Обязательно. Название ресурса-метки. Формат: accounts/{account}

label_ids[]

int64

Список идентификаторов меток, которые будут перезаписаны вместо существующих идентификаторов меток учетной записи. Если список пуст, все назначенные в данный момент идентификаторы меток будут удалены.

parent

string

Необязательно. Требуется только при обновлении меток учетной записи MC. CSS-домен, являющийся родительским ресурсом учетной записи MC. Формат: accounts/{account}

UpdateCssProductInputRequest

Сообщение запроса для метода UpdateCssProductInput.

Поля
css_product_input

CssProductInput

Обязательно. Ресурс ввода CSS-продукта для обновления. Предоставленная вами информация также будет применена к обрабатываемому CSS-продукту.

update_mask

FieldMask

Список атрибутов CSS для товара, подлежащих обновлению.

Если маска обновления опущена, то она рассматривается как подразумеваемая маска поля, эквивалентная всем полям, которые заполнены (имеют непустое значение).

Атрибуты, указанные в маске обновления без значения, указанного в теле документа, будут удалены из CSS-продукта.

Маску обновления можно указать только для полей верхнего уровня в атрибутах и ​​пользовательских атрибутах.

Для указания маски обновления пользовательских атрибутов необходимо добавить префикс custom_attribute.

Указание специального значения "*" для полной замены товара в CSS не поддерживается.