تمثّل موارد الإعداد الإعدادات التي يمكن للمستخدمين تغييرها من واجهة مستخدم "تقويم Google"، مثل المنطقة الزمنية للمستخدم. ويمكن استردادها من خلال طريقتَي list وget.يُرجى العِلم أنّه في حال ضبط الإعداد على قيمته التلقائية، قد لا يتم عرضه.
قائمة الإعدادات المتوافقة:
| رقم تعريف الإعداد | الوصف | القيم المسموح بها | القيمة التلقائية |
|---|---|---|---|
| autoAddHangouts | ما إذا كنت تريد إضافة Hangouts تلقائيًا إلى جميع الأحداث أم لا. لاحظ أن هذا الإعداد يتجاهله الخادم في حال كان eventDataVersion أكبر من 0، لأنّ العميل يتحمل مسؤولية التعامل مع المنطق وفق هذا الإعداد. للقراءة فقط. | "صحيح" أو "خطأ" | “false” |
| dateFieldOrder | ماذا يجب أن يكون ترتيب اليوم (D) والشهر (M) والسنة (Y) عند عرض التواريخ. | "MDY" و"DMY" و"YMD" | “MDY” |
| defaultEventLength | المدة التلقائية للأحداث (بالدقائق) التي تم إنشاؤها بدون مدة واضحة. | عدد موجب | “60” |
| format24HourTime | ما إذا كان سيتم عرض الوقت بتنسيق 24 ساعة. | "صحيح" أو "خطأ" | “false” |
| hideInvitations | ما إذا كان سيتم إخفاء الأحداث التي تمت دعوة المستخدم إليها ولم يتخذ أي إجراء بشأنها (على سبيل المثال، عن طريق الرد). | "صحيح" أو "خطأ" | “false” |
| hideWeekends | ما إذا كان يجب إخفاء عطلات نهاية الأسبوع عند عرض أسبوع. | "صحيح" أو "خطأ" | “false” |
| locale | لغة المستخدم. | "in" و"ca" و"cs" و"da" و"de" و"en_GB" و"en" و"es" و"es_419" و"tl" و"fr" و"hr" و"it" و"lv" و"lt" و"hu" و"nl" و"no" و"en_GB" و"en_GB" و"en" و"es" و"es_419" و"tl" و"fr" و"hr" و"it" و"lv" و"lt" و"hu" و"nl" و"no" و"pl" و"pt_BR" و"pt_BR" و"pt_PT" و"pt_PT" و"ru | “en” |
| remindOnRespondedEventsOnly | ما إذا كان يجب إرسال تذكيرات بالحدث فقط للأحداث التي تكون حالة استجابة المستخدم فيها "نعم" و"ربما". | "صحيح" أو "خطأ" | “false” |
| showDeclinedEvents | ما إذا كان يجب عرض الأحداث التي ردّ المستخدم عليها بـ "لا" في تقويم المستخدم أم لا. | "صحيح" أو "خطأ" | "صحيح" |
| المنطقة الزمنية | رقم تعريف المنطقة الزمنية للمستخدِم. | يمكنك الاطّلاع على http://www.iana.org/time-zones | “Etc/GMT” |
| useKeyboardShortcuts | ما إذا كانت اختصارات لوحة المفاتيح مفعّلة أم لا. | "صحيح" أو "خطأ" | "صحيح" |
| weekStart | ما إذا كان يجب أن يبدأ الأسبوع يوم الأحد (0) أو الاثنين (1) أو السبت (6). | "0", "1", "6" | “0” |
للحصول على قائمة بالطرق لهذا المورد، راجع نهاية هذه الصفحة.
تمثيلات الموارد
{
"kind": "calendar#setting",
"etag": etag,
"id": string,
"value": string
}
| اسم الموقع | القيمة | الوصف | Notes |
|---|---|---|---|
etag |
etag |
علامة ETag للمورد. | |
id |
string |
رقم تعريف إعداد المستخدم. | |
kind |
string |
نوع المورد ("calendar#setting"). |
|
value |
string |
قيمة إعداد المستخدم ويعتمد تنسيق القيمة على رقم تعريف الإعداد. يجب أن تكون دائمًا سلسلة UTF-8 يبلغ طولها 1024 حرفًا كحدّ أقصى. |
الطُرق
- الحصول على
- عرض إعداد مستخدم واحد.
- list
- عرض جميع إعدادات المستخدم للمستخدم الذي تمت مصادقته.
- ساعة
- انتبِه إلى التغييرات التي تطرأ على مراجع "الإعدادات".