REST Resource: accounts.dataSources.fileUploads
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Recurso: FileUpload
Es la carga de archivos de una fuente de datos específica, es decir, el resultado de la recuperación de la fuente de datos en una marca de tiempo determinada que se calcula de forma asíncrona cuando finaliza el procesamiento de la fuente de datos. Solo se aplica a las fuentes de datos de archivos.
Representación JSON |
{
"name": string,
"dataSourceId": string,
"processingState": enum (ProcessingState ),
"issues": [
{
object (Issue )
}
],
"itemsTotal": string,
"itemsCreated": string,
"itemsUpdated": string,
"uploadTime": string
} |
Campos |
name |
string
Identificador. Es el nombre de la carga del archivo de la fuente de datos. Formato: {datasource.name=accounts/{account}/dataSources/{datasource}/fileUploads/{fileupload}}
|
dataSourceId |
string (int64 format)
Solo salida. Es el ID de la fuente de datos.
|
processingState |
enum (ProcessingState )
Solo salida. El estado de procesamiento de la fuente de datos.
|
issues[] |
object (Issue )
Solo salida. Es la lista de problemas que se producen en la fuente de datos.
|
itemsTotal |
string (int64 format)
Solo salida. Es la cantidad de elementos de la fuente de datos que se procesaron.
|
itemsCreated |
string (int64 format)
Solo salida. Es la cantidad de elementos de la fuente de datos que se crearon.
|
itemsUpdated |
string (int64 format)
Solo salida. Es la cantidad de elementos de la fuente de datos que se actualizaron.
|
uploadTime |
string (Timestamp format)
Solo salida. Es la fecha en la que se subió el archivo de la fuente de datos.
|
ProcessingState
El estado de procesamiento de la fuente de datos.
Enumeraciones |
PROCESSING_STATE_UNSPECIFIED |
No se especificó el estado de procesamiento. |
FAILED |
No se pudo procesar la fuente de datos o todos los elementos tenían errores. |
IN_PROGRESS |
Se está procesando la fuente de datos. |
SUCCEEDED |
La fuente de datos se procesó correctamente, aunque es posible que algunos elementos hayan tenido errores. |
Problema
Un error en la fuente de datos, como “precio no válido”.
Representación JSON |
{
"title": string,
"description": string,
"code": string,
"count": string,
"severity": enum (Severity ),
"documentationUri": string
} |
Campos |
title |
string
Solo salida. Es el título del problema, por ejemplo, “El elemento es demasiado grande”.
|
description |
string
Solo salida. La descripción del error, por ejemplo, "Tu fuente de datos contiene artículos que se omitirán por contener demasiados atributos o ser demasiado grandes. Se eliminarán estos elementos".
|
code |
string
Solo salida. Es el código del error, por ejemplo, "validation/invalid_value". Muestra "?" si se desconoce el código.
|
count |
string (int64 format)
Solo salida. Es la cantidad de veces que se produjo el error en la carga del archivo.
|
severity |
enum (Severity )
Solo salida. La gravedad del problema.
|
documentationUri |
string
Solo salida. Vínculo a la documentación en la que se explica el problema con más detalles, si está disponible
|
Gravedad
La gravedad del problema.
Enumeraciones |
SEVERITY_UNSPECIFIED |
Gravedad sin especificar. |
WARNING |
El problema es la advertencia. |
ERROR |
El problema es un error. |
Métodos |
|
Obtiene la carga de archivo de fuente de datos más reciente. |
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2024-11-24 (UTC)
[null,null,["Última actualización: 2024-11-24 (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. |"]]