Çalışma yerlerini yönetin

Google Takvim'de kullanıcılar, bir etkinliğe davetiye gönderirken konumlarını öğrenmek için çalışma yeri belirtebilir. Bu özellik yalnızca bazı Google Takvim kullanıcıları tarafından kullanılabilir. Ayrıntılı bilgiyi Kullanıcılar için çalışma yerini etkinleştirme veya devre dışı bırakma başlıklı makalede bulabilirsiniz.

Kullanıcıların çalışma yerlerini okuma

Kullanıcıların çalışma yerlerini Calendar API'nin Events kaynağında okuyabilirsiniz.

Çalışma yeri etkinliklerini listelemek için eventTypes alanında ['workingLocation'] değerini belirterek events.list yöntemini kullanın. Döndürülen Event nesnelerinde eventType alanının 'workingLocation' değerine sahip olduğunu inceleyin ve Google Takvim'de kullanıcı tarafından ayarlanan çalışma konumuyla ilgili ayrıntılar için workingLocationProperties alanına bakın.

Not: Çalışma yeri ekleme veya güncelleme özelliği hâlâ geliştirme aşamasındadır. Çalışma saatleri şu anda programatik olarak yönetilemez.

Google Apps Komut Dosyası kod örneği

Google Apps Komut Dosyası, Google Workspace ile entegre olan basit iş uygulamaları oluşturmanıza olanak tanıyan, JavaScript tabanlı bir bulut kodlama dilidir. Komut dosyaları, tarayıcı tabanlı bir kod düzenleyicide geliştirilir ve Google sunucularında saklanır ve çalışır. Ayrıca, Google Calendar API'ye istek göndermek için Apps Komut Dosyası'nı kullanmaya başlamak amacıyla Google Apps Komut Dosyası hızlı başlangıç kılavuzunu inceleyin.

Aşağıdaki talimatlarda, Google Apps Komut Dosyası'nda gelişmiş bir hizmet olarak Google Calendar API kullanılarak çalışma yerlerinin nasıl okunacağı açıklanmaktadır. Google Calendar API kaynaklarının ve yöntemlerinin tam listesi için referans dokümanlarını inceleyin.

Komut dosyasını oluşturma

1. script.google.com/create adresine giderek bir komut dosyası oluşturun.

Google Calendar API'yi etkinleştirme

1. Sol bölmede, Hizmetler'in yanındaki Hizmet ekle'yi tıklayın add .
2. Google Calendar API'yi seçin ve Ekle'yi tıklayın.
3. Etkinleştirildiğinde API, sol bölmede görünür. API'deki mevcut yöntemler ve sınıflar, düzenleyicideki Takvim anahtar kelimesi kullanılarak listelenebilir.

Google Cloud projesini güncelleyin

Çalışma yerlerini okuma özelliği yalnızca Geliştirici Önizlemesi Programı'ndaki Google Cloud projelerinde kullanılabilir. Çalışma yeri etkinliklerini almak için Apps Komut Dosyası projesinin Google Cloud proje numarasını güncellemeniz gerekir.

1. Düzenleyicinin sol tarafında Proje Ayarları'nı settings tıklayın.
2. Google Cloud Platform (GCP) Projesi bölümünde Projeyi değiştir'i tıklayın.
3. Geliştirici Önizleme Programı'nda olan Google Cloud projesinin proje numarasını girin ve Proje ayarla'yı tıklayın.
4. Kod düzenleyiciye geri dönmek için Düzenleyici'yi code seçin.

Çalışma yerlerini okumak için komut dosyasını çalıştırın

Aşağıdaki kod örneği, takviminizdeki çalışma yeri etkinliklerini nasıl okuyacağınızı göstermektedir.

1. Aşağıdaki kısmı komut dosyası düzenleyicisine yapıştırın.

   /**
    * 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. Kod düzenleyicinin üst kısmında, açılır menüden çalıştırılacak işlevi seçip Çalıştır'ı tıklayın.

3. İlk yürütmede, erişimi yetkilendirmeniz istenir. Apps Komut Dosyası'nın takviminize erişmesine izin verin.

4. Komut dosyası yürütmenin sonuçlarını, pencerenin alt kısmında görünen Yürütme Günlüğü'nde inceleyebilirsiniz.