REST Resource: accounts.dataSources.fileUploads
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Ресурс: FileUpload
Загрузка файла определенного источника данных, то есть результат получения источника данных в определенную временную метку, вычисляемый асинхронно после завершения обработки источника данных. Применимо только к файловым источникам данных.
JSON-представление |
---|
{
"name": string,
"dataSourceId": string,
"processingState": enum (ProcessingState ),
"issues": [
{
object (Issue )
}
],
"itemsTotal": string,
"itemsCreated": string,
"itemsUpdated": string,
"uploadTime": string
} |
Поля |
---|
name | string Идентификатор. Имя загружаемого файла источника данных. Формат: {datasource.name=accounts/{account}/dataSources/{datasource}/fileUploads/{fileupload}} |
dataSourceId | string ( int64 format) Только вывод. Идентификатор источника данных. |
processingState | enum ( ProcessingState ) Только вывод. Состояние обработки источника данных. |
issues[] | object ( Issue ) Только вывод. Список проблем, возникающих в источнике данных. |
itemsTotal | string ( int64 format) Только вывод. Количество обработанных элементов в источнике данных. |
itemsCreated | string ( int64 format) Только вывод. Количество созданных элементов в источнике данных. |
itemsUpdated | string ( int64 format) Только вывод. Количество элементов в источнике данных, которые были обновлены. |
uploadTime | string ( Timestamp format) Только вывод. Дата загрузки файла источника данных. |
Состояние обработки
Состояние обработки источника данных.
Перечисления |
---|
PROCESSING_STATE_UNSPECIFIED | Статус обработки не указан. |
FAILED | Источник данных не удалось обработать, или во всех элементах были ошибки. |
IN_PROGRESS | Источник данных обрабатывается. |
SUCCEEDED | Источник данных обработан успешно, хотя в некоторых элементах могли быть ошибки. |
Проблема
В источнике данных произошла ошибка, например «недопустимая цена».
JSON-представление |
---|
{
"title": string,
"description": string,
"code": string,
"count": string,
"severity": enum (Severity ),
"documentationUri": string
} |
Поля |
---|
title | string Только вывод. Название проблемы, например: «Слишком большой предмет». |
description | string Только вывод. Описание ошибки, например: «Ваш источник данных содержит элементы, которые имеют слишком много атрибутов или слишком велики. Эти элементы будут удалены». |
code | string Только вывод. Код ошибки, например, «валидация/недействительное_значение». Возвращает "?" если код неизвестен. |
count | string ( int64 format) Только вывод. Количество ошибок при загрузке файла. |
severity | enum ( Severity ) Только вывод. Серьезность проблемы. |
documentationUri | string Только вывод. Ссылка на документацию, объясняющую проблему более подробно, если таковая имеется. |
Серьезность
Перечисления |
---|
SEVERITY_UNSPECIFIED | Тяжесть не указана. |
WARNING | Проблема в предупреждении. |
ERROR | Проблема в ошибке. |
Методы |
---|
| Получает последнюю загруженную версию файла источника данных. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-01-10 UTC.
[null,null,["Последнее обновление: 2025-01-10 UTC."],[[["\u003cp\u003eFileUpload is the asynchronous result of a data source retrieval, containing information about the processing of uploaded files.\u003c/p\u003e\n"],["\u003cp\u003eProcessingState indicates the status of the data source, whether it's being processed, has succeeded, or failed.\u003c/p\u003e\n"],["\u003cp\u003eIssue details errors encountered during data source processing, including descriptions, severity, and counts.\u003c/p\u003e\n"],["\u003cp\u003eFileUpload provides metrics such as the total, created, and updated items processed, along with the upload timestamp.\u003c/p\u003e\n"],["\u003cp\u003eThe resource provides a \u003ccode\u003eget\u003c/code\u003e method to retrieve the latest data source file upload details.\u003c/p\u003e\n"]]],["File uploads for data sources are processed asynchronously, with results available upon completion. Key information includes the `name`, `dataSourceId`, `processingState`, and any `issues`. The `processingState` can be `FAILED`, `IN_PROGRESS`, or `SUCCEEDED`. Issues have a `title`, `description`, `code`, `count`, and `severity` (`WARNING` or `ERROR`). Data like `itemsTotal`, `itemsCreated`, `itemsUpdated`, and `uploadTime` are also available. The `get` method is available to get the data.\n"],null,["# REST Resource: accounts.dataSources.fileUploads\n\n- [Resource: FileUpload](#FileUpload)\n - [JSON representation](#FileUpload.SCHEMA_REPRESENTATION)\n- [ProcessingState](#ProcessingState)\n- [Issue](#Issue)\n - [JSON representation](#Issue.SCHEMA_REPRESENTATION)\n- [Severity](#Severity)\n- [Methods](#METHODS_SUMMARY)\n\nResource: FileUpload\n--------------------\n\nThe file upload of a specific data source, that is, the result of the retrieval of the data source at a certain timestamp computed asynchronously when the data source processing is finished. Only applicable to file data sources.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"dataSourceId\": string, \"processingState\": enum (/merchant/api/reference/rest/datasources_v1beta/accounts.dataSources.fileUploads#ProcessingState), \"issues\": [ { object (/merchant/api/reference/rest/datasources_v1beta/accounts.dataSources.fileUploads#Issue) } ], \"itemsTotal\": string, \"itemsCreated\": string, \"itemsUpdated\": string, \"uploadTime\": string } ``` |\n\n| Fields ||\n|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Identifier. The name of the data source file upload. Format: `{datasource.name=accounts/{account}/dataSources/{datasource}/fileUploads/{fileupload}}` |\n| `dataSourceId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The data source id. |\n| `processingState` | `enum (`[ProcessingState](/merchant/api/reference/rest/datasources_v1beta/accounts.dataSources.fileUploads#ProcessingState)`)` Output only. The processing state of the data source. |\n| `issues[]` | `object (`[Issue](/merchant/api/reference/rest/datasources_v1beta/accounts.dataSources.fileUploads#Issue)`)` Output only. The list of issues occurring in the data source. |\n| `itemsTotal` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The number of items in the data source that were processed. |\n| `itemsCreated` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The number of items in the data source that were created. |\n| `itemsUpdated` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The number of items in the data source that were updated. |\n| `uploadTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Output only. The date at which the file of the data source was uploaded. |\n\nProcessingState\n---------------\n\nThe processing state of the data source.\n\n| Enums ||\n|--------------------------------|--------------------------------------------------------------------------------------|\n| `PROCESSING_STATE_UNSPECIFIED` | Processing state unspecified. |\n| `FAILED` | The data source could not be processed or all the items had errors. |\n| `IN_PROGRESS` | The data source is being processed. |\n| `SUCCEEDED` | The data source was processed successfully, though some items might have had errors. |\n\nIssue\n-----\n\nAn error occurring in the data source, like \"invalid price\".\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"title\": string, \"description\": string, \"code\": string, \"count\": string, \"severity\": enum (/merchant/api/reference/rest/datasources_v1beta/accounts.dataSources.fileUploads#Severity), \"documentationUri\": string } ``` |\n\n| Fields ||\n|--------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `title` | `string` Output only. The title of the issue, for example, \"Item too big\". |\n| `description` | `string` Output only. The error description, for example, \"Your data source contains items which have too many attributes, or are too big. These items will be dropped\". |\n| `code` | `string` Output only. The code of the error, for example, \"validation/invalid_value\". Returns \"?\" if the code is unknown. |\n| `count` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The number of occurrences of the error in the file upload. |\n| `severity` | `enum (`[Severity](/merchant/api/reference/rest/datasources_v1beta/accounts.dataSources.fileUploads#Severity)`)` Output only. The severity of the issue. |\n| `documentationUri` | `string` Output only. Link to the documentation explaining the issue in more details, if available. |\n\nSeverity\n--------\n\nThe severity of the issue.\n\n| Enums ||\n|------------------------|---------------------------|\n| `SEVERITY_UNSPECIFIED` | Severity unspecified. |\n| `WARNING` | The issue is the warning. |\n| `ERROR` | The issue is an error. |\n\n| Methods ------- ||\n|-------------------------------------------------------------------------------------------------|------------------------------------------|\n| ### [get](/merchant/api/reference/rest/datasources_v1beta/accounts.dataSources.fileUploads/get) | Gets the latest data source file upload. |"]]