Bu sayfa, Cloud Translation API ile çevrilmiştir.

Class FormResponse

Formun tamamına verilen yanıt. FormResponse üç şekilde kullanılabilir: Bir katılımcı tarafından gönderilen yanıtlara erişmek için (getItemResponses() bölümüne bakın), forma programatik olarak yanıt göndermek için (withItemResponse(response) ve submit() bölümlerine bakın) ve sağlanan yanıtları kullanarak alanları önceden dolduran bir form URL'si oluşturmak için. FormResponse'ler Form'den oluşturulabilir veya buraya erişilebilir.

// Open a form by ID and log the responses to each question.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const formResponses = form.getResponses();
for (let i = 0; i < formResponses.length; i++) {
  const formResponse = formResponses[i];
  const itemResponses = formResponse.getItemResponses();
  for (let j = 0; j < itemResponses.length; j++) {
    const itemResponse = itemResponses[j];
    Logger.log(
        'Response #%s to the question "%s" was "%s"',
        (i + 1).toString(),
        itemResponse.getItem().getTitle(),
        itemResponse.getResponse(),
    );
  }
}

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`getEditResponseUrl()`	`String`	Daha önce gönderilmiş bir yanıtı düzenlemek için kullanılabilecek bir URL oluşturur.
`getGradableItemResponses()`	`ItemResponse[]`	Bir form yanıtında yer alan tüm öğe yanıtlarını, öğelerin formda göründüğü sırayla alır.
`getGradableResponseForItem(item)`	`ItemResponse`	Belirli bir öğe için form yanıtında yer alan öğe yanıtını alır.
`getId()`	`String`	Form yanıtının kimliğini alır.
`getItemResponses()`	`ItemResponse[]`	Bir form yanıtında yer alan tüm öğe yanıtlarını, öğelerin formda göründüğü sırayla alır.
`getRespondentEmail()`	`String`	`Form.setCollectEmail(collect)` ayarı etkinse yanıt gönderen kişinin e-posta adresini alır.
`getResponseForItem(item)`	`ItemResponse`	Belirli bir öğe için bu form yanıtında yer alan öğe yanıtını alır.
`getTimestamp()`	`Date`	Form yanıtı gönderiminin zaman damgasını alır.
`submit()`	`FormResponse`	Yanıtı gönderir.
`toPrefilledUrl()`	`String`	Bu form yanıtındaki yanıtlara göre yanıtların önceden doldurulduğu formun URL'sini oluşturur.
`withItemGrade(gradedResponse)`	`FormResponse`	Belirtilen öğe yanıtının notlarını bir form yanıtına ekler.
`withItemResponse(response)`	`FormResponse`	Belirtilen öğe yanıtını bir form yanıtına ekler.

Ayrıntılı dokümanlar

`getEditResponseUrl()`

Daha önce gönderilmiş bir yanıtı düzenlemek için kullanılabilecek bir URL oluşturur. Form.setAllowResponseEdits(enabled) ayarı devre dışıysa bağlantı, form yanıtlarının düzenlenmesinin devre dışı olduğunu açıklayan bir sayfaya yönlendirir. Bağlantıyı ziyaret eden herkes yanıtı düzenleyebilir. Ancak Form.setRequireLogin(requireLogin) ayarı etkinse form erişimi olan bir hesaba sahip olmaları gerekir. Form.setCollectEmail(collect)Ayarı etkinleştirilirse form, orijinal katılımcının e-posta adresi yerine yanıtı düzenleyen kullanıcının e-posta adresini kaydeder.

Komut dosyasının oluşturduğu ancak henüz göndermediği bir form yanıtı için bu yöntem null değerini döndürür.

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets the first form response.
const formResponse = form.getResponses()[0];

// Gets the edit URL for the first form response and logs it to the console.
const editUrl = formResponse.getEditResponseUrl();
console.log(editUrl);

Return

