Class GridItem

GridItem

Yanıtlayanın bir dizi radyo düğmesinden satır başına bir seçenek belirlemesine olanak tanıyan, sütun ve satır tablosu olarak sunulan bir soru öğesidir. Öğelere Form üzerinden erişilebilir veya bu platformda öğe oluşturulabilir. 

// Open a form by ID and add a new grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addGridItem();
item.setTitle('Rate your interests')
    .setRows(['Cars', 'Computers', 'Celebrities'])
    .setColumns(['Boring', 'So-so', 'Interesting']);

Yöntemler

YöntemDönüş türüKısa açıklama
clearValidation()GridItemBu ızgara öğesiyle ilgili tüm veri doğrulamayı kaldırır.
createResponse(responses)ItemResponseBu ızgara öğesi için yeni bir ItemResponse oluşturur.
duplicate()GridItemBu öğenin bir kopyasını oluşturur ve formun sonuna ekler.
getColumns()String[]Izgaradaki her sütunun değerlerini alır.
getHelpText()StringÖğenin yardım metnini (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni olarak da adlandırılır) alır.
getId()IntegerÖğenin benzersiz tanımlayıcısını alır.
getIndex()IntegerFormdaki tüm öğeler arasında öğenin dizinini alır.
getRows()String[]Izgaradaki her satırın değerlerini alır.
getTitle()StringÖğenin başlığını alır (bazen SectionHeaderItem durumunda üstbilgi metni olarak adlandırılır).
getType()ItemTypeÖğenin türünü ItemType olarak alır.
isRequired()BooleanKatılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.
setColumns(columns)GridItemIzgaranın sütunlarını bir değer dizisine göre ayarlar.
setHelpText(text)GridItemÖğenin yardım metnini (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni olarak da adlandırılır) ayarlar.
setRequired(enabled)GridItemKatılımcının soruyu yanıtlamasının zorunlu olup olmadığını belirler.
setRows(rows)GridItemIzgaranın satırlarını bir değer dizisine göre ayarlar.
setTitle(title)GridItemÖğenin başlığını ayarlar (bazen SectionHeaderItem durumunda başlık metni olarak adlandırılır).
setValidation(validation)GridItemBu ızgara öğesi için veri doğrulama ayarlarını belirler.

Ayrıntılı belgeler

clearValidation()

Bu ızgara öğesiyle ilgili tüm veri doğrulamayı kaldırır.

Return

GridItem: Zincirleme için bu öğe

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

createResponse(responses)

Bu ızgara öğesi için yeni bir ItemResponse oluşturur. responses bağımsız değişkeni, ızgaradaki satır sayısı kadar değer içeren bir String[] dizisi olmalıdır. Zorunlu olmayan bir ızgara sorusu için null öğesi, ilgili satıra yanıt verilmediğini gösterir. Değerlerden herhangi biri geçerli bir seçenekle eşleşmezse istisna oluşturur.

Parametreler

AdTürAçıklama
responsesString[]Bu ızgara öğesi için geçerli yanıtlar dizisi

Return

ItemResponse: Öğenin yanıtı

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

duplicate()

Bu öğenin bir kopyasını oluşturur ve formun sonuna ekler.

Return

GridItem: Zincirleme için bu GridItem öğesinin kopyası

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getColumns()

Izgaradaki her sütunun değerlerini alır.

Return

String[]: Yanıtlayanların formu görüntülerken etiket olarak gördüğü sütun değerleri dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getHelpText()

Öğenin yardım metnini (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni olarak da adlandırılır) alır.

Return

String — öğenin yardım metni veya açıklama metni

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getId()

Öğenin benzersiz tanımlayıcısını alır.

Return

Integer: Öğenin kimliği

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getIndex()

Formdaki tüm öğeler arasında öğenin dizinini alır.

Return

Integer: Öğenin dizini

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getRows()

Izgaradaki her satırın değerlerini alır.

Return

String[]: Yanıtlayanların formu görüntülerken etiket olarak gördüğü satır değerleri dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getTitle()

Öğenin başlığını alır (bazen SectionHeaderItem durumunda üstbilgi metni olarak adlandırılır).

Return

String: Öğenin başlığı veya başlık metni

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getType()

Öğenin türünü ItemType olarak alır.

Return

ItemType: Öğenin türü

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

isRequired()

Katılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.

Return

Boolean: Katılımcının soruyu yanıtlaması gerekip gerekmediği

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setColumns(columns)

Izgaranın sütunlarını bir değer dizisine göre ayarlar. Belirtilen dizi boşsa istisna oluşturur.

Parametreler

AdTürAçıklama
columnsString[]Yanıtlayanların formu görüntülerken etiket olarak gördüğü sütun değerleri dizisi

Return

GridItem: Zincirleme için bu öğe

Verdiği hatalar

Error: Belirtilen dizi null veya boşsa

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setHelpText(text)

Öğenin yardım metnini (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni olarak da adlandırılır) ayarlar.

Parametreler

AdTürAçıklama
textStringyeni yardım metni

Return

GridItem: Zincirleme için bu GridItem

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setRequired(enabled)

Katılımcının soruyu yanıtlamasının zorunlu olup olmadığını belirler.

Parametreler

AdTürAçıklama
enabledBooleanKatılımcının soruyu yanıtlaması gerekip gerekmediği

Return

GridItem: Geçerli öğe (zincirleme için)

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setRows(rows)

Izgaranın satırlarını bir değer dizisine göre ayarlar. Belirtilen dizi boşsa istisna oluşturur.

Parametreler

AdTürAçıklama
rowsString[]Yanıtlayanların formu görüntülerken etiket olarak gördüğü satır değerleri dizisi

Return

GridItem: Zincirleme için bu öğe

Verdiği hatalar

Error: Belirtilen dizi null veya boşsa

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setTitle(title)

Öğenin başlığını ayarlar (bazen SectionHeaderItem durumunda başlık metni olarak adlandırılır).

Parametreler

AdTürAçıklama
titleStringYeni başlık veya başlık metni

Return

GridItem: Zincirleme için bu GridItem

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setValidation(validation)

Bu ızgara öğesi için veri doğrulama ayarlarını belirler. null veya hiçbir require işlevinin çağrılmadığı bir GridValidation örneği iletmek, önceki tüm doğrulamaları kaldırır.

Parametreler

AdTürAçıklama
validationGridValidationBu öğeye uygulanacak bir GridValidation.

Return

GridItem: Zincirleme için bu GridItem

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms