Etkinlik nesneleri

Bu sayfada, Google Workspace eklentileri etkinlik nesnelerinin yapısı özetlenmiştir.

Etkinlik nesneleri, kullanıcı bir eklentiyle etkileşime geçtiğinde işlevleri tetiklemek veya geri çağırılmak üzere otomatik olarak oluşturulan ve parametre olarak iletilen JSON yapılardır. Etkinlik nesneleri, ana makine uygulaması ve geçerli bağlamı, eklentinin sunucu tarafı geri çağırma işlevine ekleyebilirsiniz.

Google Workspace Eklentileri, etkinlik nesnelerini aşağıdaki yerlerde kullanır:

  • Ana sayfa tetikleyicileri. Tanımladığınız her homepageTrigger işlevine otomatik olarak bir etkinlik iletilir nesnesini tanımlayın. Etkin ana makine uygulamasını, istemcinin platformunu, kullanıcı yerel ayarlarını ve diğer bilgileri tanımlamak için ana sayfa tetikleyici işlevinizde bu nesneyi kullanabilirsiniz.

    Ana sayfa tetiklendiğinde oluşturulan etkinlik nesneleri, diğer iki durumdaki tüm alanları içermez. Widget'larla ve bağlamsal bilgilerle ilgili alanlar atlanır.

  • İçeriğe dayalı tetikleyiciler. Her ana makine uygulaması, bir dizi bağlamsal tetikleyici sağlar. Kullanıcı belirli bir bağlam girdiğinde etkinleşir. Örneğin:

    Bağlamsal bir tetikleyici etkinleştiğinde ana makine uygulaması manifest'inde listelenen karşılık gelen runFunction öğesini iletir. etkinlik nesnesini tanımlayın. Bağlamsal olduğunda oluşturulan etkinlik nesneleri etkinleşen tetikleyiciler, ana sayfa tetikleyici etkinliğine dahil edilen tüm alanları içerir nesneler ve bağlamsal bilgiler içeren alanlar sunar.

  • Widget işlemleri. Etkinlik nesneleri, Gmail eklentilerinin kullandığı işlem modelini kullanarak widget etkileşimi sağlamak için de kullanılır. Google Workspace eklentilerinde, tüm widget'lar gibi Action nesne ve işlem tıklayın. Ancak Google Workspace Eklentilerinde işlem etkinliği nesneleri bir geri çağırma işlevinin çalışabileceği daha da fazla bilgi içerir.

    Widget işlemleri sonucunda oluşturulan etkinlik nesneleri, bağlamsal tetikleyici etkinlik nesnelerine dahil edilen tüm alanları ve widget bilgilerini içeren alanları içerir.

  • Bağlantı tetikleyicilerini önizleme. Google Dokümanlar, E-Tablolar ve Slaytlar'da, üçüncü taraf hizmetleri için bağlantı önizlemelerini belirli URL kalıplarına göre yapılandırabilirsiniz. Kullanıcılar kalıba uyan bir bağlantıyla etkileşime geçtiğinde linkPreviewTriggers tetiklenir ve bağlantıyı içeren bir etkinlik nesnesi tetikleyicinin geri çağırma işlevine iletilir. Eklentiniz, ana makinede bağlantıyla ilgili bilgileri gösteren akıllı çip ve kart kabul edersiniz. Ayrıca, kullanıcıların önizleme kartıyla ve içeriğiyle etkileşime geçmesine olanak tanımak için widget işlemleri de oluşturabilirsiniz.

Etkinlik nesnesi yapısı

Aşağıdaki tabloda, projenizin üst düzey yapısı Google Workspace Eklentileri etkinlik nesneleri. Etkinlik nesnesi yapısı, ana makineye bağlı olmayan bilgiler için commonEventObject üst düzey bir alan içerir. Her etkinlik nesnesi ana makineye özel aşağıdaki üst düzey alanlardan birine sahip olduğundan emin olun. etkin ana makine uygulaması: gmailEventObject, calendarEventObject veya driveEventObject.

Geriye dönük uyumluluk için Google Workspace eklentisi etkinlik nesneleri, Gmail eklentisi işlem etkinlik nesnelerinde kullanılan tüm orijinal alanları da içerir. Bu alanlar, aşağıdaki tabloda "Orijinal Gmail eklenti alanları" altında listelenmiştir; bu alanlardaki bilgiler yeni nesne yapısında yeniden oluşturulur.

