Formu veya testi güncelleme

Bir forma içerik eklemek veya ayarları, meta verileri ya da içeriği güncellemek için batchUpdate() yöntemini kullanın. Bu yöntem, değişiklikleri bir grup halinde gruplandırır. Böylece, bir istek başarısız olursa diğer (bağlı olabilecek) değişikliklerden hiçbiri yazılmaz.

batchUpdate() yöntemi, her istek için bir yanıtın bulunduğu bir yanıt gövdesi döndürür. Her yanıt, ilgili istekle aynı dizini kaplar. Geçerli yanıtı olmayan istekler için söz konusu dizindeki yanıt boş olur.

Başlamadan önce

Bu sayfadaki görevlere devam etmeden önce aşağıdaki görevleri gerçekleştirin:

• Erken Kullanıcı Programı talimatlarında yetkilendirme/kimlik doğrulama ve kimlik bilgisi ayarlarını tamamlayın

Meta verileri, ayarları veya öğeleri güncelleme

Aşağıdaki örnekte, bir formun meta verilerinin nasıl güncelleneceği gösterilmektedir. Ancak yapı, içerik ve ayarlar için aynıdır. Bu örneklerde updateFormInfo yerine updateItem veya updateSettings istekleri kullanılır. Her istek için, değiştirilecek alanın adını ve güncellenen değeri, belirttiğiniz alanlardaki değişiklikleri sınırlamak için bir updateMask değeriyle birlikte sağlarsınız.

REST

Formun açıklamasını güncellemek için form kimliğini ve güncellenmiş açıklama değerini kullanarak batchUpdate() yöntemini çağırın.

Örnek istek metni

    "requests": [{
        "updateFormInfo": {
            "info": {
                "description": "Please complete this quiz based on this week's readings for class."
            },
            "updateMask": "description"
        }
    }]

Python

forms/snippets/update_form.py

GitHub'da göster

from apiclient import discovery
from httplib2 import Http
from oauth2client import client, file, tools

SCOPES = "https://www.googleapis.com/auth/forms.body"
DISCOVERY_DOC = "https://forms.googleapis.com/$discovery/rest?version=v1"

store = file.Storage("token.json")
creds = None
if not creds or creds.invalid:
  flow = client.flow_from_clientsecrets("client_secrets.json", SCOPES)
  creds = tools.run_flow(flow, store)

form_service = discovery.build(
    "forms",
    "v1",
    http=creds.authorize(Http()),
    discoveryServiceUrl=DISCOVERY_DOC,
    static_discovery=False,
)

form = {
    "info": {
        "title": "Update metadata example for Forms API!",
    }
}

# Creates the initial Form
createResult = form_service.forms().create(body=form).execute()

# Request body to add description to a Form
update = {
    "requests": [
        {
            "updateFormInfo": {
                "info": {
                    "description": (
                        "Please complete this quiz based on this week's"
                        " readings for class."
                    )
                },
                "updateMask": "description",
            }
        }
    ]
}

# Update the form with a description
question_setting = (
    form_service.forms()
    .batchUpdate(formId=createResult["formId"], body=update)
    .execute()
)

# Print the result to see it now has a description
getresult = form_service.forms().get(formId=createResult["formId"]).execute()
print(getresult)

Node.js

forms/snippets/update_form.js

GitHub'da göster

'use strict';

const path = require('path');
const google = require('@googleapis/forms');
const {authenticate} = require('@google-cloud/local-auth');

async function runSample(query) {
  const authClient = await authenticate({
    keyfilePath: path.join(__dirname, 'credentials.json'),
    scopes: 'https://www.googleapis.com/auth/drive',
  });
  const forms = google.forms({
    version: 'v1',
    auth: authClient,
  });
  const newForm = {
    info: {
      title: 'Creating a new form for batchUpdate in Node',
    },
  };
  const createResponse = await forms.forms.create({
    requestBody: newForm,
  });
  console.log('New formId was: ' + createResponse.data.formId);

  // Request body to add description to a Form
  const update = {
    requests: [
      {
        updateFormInfo: {
          info: {
            description:
              'Please complete this quiz based on this week\'s readings for class.',
          },
          updateMask: 'description',
        },
      },
    ],
  };
  const res = await forms.forms.batchUpdate({
    formId: createResponse.data.formId,
    requestBody: update,
  });
  console.log(res.data);
  return res.data;
}

if (module === require.main) {
  runSample().catch(console.error);
}
module.exports = runSample;

