REST Resource: properties

משאב: נכס

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

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

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

ל-methods מסוימות של משאבים (כמו 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

מעדכנות נכס.