REST Resource: properties

משאב: נכס

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

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

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

כדי להשתמש בחלק מהשיטות של המשאבים (כמו properties.update), נדרש propertyKey. משתמשים ב-method ‏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

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

Methods

delete

מחיקה של נכס.

get

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

insert

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

list

הצגת רשימה של מאפייני הקובץ.

patch

עדכון נכס.

update

עדכון נכס.