फ़ॉर्म या क्विज़ को अपडेट करना

किसी फ़ॉर्म में कॉन्टेंट जोड़ने या सेटिंग, मेटाडेटा या कॉन्टेंट को अपडेट करने के लिए, batchUpdate() तरीके का इस्तेमाल करें. यह तरीका, बदलावों को एक साथ एक ग्रुप में रखता है, ताकि अगर एक अनुरोध पूरा न हो पाए, तो दूसरे (संभावित रूप से आश्रित) बदलावों को भी न लिखा जाए.

batchUpdate() तरीका, एक रिस्पॉन्स बॉडी दिखाता है. इसमें हर अनुरोध के लिए एक रिस्पॉन्स होता है. हर रिस्पॉन्स, उससे जुड़े अनुरोध के इंडेक्स में होता है. जिन अनुरोधों के लिए कोई रिस्पॉन्स लागू नहीं होता उनके इंडेक्स में रिस्पॉन्स खाली होगा.

शुरू करने से पहले

इस पेज पर दिए गए टास्क शुरू करने से पहले, ये काम करें:

• Early Adopter Program के निर्देशों में दिए गए, अनुमति/पुष्टि करने और क्रेडेंशियल सेट अप करने की प्रोसेस पूरी करें

मेटाडेटा, सेटिंग या आइटम अपडेट करना

नीचे दिए गए उदाहरण में, फ़ॉर्म के मेटाडेटा को अपडेट करने का तरीका बताया गया है. हालांकि, कॉन्टेंट और सेटिंग के लिए भी यही स्ट्रक्चर इस्तेमाल किया जाता है. ये updateFormInfo के बजाय, updateItem या updateSettings अनुरोधों का इस्तेमाल करते हैं. हर अनुरोध के लिए, आपको बदले जाने वाले फ़ील्ड का नाम और अपडेट की गई वैल्यू के साथ-साथ, updateMask वैल्यू भी देनी होगी, ताकि आपके बताए गए फ़ील्ड में ही बदलाव किए जा सकें.

REST

फ़ॉर्म का ब्यौरा अपडेट करने के लिए, फ़ॉर्म आईडी और अपडेट की गई जानकारी की वैल्यू के साथ 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

फ़ॉर्म में कोई आइटम जोड़ने के लिए, फ़ॉर्म आईडी, आइटम की जानकारी, और पसंदीदा जगह के साथ 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 अनुरोध में, दो createItem सब-अनुरोधों वाला requests कलेक्शन होता है. सब-रिक्वेस्ट A में location.index 0 और सब-रिक्वेस्ट B में location.index 1 है. अगर requests ऐरे [A, B] है, तो batchUpdate काम करेगा. अगर ऐरे [B, A] है, तो batchUpdate काम नहीं करेगा, क्योंकि location.index 1 तब तक मान्य नहीं है, जब तक फ़ॉर्म में इंडेक्स 0 पर कोई आइटम पहले से मौजूद न हो.