REST Resource: settings.datasources

משאב: מקור נתונים

מקור נתונים הוא מרחב שמות לוגי של פריטים להוספה לאינדקס. כל הפריטים חייבים להשתייך למקור נתונים. זוהי הדרישה המוקדמת לפני שניתן יהיה להוסיף פריטים לאינדקס ב-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>, שאילתות כמו <value> יחזירו תוצאות רק עבור המקור הזה. הערך חייב להיות ייחודי בכל מקורות הנתונים. הערך חייב להכיל רק תווים אלפאנומריים (a-zA-Z0-9). הערך לא יכול להתחיל ב-google ולא יכול להיות אחת מהאפשרויות הבאות: mail, gmail, docs, Drive, קבוצות, אתרים, יומן, hangouts, gplus, Keep, אנשים, צוותים. האורך המקסימלי הוא 32 תווים.
indexingServiceAccounts[]

string

רשימה של חשבונות שירות שיש להם גישה להוספה לאינדקס.
disableServing

boolean

השבתת ההצגה של תוצאות חיפוש או תוצאות סיוע.
disableModifications

boolean

אם True, מקור הנתונים מוגדר למצב קריאה-בלבד. במצב קריאה בלבד, ה-API של ההוספה לאינדקס דוחה כל בקשה להוספה לאינדקס או למחיקה של פריטים במקור הזה. הפעלת מצב קריאה בלבד לא מפסיקה את העיבוד של נתונים שאושרו בעבר.
itemsVisibility[]

object (GSuitePrincipal)

השדה הזה מגביל את החשיפה לפריטים ברמת מקור הנתונים. הפריטים במקור הנתונים מוגבלים לאיחוד המשתמשים והקבוצות הכלולים בשדה הזה. הערה: הפעולה הזו לא מבטיחה גישה לפריט ספציפי, כי למשתמשים צריכות להיות הרשאות ACL לגבי הפריטים שבקובץ. כך אפשר להבטיח גישה ברמה גבוהה לכל מקור הנתונים, ושהפריטים הספציפיים לא ישותפו מחוץ לאזור החשיפה.
returnThumbnailUrls

boolean

משתמש יכול לבקש לקבל URI של תמונה ממוזערת עבור פריטים שנוספו לאינדקס במקור הנתונים הזה.
operationIds[]

string

המזהים של פעולות הריצה הממושכות (LROs) שפועלות כרגע בסכימה הזו.

שיטות

create

 יצירת מקור נתונים.

delete

 מחיקת מקור נתונים.

get

 מקבל מקור נתונים.

list

 בתיבת הדו-שיח הזו מפורטים מקורות נתונים.

patch

 עדכון מקור נתונים.

update

 עדכון מקור נתונים.