Etkinlik nesnesi
eventObject.commonEventObject Common fields object.
Tüm etkinlik nesneleri için ortak bilgileri içeren nesne barındırma uygulamasıdır.
eventObject.calendar Calendar event object
Yalnızca arayan düzenleyen Google Takvim ise mevcuttur. Takvim ve etkinlik bilgilerini içeren bir nesne.
eventObject.drive
Drive event object Yalnızca görüşmeyi düzenleyen kişi Google Drive ise mevcut olmalıdır. Drive bilgilerini içeren bir nesne.
eventObject.gmail Gmail event object
Yalnızca arayan ana makine Gmail ise mevcuttur. Nesne Gmail bilgilerini içeren iletiler.
eventObject.docs Docs event object
Yalnızca arayan ana makine Google Dokümanlar ise mevcuttur. Nesne bölümünü ziyaret edin.
eventObject.sheets Sheets event object
Yalnızca arayan düzenleyen Google E-Tablolar ise mevcuttur. Nesne E-Tablolar'ı tıklayın.
eventObject.slides
Slides event object Yalnızca görüşmeyi düzenleyen kişi Google Slaytlar ise ekran gösterilir. Nesne bulun.
Orijinal Gmail eklentisi alanları
eventObject.messageMetadata.accessToken string
Kullanımdan kaldırıldı. Erişim jetonu Tekliflerinizi otomatikleştirmek ve optimize etmek için Bu ayarı etkinleştirdiğinizde, geçici Gmail eklenti kapsamları kullanan kullanıcı verilerine erişim etkinleştirilir.

Google Workspace Eklentileri için bu bilgilere eventObject.gmail.accessToken girin.

eventObject.messageMetadata.messageId string
Kullanımdan kaldırıldı. İleti dizisinin ileti kimliği Gmail kullanıcı arayüzünde açın.

Google Workspace Eklentileri için bu bilgilere eventObject.gmail.messageId girin.

eventObject.clientPlatform string
Kullanımdan kaldırıldı. Etkinliğin nerede olduğunu belirtir (web, iOS veya Android) tarafından kullanılmasına izin verilir.

Google Workspace eklentileri için bu bilgileri eventObject.commonEventObject.platform alanında bulabilirsiniz.

eventObject.formInput object
Kullanımdan kaldırıldı. Karttaki tüm form widget'larının mevcut değerlerinin, widget başına bir değerle sınırlı olan bir haritası. Anahtarlar, widget'larla ilişkili dize kimlikleri, değerler ise dizelerdir. Etkinlik nesnesi, formInput öğesini kullanarak birden fazla widget'tan veri okumanız gerektiğinde metin girişleri ve anahtarlar gibi beklenen tekil değerler. Örneğin, birden çok değeri olan widget'lar (örneğin, onay kutuları gibi) olmadan her bir değeri Bunun yerine formInputs.

Google Workspace Eklentileri için bu bilgilere eventObject.commonEventObject.formInputs alanını kullanabilirsiniz; tek değerlere sahip widget'lar, tek bir öğe.

eventObject.formInputs object
Kullanımdan kaldırıldı. Karttaki widget'ların mevcut değerlerinin dize listeleri olarak sunulan bir haritası. Anahtarlar dize kimliklerinin bir listesini temsil eder. Tek değerli widget'larda değeri, tek öğeli bir dizide sunulur. Onay kutusu grupları gibi çok değerli widget'lar için tüm değerler bir listede sunulur.
.

Google Workspace Eklentileri için bu bilgilere eventObject.commonEventObject.formInputs girin.

eventObject.parameters object
Kullanımdan kaldırıldı. Action.setParameters() kullanarak Action parametresine gönderdiğiniz ek parametrelerin haritası. Harita anahtarları ve değerleri dizedir.

Google Workspace eklentileri için bu bilgileri eventObject.commonEventObject.parameters alanında bulabilirsiniz.

eventObject.userCountry string
Varsayılan olarak desteği sonlandırıldı ve devre dışı. İlgili içeriği oluşturmak için kullanılan Kullanıcının ülke veya bölgesini belirten iki harfli kod. Sayısal bir UN M49 ülke kodu da olabilir.

Google Workspace eklentileri için bu bilgileri eventObject.commonEventObject.userLocale alanında bulabilirsiniz.

eventObject.userLocale string
Varsayılan olarak desteği sonlandırıldı ve devre dışı. Kullanıcının dilini belirten iki harfli ISO 639 kodu. Daha fazla bilgi için Kullanıcı yerel ayarına ve saat dilimine erişme başlıklı makaleyi inceleyin.

Google Workspace Eklentileri için bu bilgilere eventObject.commonEventObject.userLocale girin.

eventObject.userTimezone.id string
Desteği sonlandırıldı ve varsayılan olarak devre dışıdır. İlgili içeriği oluşturmak için kullanılan kullanıcının saat diliminin saat dilimi tanımlayıcısını içermelidir. Örnekler: America/New_York, Europe/Vienna ve Asia/Seoul. Daha fazla bilgi için Kullanıcı yerel ayarına ve saat dilimine erişme başlıklı makaleyi inceleyin.

