הוספת מאפיינים מותאמים אישית של קובץ

מאפייני קובץ מותאמים אישית הם צמדי מפתח/ערך שמשמשים לאחסון מטא-נתונים מותאמים אישית של קובץ ב-Google Drive (כמו תגים), מזהים ממאגרי נתונים אחרים, מידע משותף בין אפליקציות של תהליכי עבודה וכו'. לדוגמה, אפשר להוסיף קובץ לכל המסמכים שנוצרו על ידי מחלקת המכירות ברבעון הראשון.

כדי להוסיף מאפיינים שגלויים לכל האפליקציות, צריך להשתמש בשדה properties של משאב files. כדי להוסיף מלונות מוגבל לאפליקציה שלך, צריך להשתמש בשדה appProperties של המשאב files.

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

זה המבנה של נכס אופייני שיכול לשמש לאחסון מזהה מסד הנתונים של הקובץ ב-Drive.

Drive API גרסה 3

"appProperties": {
  "additionalID": "ID",
}

Drive API גרסה 2

{
  'key':        'additionalID',
  'value':      'ID',
  'visibility': 'PRIVATE'
}

עבודה עם מאפייני קבצים מותאמים אישית

הקטע מסביר איך לבצע כמה משימות מותאמות אישית שקשורות לנכסי קבצים, ישפיעו על כל האפליקציות.

הוספה או עדכון של מאפייני קובץ מותאמים אישית

כדי להוסיף או לעדכן מאפיינים שגלויים לכל האפליקציות, משתמשים ב files.update כדי להגדיר את השדה properties ב-files משאב.

PATCH https://www.googleapis.com/drive/v3/files/FILE_ID
{
  "properties": {
    "name": "wrench",
    "mass": "1.3kg",
    "count": "3"
  }
}

אפשר גם להוסיף מאפיין מותאם אישית לקובץ באמצעות שירות Drive ב-Google Apps Script. מידע נוסף זמין במאמר הבא: הוספת תגים מותאמים אישית נכסים דיגיטליים.

אחזור או פירוט של מאפייני קובץ מותאמים אישית

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

GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=properties

התשובה מורכבת מאובייקט properties שמכיל אוסף של צמדי מפתח/ערך.

{
  "properties": {
    "name": "wrench",
    "mass": "1.3kg",
    "count": "3"
  }
}

מחיקת מאפייני קובץ מותאמים אישית

כדי למחוק ערכי מאפיינים שגלויים לכל האפליקציות, משתמשים ב files.update כדי להגדיר את השדה properties ב-files ל-null.

PATCH https://www.googleapis.com/drive/v3/files/FILE_ID
{
  "name": null
}

כדי להציג את השינוי, צריך לקרוא אל השיטה files.get כדי לאחזר את אובייקט properties לקובץ.

{
  "properties": {
    "mass": "1.3kg",
    "count": "3"
  }
}

המגבלות של מאפייני קבצים מותאמים אישית

על נכסים מותאמים אישית חלות המגבלות הבאות:

  • עד 100 מאפיינים מותאמים אישית לקובץ, סה"כ מכל המקורות.
  • עד 30 נכסים ציבוריים לקובץ, סה"כ מכל המקורות.
  • עד 30 נכסים פרטיים לקובץ מכל אפליקציה אחת.
  • עד 124 בייטים לכל מחרוזת של נכס (כולל מפתח וערך) ב- קידוד UTF-8. לדוגמה, נכס עם מפתח באורך של 10 תווים יכול להכיל רק 114 תווים. באופן דומה, נכס מחייב 100 תווים עבור הערך. הוא יכול להשתמש ב-24 תווים לכל היותר עבור המאפיין מקש.

אפשר לקרוא מידע נוסף בfiles. משאב. כדי לראות את Drive API v2, אפשר לעיין משאב properties.

גישה למאפיינים של קבצים פרטיים בהתאמה אישית

אפשר לאחזר נכסים פרטיים רק באמצעות השדה appProperties דרך בקשה מאומתת שמשתמשת באסימון גישה שהתקבל באמצעות OAuth 2.0 מזהה לקוח. לא ניתן להשתמש במפתח API כדי לאחזר נכסים פרטיים.