# Получить результаты Google Shopping Product Info по id **API:** Data API **Endpoint:** `GET /v1/beta/dataforseo/merchant/google/product_info/task_get/advanced/{id}` **Tags:** DataForSEO Страница сведений об одном товаре Google Shopping из задачи, поставленной в очередь через `post_dataforseo_merchant_google_product_info_submit`: характеристики, описание, изображения и продавцы, предлагающие его. Ответ обёрнут в конверт DataForSEO: данные в `tasks[0].result`, результат в `tasks[0].status_code` — отклонённый запрос всё равно возвращает HTTP 200. Для результатов поиска, которые ведут сюда, используйте `get_dataforseo_merchant_google_products_fetch`; для мнений покупателей — `get_dataforseo_merchant_google_reviews_fetch`. ### Справочная информация о ценах - Тарификация: заявленная стоимость ответа. - Справочная оценка запроса: USD 0.012. - Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента. Только справочные метаданные, а не котировка для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo. ## Base URL - `https://openapi.felo.ai` ## Authentication - `FeloBearerAuth` (http bearer, bearer format Felo API Key) - `FeloApiKey` (apiKey in header `X-API-Key`) ## Parameters | Name | In | Required | Type | Description | | --- | --- | --- | --- | --- | | `id` | path | yes | string | идентификатор задачи
уникальный идентификатор задачи в нашей системе в формате UUID
в течение 30 дней вы сможете в любое время запросить по нему результаты задачи | ## Responses ### 200 — Успешная операция Headers: - `X-Request-Id` (string) — Идентификатор запроса, который нужно указать при обращении в поддержку Felo. **application/json** Schema: object | null ```json { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedResponseInfo" } ] } ``` ### 400 — Запрос не удалось обработать. Проверьте параметры запроса. ### 401 — Требуется действительный API-ключ Felo. ### 402 — Запрос не может быть выполнен: не выполнено требование биллинга. ### 403 — Аккаунту не разрешено выполнять эту операцию. ### 429 — Достигнут лимит запросов или расходов. ### 502 — Сервис не смог выполнить запрос. ### 503 — API или сервис биллинга временно недоступны. ### 504 — Истекло время ожидания обработки запроса. ### default — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера **application/json** Schema: ```json {} ``` ## Schema definitions ### Response36Afe1097B20_BaseResponseInfo `#/components/schemas/Response36Afe1097B20_BaseResponseInfo` ```json { "properties": { "version": { "type": [ "string", "null" ], "description": "текущая версия API" }, "status_code": { "type": [ "integer", "null" ], "description": "общий код состояния.\nПолный список кодов ответа можно найти здесь." }, "status_message": { "type": [ "string", "null" ], "description": "общее информационное сообщение.\nПолный список общих информационных сообщений можно найти здесь." }, "time": { "type": [ "string", "null" ], "description": "общее время выполнения, секунды" }, "cost": { "type": [ "number", "null" ], "description": "общая стоимость задач, USD", "format": "double" }, "tasks_count": { "type": [ "integer", "null" ], "description": "число задач в массиве tasks", "format": "int64" }, "tasks_error": { "type": [ "integer", "null" ], "description": "число задач в массиве tasks, возвращённых с ошибкой", "format": "int64" } } } ``` ### Response36Afe1097B20_BaseResponseTaskInfo `#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo` ```json { "properties": { "id": { "type": [ "string", "null" ], "description": "идентификатор задачи\nуникальный идентификатор задачи в нашей системе в формате UUID" }, "status_code": { "type": [ "integer", "null" ], "description": "код состояния задачи\nформируется DataForSEO, может находиться в диапазоне 10000-60000\nПолный список кодов ответа можно найти здесь." }, "status_message": { "type": [ "string", "null" ], "description": "информационное сообщение задачи\nПолный список общих информационных сообщений можно найти здесь." }, "time": { "type": [ "string", "null" ], "description": "время выполнения, секунды" }, "cost": { "type": [ "number", "null" ], "description": "общая стоимость задач, USD", "format": "double" }, "result_count": { "type": [ "integer", "null" ], "description": "число элементов в массиве result", "format": "int64" }, "path": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "путь URL" }, "data": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "object", "null" ] }, "description": "содержит те же параметры, что вы указали в POST-запросе" } } } ``` ### Response36Afe1097B20_DeliveryInfo `#/components/schemas/Response36Afe1097B20_DeliveryInfo` ```json { "type": "object", "properties": { "delivery_date_from": { "type": [ "string", "null" ], "description": "самая ранняя дата доставки
самая ранняя дата, когда товар может быть отправлен, в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00”
пример: 2019-11-15 12:57:46 +00:00" }, "delivery_date_to": { "type": [ "string", "null" ], "description": "самая поздняя дата доставки
самая поздняя дата, когда товар может быть доставлен, в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00”
пример: 2019-11-15 12:57:46 +00:00" }, "fastest_delivery_date_from": { "type": [ "string", "null" ], "description": "самая ранняя дата бесплатной доставки
самая ранняя дата, когда товар может быть доставлен с опцией быстрой доставки, в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00”
пример: 2019-11-15 12:57:46 +00:00" }, "fastest_delivery_date_to": { "type": [ "string", "null" ], "description": "самая поздняя дата бесплатной доставки
самая поздняя дата, когда товар может быть доставлен с опцией быстрой доставки, в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00”
пример: 2019-11-15 12:57:46 +00:00" }, "delivery_message": { "type": [ "string", "null" ], "description": "информация о доставке
сообщение, сопровождающее информацию о доставке, опубликованное продавцом" }, "delivery_price": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_PriceInfo" } ], "description": "стоимость доставки
стоимость доставки в зависимости от местоположения, указанного в запросе POST;
если доступна бесплатная доставка, значение — null" } } } ``` ### Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedResponseInfo `#/components/schemas/Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedResponseInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo" }, { "type": "object", "properties": { "tasks": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedTaskInfo" } ] }, "description": "массив задач" } } } ] } ``` ### Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedResultInfo `#/components/schemas/Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedResultInfo` ```json { "type": "object", "properties": { "product_id": { "type": [ "string", "null" ], "description": "ID товара в массиве POST
подробнее о параметре — в этом руководстве справочного центра" }, "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "se_domain": { "type": [ "string", "null" ], "description": "домен поисковой системы в массиве POST" }, "location_code": { "type": [ "integer", "null" ], "description": "код местоположения в массиве POST" }, "language_code": { "type": [ "string", "null" ], "description": "код языка в массиве POST" }, "check_url": { "type": [ "string", "null" ], "description": "прямой URL к результатам поисковой системы
с его помощью можно убедиться, что мы предоставили точные результаты" }, "datetime": { "type": [ "string", "null" ], "description": "дата и время получения результата
в формате: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”
пример:
2019-11-15 12:57:46 +00:00" }, "item_types": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "типы элементов, найденных на странице спецификаций товара
возможные типы элементов:
product_info_element" }, "items_count": { "type": [ "integer", "null" ], "description": "количество результатов, возвращённых в массиве items", "format": "int64" }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_ProductInfoElement" } ] }, "description": "элементы на странице товара
содержит все атрибуты товара и связанные данные, перечисленные на странице товара" } } } ``` ### Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedTaskInfo `#/components/schemas/Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedTaskInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo" }, { "type": "object", "properties": { "result": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedResultInfo" } ] }, "description": "массив результатов" } } } ] } ``` ### Response36Afe1097B20_PriceInfo `#/components/schemas/Response36Afe1097B20_PriceInfo` ```json { "type": "object", "properties": { "current": { "type": [ "number", "null" ], "description": "текущая цена\nуказывает текущую цену товара или услуги, представленных в результате", "format": "double" }, "regular": { "type": [ "number", "null" ], "description": "обычная цена\nуказывает обычную цену товара или услуги без скидок", "format": "double" }, "max_value": { "type": [ "number", "null" ], "description": "максимальная цена\nмаксимальная цена товара или услуги, указанная в результате", "format": "double" }, "currency": { "type": [ "string", "null" ], "description": "валюта указанной цены\nISO-код валюты, применяемой к цене" }, "is_price_range": { "type": [ "boolean", "null" ], "description": "цена указана в виде диапазона\nуказывает, предоставляется ли цена в виде диапазона" }, "displayed_price": { "type": [ "string", "null" ], "description": "строка цены в результате\nисходная строка цены, как она предоставлена в результате" } } } ``` ### Response36Afe1097B20_ProductInfoElement `#/components/schemas/Response36Afe1097B20_ProductInfoElement` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "rank_group": { "type": [ "integer", "null" ], "description": "позиция в группе элементов с одинаковыми значениями type
позиции элементов с другими значениями type исключаются из rank_group" }, "rank_absolute": { "type": [ "integer", "null" ], "description": "абсолютный ранг на странице спецификации товара
абсолютная позиция среди всех элементов, найденных на странице спецификации товара" }, "position": { "type": [ "string", "null" ], "description": "выравнивание элемента на странице спецификации товара
может принимать следующие значения:
right, left" }, "product_id": { "type": [ "string", "null" ], "description": "product_id, полученный в массиве POST
подробнее о параметре — в этом руководстве справочного центра" }, "title": { "type": [ "string", "null" ], "description": "название товара" }, "description": { "type": [ "string", "null" ], "description": "описание товара" }, "url": { "type": [ "string", "null" ], "description": "URL товара
URL товара в Google Shopping" }, "images": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "изображения товара
содержит URL изображений товара" }, "features": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "характеристики товара
содержит фрагменты с описанием характеристик товара" }, "rating": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_RatingElement" } ], "description": "рейтинг товара
показатель популярности на основе отзывов" }, "seller_reviews_count": { "type": [ "integer", "null" ], "description": "количество отзывов продавца
количество отзывов в аккаунте продавца товара", "format": "int64" }, "data_docid": { "type": [ "string", "null" ], "description": "уникальный идентификатор элемента данных SERP
обратите внимание: полного списка возможных значений нет, так как data_docid — динамическое значение, назначаемое Google
пример:
17363035694596624076" }, "gid": { "type": [ "string", "null" ], "description": "глобальный идентификатор товара в Google Shopping
учтите, что полного списка возможных значений нет, поскольку gid — динамическое значение, назначаемое Google
если значений нет, вы получите null
пример:
4702526954592161872
подробнее о gid — в этом руководстве справочного центра" }, "specifications": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_ShoppingSpecification" } ] }, "description": "спецификации товара
содержит все атрибуты товара и связанные данные, перечисленные на странице спецификации товара" }, "sellers": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_ProductSeller" } ] }, "description": "продавцы товара
количество отзывов в аккаунте продавца товара" }, "variations": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_ProductVariation" } ] }, "description": "варианты товара
содержит краткую информацию о различных вариантах товара" } } } ``` ### Response36Afe1097B20_ProductSeller `#/components/schemas/Response36Afe1097B20_ProductSeller` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "title": { "type": [ "string", "null" ], "description": "название товара" }, "url": { "type": [ "string", "null" ], "description": "URL продавца
URL страницы, на которой продаётся товар" }, "seller_rating": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_RatingElement" } ], "description": "рейтинг продавца" }, "seller_review_count": { "type": [ "integer", "null" ], "description": "количество отзывов продавца\nколичество отзывов в аккаунте продавца товара" }, "price": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_PriceInfo" } ], "description": "цена товара
сведения о цене товара на сайте продавца" }, "delivery_info": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_DeliveryInfo" } ], "description": "информация о доставке
информация о доставке товара" }, "product_availability": { "type": [ "string", "null" ], "description": "информация о наличии товара
может принимать следующие значения: in_stock, limited_stock, out_of_stock, backordered, pre_order_available, on_display_to_order" } } } ``` ### Response36Afe1097B20_ProductVariation `#/components/schemas/Response36Afe1097B20_ProductVariation` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "product_id": { "type": [ "string", "null" ], "description": "ID товара в массиве POST
подробнее о параметре — в этом руководстве справочного центра" }, "gid": { "type": [ "string", "null" ], "description": "GID ID в массиве POST
подробнее о параметре — в этом руководстве справочного центра" }, "data_docid": { "type": [ "string", "null" ], "description": "уникальный идентификатор элемента данных SERP в массиве POST" }, "pvf": { "type": [ "string", "null" ], "description": "фильтр вариантов товара
используется в URL варианта товара как идентификатор конкретного варианта товара" }, "title": { "type": [ "string", "null" ], "description": "название продавца товара" }, "url": { "type": [ "string", "null" ], "description": "URL варианта товара в Google Shopping" }, "variation_category": { "type": [ "string", "null" ], "description": "категория варианта товара
пример: \"Storage Capacity\"" } } } ``` ### Response36Afe1097B20_RatingElement `#/components/schemas/Response36Afe1097B20_RatingElement` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "position": { "type": [ "string", "null" ], "description": "выравнивание элемента в Google Shopping SERP
возможные значения:
left, right" }, "rating_type": { "type": [ "string", "null" ], "description": "тип рейтинга
здесь можно найти следующие элементы: Max5, Percents, CustomMax" }, "value": { "type": [ "number", "null" ], "description": "значение рейтинга" }, "votes_count": { "type": [ "integer", "null" ], "description": "количество отзывов", "format": "int64" }, "rating_max": { "type": [ "integer", "null" ], "description": "максимальное значение для rating_type" } } } ``` ### Response36Afe1097B20_ShoppingSpecification `#/components/schemas/Response36Afe1097B20_ShoppingSpecification` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "block_name": { "type": [ "string", "null" ], "description": "название блока атрибутов товара
указывает название раздела спецификации товара, в котором перечислен соответствующий элемент" }, "specification_name": { "type": [ "string", "null" ], "description": "атрибут товара
название атрибута в спецификации товарных данных" }, "specification_value": { "type": [ "string", "null" ], "description": "содержимое спецификации" } } } ```