이 페이지는 Cloud Translation API를 통해 번역되었습니다.

양식 또는 퀴즈 업데이트

양식에 콘텐츠를 추가하거나 설정, 메타데이터 또는 콘텐츠를 업데이트하려면 batchUpdate() 메서드를 사용합니다. 이 메서드는 변경사항을 일괄적으로 그룹화하므로 한 요청이 실패하면 (잠재적으로 종속된) 다른 변경사항이 기록되지 않습니다.

batchUpdate() 메서드는 각 요청에 대한 응답인 응답 본문을 반환합니다. 각 응답은 해당 요청과 동일한 색인을 차지합니다. 적용 가능한 응답이 없는 요청의 경우 해당 색인의 응답은 비어 있습니다.

시작하기 전에

이 페이지의 작업을 진행하기 전에 다음 작업을 수행합니다.

얼리 어답터 프로그램 안내에서 승인/인증 및 사용자 인증 정보 설정을 완료합니다.

메타데이터, 설정, 항목 업데이트

다음 예시는 양식의 메타데이터를 업데이트하는 방법을 보여주지만 콘텐츠와 설정 구조는 동일합니다. 즉, updateFormInfo 대신 updateItem 또는 updateSettings 요청을 사용합니다. 지정한 필드의 변경을 제한하려면 변경할 필드 이름 및 업데이트된 값과 함께 updateMask 값을 각 요청에 제공합니다.

REST

양식의 설명을 업데이트하려면 양식 ID와 업데이트된 설명 값을 사용하여 batchUpdate() 메서드를 호출합니다.

샘플 요청 본문

    "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에서 보기

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에서 보기

'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;

항목 추가

다음 예는 양식에 새 콘텐츠를 추가하는 방법을 보여줍니다. 새 콘텐츠를 추가할 때는 새 콘텐츠를 삽입해야 하는 위치의 색인을 제공해야 합니다. 예를 들어 색인이 0인 위치는 양식의 시작 부분에 콘텐츠를 삽입합니다.

REST

양식에 항목을 추가하려면 양식 ID, 항목 정보, 원하는 위치를 사용하여 batchUpdate() 메서드를 호출합니다.

샘플 요청 본문

"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에서 보기

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에서 보기

'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;

주문 요청

batchUpdate() 메서드는 createItem 및 updateItem와 같은 하위 요청의 배열을 허용합니다. 하위 요청은 제공된 순서대로 한 번에 하나씩 검증됩니다.

예: batchUpdate 요청에는 2개의 createItem 하위 요청이 있는 requests 배열이 있습니다. 하위 요청 A에는 location.index 0이 있고 하위 요청 B에는 location.index 1이 있습니다. requests 배열이 [A, B]이면 batchUpdate가 성공합니다. 배열이 [B, A]이면 batchUpdate는 실패합니다. 양식에 색인 0에 있는 항목이 이미 포함되어 있지 않으면 location.index 1이 유효하지 않기 때문입니다.