REST Resource: settings.datasources
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المرجع: DataSource
مصدر البيانات هو مساحة اسم منطقية للعناصر التي سيتم فهرستها. يجب أن تنتمي جميع العناصر إلى مصدر بيانات. هذا هو الشرط الأساسي قبل أن تتم فهرسة العناصر في Cloud Search.
| تمثيل JSON |
{
"name": string,
"displayName": string,
"shortName": string,
"indexingServiceAccounts": [
string
],
"disableServing": boolean,
"disableModifications": boolean,
"itemsVisibility": [
{
object (GSuitePrincipal)
}
],
"returnThumbnailUrls": boolean,
"operationIds": [
string
]
} |
| الحقول |
name |
string
اسم مورد مصدر البيانات التنسيق: datasources/{sourceId}. يتم تجاهل الاسم عند إنشاء مصدر بيانات.
|
displayName |
string
مطلوب. الاسم المعروض لمصدر البيانات. الحد الأقصى للطول هو 300 حرف.
|
shortName |
string
اسم قصير أو اسم بديل للمصدر سيتم استخدام هذه القيمة لمطابقة عامل التشغيل source. على سبيل المثال، إذا كان الاسم المختصر هو <value>، لن تعرض طلبات البحث مثل source:<value> سوى نتائج لهذا المصدر. يجب أن تكون القيمة فريدة في جميع مصادر البيانات. يجب أن تحتوي القيمة على أحرف أبجدية رقمية فقط (a-zA-Z0-9). لا يمكن أن تبدأ القيمة بـ "google" ولا يمكن أن تكون إحدى الأسماء التالية: mail أو gmail أو docs أو drive أو groups أو sites أو calendar أو hangouts أو gplus أو keep أو people أو teams. الحد الأقصى لعدد الأحرف المسموح به هو 32 حرفًا.
|
indexingServiceAccounts[] |
string
قائمة بحسابات الخدمة التي لديها إذن الوصول إلى الفهرسة
|
disableServing |
boolean
أوقِف عرض أي نتائج بحث أو مساعدة.
|
disableModifications |
boolean
في حال ضبطها على "صحيح"، يتم ضبط مصدر البيانات على وضع القراءة فقط. في وضع "القراءة فقط"، ترفض واجهة برمجة التطبيقات Indexing API أي طلبات للفهرسة أو حذف العناصر في هذا المصدر. لا يؤدي تفعيل وضع القراءة فقط إلى إيقاف معالجة البيانات المقبولة سابقًا.
|
itemsVisibility[] |
object (GSuitePrincipal)
يحدّ هذا الحقل من مستوى الوصول إلى العناصر على مستوى مصدر البيانات. تقتصر العناصر ضمن مصدر البيانات على اتحاد المستخدمين والمجموعات المضمّنة في هذا الحقل. يُرجى العِلم أنّ هذا الإجراء لا يضمن الوصول إلى عنصر معيّن، لأنّ المستخدمين يحتاجون إلى أذونات قائمة التحكّم في الوصول إلى العناصر المضمّنة. يضمن ذلك الوصول إلى مستوى عالٍ في مصدر البيانات بالكامل، وعدم مشاركة العناصر الفردية خارج نطاق إذن الوصول هذا.
|
returnThumbnailUrls |
boolean
هل يمكن للمستخدم طلب الحصول على معرّف الموارد المنتظم (URI) للصورة المصغّرة للعناصر المفهرَسة في مصدر البيانات هذا؟
|
operationIds[] |
string
أرقام تعريف "العمليات التي تستغرق وقتًا طويلاً" (LROs) التي يتم تنفيذها حاليًا لهذا المخطّط
|
الطُرق |
|
|
لإنشاء مصدر بيانات |
|
|
لحذف مصدر بيانات |
|
|
تحصل على مصدر بيانات. |
|
|
يسرد مصادر البيانات. |
|
|
تعديل مصدر بيانات |
|
|
تعديل مصدر بيانات |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# REST Resource: settings.datasources\n\n- [Resource: DataSource](#DataSource)\n - [JSON representation](#DataSource.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: DataSource\n--------------------\n\nDatasource is a logical namespace for items to be indexed. All items must belong to a datasource. This is the prerequisite before items can be indexed into Cloud Search.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"displayName\": string, \"shortName\": string, \"indexingServiceAccounts\": [ string ], \"disableServing\": boolean, \"disableModifications\": boolean, \"itemsVisibility\": [ { object (/workspace/cloud-search/docs/reference/rest/v1/GSuitePrincipal) } ], \"returnThumbnailUrls\": boolean, \"operationIds\": [ string ] } ``` |\n\n| Fields ||\n|-----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` The name of the datasource resource. Format: datasources/{sourceId}. The name is ignored when creating a datasource. |\n| `displayName` | `string` Required. Display name of the datasource The maximum length is 300 characters. |\n| `shortName` | `string` A short name or alias for the source. This value will be used to match the 'source' operator. For example, if the short name is *\\\u003cvalue\\\u003e* then queries like *source:\\\u003cvalue\\\u003e* will only return results for this source. The value must be unique across all datasources. The value must only contain alphanumeric characters (a-zA-Z0-9). The value cannot start with 'google' and cannot be one of the following: mail, gmail, docs, drive, groups, sites, calendar, hangouts, gplus, keep, people, teams. Its maximum length is 32 characters. |\n| `indexingServiceAccounts[]` | `string` List of service accounts that have indexing access. |\n| `disableServing` | `boolean` Disable serving any search or assist results. |\n| `disableModifications` | `boolean` If true, sets the datasource to read-only mode. In read-only mode, the Indexing API rejects any requests to index or delete items in this source. Enabling read-only mode does not stop the processing of previously accepted data. |\n| `itemsVisibility[]` | `object (`[GSuitePrincipal](/workspace/cloud-search/docs/reference/rest/v1/GSuitePrincipal)`)` This field restricts visibility to items at the datasource level. Items within the datasource are restricted to the union of users and groups included in this field. Note that, this does not ensure access to a specific item, as users need to have ACL permissions on the contained items. This ensures a high level access on the entire datasource, and that the individual items are not shared outside this visibility. |\n| `returnThumbnailUrls` | `boolean` Can a user request to get thumbnail URI for Items indexed in this data source. |\n| `operationIds[]` | `string` IDs of the Long Running Operations (LROs) currently running for this schema. |\n\n| Methods ------- ||\n|------------------------------------------------------------------------------------------|-----------------------|\n| ### [create](/workspace/cloud-search/docs/reference/rest/v1/settings.datasources/create) | Creates a datasource. |\n| ### [delete](/workspace/cloud-search/docs/reference/rest/v1/settings.datasources/delete) | Deletes a datasource. |\n| ### [get](/workspace/cloud-search/docs/reference/rest/v1/settings.datasources/get) | Gets a datasource. |\n| ### [list](/workspace/cloud-search/docs/reference/rest/v1/settings.datasources/list) | Lists datasources. |\n| ### [patch](/workspace/cloud-search/docs/reference/rest/v1/settings.datasources/patch) | Updates a datasource. |\n| ### [update](/workspace/cloud-search/docs/reference/rest/v1/settings.datasources/update) | Updates a datasource. |"]]
