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

یک ملک را به روز می کند.