একটি ফর্ম বা কুইজ আপডেট করুন

কোনও ফর্মে কন্টেন্ট যোগ করতে বা সেটিংস, মেটাডেটা বা কন্টেন্ট আপডেট করতে, batchUpdate() পদ্ধতি ব্যবহার করুন, যা একটি ব্যাচে পরিবর্তনগুলিকে একসাথে গোষ্ঠীভুক্ত করে যাতে একটি অনুরোধ ব্যর্থ হলে, অন্য কোনও (সম্ভাব্যভাবে নির্ভরশীল) পরিবর্তন লেখা না হয়।

batchUpdate() পদ্ধতিটি একটি প্রতিক্রিয়া বডি প্রদান করে, যার মধ্যে প্রতিটি অনুরোধের জন্য একটি প্রতিক্রিয়া থাকে। প্রতিটি প্রতিক্রিয়া সংশ্লিষ্ট অনুরোধের মতো একই সূচক দখল করে; প্রযোজ্য প্রতিক্রিয়া ছাড়াই অনুরোধগুলির জন্য, সেই সূচকের প্রতিক্রিয়া খালি থাকবে।

শুরু করার আগে

এই পৃষ্ঠার কাজগুলি শুরু করার আগে নিম্নলিখিত কাজগুলি সম্পাদন করুন:

  • আর্লি অ্যাডপ্টার প্রোগ্রামের নির্দেশাবলীতে অনুমোদন/প্রমাণীকরণ এবং শংসাপত্র সেটআপ সম্পূর্ণ করুন।

মেটাডেটা, সেটিংস, অথবা আইটেম আপডেট করুন

নিচের উদাহরণটি দেখায় কিভাবে একটি ফর্মের মেটাডেটা আপডেট করতে হয়, কিন্তু কন্টেন্ট এবং সেটিংসের জন্য কাঠামো একই—তারা updateFormInfo এর পরিবর্তে updateItem বা updateSettings অনুরোধ ব্যবহার করে। প্রতিটি অনুরোধের জন্য, আপনি যে ক্ষেত্রের পরিবর্তন করতে হবে তার নাম এবং আপডেট করা মান, সাথে একটি updateMask মান প্রদান করেন যাতে আপনার নির্দিষ্ট ক্ষেত্রগুলিতে পরিবর্তন সীমিত করা যায়।

বিশ্রাম

ফর্মের বর্ণনা আপডেট করতে, ফর্ম আইডি এবং আপডেট করা বিবরণের মান সহ batchUpdate() পদ্ধতিটি কল করুন।

নমুনা অনুরোধের মূল অংশ

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

পাইথন

ফর্ম/স্নিপেট/update_form.py
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)

নোড.জেএস

ফর্ম/স্নিপেট/আপডেট_ফর্ম.জেএস
import path from 'node:path';
import {authenticate} from '@google-cloud/local-auth';
import {forms} from '@googleapis/forms';

/**
 * Creates a new form and then updates it to add a description.
 */
async function updateForm() {
  // Authenticate with Google and get an authorized client.
  const authClient = await authenticate({
    keyfilePath: path.join(__dirname, 'credentials.json'),
    scopes: 'https://www.googleapis.com/auth/drive',
  });

  // Create a new Forms API client.
  const formsClient = forms({
    version: 'v1',
    auth: authClient,
  });

  // The initial form to be created.
  const newForm = {
    info: {
      title: 'Creating a new form for batchUpdate in Node',
    },
  };

  // Create the new form.
  const createResponse = await formsClient.forms.create({
    requestBody: newForm,
  });

  if (!createResponse.data.formId) throw new Error('Form ID not returned.');

  console.log(`New formId was: ${createResponse.data.formId}`);

  // Request body to add a description to the form.
  const update = {
    requests: [
      {
        updateFormInfo: {
          info: {
            description:
              "Please complete this quiz based on this week's readings for class.",
          },
          // The updateMask specifies which fields to update.
          updateMask: 'description',
        },
      },
    ],
  };

  // Send the batch update request to update the form.
  const result = await formsClient.forms.batchUpdate({
    formId: createResponse.data.formId,
    requestBody: update,
  });

  console.log(result.data);
  return result.data;
}

একটি আইটেম যোগ করুন

নিচের উদাহরণে দেখানো হয়েছে কিভাবে একটি ফর্মে নতুন কন্টেন্ট যোগ করতে হয়। নতুন কন্টেন্ট যোগ করার সময়, আপনাকে অবশ্যই একটি সূচী সহ একটি অবস্থান প্রদান করতে হবে যেখানে নতুন কন্টেন্ট সন্নিবেশ করানো হবে। উদাহরণস্বরূপ, সূচী 0 সহ একটি অবস্থান ফর্মের শুরুতে কন্টেন্ট সন্নিবেশ করবে।

বিশ্রাম

ফর্মে একটি আইটেম যোগ করতে, ফর্ম আইডি, আইটেমের তথ্য এবং নির্বাচিত অবস্থান সহ 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
        }
}]

পাইথন

ফর্ম/স্নিপেট/add_item.py
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)

নোড.জেএস

ফর্ম/স্নিপেট/add_item.js
import path from 'node:path';
import {authenticate} from '@google-cloud/local-auth';
import {forms} from '@googleapis/forms';

/**
 * Creates a new form and adds a video item to it.
 */
async function addItem() {
  // Authenticate with Google and get an authorized client.
  const authClient = await authenticate({
    keyfilePath: path.join(__dirname, 'credentials.json'),
    scopes: 'https://www.googleapis.com/auth/drive',
  });

  // Create a new Forms API client.
  const formsClient = forms({
    version: 'v1',
    auth: authClient,
  });

  // The initial form to be created.
  const newForm = {
    info: {
      title: 'Creating a new form for batchUpdate in Node',
    },
  };

  // Create the new form.
  const createResponse = await formsClient.forms.create({
    requestBody: newForm,
  });

  if (!createResponse.data.formId) {
    throw new Error('Form ID not returned.');
  }

  console.log(`New formId was: ${createResponse.data.formId}`);

  // Request body to add a video item to the 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',
              },
            },
          },
          // The location to insert the new item.
          location: {
            index: 0,
          },
        },
      },
    ],
  };

  // Send the batch update request to add the item to the form.
  const updateResponse = await formsClient.forms.batchUpdate({
    formId: createResponse.data.formId,
    requestBody: update,
  });

  console.log(updateResponse.data);
  return updateResponse.data;
}

অর্ডারের অনুরোধ করুন

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-এ একটি আইটেম থাকে।