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

في حال الضبط على "true"، يتم ضبط مصدر البيانات على وضع القراءة فقط. في وضع القراءة فقط، ترفض Indexing API أي طلبات لفهرسة العناصر في هذا المصدر أو حذفها. لا يؤدي تفعيل وضع القراءة فقط إلى إيقاف معالجة البيانات المقبولة سابقًا.
itemsVisibility[]

object (GSuitePrincipal)

يقصر هذا الحقل مستوى الرؤية على العناصر على مستوى مصدر البيانات. تقتصر العناصر الموجودة في مصدر البيانات على اتحاد المستخدمين والمجموعات المضمنة في هذا الحقل. لاحظ أن هذا لا يضمن الدخول إلى عنصر معين، حيث يجب أن يكون لدى المستخدمين أذونات ACL للعناصر المتضمّنة. يضمن ذلك الوصول عالي المستوى إلى مصدر البيانات بالكامل، وعدم مشاركة العناصر الفردية خارج نطاق مستوى الرؤية هذا.
returnThumbnailUrls

boolean

هل يمكن أن يطلب المستخدم الحصول على معرّف موارد منتظم (URI) للصورة المصغّرة للعناصر المفهرسة في مصدر البيانات هذا
operationIds[]

string

أرقام تعريف عمليات التشغيل الطويل (LRO) التي يتم تشغيلها حاليًا لهذا المخطط.

الطُرق

create

 تنشئ مصدر بيانات.

delete

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

get

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

list

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

patch

 تُحدّث مصدر بيانات.

update

 تُحدّث مصدر بيانات.