Class GridItem

GridItem

Sütun ve satır tablosu olarak sunulan bir soru öğesidir. Yanıt veren kişinin bir dizi radyo düğmesinden satır başına bir seçenek belirlemesine olanak tanır. Öğ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öntem	Dönüş türü	Kısa açıklama
clearValidation()	GridItem	Bu ızgara öğesiyle ilgili tüm veri doğrulamayı kaldırır.
createResponse(responses)	ItemResponse	Bu ızgara öğesi için yeni bir ItemResponse oluşturur.
duplicate()	GridItem	Bu öğ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()	Integer	Öğenin formdaki tüm öğeler arasındaki 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()	Boolean	Katılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.
setColumns(columns)	GridItem	Izgaranı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)	GridItem	Katılımcının soruyu yanıtlamasının zorunlu olup olmadığını belirler.
setRows(rows)	GridItem	Izgaranın satırlarını bir değer dizisine göre ayarlar.
setTitle(title)	GridItem	Öğenin başlığını (bazen SectionHeaderItem durumunda başlık metni olarak da adlandırılır) ayarlar.
setValidation(validation)	GridItem	Bu ı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

Ad	Tür	Açıklama
responses	String[]	Bu ızgara öğesi için geçerli cevaplar 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()

Öğenin formdaki tüm öğeler arasındaki 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

Ad	Tür	Açıklama
columns	String[]	Yanıtlayanların formu görüntülerken etiket olarak gördüğü sütun değerleri dizisi

Return

GridItem: Zincirleme için bu öğe

Battaniyeler

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

Ad	Tür	Açıklama
text	String	yeni yardım metni

Return

GridItem: Zincirleme için 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

Ad	Tür	Açıklama
enabled	Boolean	Katı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

Ad	Tür	Açıklama
rows	String[]	Satır değerleri dizisi. Yanıtlayanlar, formu görüntülerken bu değerleri etiket olarak görür.

Return

GridItem: Zincirleme için bu öğe

Battaniyeler

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ı (bazen SectionHeaderItem durumunda başlık metni olarak da adlandırılır) ayarlar.

Parametreler

Ad	Tür	Açıklama
title	String	Yeni başlık veya başlık metni

Return

GridItem: Zincirleme için 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

Ad	Tür	Açıklama
validation	GridValidation	Bu öğeye uygulanacak bir GridValidation.

Return

GridItem: Zincirleme için 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