Add item

googleForms.addItem appends or inserts any supported Forms item.

Example

import { automation, onDashboardRun } from "automate.ax"
import { googleForms } from "automate.ax/google-forms"

export default automation("Add a survey section", () => {
  onDashboardRun({ title: "Add a survey section" })

  googleForms.addItem({
    form: "form-id",
    item: {
      type: "grid",
      title: "Rate the product",
      gridType: "multipleChoice",
      columns: ["Poor", "Good", "Excellent"],
      rows: [{ title: "Speed", required: true }, { title: "Reliability" }],
    },
  })
})

Inputs

Provide form and item. position is a one-based insertion position. Omit it to append. requiredRevisionId enables optimistic concurrency.

Item types

question: title, optional description/grading, and a question configuration from Add question.
grid: columns, gridType: "multipleChoice" | "checkbox", and rows with title, optional required and questionId. shuffleRows is optional.
pageBreak or text: optional title and description.
image: public sourceUrl, optional altText, alignment, width 1–740, title, and description.
video: a YouTube youtubeUrl, optional caption, alignment, width 1–740, title, and description.

Second argument { account } selects the Google Account binding.

Output

Returns the updated Form, including Google’s generated IDs. Images must be reachable by Google and videos must use a YouTube watch or share URL.

Built-in triggers

Built-in actions

Runtime utilities

Integrations

Example

Inputs

Item types

Output

​Example

​Inputs

​Item types

​Output

Example

Inputs

Item types

Output