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
حالة معالجة مصدر البيانات.
| عمليات التعداد |
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. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-11-24 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-11-24 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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. |"]]
