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

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

string

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

string

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

string

مفتاح هذه السمة.

الطُرق

delete

 حذف موقع.

get

 يمكن الحصول على موقع من خلال مفتاحه.

insert

 إضافة سمة إلى ملف، أو تعديلها إذا كانت موجودة من قبل.

list

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

patch

 تُعدِّل موقعًا.

update

 تُعدِّل موقعًا.