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
} |
فیلدها |
---|
selfLink | string فقط خروجی لینک بازگشت به این ملک. |
value | string ارزش این ملک. |
visibility | string دید این ملک. مقادیر مجاز PRIVATE (پیشفرض) و PUBLIC هستند. ویژگی های خصوصی فقط با استفاده از یک درخواست احراز هویت قابل بازیابی هستند. یک درخواست احراز هویت شده از یک نشانه دسترسی به دست آمده با شناسه مشتری OAuth 2 استفاده می کند. شما نمی توانید از یک کلید API برای بازیابی ویژگی های خصوصی استفاده کنید. |
kind | string فقط خروجی این همیشه drive#property است. |
etag | string فقط خروجی ETag ملک. |
key | string کلید این ملک. |
روش ها |
---|
| یک خاصیت را حذف می کند. |
| ملکی را با کلید آن بدست می آورد. |
| یک ویژگی را به یک فایل اضافه می کند یا در صورت وجود آن، آن را به روز می کند. |
| ویژگی های یک فایل را فهرست می کند. |
| یک ملک را به روز می کند. |
| یک ملک را به روز می کند. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-01-09 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-01-09 بهوقت ساعت هماهنگ جهانی."],[[["File properties are key-value pairs that can be attached to a file, with limits on the total number and size."],["Properties can have either public or private visibility, impacting how they are accessed."],["The `properties` resource provides methods for managing file properties, such as adding, updating, deleting, and listing them."],["Each property is represented by a JSON object with fields like `selfLink`, `value`, `visibility`, `kind`, `etag`, and `key`."],["To retrieve the key for a property, which is needed for some operations, use the `properties.list` method."]]],["File properties are key-value pairs, either public or private, with limits: 100 total, 30 private per app, 30 public, and 124 bytes per property. Properties can be manipulated using methods such as `delete`, `get`, `insert`, `list`, `patch`, and `update`. The `visibility` field determines if the property is private or public. Private properties require OAuth 2 authentication, they can't use an API key. `properties.list` retrieves property keys, necessary for `properties.update`.\n"]]