String: Gönderilen bir yanıtı değiştirmek için kullanılan URL.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getGradableItemResponses()`

Bir form yanıtında yer alan tüm öğe yanıtlarını, öğelerin formda göründüğü sırayla alır. Bu yöntem getItemResponses() ile benzer şekilde çalışır ancak eksik bir yanıtın notlandırılmasına izin vermek için gerçek bir yanıt olmasa bile ilgili Item notlandırılabiliyorsa (yani puan değeri varsa) ItemResponse döndürür. Ancak Item derecelendirilemiyorsa bu yöntem, söz konusu öğeyi döndürülen dizisinden hariç tutar.

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets an array of the form's responses.
const formResponses = form.getResponses();

// Gets the item responses contained in each form response.
for (const formResponse of formResponses) {
  const gradableItemsResponses = formResponse.getGradableItemResponses();

  // Logs the title and score for each item response to the console.
  for (const gradableItemsResponse of gradableItemsResponses) {
    console.log(`${gradableItemsResponse.getItem().getTitle()}
       score ${gradableItemsResponse.getScore()}`);
  }
}

Return

ItemResponse[]: Formdaki her soru öğesine verilen ve katılımcının puan alabileceği yanıtların dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getGradableResponseForItem(item)`

Belirli bir öğe için form yanıtında yer alan öğe yanıtını alır. Bu yöntem getResponseForItem(item) ile benzer şekilde çalışır ancak eksik bir yanıtın notlandırılmasına izin vermek için gerçek bir yanıt olmasa bile ilgili Item notlandırılabiliyorsa (yani puan değeri varsa) yine de ItemResponse döndürür. Ancak Item notlandırılamıyorsa bu yöntem null değerini döndürür.

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets an array of the form's responses.
const formResponses = form.getResponses();

// Gets the item responses contained in a form response.
for (const formResponse of formResponses) {
  const formItemResponses = formResponse.getGradableItemResponses();

  // Logs the title and score for responses to the first item of the form.
  const itemResponse = formResponse.getGradableResponseForItem(
      formItemResponses[0].getItem(),
  );
  console.log(
      `${itemResponse.getItem().getTitle()} score ${itemResponse.getScore()}`,
  );
}

Parametreler

Ad	Tür	Açıklama
`item`	`Item`

Return

ItemResponse: Belirli bir öğe için verilen yanıt veya öğe notlandırılmamışsa null.

`getId()`

Form yanıtının kimliğini alır. Form yanıtı gönderilmediyse bu yöntem null değerini döndürür.

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets an array of the form's responses.
const formResponses = form.getResponses();

// Loops through the form responses and logs the ID for each form response to
// the console.
for (const formResponse of formResponses) {
  console.log(`Response ID: ${formResponse.getId()}`);
}

Return

String: Form yanıtının kimliğidir. Form yanıtı gönderilmediyse null değerini alır.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getItemResponses()`

Bir form yanıtında yer alan tüm öğe yanıtlarını, öğelerin formda göründüğü sırayla alır. Form yanıtı belirli bir TextItem, DateItem, TimeItem veya ParagraphTextItem için yanıt içermiyorsa söz konusu öğe için döndürülen ItemResponse yanıtında boş bir dize bulunur. Form yanıtında başka bir öğe türü için yanıt atlanmışsa bu yöntem, söz konusu öğeyi döndürülen dizisinden hariç tutar.

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets the responses to the form.
const formResponses = form.getResponses();

// Iterates over the responses.
for (const formResponse of formResponses) {
  // Gets the item responses from each form response.
  const itemResponses = formResponse.getItemResponses();

  // Iterates over the item responses.
  for (const itemResponse of itemResponses) {
    // Logs the items' questions and responses to the console.
    console.log(
        `Response to the question '${itemResponse.getItem().getTitle()}' was
      '${itemResponse.getResponse()}'`);
  }
}

Return

ItemResponse[]: Formdaki her soru öğesine yanıt veren katılımcıların yanıtları dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getRespondentEmail()`

Form.setCollectEmail(collect) ayarı etkinse yanıt gönderen kişinin e-posta adresini alır.

Komut dosyasının oluşturduğu ancak henüz göndermediği bir form yanıtı için bu yöntem null değerini döndürür.

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets an array of the form's responses.
const formResponses = form.getResponses();

// Loops through the responses and logs each respondent's email to the console.
// To collect respondent emails, ensure that Form.setCollectEmail(collect) is
// set to true.
for (const formResponse of formResponses) {
  console.log(`Respondent Email: ${formResponse.getRespondentEmail()}`);
}

Return

