REST Resource: projects.locations.dataStores.branches.documents

משאב: מסמך

המסמך כולל את כל פרטי המטא-נתונים הגולמיים של הפריטים שיומלצו או ייכללו בחיפוש.

ייצוג JSON 
{
  "name": string,
  "id": string,
  "schemaId": string,
  "content": {
    object (Content)
  },
  "parentDocumentId": string,
  "derivedStructData": {
    object
  },
  "aclInfo": {
    object (AclInfo)
  },
  "indexTime": string,
  "indexStatus": {
    object (IndexStatus)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "structData": {
    object
  },
  "jsonData": string
  // End of mutually exclusive fields.
}
שדות
name

string

אי אפשר לשנות. השם המלא של המשאב של המסמך. פורמט: projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}/documents/{documentId}

השדה הזה חייב להיות מחרוזת בקידוד UTF-8, עם מגבלת אורך של 1,024 תווים.
id

string

אי אפשר לשנות. המזהה של המסמך.

המזהה צריך להיות בהתאם לתקן RFC-1034, עם מגבלת אורך של 128 תווים.
schemaId

string

המזהה של הסכימה שנמצאת באותו מאגר נתונים.
content

object (Content)

הנתונים הלא מובנים שמקושרים למסמך הזה. אפשר להגדיר תוכן רק אם המסמך הזה נמצא במאגר נתונים של CONTENT_REQUIRED, וחובה להגדיר אותו.
parentDocumentId

string

המזהה של מסמך האב. כרגע יש תמיכה בהיררכיית מסמכים עם שתי רמות לכל היותר.

המזהה צריך להיות תואם לתקן RFC-1034, והאורך שלו צריך להיות עד 63 תווים.
derivedStructData

object (Struct format)

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

object (AclInfo)

מידע על בקרת הגישה למסמך.
indexTime

string (Timestamp format)

פלט בלבד. השעה שבה המסמך נוסף לאינדקס בפעם האחרונה.

אם השדה הזה מאוכלס, המשמעות היא שהמסמך נוסף לאינדקס. בדרך כלל, אפשר לחפש מסמכים תוך שניות אחרי שהם נוספים לאינדקס, אבל לפעמים זה יכול לקחת כמה שעות.

אם השדה הזה לא מאוכלס, המשמעות היא שהמסמך מעולם לא נוסף לאינדקס.

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
indexStatus

object (IndexStatus)

פלט בלבד. סטטוס האינדקס של המסמך.

  • אם המסמך נוסף לאינדקס בהצלחה, השדה indexTime יאוכלס.
  • אחרת, אם המסמך לא נוסף לאינדקס בגלל שגיאות, השדה errorSamples יאוכלס.
  • אחרת, אם מתבצעת יצירת אינדקס של המסמך, השדה pendingMessage מאוכלס.
ייצוג נתונים. צריך לספק את אחד מהערכים struct_data או json_data, אחרת מוצגת שגיאה INVALID_ARGUMENT. בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. רק אחד מהשדות הבאים יוגדר בתשובה:
structData

object (Struct format)

נתוני ה-JSON המובְנים של המסמך. הוא צריך להיות תואם ל-Schema הרשום, אחרת תופיע שגיאת INVALID_ARGUMENT.
jsonData

string

ייצוג מחרוזת ה-JSON של המסמך. הוא צריך להיות תואם ל-Schema הרשום, אחרת תופיע שגיאת INVALID_ARGUMENT.
סוף השדות הבלעדיים.

Methods

create

 יצירת Document.

delete

 מחיקת Document.

get

 הפונקציה מחזירה Document.

import

 ייבוא בכמות גדולה של כמה Document.

list

 מקבל רשימה של Document.

patch

 עדכון של Document.

purge

 מחיקה סופית של כל Document שנבחרו בענף.