Öğe ekleyin

Aşağıdaki örnekte, bir forma nasıl yeni içerik ekleneceği gösterilmektedir. Yeni içerik eklerken, yeni içeriğin ekleneceği bir dizine sahip bir konum sağlamanız gerekir. Örneğin, 0 dizine sahip bir konum, içeriği formun başına ekler.

REST

Forma öğe eklemek için form kimliği, öğenin bilgileri ve istenen konumu belirterek batchUpdate() yöntemini çağırın.

Örnek istek metni

"requests": [{
    "createItem": {
        "item": {
            "title": "Homework video",
            "description": "Quizzes in Google Forms",
            "videoItem": {
                "video": {
                     "youtubeUri": "https://www.youtube.com/watch?v=Lt5HqPvM-eI"
                }
            }},
        "location": {
          "index": 0
        }
}]

Python

forms/snippets/add_item.py

GitHub'da göster

from apiclient import discovery
from httplib2 import Http
from oauth2client import client, file, tools

SCOPES = "https://www.googleapis.com/auth/forms.body"
DISCOVERY_DOC = "https://forms.googleapis.com/$discovery/rest?version=v1"

store = file.Storage("token.json")
creds = None
if not creds or creds.invalid:
  flow = client.flow_from_clientsecrets("client_secrets.json", SCOPES)
  creds = tools.run_flow(flow, store)

form_service = discovery.build(
    "forms",
    "v1",
    http=creds.authorize(Http()),
    discoveryServiceUrl=DISCOVERY_DOC,
    static_discovery=False,
)

form = {
    "info": {
        "title": "Update item example for Forms API",
    }
}

# Creates the initial Form
createResult = form_service.forms().create(body=form).execute()

# Request body to add a video item to a Form
update = {
    "requests": [
        {
            "createItem": {
                "item": {
                    "title": "Homework video",
                    "description": "Quizzes in Google Forms",
                    "videoItem": {
                        "video": {
                            "youtubeUri": (
                                "https://www.youtube.com/watch?v=Lt5HqPvM-eI"
                            )
                        }
                    },
                },
                "location": {"index": 0},
            }
        }
    ]
}

# Add the video to the form
question_setting = (
    form_service.forms()
    .batchUpdate(formId=createResult["formId"], body=update)
    .execute()
)

# Print the result to see it now has a video
result = form_service.forms().get(formId=createResult["formId"]).execute()
print(result)

Node.js

forms/snippets/add_item.js

GitHub'da göster

'use strict';

const path = require('path');
const google = require('@googleapis/forms');
const {authenticate} = require('@google-cloud/local-auth');

async function runSample(query) {
  const authClient = await authenticate({
    keyfilePath: path.join(__dirname, 'credentials.json'),
    scopes: 'https://www.googleapis.com/auth/drive',
  });
  const forms = google.forms({
    version: 'v1',
    auth: authClient,
  });
  const newForm = {
    info: {
      title: 'Creating a new form for batchUpdate in Node',
    },
  };
  const createResponse = await forms.forms.create({
    requestBody: newForm,
  });
  console.log('New formId was: ' + createResponse.data.formId);

  // Request body to add video item to a Form
  const update = {
    requests: [
      {
        createItem: {
          item: {
            title: 'Homework video',
            description: 'Quizzes in Google Forms',
            videoItem: {
              video: {
                youtubeUri: 'https://www.youtube.com/watch?v=Lt5HqPvM-eI',
              },
            },
          },
          location: {
            index: 0,
          },
        },
      },
    ],
  };
  const updateResponse = await forms.forms.batchUpdate({
    formId: createResponse.data.formId,
    requestBody: update,
  });
  console.log(updateResponse.data);
  return updateResponse.data;
}

if (module === require.main) {
  runSample().catch(console.error);
}
module.exports = runSample;

Sipariş isteği

batchUpdate() yöntemi, createItem ve updateItem gibi bir dizi alt istek kabul eder. Alt istekler, sağlandıkları sırada tek tek doğrulanır.

Örnek: Bir batchUpdate isteğinde, iki createItem alt isteği içeren bir requests dizisi vardır. A alt isteği location.index 0, B alt isteği ise location.index 1 değerine sahiptir. requests dizisi [A, B] ise batchUpdate başarılı olur. Dizi [B, A] ise form 0 dizininde zaten bir öğe içermediği sürece location.index1 geçerli olmadığından batchUpdate başarısız olur.