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