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

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

string

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

string

النتائج فقط. تشير هذه السمة إلى علامة ETag للموقع الإلكتروني.
key

string

تمثّل هذه السمة مفتاح هذا الموقع.

الطُرق

delete

 حذف موقع.

get

 يحصل على خاصية بمفتاحها.

insert

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

list

 يسرد خصائص ملفّ.

patch

 يعدِّل أحد المواقع.

update

 يعدِّل أحد المواقع.