REST Resource: properties
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المرجع: الموقع
زوج مفتاح/قيمة مرفق بملف علني أو خاص بتطبيق
تنطبق الحدود التالية على سمات الملفات:
- الحد الأقصى لعدد المواقع هو 100 موقع في كل ملف.
- 30 موقعًا خاصًا كحدّ أقصى لكل تطبيق
- 30 موقعًا علنيًا كحدّ أقصى
- الحد الأقصى لحجم سلسلة (المفتاح + القيمة) بترميز UTF-8 هو 124 بايت لسمة واحدة.
تتطلّب بعض طرق الموارد (مثل 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. لا يمكنك استخدام مفتاح واجهة برمجة التطبيقات لاسترداد المواقع الخاصة.
|
kind |
string
النتائج فقط. يكون هذا الخيار دائمًا drive#property.
|
etag |
string
النتائج فقط. علامة ETag للموقع
|
key |
string
مفتاح هذا الموقع.
|
الطُرق |
|
|
لحذف موقع |
|
|
تحصل على موقع حسب مفتاحه. |
|
|
تُضيف هذه الدالة موقعًا إلى ملف أو تعدّله إذا كان متوفّرًا. |
|
|
يُدرج خصائص الملف. |
|
|
تعديل موقع |
|
|
تعديل موقع |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة 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. |"]]
