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)
פלט בלבד. התאריך שבו הועלה הקובץ של מקור הנתונים.
|
ProcessingState
מצב העיבוד של מקור הנתונים.
טיפוסים בני מנייה (enum) |
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
פלט בלבד. קישור לתיעוד שבו מוסבר על הבעיה בפירוט רב יותר, אם יש כזה.
|
מידת החומרה
טיפוסים בני מנייה (enum) |
SEVERITY_UNSPECIFIED |
רמת החומרה לא צוינה. |
WARNING |
הבעיה היא האזהרה. |
ERROR |
הבעיה היא שגיאה. |
Methods |
|
הפונקציה מקבלת את קובץ ההעלאה האחרון של מקור הנתונים. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת 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. |"]]