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

שם קצר או כינוי למקור. הערך הזה ישמש להתאמת האופרטור 'מקור'. לדוגמה, אם השם המקוצר הוא <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, מקור הנתונים יהיה במצב קריאה-בלבד. במצב קריאה-בלבד, ה-API ליצירת אינדקס דוחה את כל הבקשות להוספה לאינדקס או למחיקה של פריטים במקור זה. הפעלת מצב הקריאה-בלבד לא עוצרת את העיבוד של נתונים שהתקבלו בעבר.
itemsVisibility[]

object (GSuitePrincipal)

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

boolean

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

string

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

שיטות

create

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

delete

 מתבצעת מחיקה של מקור נתונים.

get

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

list

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

patch

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

update

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