# Получение результатов обновлений Google My Business по id **API:** Data API **Endpoint:** `GET /v1/beta/dataforseo/business_data/google/my_business_updates/task_get/{id}` **Tags:** DataForSEO По `id` получает из очереди обновления профиля Google Business: каждую публикацию с её текстом, медиа и датой. Ответ обёрнут в конверт DataForSEO: данные в `tasks[0].result`, результат в `tasks[0].status_code` — отклонённый запрос всё равно возвращает HTTP 200. ### Справочные цены - Тарификация: стоимость ответа по данным провайдера. - Справочная оценка запроса: 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_BusinessDataGoogleMyBusinessUpdatesTaskGetResponseInfo" } ] } ``` ### 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_BusinessDataGoogleMyBusinessUpdatesTaskGetResponseInfo `#/components/schemas/Response36Afe1097B20_BusinessDataGoogleMyBusinessUpdatesTaskGetResponseInfo` ```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_BusinessDataGoogleMyBusinessUpdatesTaskGetTaskInfo" } ] }, "description": "массив задач" } } } ] } ``` ### Response36Afe1097B20_BusinessDataGoogleMyBusinessUpdatesTaskGetResultInfo `#/components/schemas/Response36Afe1097B20_BusinessDataGoogleMyBusinessUpdatesTaskGetResultInfo` ```json { "type": "object", "properties": { "keyword": { "type": [ "string", "null" ], "description": "ключевое слово, полученное в массиве POST
ключевое слово возвращается с декодированными %## (символ '+' будет декодирован в пробел)
это поле будет содержать параметр cid, если вы указали его в поле keyword при постановке задачи;
пример:
cid:2946633002421908862
Подробнее о параметре — в этой статье справочного центра" }, "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": "дата и время получения результата
в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00”
пример:
2019-11-15 12:57:46 +00:00" }, "business_updates_id": { "type": [ "string", "null" ], "description": "идентификатор элемента обновлений компании в SERP" }, "cid": { "type": [ "string", "null" ], "description": "идентификатор клиента, определяемый Google
уникальный идентификатор местного заведения
Подробнее об идентификаторе cid — в этой статье справочного центра" }, "feature_id": { "type": [ "string", "null" ], "description": "уникальный идентификатор элемента в SERP
Подробнее об идентификаторе — в этой статье справочного центра" }, "item_types": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "типы элементов
типы результатов поисковой системы, встречающиеся в массиве items;
возможные типы элементов: google_business_post" }, "items_count": { "type": [ "integer", "null" ], "description": "типы элементов
количество элементов в массиве items", "format": "int64" }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_GoogleBusinessPost" } ] }, "description": "встреченные типы элементов
типы результатов поисковой системы, встречающиеся в массиве items;
возможные типы элементов: google_business_post" } } } ``` ### Response36Afe1097B20_BusinessDataGoogleMyBusinessUpdatesTaskGetTaskInfo `#/components/schemas/Response36Afe1097B20_BusinessDataGoogleMyBusinessUpdatesTaskGetTaskInfo` ```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_BusinessDataGoogleMyBusinessUpdatesTaskGetResultInfo" } ] }, "description": "массив результатов" } } } ] } ``` ### Response36Afe1097B20_GoogleBusinessPost `#/components/schemas/Response36Afe1097B20_GoogleBusinessPost` ```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": "выравнивание элемента в SERP
может принимать следующие значения: right" }, "xpath": { "type": [ "string", "null" ], "description": "XPath элемента" }, "author": { "type": [ "string", "null" ], "description": "автор публикации" }, "snippet": { "type": [ "string", "null" ], "description": "дополнительное содержимое поста" }, "post_text": { "type": [ "string", "null" ], "description": "основное содержимое поста" }, "url": { "type": [ "string", "null" ], "description": "URL поста" }, "images_url": { "type": [ "string", "null" ], "description": "URL изображения, включённого в публикацию" }, "post_date": { "type": [ "string", "null" ], "description": "дата публикации поста
в следующем формате:
\"mm/dd/yyyy hh:mm:ss\"" }, "timestamp": { "type": [ "string", "null" ], "description": "время публикации поста
в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00”
пример:
2019-11-15 12:57:46 +00:00" }, "links": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_LinkElement" } ] }, "description": "ссылки, включённые в публикацию" } } } ``` ### Response36Afe1097B20_LinkElement `#/components/schemas/Response36Afe1097B20_LinkElement` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "title": { "type": [ "string", "null" ], "description": "заголовок заданного элемента-ссылки" }, "snippet": { "type": [ "string", "null" ], "description": "текст рядом с заголовком ссылки" }, "description": { "type": [ "string", "null" ], "description": "описание элемента результатов" }, "url": { "type": [ "string", "null" ], "description": "URL" }, "domain": { "type": [ "string", "null" ], "description": "домен, на который ведёт ссылка" }, "xpath": { "type": [ "string", "null" ], "description": "XPath элемента" } } } ```