منبع داده یک فضای نام منطقی برای مواردی است که باید نمایه شوند. همه موارد باید به یک منبع داده تعلق داشته باشند. این پیش نیاز قبل از ایندکس شدن موارد در جستجوی ابری است.
هنگام ایجاد یک منبع داده، نام نادیده گرفته می شود.
displayName
string
مورد نیاز. نام نمایشی منبع داده حداکثر طول 300 کاراکتر است.
shortName
string
نام کوتاه یا نام مستعار برای منبع. این مقدار برای مطابقت با عملگر «source» استفاده خواهد شد. به عنوان مثال، اگر نام کوتاه <value> باشد، پرس و جوهایی مانند source:<value> فقط نتایج را برای این منبع برمی گرداند. مقدار باید در همه منابع داده منحصر به فرد باشد. مقدار فقط باید دارای نویسه های الفبایی باشد (a-zA-Z0-9). این مقدار نمی‌تواند با «google» شروع شود و نمی‌تواند یکی از موارد زیر باشد: نامه، gmail، اسناد، درایو، گروه‌ها، سایت‌ها، تقویم، hangouts، gplus، keep، افراد، تیم‌ها. حداکثر طول آن 32 کاراکتر است.
indexingServiceAccounts[]
string
فهرست حساب‌های خدماتی که دسترسی نمایه‌سازی دارند.
disableServing
boolean
غیرفعال کردن ارائه نتایج جستجو یا کمک.
disableModifications
boolean
اگر درست باشد، منبع داده را روی حالت فقط خواندنی تنظیم می کند. در حالت فقط خواندنی، API Indexing هرگونه درخواست برای فهرست یا حذف موارد در این منبع را رد می کند. فعال کردن حالت فقط خواندنی، پردازش داده‌های پذیرفته شده قبلی را متوقف نمی‌کند.
این فیلد دید را به موارد در سطح منبع داده محدود می کند. موارد موجود در منبع داده به اتحادیه کاربران و گروه‌های موجود در این قسمت محدود می‌شوند. توجه داشته باشید که این امر دسترسی به یک مورد خاص را تضمین نمی کند، زیرا کاربران باید مجوزهای ACL را در مورد موارد موجود داشته باشند. این امر دسترسی سطح بالایی را به کل منبع داده تضمین می کند و موارد منفرد خارج از این قابلیت مشاهده به اشتراک گذاشته نمی شوند.
returnThumbnailUrls
boolean
آیا کاربر می تواند درخواست کند URI تصویر کوچک برای موارد نمایه شده در این منبع داده را دریافت کند.
operationIds[]
string
شناسه‌های عملیات طولانی مدت (LRO) که در حال حاضر برای این طرح اجرا می‌شوند.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 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. |"]]
