Etkinlik türleri

Bu sayfada eventType özelliği ve etkinlik türlerinin özellikleri açıklanmaktadır Google Takvim API'sinde kullanılabilir.

Google Takvim, kullanıcıların genel etkinliklerin yanı sıra belirli kullanım alanları için tasarlanmış ve özel özelliklere sahip.

Etkinlik türü, API'nin aşağıdaki yerlerinde bulunabilir:

  • Tüm etkinlikler bir eventType ile döndürülür.
  • eventType bir etkinlik kaynağı oluştururken veya güncellerken ayarlanması gerekir. Ayarlanmadan bırakılırsa 'default' türü kullanılacak.
  • eventTypes bir Etkinlikler:liste içinde belirtilebilir. belirli türlerdeki etkinlikleri listelemek için kullanılır. Tür belirtilmezse tüm etkinlik türleri döndürülecek.
  • eventTypes Events:watch'ta belirtilebilir "Belirli türdeki etkinliklerle ilgili güncellemelere abone olun" çağrısı. Hiçbir tür belirtildiğinde, istek tüm etkinlik türlerine abone olunmasını sağlar.

Varsayılan etkinlik

default etkinlik türüne sahip etkinlikler oluşturulur ve ana etkinliklerden biri olarak kullanılır kaynakları hakkında bilgi edinin. Çok geniş bir yelpazede mülkler Bu etkinlik, etkinliği daha da özelleştirmek için kullanılabilir.

Görüntüleyin Çalışmaya başlamak için etkinlikler oluşturun. Google Takvim etkinlikleri.

Doğum Günü

Doğum günleri, her yıl tekrarlanan ve tüm gün süren özel etkinliklerdir. Sahip oldukları aşağıdaki spesifikasyonlara uygundur:

  • eventType şuna ayarlandı: 'birthday'.
  • start ve end alanları bir tam olarak bir güne yayılan tüm gün süren bir etkinliktir.
  • visibility alan değeri 'private' olmalıdır.
  • transparency alan değeri 'transparent' olmalıdır.
  • Her yıl yinelenmesi gerekir, yani recurrence alanı şu şekilde olmalıdır: 'RRULE:FREQ=YEARLY'. 29 Şubat'a denk gelen doğum günü etkinliklerinde şu yinelenme kuralı: 'RRULE:FREQ=YEARLY;BYMONTH=2;BYMONTHDAY=-1'
  • colorId olabilir, summary ve reminders.
  • Diğer etkinlik özellikleri desteklenmez.

Gmail'den Etkinlikler

Gmail'den otomatik olarak oluşturulan etkinlikler 'fromGmail' etkinlik türüne sahip.

Google Calendar API, insert yöntemini kullanın.

API, colorId, reminders, visibility, transparency, status, private ve shared güncellemeyi kullanarak genişletilmiş mülkler ve yama yöntemleri ekleyin.

API, get ve etkinlik okuma yöntemlerini listeleyin Gmail eventTypes şunlar olabilir: yalnızca Gmail'den oluşturulan etkinlikleri listelemek için 'fromGmail' olarak ayarlandı. Hiçbir tür belirtildiğinde, Gmail'den gelen etkinlikler diğer tüm etkinlik türleriyle birlikte listelenir.

API, aşağıdaki işlemler için watch yöntemini destekler: Google Takvim'de Gmail'den etkinliklerdeki değişikliklere abone olma Hiçbir tür belirtildi, 'fromGmail' dahil tüm etkinlik türlerine abone olunacak.

Gmail'den etkinlikler delete yöntemini Google Takvim API'sı.

Gmail'de bir etkinliğin düzenleyicisini aşağıdakileri kullanarak değiştirme: move veya güncelleme yöntemleri desteklenmez.

Odaklanma zamanı, ofis dışında ve çalışma yeri

Google Calendar API, aşağıdaki bilgilerin gösterildiği etkinlikler oluşturmak ve yönetmek için kullanılabilir: Google Takvim kullanıcılarının durumu.

Bu özellikler yalnızca birincil takvimlerde ve bazı kullanıcılar Google Takvim kullanıcıları. Bkz. Odaklanma zamanını, ofis dışında durumunu ve çalışmayı yönetme konum etkinlikleri başlıklı makaleye göz atın.

Google Apps Komut Dosyası'ndaki etkinlik türlerini keşfedin

Google Apps Komut Dosyası, JavaScript tabanlı bir buluttur Google Analytics 4 ile entegre olan iş uygulamaları Google Workspace Komut dosyaları, tarayıcı tabanlı bir kod düzenleyicide geliştirilir. Google'ın sunucularında saklanır ve çalışır. Ayrıca bkz. Google Apps Komut Dosyası kullanmaya başlamak için hızlı başlangıç kılavuzu Google Takvim API'sine istek göndermek için Apps Komut Dosyası.

