REST Resource: properties

משאב: נכס

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

המגבלות הבאות חלות על מאפייני קובץ:

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

לשיטות משאבים מסוימות (כמו properties.update) נדרש propertyKey. משתמשים בשיטה properties.list כדי לאחזר את המפתח של נכס.

ייצוג JSON 
{
  "selfLink": string,
  "value": string,
  "visibility": string,
  "kind": string,
  "etag": string,
  "key": string
}
שדות
value

string

הערך של המאפיין הזה.
visibility

string

החשיפה של הנכס הזה. הערכים המותרים הם Private (ברירת מחדל) ו-PUBLIC. ניתן לאחזר נכסים פרטיים רק באמצעות בקשה מאומתת. בקשה מאומתת משתמשת באסימון גישה שהתקבל עם מזהה לקוח של OAuth 2. לא ניתן להשתמש במפתח API כדי לאחזר נכסים פרטיים.
kind

string

פלט בלבד. הערך הוא תמיד drive#property.
etag

string

פלט בלבד. ETag של הנכס.
key

string

המפתח של הנכס הזה.

שיטות

delete

 מוחק נכס.

get

 הפונקציה מקבלת נכס לפי המפתח שלו.

insert

 מוסיף מאפיין לקובץ או מעדכן אותו אם הוא כבר קיים.

list

 מפרט את המאפיינים של קובץ.

patch

 מתבצע עדכון של נכס.

update

 מתבצע עדכון של נכס.