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) التي يتم تنفيذها حاليًا لهذا المخطّط

الطُرق

create

لإنشاء مصدر بيانات

delete

لحذف مصدر بيانات

get

تحصل على مصدر بيانات.

list

يسرد مصادر البيانات.

patch

تعديل مصدر بيانات

update

تعديل مصدر بيانات