Aşağıdaki talimatlarda, Google Calendar API'yi kullanarak Google Apps Komut Dosyası. Google Calendar API kaynaklarının ve yöntemlerinin tam listesi için referans belgelerine bakın.

Komut dosyasını oluşturun ve ayarlayın

  1. Komut dosyası oluşturmak için script.google.com/create.
  2. Hizmetler'in yanındaki sol bölmede Hizmet ekle'yi tıklayın.
  3. Google Calendar API'yi seçip Add'i (Ekle) tıklayın.
  4. Etkinleştirildikten sonra API soldaki bölmede görünür. Kullanılabilir yöntemler ve API'deki sınıflar, düzenleyicide Calendar anahtar kelimesi kullanılarak listelenebilir.

(İsteğe bağlı) Google Cloud projesini güncelleme

Her Google Apps Komut Dosyası projesinin ilişkili bir Google Cloud projesi vardır. Sizin komut dosyası, Google Apps Komut Dosyası'nın otomatik olarak oluşturduğu varsayılan projeyi kullanabilir oluşturuyor. Özel bir Google Cloud projesi kullanmak istiyorsanız farklı standart Cloud projeleri için. Google Cloud projesini ayarladıktan sonra sol taraftan Düzenleyici'yi seçerek kod düzenleyiciyi kullanabilirsiniz.

Komut dosyasına kod ekleyin

Aşağıdaki kod örneğinde, şununla etkinlikleri listeleme, okuma ve oluşturma gösterilmektedir: farklı eventType değerleridir.

  1. Aşağıdakini kod düzenleyiciye yapıştırın.

    const CALENDAR_ID = 'CALENDAR_ID' || 'primary';

/** Lists default events. */
function listDefaultEvents() {
  listEvents('default');
}

/** Lists events from Gmail. */
function listEventsFromGmail() {
  listEvents('fromGmail');
}

/**
  * Lists events with the given event type. If no type is specified, lists all events.
  * See https://developers.google.com/calendar/api/v3/reference/events/list
  */
function listEvents(eventType = undefined) {
  // Query parameters for the list request.
  const optionalArgs = {
    eventTypes: eventType ? [eventType] : undefined,
    singleEvents: true,
    timeMax: '2024-07-30T00:00:00+01:00',
    timeMin: '2024-07-29T00:00:00+01:00',
  }
  try {
    var response = Calendar.Events.list(CALENDAR_ID, optionalArgs);
    response.items.forEach(event => console.log(event));
  } catch (exception) {
    console.log(exception.message);
  }
}

/**
  * Reads the event with the given eventId.
  * See https://developers.google.com/calendar/api/v3/reference/events/get
  */
function readEvent() {
  try {
    var response = Calendar.Events.get(CALENDAR_ID, 'EVENT_ID');
    console.log(response);
  } catch (exception) {
    console.log(exception.message);
  }
}

/** Creates a default event. */
function createDefaultEvent() {
  const event = {
    start: { dateTime: '2024-07-30T10:30:00+01:00'},
    end: { dateTime: '2024-07-30T12:30:00+01:00'},
    description: 'Created from Apps Script.',
    eventType: 'default',
    summary: 'Sample event',
  }
  createEvent(event);
}

/**
  * Creates a Calendar event.
  * See https://developers.google.com/calendar/api/v3/reference/events/insert
  */
function createEvent(event) {

  try {
    var response = Calendar.Events.insert(event, CALENDAR_ID);
    console.log(response);
  } catch (exception) {
    console.log(exception.message);
  }
}

    Aşağıdakini değiştirin:

    • CALENDAR_ID: Bu takvimin e-posta adresi: alma ve oluşturma üzerine kuruludur. Bu sabit değer başlangıçta 'primary', etkinliğin birincil takvimine erişmek için bir anahtar oturum açmış kullanıcı. Bu değeri değiştirmek şu kullanıcıların takvimlerindeki etkinlikleri okumanıza olanak tanır: diğer kullanıcıları da dahil edebilirsiniz.
    • EVENT_ID: Etkinliğin kimliği. Örneğin, Etkinlik kimliklerini almak için Events:list kullanın.

Kod örneğini çalıştırma

  1. Kod düzenleyicinin üzerinde, açılır menüden çalıştırılacak işlevi seçin. ve Çalıştır'ı tıklayın.
  2. İlk yürütmede erişimi yetkilendirmeniz istenir. İncele ve izin ver Takviminize erişmek için Apps Komut Dosyası.
  3. Komut dosyası yürütme sonuçlarını şurada inceleyebilirsiniz: Pencerenin en altında görünen Yürütme Günlüğü.