Google Workspace eklentileri için bu bilgileri eventObject.commonEventObject.timeZone.id alanında bulabilirsiniz.

eventObject.userTimezone.offset string
Varsayılan olarak desteği sonlandırıldı ve devre dışı. İlgili içeriği oluşturmak için kullanılan kullanıcının Eşgüdümlü Evrensel Saati'nden (UTC) zaman farkı milisaniye cinsinden ölçülen saat dilimi. Görüntüleyin Daha fazla ayrıntı için kullanıcının yerel ayarına ve saat dilimine erişme.

Google Workspace eklentileri için bu bilgileri eventObject.commonEventObject.timeZone.offset alanında bulabilirsiniz.

Ortak etkinlik nesnesi

Ortak etkinlik nesnesi, şunu içeren genel etkinlik nesnesinin kısmıdır: Kullanıcının istemcisindeki eklentiye ilişkin ana makineden bağımsız genel bilgilerdir. Bu bilgiler arasında kullanıcının yerel ayarı, barındırma uygulaması ve platformu gibi ayrıntılar yer alır.

Eklentiler, ana sayfa tetikleyicileri ve bağlamsal tetikleyicilere ek olarak işlem geri çağırma işlevlerine etkinlik nesneleri Kullanıcı widget'larla etkileşimde bulunduğunda. Eklentinizin geri çağırma işlevi, kullanıcının istemcisinde açık widget'ların içeriğini belirlemek için ortak etkinlik nesnesini sorgulayabilir. Örneğin, eklentiniz kullanıcının eventObject.commentEventObject.formInputs nesnesinde bir TextInput widget'ına girdiği metni bulabilir.

Sık kullanılan etkinlik nesnesi alanları
commonEventObject.platform string
Etkinliğin nereden kaynaklandığını belirtir (`WEB`, "IOS" veya "ANDROID").
commonEventObject.formInputs object
widget'ları görebilirsiniz. Eşleme anahtarları dize kimlikleridir her bir widget'la atanır.

Harita değeri nesnesinin yapısı widget türüne bağlıdır:

  • Tek değerli widget'lar (ör. metin kutusu): dize listesi (yalnızca bir öğe).

    Örnek: Kimliği employeeName olan bir metin girişi widget'ı için metin girişi değerine şu şekilde erişin: e.commonEventObject.formInputs.employeeName.stringInputs.value[0]

  • Çok değerli widget'lar (ör. onay kutusu grupları): dizelerden oluşan bir liste.

    Örnek: Kimliği participants olan çok değerli bir widget için değer dizisine şu şekilde erişin: e.commonEventObject.formInputs.participants.stringInputs.value.

  • A date-time picker: a DateTimeInput object.

    Örnek: myDTPicker kimlikli bir seçici için e.commonEventObject.formInputs.myDTPicker.dateTimeInput kullanarak DateTimeInput nesnesine erişin.

  • A date-only picker: a DateInput object.

    Örnek: myDatePicker kimliğine sahip bir seçici için şuna erişin: DateInput nesne kullanılıyor e.commonEventObject.formInputs.myDatePicker.dateInput.

  • A time-only picker: öö TimeInput object

    Örnek: myTimePicker kimlikli bir seçici için e.commonEventObject.formInputs.myTimePicker.timeInput kullanarak TimeInput nesnesine erişin.

commonEventObject.hostApp string
Etkinlik nesnesi oluşturulduğunda eklentinin etkin olduğu ana uygulamayı gösterir. Olası değerler takip etmek için:
  • GMAIL
  • CALENDAR
  • DRIVE
  • DOCS
  • SHEETS
  • SLIDES
commonEventObject.parameters object
Action.setParameters() kullanarak Action'ye sağladığınız ek parametreler.
commonEventObject.userLocale string
Varsayılan olarak devre dışıdır. Kullanıcının dili ve ülke/bölge tanımlayıcısını ISO 639 dil kodu-ISO 3166 ülke/bölge kodundan oluşur. Örneğin, en-US.

Bu alanı etkinleştirmek için eklentinizin manifest dosyasında addOns.common.useLocaleFromApp değerini true olarak ayarlamanız gerekir. Eklentinizin kapsam listesi https://www.googleapis.com/auth/script.locale değerini de içermelidir. Daha fazla bilgi için Kullanıcı yerel ayarına ve saat dilimine erişme başlıklı makaleyi inceleyin.

