إدارة أماكن العمل

في "تقويم Google"، يمكن للمستخدمين تحديد مكان العمل حتى يعرف المستخدمون موقعهم الجغرافي عند إرسال دعوات إلى حدث. تتوفر هذه الميزة لبعض مستخدمي تقويم Google فقط. لمزيد من التفاصيل، يُرجى الانتقال إلى تفعيل مكان العمل أو إيقافه للمستخدمين.

قراءة أماكن عمل المستخدم

يمكنك الاطِّلاع على مواقع عمل المستخدمين في مورد Events لواجهة برمجة تطبيقات "تقويم Google".

لإدراج أحداث مكان العمل، استخدِم طريقة events.list، مع تحديد ['workingLocation'] في حقل eventTypes. بعد ذلك، في كائنات Event المعروضة، تحقَّق من أن حقل eventType يحتوي على القيمة 'workingLocation'، وراجِع حقل workingLocationProperties للحصول على تفاصيل عن مكان العمل الذي حدَّده المستخدم في "تقويم Google".

ملاحظة: لا تزال القدرة على إضافة أماكن العمل أو تحديثها قيد التطوير. لا يمكن حاليًا إدارة ساعات العمل برمجيًا.

نموذج شفرة برمجة تطبيقات Google

برمجة تطبيقات Google هي لغة برمجة نصية في السحابة الإلكترونية مستندة إلى جافا سكريبت، تتيح لك إنشاء تطبيقات تجارية بسيطة تتكامل مع Google Workspace. تم تطوير النصوص البرمجية في محرر شفرة يستند إلى المتصفح، ويتم تخزينها وتشغيلها على خوادم Google. راجع أيضًا البدء السريع لبرمجة تطبيقات Google للبدء في استخدام "برمجة تطبيقات Google" لإرسال الطلبات إلى واجهة برمجة تطبيقات "تقويم Google".

توضح الإرشادات التالية كيفية قراءة أماكن العمل باستخدام واجهة برمجة تطبيقات تقويم Google كخدمة متقدمة في برمجة تطبيقات Google. للحصول على قائمة كاملة بموارد واجهة برمجة تطبيقات "تقويم Google" وطرقها، يمكنك الاطّلاع على المستندات المرجعية.

إنشاء النص البرمجي

1. أنشئ نصًا برمجيًا بالانتقال إلى script.google.com/create.

تفعيل واجهة برمجة تطبيقات "تقويم Google"

1. في اللوحة اليمنى بجانب الخدمات، انقر على "إضافة خدمة" add .
2. حدد واجهة برمجة تطبيقات تقويم Google وانقر على إضافة.
3. بعد التفعيل، تظهر واجهة برمجة التطبيقات في الجزء الأيمن. يمكن إدراج الطرق والفئات المتاحة في واجهة برمجة التطبيقات باستخدام الكلمة الرئيسية للتقويم في المحرر.

تحديث مشروع Google Cloud

لا تتوفّر إمكانية قراءة أماكن العمل إلا لمشاريع Google Cloud في برنامج معاينة مطوّري البرامج. يجب تحديث رقم مشروع Google Cloud لمشروع النص البرمجي لـ Apps لاسترداد أحداث موقع العمل.

1. على يمين المحرّر، انقر على رمز إعدادات المشروع settings.
2. ضمن مشروع Google Cloud Platform (GCP)، انقر على تغيير المشروع.
3. أدخِل رقم مشروع Google Cloud المشارِك في برنامج معاينة مطوّر البرامج، وانقر على تحديد المشروع.
4. في الجانب الأيمن، اختَر "محرّر إعلانات Google" code للرجوع إلى أداة تعديل الرموز.

تشغيل النص البرمجي لقراءة أماكن العمل

يعرض نموذج الرمز التالي كيفية قراءة أحداث مكان العمل على تقويمك.

1. الصق ما يلي في محرر النص البرمجي.

   /**
    * Lists working location events for given dates.
    * See https://developers.google.com/calendar/api/v3/reference/events/list
    */
   function listWorkingLocationEvents() {
     const calendarId = 'primary'
   
     // Query parameters for the list request.
     const optionalArgs = {
         eventTypes: ['workingLocation'],
         showDeleted: false,
         singleEvents: true,
         timeMax: '2023-04-01T00:00:00+01:00',
         timeMin: '2023-03-27T00:00:00+01:00',
       }
     try {
     var response = Calendar.Events.list(calendarId, optionalArgs );
     response.items.forEach(event =>
         console.log('%s: %s', event.start.date, parseWorkingLocation(event)));
     } catch (exception) {
       console.log(exception.message);
     }
   }
   
   /**
    * Reads the working location event with the given eventId.
    * See https://developers.google.com/calendar/api/v3/reference/events/get
    */
   function readWorkingLocationEvent() {
     const calendarId = 'primary';
   
     // Replace with a valid eventId.
     const eventId = "sample-event-id";
   
     try {
       const event = Calendar.Events.get(calendarId, eventId);
       console.log('%s: %s', event.start.date, parseWorkingLocation(event));
     } catch (exception) {
       console.log(exception.message);
     }
   }
   
   /**
    * Parses working location properties of an event into a string.
    * See https://developers.google.com/calendar/api/v3/reference/events#resource
    */
   function parseWorkingLocation(event) {
     if(event.eventType != "workingLocation") {
       throw new Error("'" +  event.summary +"' is not a working location event.");
     }
     const workingLocation = event.workingLocationProperties;
     if (workingLocation) {
       if (workingLocation.homeOffice) {
         return 'Home';
       }
       if (workingLocation.officeLocation) {
         return workingLocation.officeLocation.label;
       }
       if (workingLocation.customLocation) {
         return workingLocation.customLocation.label;
       }
     }
     return 'No Location';
   }
   

2. أعلى محرر الشفرة، حدد الدالة المطلوب تشغيلها من القائمة المنسدلة، ثم انقر على تشغيل.

3. في عملية التنفيذ الأولى، سيطلب منك تفويض الوصول. يمكنك مراجعة "برمجة التطبيقات" والسماح لها بالوصول إلى التقويم.

4. يمكنك فحص نتائج تنفيذ النص البرمجي في سجل التنفيذ الذي يظهر في أسفل النافذة.