String: Varsa bu yanıtı gönderen kişinin e-posta adresidir. Komut dosyası bu yanıtı oluşturduysa ancak henüz göndermediyse null olur.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getResponseForItem(item)`

Belirli bir öğe için bu form yanıtında yer alan öğe yanıtını alır.

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets the first item on the form.
const item = form.getItems()[0];

// Gets an array of the form's responses.
const formResponses = form.getResponses();

// Loops through the responses and logs each response to the first item to the
// console.
for (const formResponse of formResponses) {
  const itemResponse = formResponse.getResponseForItem(item);
  console.log(itemResponse.getResponse());
}

Parametreler

Ad	Tür	Açıklama
`item`	`Item`

Return

ItemResponse: Belirli bir öğe için yanıt veya öğe yoksa null.

`getTimestamp()`

Form yanıtı gönderiminin zaman damgasını alır.

Komut dosyasının oluşturduğu ancak henüz göndermediği bir form yanıtı için bu yöntem null değerini döndürür.

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets an array of the form's responses.
const formResponses = form.getResponses();

// Loops through the responses and logs the timestamp of each response to the
// console.
for (const formResponse of formResponses) {
  console.log(`Timestamp: ${formResponse.getTimestamp()}`);
}

Return

Date: Bu yanıtın gönderildiği zaman damgası veya komut dosyası bu yanıtı oluşturduysa ancak henüz göndermediyse null.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`submit()`

Yanıtı gönderir. Yanıt daha önce gönderilmişse komut dosyası istisnası oluşturur.

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Creates an empty response for the form.
const formResponse = form.createResponse();

// Submits an empty response.
formResponse.submit();

Return

FormResponse: Formun yanıt deposuna kaydedilen yeni oluşturulmuş bir yanıt.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`toPrefilledUrl()`

Bu form yanıtındaki yanıtlara göre yanıtların önceden doldurulduğu formun URL'sini oluşturur.

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets the first form response.
const formResponse = form.getResponses()[0];

// Generates and logs the URL of a pre-filled form response based on the answers
// of the first form response.
const prefilledUrl = formResponse.toPrefilledUrl();
console.log(prefilledUrl);

Return

String: Önceden doldurulmuş yanıtları içeren bir formun URL'sidir.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`withItemGrade(gradedResponse)`

Belirtilen öğe yanıtının notlarını bir form yanıtına ekler. Bu yöntem yalnızca daha önce gönderilmiş form yanıtları için geçerlidir ve yalnızca depolanan notlar gönderildikten sonra notları etkiler. Bu yöntem de yalnızca öğe yanıtının notlarını günceller. Gerçek yanıtı etkilemez (yanıt zaten gönderilmiş olduğundan). Bu yöntem aynı öğe için birden çok kez çağrılırsa yalnızca son not saklanır. ItemResponse hiçbir not içermiyorsa bu yöntem, öğenin notlarını kaldırır.

// Programmatically award partial credit for a given response
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const formResponses = form.getResponses();
const formItems = form.getItems();
for (const formResponse of formResponses) {
  for (const item of formItems) {
    const points = item.asMultipleChoiceItem().getPoints();
    const itemResponse = formResponse.getGradableResponseForItem(item);
    Logger.log('Award half credit for answers containing the word "Kennedy"');
    const answer = itemResponse.getResponse();

    if (answer?.includes('Kennedy')) {
      itemResponse.setScore(points / 2);
      formResponse.withItemGrade(itemResponse);
    }
  }
}
form.submitGrades(formResponses);

Parametreler

Ad	Tür	Açıklama
`gradedResponse`	`ItemResponse`

Return

FormResponse: Zincirleme için bu FormResponse

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`withItemResponse(response)`

Belirtilen öğe yanıtını bir form yanıtına ekler. Bu yöntem yalnızca komut dosyasının oluşturduğu ancak henüz göndermediği form yanıtları için geçerlidir. Depolanan yanıtları etkileyemez. Bu yöntem aynı öğe için birden çok kez çağrılırsa yalnızca son öğe yanıtı saklanır.

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Creates a response for the form.
const formResponse = form.createResponse();

// Appends a checkbox item to the form.
const item = form.addCheckboxItem();

// Sets the title of the item to 'Which items are ice cream flavors?'
item.setTitle('Which items are ice cream flavors?');

// Sets choices for the item.
item.setChoices([
  item.createChoice('Vanilla'),
  item.createChoice('Strawberry'),
  item.createChoice('Brick'),
]);

// Creates a response for the item.
const response = item.createResponse(['Vanilla', 'Strawberry']);

// Adds the item response to the form response.
formResponse.withItemResponse(response);

// Submits the form response.
formResponse.submit();

Parametreler

Ad	Tür	Açıklama
`response`	`ItemResponse`

Return

FormResponse: Zincirleme için bu FormResponse.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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