إنشاء نموذج أو اختبار

توضّح هذه الصفحة كيفية تنفيذ المهام التالية المتعلقة بالنماذج:

• إنشاء نموذج جديد
• إنشاء نسخة مكرّرة من نموذج حالي
• تحويل نموذج إلى اختبار

قبل البدء

نفِّذ المهام التالية قبل المتابعة إلى المهام الواردة في هذه الصفحة:

• أكمِل عملية التفويض أو المصادقة وإعداد بيانات الاعتماد باتّباع التعليمات الواردة في "برنامج الاستخدام المبكر".
• اطّلِع على نظرة عامة على Forms API.

إنشاء نموذج جديد

لا يتطلّب إنشاء نموذج في البداية سوى حقل عنوان، وسيتم تجاهل أي حقول أخرى في الطلب. لإنشاء محتوى وبيانات وصفية لنموذج أو إجراء تعديلات، استخدِم طريقة batchUpdate(). يمكنك الاطّلاع على مقالة تعديل نموذج أو اختبار لمزيد من المعلومات.

REST

استدعِ طريقة forms.create() باستخدام عنوان فقط.

نموذج نص الطلب

{
  "info": {
      "title": "My new form"
  }
}

Python

forms/snippets/create_form.py

عرض على GitHub

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

SCOPES = "https://www.googleapis.com/auth/drive"
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": "My new form",
    },
}
# Prints the details of the sample form
result = form_service.forms().create(body=form).execute()
print(result)

Node.js

forms/snippets/create_form.js

عرض على GitHub

import path from 'node:path';
import {authenticate} from '@google-cloud/local-auth';
import {forms} from '@googleapis/forms';

/**
 * Creates a new form.
 */
async function createForm() {
  // 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 request body to create a new form.
  const newForm = {
    info: {
      title: 'Creating a new form in Node',
    },
  };

  // Send the request to create the form.
  const result = await formsClient.forms.create({
    requestBody: newForm,
  });

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

إنشاء نسخة مكرّرة من نموذج حالي

يمكنك تكرار نموذج حالي باستخدام Google Drive API لتسهيل إعادة استخدام المحتوى. يمكنك العثور على معرّف النموذج في عنوان URL لنموذج Google:

https://docs.google.com/forms/d/FORM_ID/edit

REST

اتّصِل بطريقة files.copy() في Google Drive API مع رقم تعريف النموذج الذي تريد نسخه.

Python

forms/snippets/duplicate_form.py

عرض على GitHub

import os.path

from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# If modifying these scopes, delete the file token.json.
SCOPES = ["https://www.googleapis.com/auth/drive"]


def main():
  """Shows copy file example in Drive v3 API.
  Prints the name, id and other data of the copied file.
  """
  creds = None
  if os.path.exists("token.json"):
    creds = Credentials.from_authorized_user_file("token.json", SCOPES)
  # If there are no (valid) credentials available, let the user log in.
  if not creds or not creds.valid:
    if creds and creds.expired and creds.refresh_token:
      creds.refresh(Request())
    else:
      flow = InstalledAppFlow.from_client_secrets_file(
          "client_secrets.json", SCOPES
      )
      creds = flow.run_local_server(port=0)
    # Save the credentials for the next run
    with open("token.json", "w") as token:
      token.write(creds.to_json())

  service = build("drive", "v3", credentials=creds)

  # Call the Drive v3 API
  origin_file_id = "1ox-6vHFeKpC6mon-tL5ygBC8zpbTnTp76JCZdIg80hA"  # example ID
  copied_file = {"title": "my_copy"}
  results = (
      service.files().copy(fileId=origin_file_id, body=copied_file).execute()
  )
  print(results)


if __name__ == "__main__":
  main()

تحويل نموذج إلى اختبار

لإنشاء اختبار، عليك أولاً إنشاء نموذج كما هو موضّح في إنشاء نموذج جديد، ثم تعديل إعدادات النموذج. يتطلّب التحديث معرّف النموذج.

REST

استدعِ طريقة batch.update() في نموذج حالي لضبط الإعداد isQuiz على "صحيح".

نموذج نص الطلب

{
  "requests": [
    {
      "updateSettings": {
        "settings": {
          "quizSettings": {
            "isQuiz": True
          }
        },
       "updateMask": "quizSettings.isQuiz"
      }
    }
  ]
}

Python

forms/snippets/convert_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": "My new quiz",
    }
}

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

# JSON to convert the form into a quiz
update = {
    "requests": [
        {
            "updateSettings": {
                "settings": {"quizSettings": {"isQuiz": True}},
                "updateMask": "quizSettings.isQuiz",
            }
        }
    ]
}

# Converts the form into a quiz
question_setting = (
    form_service.forms()
    .batchUpdate(formId=result["formId"], body=update)
    .execute()
)

# Print the result to see it's now a quiz
getresult = form_service.forms().get(formId=result["formId"]).execute()
print(getresult)

Node.js

forms/snippets/convert_form.js

عرض على GitHub

import path from 'node:path';
import {authenticate} from '@google-cloud/local-auth';
import {forms} from '@googleapis/forms';

/**
 * Creates a new form and then converts it into a quiz.
 */
async function convertForm() {
  // 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('Failed to create form.');
  }

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

  // Request body to convert the form to a quiz.
  const updateRequest = {
    requests: [
      {
        updateSettings: {
          settings: {
            quizSettings: {
              isQuiz: true,
            },
          },
          // The updateMask specifies which fields to update.
          updateMask: 'quizSettings.isQuiz',
        },
      },
    ],
  };

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

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

الخطوات التالية

في ما يلي بعض الخطوات التالية التي يمكنك تجربتها:

• لإضافة محتوى النموذج أو تعديله، يُرجى الرجوع إلى مقالة تعديل نموذج أو اختبار.
• لعرض معلومات النموذج أو الردود، يُرجى الرجوع إلى استرداد النماذج والردود.
• لنشر النموذج وإدارة المجيبين، يُرجى الرجوع إلى مقالة نشر النموذج وإدارة المجيبين.