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
}
الحقول
value

string

قيمة هذه السمة.
visibility

string

إذن الوصول إلى هذا الموقع. القيم المسموح بها هي PRIVATE (القيمة التلقائية) وPUBLIC. لا يمكن استرداد المواقع الخاصة إلا باستخدام طلب تمّت مصادقته. يستخدم الطلب الذي تمّت مصادقته رمز دخول تم الحصول عليه باستخدام معرّف عميل OAuth 2. لا يمكنك استخدام مفتاح واجهة برمجة التطبيقات لاسترداد المواقع الخاصة.
kind

string

النتائج فقط. يكون هذا الخيار دائمًا drive#property.
etag

string

النتائج فقط. علامة ETag للموقع
key

string

مفتاح هذا الموقع.

الطُرق

delete

 لحذف موقع

get

 تحصل على موقع حسب مفتاحه.

insert

 تُضيف هذه الدالة موقعًا إلى ملف أو تعدّله إذا كان متوفّرًا.

list

 يُدرج خصائص الملف.

patch

 تعديل موقع

update

 تعديل موقع