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-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# REST Resource: properties\n\n- [Resource: Property](#Property)\n - [JSON representation](#Property.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Property\n------------------\n\nA key-value pair attached to a file that is either public or private to an application.\n\nThe following limits apply to file properties:\n\n- Maximum of 100 properties total per file\n- Maximum of 30 private properties per app\n- Maximum of 30 public properties\n- Maximum of 124 bytes size limit on (key + value) string in UTF-8 encoding for a single property\n\nSome resource methods (such as `properties.update`) require a `propertyKey`. Use the `properties.list` method to retrieve the key for a property.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------|\n| ``` { \"selfLink\": string, \"value\": string, \"visibility\": string, \"kind\": string, \"etag\": string, \"key\": string } ``` |\n\n| Fields ||\n|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `selfLink` | `string` Output only. The link back to this property. |\n| `value` | `string` The value of this property. |\n| `visibility` | `string` The visibility of this property. Allowed values are PRIVATE (default) and PUBLIC. Private properties can only be retrieved using an authenticated request. An authenticated request uses an access token obtained with a OAuth 2 client ID. You cannot use an API key to retrieve private properties. |\n| `kind` | `string` Output only. This is always `drive#property`. |\n| `etag` | `string` Output only. ETag of the property. |\n| `key` | `string` The key of this property. |\n\n| Methods ------- ||\n|------------------------------------------------------------------------|----------------------------------------------------------------|\n| ### [delete](/workspace/drive/api/reference/rest/v2/properties/delete) | Deletes a property. |\n| ### [get](/workspace/drive/api/reference/rest/v2/properties/get) | Gets a property by its key. |\n| ### [insert](/workspace/drive/api/reference/rest/v2/properties/insert) | Adds a property to a file, or updates it if it already exists. |\n| ### [list](/workspace/drive/api/reference/rest/v2/properties/list) | Lists a file's properties. |\n| ### [patch](/workspace/drive/api/reference/rest/v2/properties/patch) | Updates a property. |\n| ### [update](/workspace/drive/api/reference/rest/v2/properties/update) | Updates a property. |"]]
