REST Resource: accounts.dataSources.fileUploads
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài nguyên: FileUpload
Quá trình tải tệp lên một nguồn dữ liệu cụ thể, tức là kết quả truy xuất nguồn dữ liệu tại một dấu thời gian nhất định được tính toán không đồng bộ khi quá trình xử lý nguồn dữ liệu kết thúc. Chỉ áp dụng cho nguồn dữ liệu tệp.
Biểu diễn dưới dạng JSON |
{
"name": string,
"dataSourceId": string,
"processingState": enum (ProcessingState ),
"issues": [
{
object (Issue )
}
],
"itemsTotal": string,
"itemsCreated": string,
"itemsUpdated": string,
"uploadTime": string
} |
Trường |
name |
string
Giá trị nhận dạng. Tên của tệp nguồn dữ liệu được tải lên. Định dạng {datasource.name=accounts/{account}/dataSources/{datasource}/fileUploads/{fileupload}}
|
dataSourceId |
string (int64 format)
Chỉ có đầu ra. Mã nguồn dữ liệu.
|
processingState |
enum (ProcessingState )
Chỉ có đầu ra. Trạng thái xử lý của nguồn dữ liệu.
|
issues[] |
object (Issue )
Chỉ có đầu ra. Danh sách các vấn đề xảy ra trong nguồn dữ liệu.
|
itemsTotal |
string (int64 format)
Chỉ có đầu ra. Số lượng mục trong nguồn dữ liệu đã được xử lý.
|
itemsCreated |
string (int64 format)
Chỉ có đầu ra. Số lượng mục trong nguồn dữ liệu đã được tạo.
|
itemsUpdated |
string (int64 format)
Chỉ có đầu ra. Số lượng mục trong nguồn dữ liệu đã được cập nhật.
|
uploadTime |
string (Timestamp format)
Chỉ có đầu ra. Ngày tải tệp nguồn dữ liệu lên.
|
ProcessingState
Trạng thái xử lý của nguồn dữ liệu.
Enum |
PROCESSING_STATE_UNSPECIFIED |
Trạng thái xử lý chưa xác định. |
FAILED |
Không thể xử lý nguồn dữ liệu hoặc tất cả các mục đều có lỗi. |
IN_PROGRESS |
Nguồn dữ liệu đang được xử lý. |
SUCCEEDED |
Nguồn dữ liệu đã được xử lý thành công, mặc dù một số mục có thể gặp lỗi. |
Vấn đề
Lỗi xảy ra trong nguồn dữ liệu, chẳng hạn như "giá không hợp lệ".
Biểu diễn dưới dạng JSON |
{
"title": string,
"description": string,
"code": string,
"count": string,
"severity": enum (Severity ),
"documentationUri": string
} |
Trường |
title |
string
Chỉ có đầu ra. Tên của vấn đề, ví dụ: "Mặt hàng quá lớn".
|
description |
string
Chỉ có đầu ra. Nội dung mô tả lỗi, ví dụ: "Nguồn dữ liệu của bạn chứa các mặt hàng có quá nhiều thuộc tính hoặc có kích thước quá lớn. Các mục này sẽ bị xoá".
|
code |
string
Chỉ có đầu ra. Mã lỗi, ví dụ: "validation/invalid_value". Trả về "?" nếu không xác định được mã.
|
count |
string (int64 format)
Chỉ có đầu ra. Số lần xảy ra lỗi trong quá trình tải tệp lên.
|
severity |
enum (Severity )
Chỉ có đầu ra. Mức độ nghiêm trọng của vấn đề.
|
documentationUri |
string
Chỉ có đầu ra. Đường liên kết đến tài liệu giải thích chi tiết hơn về vấn đề (nếu có).
|
Mức độ nghiêm trọng
Mức độ nghiêm trọng của vấn đề.
Enum |
SEVERITY_UNSPECIFIED |
Mức độ nghiêm trọng không được chỉ định. |
WARNING |
Vấn đề là cảnh báo. |
ERROR |
Vấn đề là một lỗi. |
Phương thức |
|
Tải tệp nguồn dữ liệu mới nhất lên. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2024-11-24 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]