commonEventObject.timeZone string
Varsayılan olarak devre dışıdır. Saat dilimi kimliği ve farkı. Bu alanı etkinleştirmek için şunları ayarlamanız gerekir: Eklentinizin manifest dosyasında addOns.common.useLocaleFromApp to true adresine gidin. Eklentinizin kapsam listesi https://www.googleapis.com/auth/script.locale değerini de içermelidir. Bkz. Daha fazla ayrıntı için kullanıcının yerel ayarına ve saat dilimine erişme.
commonEventObject.timeZone.id string
Kullanıcının saat diliminin saat dilimi tanımlayıcısı. Örnekler: America/New_York, Europe/Vienna ve Asia/Seoul. Bu alanı etkinleştirmek için şunları ayarlamanız gerekir: Eklentinizin manifest dosyasında addOns.common.useLocaleFromApp to true adresine gidin. Eklentinizin kapsam listesinde de şunlar bulunmalıdır: https://www.googleapis.com/auth/script.locale Görüntüleyin Daha fazla ayrıntı için kullanıcının yerel ayarına ve saat dilimine erişme.
commonEventObject.timeZone.offset string
kullanıcının Eşgüdümlü Evrensel Saati'nden (UTC) zaman farkı milisaniye cinsinden ölçülen saat dilimi. Daha fazla bilgi için Kullanıcı yerel ayarına ve saat dilimine erişme başlıklı makaleyi inceleyin.

Tarih/saat seçici form girişleri

İşlem geri çağırma işlevleri commonEventObject.formInputs alanındaki geçerli widget değerlerini alabilir. Buna, tarih veya saat seçici widget'larında kullanıcının seçtiği tarih ya da saat değerleri de dahildir. Ancak bilgilerin yapısı, widget'ın tarih ve saat seçici, yalnızca tarih seçici veya yalnızca saat seçici olarak yapılandırılmasına bağlı olarak farklılık gösterir. Yapısal farklılıklar aşağıdaki tabloda açıklanmıştır:

DateTimeInput nesnesi
dateTimeInput.hasDate Tarih saat girildiyse boolean
true Bir tarih içermelidir; (false yalnızca bir saat dahil edilirse)
dateTimeInput.hasTime Giriş tarih ve saati bir saat içeriyorsa boolean
true; false yalnızca bir tarih içeriyorsa.
dateTimeInput.msSinceEpoch string
Kullanıcı tarafından seçilen zaman (milisaniye cinsinden), sıfır zamandan (1 Ocak 1970'de 00:00:00 UTC) itibaren.
DateInput nesnesi
dateInput.msSinceEpoch string
Kullanıcı tarafından seçilen zaman (milisaniye cinsinden), sıfır zamandan (1 Ocak 1970'de 00:00:00 UTC) itibaren.
TimeInput nesnesi
timeInput.hours number
Kullanıcı tarafından seçilen saat numarası.
timeInput.minutes number
Kullanıcı tarafından seçilen dakika sayısı.

Takvim etkinliği nesnesi

Takvim etkinliği nesnesi, genel etkinlik nesnesinin bir kullanıcının takvimi ve takvim etkinlikleri hakkında bilgi taşıyan kısmıdır. Yalnızca bir etkinlik nesnesinde bulunur.

Aşağıdaki tabloda, calendarEventObject sütununda bulunan alanlar listelenmiştir. alanı olacaktır. Kullanıcı tarafından oluşturulan veriler olarak işaretlenen alanlar, yalnızca veriler Takvim etkinliğinde mevcutsa ve eklenti addOns.calendar.currentEventAccessmanifest alanını READ veya READ_WRITE olarak ayarlarsa etkinlik nesnesinde bulunur.

Takvim etkinliği nesnesi
calendar.attendees[] list of attendee objects
Kullanıcı tarafından oluşturulan veriler. Takvim etkinliğinin katılımcılarının listesi.
calendar.calendarId string
Takvim kimliği.
calendar.capabilities object
Kullanıcı tarafından oluşturulan veriler. Nesne Eklentinin etkinliği görüntüleme veya güncelleme özelliklerini açıklayan ekleyebilirsiniz.
calendar.capabilities.canAddAttendees boolean
Kullanıcı tarafından oluşturulan veriler. true Eklenti, etkinlik katılımcı listesine yeni katılımcı ekleyebiliyorsa; false aksi takdirde.
calendar.capabilities.canSeeAttendees boolean
Kullanıcı tarafından oluşturulan veriler. true Eklenti etkinlik katılımcısı listesini okuyabiliyorsa; false aksi takdirde.
calendar.capabilities.canSeeConferenceData boolean
Kullanıcı tarafından oluşturulan veriler. true eklenti etkinlik konferans verilerini okuyabiliyorsa; false aksi takdirde.
calendar.capabilities.canSetConferenceData boolean
Kullanıcı tarafından oluşturulan veriler. true. Eklenti, etkinlik konferans verilerini güncelleyebiliyor mu? false aksi takdirde.
calendar.capabilities.canAddAttachments boolean
Kullanıcı tarafından oluşturulan veriler. true Eklenti etkinliğe yeni ekler ekleyebiliyorsa; false aksi takdirde.
calendar.conferenceData Conference data object
Kullanıcı tarafından oluşturulan veriler. Bu etkinlikle ilişkili tüm konferans verilerini (ör. Google Meet konferansı ayrıntıları) temsil eden bir nesne.
calendar.id string
Etkinlik kimliği.
calendar.organizer object
Etkinliği düzenleyeni temsil eden bir nesne unutmayın.
calendar.organizer.email string
Etkinliği düzenleyen kullanıcının e-posta adresi.
calendar.recurringEventId string
Düzenli bir etkinliğin kimliği.

Katılımcı

Katılımcı nesneleri, Google Takvim etkinliklerindeki katılımcılarla ilgili bilgileri içerir. Bu bilgiler, yalnızca veriler Takvim etkinliğinde mevcutsa ve eklenti addOns.calendar.currentEventAccess manifest alanını READ veya READ_WRITE olarak ayarlarsa etkinlik nesnesinde bulunur.

Katılımcı nesnesi
attendee.additionalGuests number
Katılımcının getireceğini belirttiği ek konuk sayısı. Varsayılan değer sıfırdır.
attendee.comment string
Katılımcının yanıt yorumu (varsa).
attendee.displayName string
Katılımcıya gösterilen ad.
attendee.email string
Katılımcının e-posta adresi.
attendee.optional Bu etkinliğe katılım durumu boolean
true ise katılımcı isteğe bağlı olarak işaretlendi; Aksi takdirde false.
attendee.organizer boolean
true (katılımcı: bu etkinliğin düzenleyicisi.
attendee.resource Katılımcı bir kişiyi temsil ediyorsa boolean
true oda veya ekipman gibi bir kaynak; false aksi takdirde.
attendee.responseStatus string
Katılımcının yanıt durumu. Olası değerler şunlardır:
  • accepted: Katılımcı etkinlik davetini kabul etmiştir.
  • declined: Katılımcı etkinlik davetini reddetti.
  • needsAction: Katılımcı yanıt vermedi Etkinlik davetiyesi.
  • tentative: Katılımcı, etkinlik davetini geçici olarak kabul etti.
attendee.self Bu katılımcı şu kişiyi temsil ediyorsa boolean
true bu etkinliğin göründüğü takvim; Aksi takdirde false.

Konferans verileri

Konferans verileri nesneleri, Google Takvim etkinliklerine ekli konferanslarla ilgili bilgileri içerir. Bu çözümler arasında yer alan Google konferans çözümleri Google Meet veya üçüncü taraf konferanslar olabilir. Bu bilgiler, veriler Takvim etkinliğinde mevcutsa ve eklenti addOns.calendar.currentEventAccessmanifest alanını READ veya READ_WRITE olarak ayarlarsa etkinlik nesnesinde bulunur.

Konferans veri nesnesi
conferenceData.conferenceId string
Konferansın kimliği. Bu kimliğin amacı, uygulamaların konferansları takip etmesine izin vermektir. Bu kimliği kullanıcılara göstermemeniz gerekir.
conferenceData.conferenceSolution object
Konferansı temsil eden bir nesne örneğin Hangouts veya Google Meet gibi
conferenceData.conferenceSolution.iconUri string
Kullanıcının görebileceği simgenin URI'sı konferans çözümü.
conferenceData.conferenceSolution.key object
Bu etkinlik için konferans çözümünü benzersiz şekilde tanımlayan anahtar.
conferenceData.conferenceSolution.key.type string
Konferans çözümü türü. Olası değerler şunları içerir:
  • Tüketicilere yönelik Hangouts için eventHangout (http://hangouts.google.com).
  • Klasik Hangouts için eventNamedHangout Google Workspace kullanıcıları (http://hangouts.google.com).
  • Google Meet için hangoutsMeet (http://meet.google.com) kullanıyor.
conferenceData.conferenceSolution.name string
Bu konferansın kullanıcılar tarafından görülebilen adı (yerelleştirilmiş değil).
conferenceData.entryPoints[] list of entry point objects.
URL'ler veya telefon numaraları gibi konferans giriş noktalarının listesi.
conferenceData.notes string
Kullanıcıya gösterilecek konferansla ilgili ek notlar (ör. alan yöneticisinden gelen talimatlar veya yasal uyarılar). HTML içerebilir. Maksimum uzunluk 2.048 karakterdir. karakteri ekleyin.
conferenceData.parameters object
Eklentinin kullanacağı tanımlanmış parametre verilerinin haritasını içeren bir nesne.
conferenceData.parameters.addOnParameters object
Parametre dize anahtarlarının ve değerlerinin haritası. Bu anahtarlar ve değerler, eklentinin kullanımı için belirli bir konferansa bilgi eklemek amacıyla eklenti geliştiricisi tarafından tanımlanır.

Giriş noktası

Giriş noktası nesneleri, belirli bir konferansa erişmek için kullanılan yöntemler (ör. telefon veya video) hakkında bilgi içerir. Bu bilgiler veri Takvim etkinliğinde mevcutsa etkinlik nesnesini ve yalnızca eklenti addOns.calendar.currentEventAccess özelliğini ayarlar manifest alanı READ veya READ_WRITE.

Giriş noktası nesnesi
entryPoint.accessCode string
Konferansa erişmek için kullanılan erişim kodu. Maksimum uzunluk 128 karakterdir. Konferans sağlayıcılar genellikle {accessCode, meetingCode, passcode, password, pin} - konferanslara erişim sağlar. Konferans sağlayıcının kullandığı alanları eşleştirip yalnızca bu alanları gösterin.
entryPoint.entryPointFeatures list
Giriş noktasının özellikleri. Şu anda bu özellikler yalnızca phone giriş noktaları için geçerlidir:
  • toll: Giriş noktası ücretli bir telefon araması.
  • toll_free: Giriş noktası, ücretsiz telefon görüşmesidir.
entryPoint.entryPointType string
Giriş noktasının türü. Olası değerler: şu:
  • more: Konferansa katılım için ek talimatlar, telefon numaraları da kullanabilirsiniz. Bir konferansta yalnızca bir more giriş noktası; en az bir başka tür varsa bir giriş noktasının da sağlanması gerekir.
  • phone: Konferansta telefon numarası üzerinden oturum açın. Bir konferansta sıfır veya daha fazla phone giriş noktası olabilir. Google Takvim, biçimlendirilip alfabetik olarak sıralanan telefon giriş noktalarının yalnızca ilk ikisini gösterir.
  • sip: SIP üzerinden konferansa katılın. Konferanslar en fazla bir sip giriş noktası olmalıdır.
  • video: Konferansa HTTP üzerinden katılın. Bir konferansta en fazla bir video giriş noktası olabilir.
entryPoint.label string
Giriş noktası URI'si için kullanıcı tarafından görülebilen etiket (yerelleştirilmez).
entryPoint.meetingCode string
Konferansa erişmek için kullanılan toplantı kodu. Maksimum uzunluk 128 karakterdir. Konferans sağlayıcılar genellikle {accessCode, meetingCode, passcode, password, pin} - konferanslara erişim sağlar. Eşleştir ve yalnızca alanları her zaman göster konferans yöneticisi kullanılır.
entryPoint.passcode string
Konferansa erişmek için kullanılan şifre kodu. En çok 128 karakter kullanılabilir. Konferans sağlayıcılar genellikle konferanslara erişim sağlamak için genellikle {accessCode, meetingCode, passcode, password, pin} değerlerinin yalnızca bir alt kümesini kullanır. Eşleştir ve yalnızca alanları göster konferans yöneticisi kullanılır.
entryPoint.password string
Konferansa erişmek için kullanılan şifre. En çok 128 karakter kullanılabilir. Konferans sağlayıcılar genellikle konferanslara erişim sağlamak için genellikle {accessCode, meetingCode, passcode, password, pin} değerlerinin yalnızca bir alt kümesini kullanır. Konferans sağlayıcının kullandığı alanları eşleştirip yalnızca bu alanları gösterin.
entryPoint.pin string
Konferansa erişmek için kullanılan PIN. Maksimum uzunluk 128 karakterdir. Konferans sağlayıcılar genellikle konferanslara erişim sağlamak için genellikle {accessCode, meetingCode, passcode, password, pin} değerlerinin yalnızca bir alt kümesini kullanır. Eşleştir ve yalnızca alanları her zaman göster konferans yöneticisi kullanılır.
entryPoint.regionCode string
Telefon numarasının bölge kodu. URI'de ülke kodu yoksa kullanıcılar tarafından gereklidir. Değerler, genel Bölge kodlarının CLDR listesi
entryPoint.uri string
Giriş noktasının URI'si. Maksimum uzunluk 1.300 karakterdir. Biçimlendirme, giriş noktası türüne bağlıdır:
  • more: http: veya https: gerekir.
  • phone: tel: şeması gereklidir. URI, arama sırasının tamamını içermelidir (ör. "tel:+12345678900,,,12345678;1234").
  • sip: sip: veya sips: gerekir. Örneğin, "sip:12345678@sağlayıcım.com".
  • video: http: veya https: gerekir.

Drive etkinlik nesnesi

Drive etkinlik nesnesi, genel etkinlik nesnesinin kullanıcının Google Drive'ı ve içeriği hakkında bilgi taşıyan kısmıdır. Yalnızca ana uygulama Google Drive ise bir etkinlik nesnesinde bulunur.

Drive etkinlik nesnesi
drive.activeCursorItem Drive item object
Şu anda etkin olan Drive öğesi.
drive.selectedItems[]
list of Drive item objects Drive'da seçilen öğelerin (dosyalar veya klasörler) listesi.

Drive öğesi

Drive öğesi nesneleri, dosya veya klasör gibi belirli Drive öğeleriyle ilgili bilgileri içerir.

Drive öğesi nesnesi
item.addonHasFileScopePermission boolean
true ise eklenti bu öğe için https://www.googleapis.com/auth/drive.file kapsamlı yetkilendirme isteğinde bulunmuş ve bu yetkilendirmeyi almış demektir. Aksi takdirde bu alan false değerini alır.
item.id string
Seçilen öğenin kimliği.
item.iconUrl string
öğe seçildi.
item.mimeType string
Seçilen öğenin MIME türü.
item.title string
Seçilen öğenin başlığı.

Gmail etkinlik nesnesi

Gmail etkinlik nesnesi, genel etkinlik nesnesinin kullanıcının Gmail iletileriyle ilgili bilgileri taşıyan kısmıdır. Yalnızca barındıran uygulama Gmail ise bir etkinlik nesnesinde bulunur.

Gmail etkinlik nesnesi
gmail.accessToken string
Gmail'e özel erişim jetonu. Tekliflerinizi otomatikleştirmek ve optimize etmek için bu jetonu GmailApp.setCurrentMessageAccessToken(accessToken) veya eklentinizin bir kullanıcının şu anda Gmail iletisini açabilir veya eklentinizin yeni taslaklar oluşturmasına izin verebilirsiniz.
gmail.bccRecipients[] list of strings
Varsayılan olarak devre dışıdır. Liste "BCC:" alıcı e-posta adresleri şu anda bir taslakta eklentisi oluşturulur. Bu alanı etkinleştirmek için manifest dosyanızdaki addOns.gmail.composeTrigger.draftAccess alanını METADATA olarak ayarlamanız gerekir.
gmail.ccRecipients[] list of strings
Varsayılan olarak devre dışıdır. Eklentinin oluşturduğu bir taslağa şu anda dahil edilen "CC:" alıcı e-posta adreslerinin listesi. Bu alanı etkinleştirmek için manifest dosyanızdaki addOns.gmail.composeTrigger.draftAccess alanını METADATA olarak ayarlamanız gerekir.
gmail.messageId string
Şu anda açık olan Gmail iletisinin kimliği.
gmail.threadId string
Şu anda açık olan Gmail ileti dizisi kimliği.
gmail.toRecipients[] list of strings
Varsayılan olarak devre dışıdır. Liste "Kime:" alıcı e-posta adresleri şu anda bir taslakta eklentisi oluşturulur. Bu alanı etkinleştirmek için addOns.gmail.composeTrigger.draftAccess alanını METADATA.

Dokümanlar etkinlik nesnesi

Docs etkinlik nesnesi, genel etkinlik nesnesinin bir kullanıcının dokümanı ve içeriği hakkında bilgi taşıyan kısmıdır. Yalnızca etkinlik nesnesini tanımlayın.

Dokümanlar etkinlik nesnesi
docs.id string
Yalnızca https://www.googleapis.com/auth/drive.file kapsamı kullanıcı tarafından yetkilendirilir.
Dokümanın kimliği Dokümanlar kullanıcı arayüzünde açılır.
docs.title string
Yalnızca https://www.googleapis.com/auth/drive.file kapsamı kullanıcı tarafından yetkilendirildi.
Dokümanın başlığı Dokümanlar kullanıcı arayüzünde açılır.
docs.addonHasFileScopePermission boolean
true ise eklenti şu istekte bulundu: ve https://www.googleapis.com/auth/drive.file tarihinde alındı Dokümanlar kullanıcı arayüzünde açık doküman için kapsam yetkilendirmesi; Aksi takdirde bu alanı false.
docs.matchedUrl.url string.
Yalnızca aşağıdaki koşullar karşılandığında mevcuttur:
  • https://www.googleapis.com/auth/workspace.linkpreview, kullanıcı tarafından yetkilendirilmiş olmalıdır.
  • URL, LinkPreviewTriggers tetikleyicisinde belirtilen ana makine kalıbıyla eşleşiyor.

Google Dokümanlar'da önizleme oluşturan bağlantının URL'si. Bu alanı kullanmak için eklentinizin manifest dosyasında LinkPreviewTriggers öğesini yapılandırmanız gerekir. Daha fazla bilgi için Akıllı çiplerle bağlantıları önizleme bölümüne bakın.

Kullanıcı https://www.example.com/12345 bağlantısını önizlediğinde örnek yük:

"docs" : {
  "matchedUrl" : {
      "url" : "https://www.example.com/12345"
  }
}
        

E-Tablolar etkinlik nesnesi

E-Tablolar etkinlik nesnesi, genel etkinlik nesnesinin kullanıcının dokümanı ve içeriği hakkında bilgi taşıyan kısmıdır. Yalnızca etkinlik nesnesini tanımlayın.

E-Tablolar etkinlik nesnesi
sheets.id string
Yalnızca https://www.googleapis.com/auth/drive.file kapsamı kullanıcı tarafından yetkilendirildi. E-tablonun kimliği, E-Tablolar kullanıcı arayüzünde açılır.
sheets.title string
Yalnızca https://www.googleapis.com/auth/drive.file kapsamı kullanıcı tarafından yetkilendirildi. E-Tablolar kullanıcı arayüzünde açık olan e-tablonun başlığı.
sheets.addonHasFileScopePermission boolean
true ise eklenti, E-Tablolar kullanıcı arayüzünde açık olan e-tablo için https://www.googleapis.com/auth/drive.file kapsam yetkilendirmesi istemiş ve almış demektir. Aksi takdirde bu alan false olur.
sheets.matchedUrl.url string
Yalnızca aşağıdaki koşullar karşılanırsa gösterilir:
  • https://www.googleapis.com/auth/workspace.linkpreview, kullanıcı tarafından yetkilendirilmiş olmalıdır.
  • URL, LinkPreviewTriggers tetikleyicisinde belirtilen ana makine kalıbıyla eşleşir.

Google E-Tablolar'da önizleme oluşturan bağlantının URL'si. Bu alanı kullanmak için eklentinizin manifest dosyasında LinkPreviewTriggers öğesini yapılandırmanız gerekir. Daha fazla bilgi için Akıllı çiplerle bağlantıları önizleme bölümüne bakın.

Kullanıcı https://www.example.com/12345 bağlantısını önizlediğinde örnek yük:

"sheets" : {
  "matchedUrl" : {
      "url" : "https://www.example.com/12345"
  }
}
        

Slaytlar etkinlik nesnesi

Slaytlar etkinlik nesnesi, genel etkinlik nesnesinin bir kullanıcının dokümanı ve içeriği hakkında bilgi taşıyan kısmıdır. Yalnızca etkinlik nesnesini tanımlayın.

Slaytlar etkinlik nesnesi
slides.id string
Yalnızca https://www.googleapis.com/auth/drive.file kapsamı kullanıcı tarafından yetkilendirilmişse bulunur. Slaytlar kullanıcı arayüzünde açık olan sununun kimliği.
slides.title string
Yalnızca https://www.googleapis.com/auth/drive.file kapsamı kullanıcı tarafından yetkilendirilmişse bulunur. Slaytlar kullanıcı arayüzünde açık olan sununun başlığı.
slides.addonHasFileScopePermission boolean
true ise eklenti, Slaytlar kullanıcı arayüzünde açık olan sunu için https://www.googleapis.com/auth/drive.file kapsam yetkilendirmesi istemiş ve almış demektir. Aksi takdirde bu alan false olur.
slides.matchedUrl.url string
Yalnızca aşağıdaki koşullar karşılanırsa gösterilir:
  • https://www.googleapis.com/auth/workspace.linkpreview, kullanıcı tarafından yetkilendirilmiş olmalıdır.
  • URL, LinkPreviewTriggers tetikleyicisinde belirtilen ana makine kalıbıyla eşleşir.

Google Slaytlar'da önizleme oluşturan bağlantının URL'si. Bu alanı kullanmak için eklentinizin manifest dosyasında LinkPreviewTriggers öğesini yapılandırmanız gerekir. Daha fazla bilgi için Akıllı çiplerle bağlantıları önizleme bölümüne bakın.

Kullanıcı https://www.example.com/12345 bağlantısını önizlediğinde örnek yük:

"slides" : {
  "matchedUrl" : {
      "url" : "https://www.example.com/12345"
  }
}