Google Forms APIが正式リリースされたのでさっそく試してみました。

ホーム
Google関連
Google Forms APIが正式リリースされたのでさっそく試してみました。

Google関連

2022.03.22

Google Forms APIが正式リリースされたのでさっそく試してみました。

アンケート等で使用する機会が多いGoogleフォームを、API経由で作成・編集できる「Google Forms API」が正式リリースされたので、さっそく試してみました。

www.publickey1.jp

Google Forms APIが正式リリース。Googleフォームの作成や編集、集計などをプログ...

https://www.publickey1.jp/blog/22/google_forms_apigoogle_1.html

アンケートやクイズなどを簡単に制作できるGoogleフォームをAPI経由で作成、編集できる「Google Forms API」が正式版となったことを、Googleが発表しました。 Introducing the new Google For...

developers.googleblog.com

Introducing the Google Forms API

https://developers.googleblog.com/2022/03/introducing-google-forms-api.html

How to leverage the new Google Forms API for a variety of use cases.

事前準備

Google Cloud Platformのコンソールから「Google Forms API」を有効にしておきます。

APIの実行にはアクセストークンが必要となりますが、以前Power Automate for desktopでフローを作っていたので、そのまま使うことにしました。
(スコープ：https://www.googleapis.com/auth/drive)

2021.09.14

[Power Automate Desktop]Google APIのアクセストークンを取得するフロー

前回の記事でGoogle APIのアクセストークンを取得するPowerShellスクリプトを紹介しました。今回はそのスクリプトをPower Automate Desktop(PAD)のフローに組み込んでみようと思います。 Google APIのアクセスト...

フォームの作成

フォームの作成には(forms).createメソッドを使用します。
今回はFiddler ClassicのComposerでテストすることにしました。

HTTP request

POST https://forms.googleapis.com/v1/forms

Headers

Content-Type: application/json
Authorization: Bearer (アクセストークン)

Request Body

{
  "info": {
      "title": "アンケートフォーム",
      "documentTitle": "新規フォーム"
  }
}

Response Body

問題なく実行された場合はフォームのIDを示す「formId」が返ってきます。後述するbatchUpdateメソッドを実行する際にこのIDが必要となります。

{
  "formId": "********",
  "info": {
    "title": "アンケートフォーム",
    "documentTitle": "新規フォーム"
  },
  "revisionId": "00000002",
  "responderUri": "https://docs.google.com/forms/d/e/********"
}

質問の追加

質問の追加等、フォームの内容を変更する際は(forms).batchUpdateメソッドを使用します。

HTTP request

POST https://forms.googleapis.com/v1/forms/{formId}:batchUpdate

Headers

Content-Type: application/json
Authorization: Bearer (アクセストークン)

Request Body

{
  "requests": [
    {
      "createItem": {
        "item": {
          "title": "好きな動物を教えてください。",
          "questionItem": {
            "question": {
              "required": "True",
              "choiceQuestion": {
                "type": "RADIO",
                "options": [
                  {
                    "value": "イヌ"
                  },
                  {
                    "value": "ネコ"
                  },
                  {
                    "value": "パンダ"
                  },
                  {
                    "value": "タヌキ"
                  }
                ]
              }
            }
          }
        },
        "location": {
          "index": 0
        }
      }
    }
  ]
}

Response Body

{
  "replies": [
    {
      "createItem": {
        "itemId": "******",
        "questionId": [
          "******"
        ]
      }
    }
  ],
  "writeControl": {
    "requiredRevisionId": "00000005"
  }
}

その他、APIの詳細については公式リファレンスをご参照ください。

Google Developers

Google Forms API | Google Developers

https://developers.google.com/forms/api/reference/rest

Google Developers

REST Resource: forms | Forms API | Google Developers

https://developers.google.com/forms/api/reference/rest/v1/forms

以上、Google Forms APIのテストをしてみましたが、簡単にフォームを作成できました。
正式にAPIがリリースされたことで他サービスからフォームの作成や編集が行いやすくなったので、今後はGoogleフォームを利用する機会ももっと増えるのではないでしょうか。

ちなみに、Google Apps Script(GAS)の場合はFormAppクラスが用意されているので、フォームの作成や編集を行う際はこちらを使うと良いでしょう。

function myFunction() {
  const form = FormApp.create("新規フォーム");
  form.setTitle("アンケートフォーム");
  form.addMultipleChoiceItem()
    .setTitle("好きな動物を教えてください。")
    .setChoiceValues(["イヌ", "ネコ", "パンダ", "タヌキ"]);
}