To give form creators more control over who can respond, we're introducing granular controls for responders. Forms created with the API after January 31, 2026 will have an unpublished state by default. To learn more, see
API changes to Google Forms.
Feedback
Stay organized with collections
Save and categorize content based on your preferences.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-02-27 UTC.
[null,null,["Last updated 2025-02-27 UTC."],[],["The provided content defines feedback structures using JSON. Feedback includes required text and optional supplementary materials. Supplementary materials, indicated under \"ExtraMaterial,\" can be text links (\"TextLink\") or video links (\"VideoLink\"). Text links require a URI and display text. Video links require display text and support YouTube URIs. The \"ExtraMaterial\" uses union field to identify the link type. The main Feedback contains text and a list of materials.\n"],null,["# Feedback\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [ExtraMaterial](#ExtraMaterial)\n - [JSON representation](#ExtraMaterial.SCHEMA_REPRESENTATION)\n- [TextLink](#TextLink)\n - [JSON representation](#TextLink.SCHEMA_REPRESENTATION)\n- [VideoLink](#VideoLink)\n - [JSON representation](#VideoLink.SCHEMA_REPRESENTATION)\n\nFeedback for a respondent about their response to a question.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"text\": string, \"material\": [ { object (/workspace/forms/api/reference/rest/v1/Feedback#ExtraMaterial) } ] } ``` |\n\n| Fields ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `text` | `string` Required. The main text of the feedback. |\n| `material[]` | `object (`[ExtraMaterial](/workspace/forms/api/reference/rest/v1/Feedback#ExtraMaterial)`)` Additional information provided as part of the feedback, often used to point the respondent to more reading and resources. |\n\nExtraMaterial\n-------------\n\nSupplementary material to the feedback.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { // Union field `content` can be only one of the following: \"link\": { object (/workspace/forms/api/reference/rest/v1/Feedback#TextLink) }, \"video\": { object (/workspace/forms/api/reference/rest/v1/Feedback#VideoLink) } // End of list of possible types for union field `content`. } ``` |\n\n| Fields ||\n|---------|-----------------------------------------------------------------------------------------------------|\n| Union field `content`. Required. The contents of the extra material. `content` can be only one of the following: ||\n| `link` | `object (`[TextLink](/workspace/forms/api/reference/rest/v1/Feedback#TextLink)`)` Text feedback. |\n| `video` | `object (`[VideoLink](/workspace/forms/api/reference/rest/v1/Feedback#VideoLink)`)` Video feedback. |\n\nTextLink\n--------\n\nLink for text.\n\n| JSON representation |\n|--------------------------------------------------|\n| ``` { \"uri\": string, \"displayText\": string } ``` |\n\n| Fields ||\n|---------------|----------------------------------------------|\n| `uri` | `string` Required. The URI. |\n| `displayText` | `string` Required. Display text for the URI. |\n\nVideoLink\n---------\n\nLink to a video.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"displayText\": string, // Union field `video` can be only one of the following: \"youtubeUri\": string // End of list of possible types for union field `video`. } ``` |\n\n| Fields ||\n|---------------|---------------------------------------------------|\n| `displayText` | `string` Required. The display text for the link. |\n| Union field `video`. Required. The video. `video` can be only one of the following: ||\n| `youtubeUri` | `string` The URI of a YouTube video. |"]]