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)
출력 전용입니다. 데이터 소스 ID입니다.
|
processingState |
enum (ProcessingState )
출력 전용입니다. 데이터 소스의 처리 상태입니다.
|
issues[] |
object (Issue )
출력 전용입니다. 데이터 소스에서 발생한 문제 목록
|
itemsTotal |
string (int64 format)
출력 전용입니다. 데이터 소스에서 처리된 항목 수입니다.
|
itemsCreated |
string (int64 format)
출력 전용입니다. 생성된 데이터 소스의 항목 수입니다.
|
itemsUpdated |
string (int64 format)
출력 전용입니다. 데이터 소스에서 업데이트된 항목 수입니다.
|
uploadTime |
string (Timestamp format)
출력 전용입니다. 데이터 소스 파일이 업로드된 날짜입니다.
|
ProcessingState
열거형 |
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
출력 전용입니다. 오류 코드입니다(예: 'validation/invalid_value'). 코드를 알 수 없는 경우 '?'를 반환합니다.
|
count |
string (int64 format)
출력 전용입니다. 파일 업로드에서 오류가 발생한 횟수입니다.
|
severity |
enum (Severity )
출력 전용입니다. 문제의 심각도입니다.
|
documentationUri |
string
출력 전용입니다. 문제를 자세히 설명하는 문서 링크(있는 경우)
|
심각도
열거형 |
SEVERITY_UNSPECIFIED |
심각도가 지정되지 않았습니다. |
WARNING |
문제는 경고입니다. |
ERROR |
이 문제는 오류입니다. |
메서드 |
|
최신 데이터 소스 파일 업로드를 가져옵니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-11-24(UTC)
[null,null,["최종 업데이트: 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. |"]]