/google-forms | Type: Application | PCID required: Yes
Tools
| Tool | Description |
|---|---|
google-forms_batch_update | Change the form with a batch of updates. |
google-forms_create_form | Create a new form using the title given in the provided form message in the request. Important: Only the form.info.title and form.info.document_title fields are copied to the new form. All other fields including the form description, items and settings are disallowed. To create a new form and add items, you must first call forms.create to create an empty form with a title and (optional) document title, and then call forms.update to add the items. |
google-forms_create_watch | Create a new watch. If a watch ID is provided, it must be unused. For each invoking project, the per form limit is one watch per Watch.EventType. A watch expires seven days after it is created (see Watch.expire_time). |
google-forms_delete_watch | Delete a watch. |
google-forms_get_form | Get a form. |
google-forms_get_response | Get one response from the form. |
google-forms_list_responses | List a form’s responses. |
google-forms_list_watches | Return a list of the watches owned by the invoking project. The maximum number of watches is two: For each invoker, the limit is one for each event type per form. |
google-forms_renew_watch | Renew an existing watch for seven days. The state of the watch after renewal is ACTIVE, and the expire_time is seven days from the renewal. Renewing a watch in an error state (e.g. SUSPENDED) succeeds if the error is no longer present, but fail otherwise. After a watch has expired, RenewWatch returns NOT_FOUND. |
google-forms_set_publish_settings | Updates the publish settings of a form. Legacy forms aren’t supported because they don’t have the publish_settings field. |
google-forms_batch_update
Change the form with a batch of updates. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
formId | string | Yes | — | Required. The form ID. |
includeFormInResponse | boolean | No | — | Whether to return an updated version of the model in the response. |
requests | object[] | Yes | — | Required. The update requests of this batch. |
writeControl | object | No | — | Provides control over how write requests are executed. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"formId": {
"type": "string",
"description": "Required. The form ID."
},
"includeFormInResponse": {
"type": "boolean",
"description": "Whether to return an updated version of the model in the response."
},
"requests": {
"type": "array",
"items": {
"type": "object",
"properties": {
"updateFormInfo": {
"type": "object",
"description": "Update Form's Info."
},
"updateSettings": {
"type": "object",
"description": "Update Form's FormSettings."
},
"createItem": {
"type": "object",
"description": "Create an item in a form."
},
"moveItem": {
"type": "object",
"description": "Move an item in a form."
},
"deleteItem": {
"type": "object",
"description": "Delete an item in a form."
},
"updateItem": {
"type": "object",
"description": "Update an item in a form."
}
}
},
"description": "Required. The update requests of this batch."
},
"writeControl": {
"type": "object",
"description": "Provides control over how write requests are executed.",
"properties": {
"requiredRevisionId": {
"type": "string",
"description": "The revision ID of the form that the write request is applied to. If this is not the latest revision of the form, the request is not processed and returns a 400 bad request error."
},
"targetRevisionId": {
"type": "string",
"description": "The target revision ID of the form that the write request is applied to. If changes have occurred after this revision, the changes in this update request are transformed against those changes. This results in a new revision of the form that incorporates both the changes in the request and the intervening changes, with the server resolving conflicting changes. The target revision ID may only be used to write to recent versions of a form. If the target revision is too far behind the latest revision, the request is not processed and returns a 400 (Bad Request Error). The request may be retried after reading the latest version of the form. In most cases a target revision ID remains valid for several minutes after it is read, but for frequently-edited forms this window may be shorter."
}
}
}
},
"required": [
"PCID",
"formId",
"requests"
]
}
google-forms_create_form
Create a new form using the title given in the provided form message in the request. Important: Only the form.info.title and form.info.document_title fields are copied to the new form. All other fields including the form description, items and settings are disallowed. To create a new form and add items, you must first call forms.create to create an empty form with a title and (optional) document title, and then call forms.update to add the items. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
unpublished | boolean | No | — | Optional. Whether the form is unpublished. If set to true, the form doesn’t accept responses. If set to false or unset, the form is published and accepts responses. |
info | object | Yes | — | The general information for a form. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"unpublished": {
"type": "boolean",
"description": "Optional. Whether the form is unpublished. If set to `true`, the form doesn't accept responses. If set to `false` or unset, the form is published and accepts responses."
},
"info": {
"type": "object",
"description": "The general information for a form.",
"properties": {
"title": {
"type": "string",
"description": "Required. The title of the form which is visible to responders."
},
"documentTitle": {
"type": "string",
"description": "Output only. The title of the document which is visible in Drive. If Info.title is empty, `document_title` may appear in its place in the Google Forms UI and be visible to responders. `document_title` can be set on create, but cannot be modified by a batchUpdate request. Please use the [Google Drive API](https://developers.google.com/drive/api/v3/reference/files/update) if you need to programmatically update `document_title`."
},
"description": {
"type": "string",
"description": "The description of the form."
}
},
"required": [
"title"
]
}
},
"required": [
"PCID",
"info"
]
}
google-forms_create_watch
Create a new watch. If a watch ID is provided, it must be unused. For each invoking project, the per form limit is one watch per Watch.EventType. A watch expires seven days after it is created (see Watch.expire_time). Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
formId | string | Yes | — | Required. ID of the Form to watch. |
watch | object | Yes | — | A watch for events for a form. When the designated event happens, a notification will be published to the specified target. The notification’s attributes will include a formId key that has the ID of the watched form and an eventType key that has the string of the type. Messages are sent with at-least-once delivery and are only dropped in extraordinary circumstances. Typically all notifications should be reliably delivered within a few seconds; however, in some situations notifications may be delayed. A watch expires seven days after it is created unless it is renewed with watches.renew |
watchId | string | No | — | The ID to use for the watch. If specified, the ID must not already be in use. If not specified, an ID is generated. This value should be 4-63 characters, and valid characters are /a-z-/. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"formId": {
"type": "string",
"description": "Required. ID of the Form to watch."
},
"watch": {
"type": "object",
"description": "A watch for events for a form. When the designated event happens, a notification will be published to the specified target. The notification's attributes will include a `formId` key that has the ID of the watched form and an `eventType` key that has the string of the type. Messages are sent with at-least-once delivery and are only dropped in extraordinary circumstances. Typically all notifications should be reliably delivered within a few seconds; however, in some situations notifications may be delayed. A watch expires seven days after it is created unless it is renewed with watches.renew",
"properties": {
"id": {
"type": "string",
"description": "Output only. The ID of this watch. See notes on CreateWatchRequest.watch_id."
},
"target": {
"type": "object",
"description": "The target for notification delivery."
},
"eventType": {
"type": "string",
"description": "Required. Which event type to watch for.",
"enum": [
"EVENT_TYPE_UNSPECIFIED",
"SCHEMA",
"RESPONSES"
]
},
"createTime": {
"type": "string",
"description": "Output only. Timestamp of when this was created."
},
"expireTime": {
"type": "string",
"description": "Output only. Timestamp for when this will expire. Each watches.renew call resets this to seven days in the future."
},
"errorType": {
"type": "string",
"description": "Output only. The most recent error type for an attempted delivery. To begin watching the form again a call can be made to watches.renew which also clears this error information.",
"enum": [
"ERROR_TYPE_UNSPECIFIED",
"PROJECT_NOT_AUTHORIZED",
"NO_USER_ACCESS",
"OTHER_ERRORS"
]
},
"state": {
"type": "string",
"description": "Output only. The current state of the watch. Additional details about suspended watches can be found by checking the `error_type`.",
"enum": [
"STATE_UNSPECIFIED",
"ACTIVE",
"SUSPENDED"
]
}
}
},
"watchId": {
"type": "string",
"description": "The ID to use for the watch. If specified, the ID must not already be in use. If not specified, an ID is generated. This value should be 4-63 characters, and valid characters are /a-z-/."
}
},
"required": [
"PCID",
"formId",
"watch"
]
}
google-forms_delete_watch
Delete a watch. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
formId | string | Yes | — | Required. The ID of the Form. |
watchId | string | Yes | — | Required. The ID of the Watch to delete. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"formId": {
"type": "string",
"description": "Required. The ID of the Form."
},
"watchId": {
"type": "string",
"description": "Required. The ID of the Watch to delete."
}
},
"required": [
"PCID",
"formId",
"watchId"
]
}
google-forms_get_form
Get a form. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
formId | string | Yes | — | Required. The form ID. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"formId": {
"type": "string",
"description": "Required. The form ID."
}
},
"required": [
"PCID",
"formId"
]
}
google-forms_get_response
Get one response from the form. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
formId | string | Yes | — | Required. The form ID. |
responseId | string | Yes | — | Required. The response ID within the form. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"formId": {
"type": "string",
"description": "Required. The form ID."
},
"responseId": {
"type": "string",
"description": "Required. The response ID within the form."
}
},
"required": [
"PCID",
"formId",
"responseId"
]
}
google-forms_list_responses
List a form’s responses. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
formId | string | Yes | — | Required. ID of the Form whose responses to list. |
filter | string | No | — | Which form responses to return. Currently, the only supported filters are: * timestamp > N which means to get all form responses submitted after (but not at) timestamp N. * timestamp >= N which means to get all form responses submitted at and after timestamp N. For both supported filters, timestamp must be formatted in RFC3339 UTC “Zulu” format. Examples: “2014-10-02T15:01:23Z” and “2014-10-02T15:01:23.045123456Z”. |
pageSize | integer | No | — | The maximum number of responses to return. The service may return fewer than this value. If unspecified or zero, at most 5000 responses are returned. |
pageToken | string | No | — | A page token returned by a previous list response. If this field is set, the form and the values of the filter must be the same as for the original request. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"formId": {
"type": "string",
"description": "Required. ID of the Form whose responses to list."
},
"filter": {
"type": "string",
"description": "Which form responses to return. Currently, the only supported filters are: * timestamp > *N* which means to get all form responses submitted after (but not at) timestamp *N*. * timestamp >= *N* which means to get all form responses submitted at and after timestamp *N*. For both supported filters, timestamp must be formatted in RFC3339 UTC \"Zulu\" format. Examples: \"2014-10-02T15:01:23Z\" and \"2014-10-02T15:01:23.045123456Z\"."
},
"pageSize": {
"type": "integer",
"description": "The maximum number of responses to return. The service may return fewer than this value. If unspecified or zero, at most 5000 responses are returned."
},
"pageToken": {
"type": "string",
"description": "A page token returned by a previous list response. If this field is set, the form and the values of the filter must be the same as for the original request."
}
},
"required": [
"PCID",
"formId"
]
}
google-forms_list_watches
Return a list of the watches owned by the invoking project. The maximum number of watches is two: For each invoker, the limit is one for each event type per form. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
formId | string | Yes | — | Required. ID of the Form whose watches to list. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"formId": {
"type": "string",
"description": "Required. ID of the Form whose watches to list."
}
},
"required": [
"PCID",
"formId"
]
}
google-forms_renew_watch
Renew an existing watch for seven days. The state of the watch after renewal isACTIVE, and the expire_time is seven days from the renewal. Renewing a watch in an error state (e.g. SUSPENDED) succeeds if the error is no longer present, but fail otherwise. After a watch has expired, RenewWatch returns NOT_FOUND.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
formId | string | Yes | — | Required. The ID of the Form. |
watchId | string | Yes | — | Required. The ID of the Watch to renew. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"formId": {
"type": "string",
"description": "Required. The ID of the Form."
},
"watchId": {
"type": "string",
"description": "Required. The ID of the Watch to renew."
}
},
"required": [
"PCID",
"formId",
"watchId"
]
}
google-forms_set_publish_settings
Updates the publish settings of a form. Legacy forms aren’t supported because they don’t have thepublish_settings field.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
formId | string | Yes | — | Required. The ID of the form. You can get the id from Form.form_id field. |
publishSettings | object | Yes | — | The publishing settings of a form. |
updateMask | string | No | — | Optional. The publish_settings fields to update. This field mask accepts the following values: * publish_state: Updates or replaces all publish_state settings. * "*": Updates or replaces all publish_settings fields. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"formId": {
"type": "string",
"description": "Required. The ID of the form. You can get the id from Form.form_id field."
},
"publishSettings": {
"type": "object",
"description": "The publishing settings of a form.",
"properties": {
"publishState": {
"type": "object",
"description": "The publishing state of a form."
}
}
},
"updateMask": {
"type": "string",
"description": "Optional. The `publish_settings` fields to update. This field mask accepts the following values: * `publish_state`: Updates or replaces all `publish_state` settings. * `\"*\"`: Updates or replaces all `publish_settings` fields."
}
},
"required": [
"PCID",
"formId",
"publishSettings"
]
}

