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

itemsVisibility[]

object (GSuitePrincipal)

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

returnThumbnailUrls

boolean

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

operationIds[]

string

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

Methods

create

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

delete

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

get

אחזור של מקור נתונים.

list

הצגת רשימה של מקורות הנתונים.

patch

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

update

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