Merge pull request #107 from GiganticMinecraft/feat/addAnswerTitle

フォームに対する回答にタイトルを付与できるようにする

schema/paths/forms/[formId]/index.yml

@@ -50,6 +50,7 @@ patch:
     - $ref: "../../../types/forms/parameters.yml#/parameters/start_at"
     - $ref: "../../../types/forms/parameters.yml#/parameters/end_at"
     - $ref: "../../../types/forms/parameters.yml#/parameters/webhook_url"
+    - $ref: "../../../types/forms/parameters.yml#/parameters/default_title"
   responses:
     "200":
       description: 指定されたFormの更新に成功

schema/types/forms/components.yml

@@ -35,6 +35,12 @@ components:
     webhook_url:
       description: webhookのURL
       type: string
+    default_title:
+      description: |
+        フォームに回答された内容に対して設定されるタイトル。
+        これが設定されていないとタイトルは「未設定」となります。
+      type: string
+      example: 未設定
     settings:
       description: フォームの設定
       type: object
@@ -43,6 +49,8 @@ components:
           $ref: "#/components/schemas/response_period"
         webhook_url:
           $ref: "#/components/schemas/webhook_url"
+        default_title:
+          $ref: "#/components/schemas/default_title"
     created_at:
       description: フォームの作成日時
       type: string

schema/types/forms/definitions.yml

@@ -55,6 +55,11 @@ definitions:
       timestamp:
         type: string
         format: date-time
+      title:
+        type: string
+        description: titleをnullにするとデフォルト設定が適用
+        example: "[hoge] 整地の心得違反"
+        nullable: true
       answers:
         type: array
         uniqueItems: true

schema/types/forms/parameters.yml

@@ -49,6 +49,16 @@ parameters:
     required: false
     schema:
       $ref: "./components.yml#/components/schemas/webhook_url"
+  default_title:
+    name: defaultTitle
+    in: query
+    description: |
+      各回答に対してつけられるタイトル。
+      $[question_id]と指定することで質問のquestion_idに対応する回答を埋め込むことができます。
+      デフォルト値: 未設定
+    required: false
+    schema:
+      $ref: "./components.yml#/components/schemas/default_title"
   form_label_target:
     name: target
     in: query