blob: 89b57073a829e7bb420dad2fbd991084e3c30eb0 [file] [log] [blame] [edit]
{
"id": "dialogflow:v2beta1",
"ownerDomain": "google.com",
"canonicalName": "Dialogflow",
"resources": {
"projects": {
"methods": {
"deleteAgent": {
"response": {
"$ref": "GoogleProtobufEmpty"
},
"httpMethod": "DELETE",
"path": "v2beta1/{+parent}/agent",
"id": "dialogflow.projects.deleteAgent",
"flatPath": "v2beta1/projects/{projectsId}/agent",
"description": "Deletes the specified agent.",
"parameters": {
"parent": {
"location": "path",
"pattern": "^projects/[^/]+$",
"required": true,
"description": "Required. The project that the agent to delete is associated with. Format: `projects/` or `projects//locations/`.",
"type": "string"
}
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameterOrder": [
"parent"
]
},
"getAgent": {
"parameters": {
"parent": {
"description": "Required. The project that the agent to fetch is associated with. Format: `projects/` or `projects//locations/`.",
"location": "path",
"required": true,
"type": "string",
"pattern": "^projects/[^/]+$"
}
},
"path": "v2beta1/{+parent}/agent",
"httpMethod": "GET",
"flatPath": "v2beta1/projects/{projectsId}/agent",
"id": "dialogflow.projects.getAgent",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Agent"
},
"parameterOrder": [
"parent"
],
"description": "Retrieves the specified agent."
},
"setAgent": {
"parameters": {
"parent": {
"location": "path",
"description": "Required. The project of this agent. Format: `projects/` or `projects//locations/`",
"type": "string",
"pattern": "^projects/[^/]+$",
"required": true
},
"updateMask": {
"format": "google-fieldmask",
"description": "Optional. The mask to control which fields get updated.",
"type": "string",
"location": "query"
}
},
"flatPath": "v2beta1/projects/{projectsId}/agent",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1Agent"
},
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Agent"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"description": "Creates/updates the specified agent.",
"path": "v2beta1/{+parent}/agent",
"httpMethod": "POST",
"parameterOrder": [
"parent"
],
"id": "dialogflow.projects.setAgent"
}
},
"resources": {
"knowledgeBases": {
"resources": {
"documents": {
"methods": {
"get": {
"path": "v2beta1/{+name}",
"description": "Retrieves the specified document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`.",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"flatPath": "v2beta1/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}/documents/{documentsId}",
"parameterOrder": [
"name"
],
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Document"
},
"parameters": {
"name": {
"pattern": "^projects/[^/]+/knowledgeBases/[^/]+/documents/[^/]+$",
"description": "Required. The name of the document to retrieve. Format `projects//knowledgeBases//documents/`.",
"location": "path",
"required": true,
"type": "string"
}
},
"httpMethod": "GET",
"id": "dialogflow.projects.knowledgeBases.documents.get"
},
"reload": {
"id": "dialogflow.projects.knowledgeBases.documents.reload",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"response": {
"$ref": "GoogleLongrunningOperation"
},
"request": {
"$ref": "GoogleCloudDialogflowV2beta1ReloadDocumentRequest"
},
"description": "Reloads the specified document from its specified source, content_uri or content. The previously loaded content of the document will be deleted. Note: Even when the content of the document has not changed, there still may be side effects because of internal implementation changes. Note: If the document source is Google Cloud Storage URI, its metadata will be replaced with the custom metadata from Google Cloud Storage if the `import_gcs_custom_metadata` field is set to true in the request. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`.",
"path": "v2beta1/{+name}:reload",
"flatPath": "v2beta1/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}/documents/{documentsId}:reload",
"httpMethod": "POST",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Required. The name of the document to reload. Format: `projects//knowledgeBases//documents/`",
"type": "string",
"location": "path",
"required": true,
"pattern": "^projects/[^/]+/knowledgeBases/[^/]+/documents/[^/]+$"
}
}
},
"list": {
"response": {
"$ref": "GoogleCloudDialogflowV2beta1ListDocumentsResponse"
},
"path": "v2beta1/{+parent}/documents",
"description": "Returns the list of all documents of the knowledge base. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`.",
"parameters": {
"pageToken": {
"description": "The next_page_token value returned from a previous list request.",
"location": "query",
"type": "string"
},
"parent": {
"required": true,
"description": "Required. The knowledge base to list all documents for. Format: `projects//knowledgeBases/`.",
"location": "path",
"type": "string",
"pattern": "^projects/[^/]+/knowledgeBases/[^/]+$"
},
"pageSize": {
"type": "integer",
"format": "int32",
"location": "query",
"description": "The maximum number of items to return in a single page. By default 10 and at most 100."
},
"filter": {
"location": "query",
"type": "string",
"description": "The filter expression used to filter documents returned by the list method. The expression has the following syntax: [AND ] ... The following fields and operators are supported: * knowledge_types with has(:) operator * display_name with has(:) operator * state with equals(=) operator Examples: * \"knowledge_types:FAQ\" matches documents with FAQ knowledge type. * \"display_name:customer\" matches documents whose display name contains \"customer\". * \"state=ACTIVE\" matches documents with ACTIVE state. * \"knowledge_types:FAQ AND state=ACTIVE\" matches all active FAQ documents. For more information about filtering, see [API Filtering](https://aip.dev/160)."
}
},
"httpMethod": "GET",
"flatPath": "v2beta1/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}/documents",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameterOrder": [
"parent"
],
"id": "dialogflow.projects.knowledgeBases.documents.list"
},
"patch": {
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"description": "Updates the specified document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`.",
"id": "dialogflow.projects.knowledgeBases.documents.patch",
"flatPath": "v2beta1/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}/documents/{documentsId}",
"parameters": {
"updateMask": {
"description": "Optional. Not specified means `update all`. Currently, only `display_name` can be updated, an InvalidArgument will be returned for attempting to update other fields.",
"type": "string",
"location": "query",
"format": "google-fieldmask"
},
"name": {
"location": "path",
"required": true,
"type": "string",
"pattern": "^projects/[^/]+/knowledgeBases/[^/]+/documents/[^/]+$",
"description": "Optional. The document resource name. The name must be empty when creating a document. Format: `projects//knowledgeBases//documents/`."
}
},
"httpMethod": "PATCH",
"response": {
"$ref": "GoogleLongrunningOperation"
},
"parameterOrder": [
"name"
],
"path": "v2beta1/{+name}",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1Document"
}
},
"delete": {
"httpMethod": "DELETE",
"flatPath": "v2beta1/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}/documents/{documentsId}",
"id": "dialogflow.projects.knowledgeBases.documents.delete",
"description": "Deletes the specified document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`.",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameterOrder": [
"name"
],
"response": {
"$ref": "GoogleLongrunningOperation"
},
"path": "v2beta1/{+name}",
"parameters": {
"name": {
"type": "string",
"description": "Required. The name of the document to delete. Format: `projects//knowledgeBases//documents/`.",
"required": true,
"pattern": "^projects/[^/]+/knowledgeBases/[^/]+/documents/[^/]+$",
"location": "path"
}
}
},
"create": {
"flatPath": "v2beta1/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}/documents",
"description": "Creates a new document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`.",
"httpMethod": "POST",
"parameterOrder": [
"parent"
],
"parameters": {
"parent": {
"location": "path",
"type": "string",
"description": "Required. The knowledge base to create a document for. Format: `projects//knowledgeBases/`.",
"pattern": "^projects/[^/]+/knowledgeBases/[^/]+$",
"required": true
},
"importGcsCustomMetadata": {
"type": "boolean",
"description": "Whether to import custom metadata from Google Cloud Storage. Only valid when the document source is Google Cloud Storage URI.",
"location": "query"
}
},
"response": {
"$ref": "GoogleLongrunningOperation"
},
"path": "v2beta1/{+parent}/documents",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1Document"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"id": "dialogflow.projects.knowledgeBases.documents.create"
}
}
}
},
"methods": {
"patch": {
"description": "Updates the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1KnowledgeBase"
},
"flatPath": "v2beta1/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}",
"id": "dialogflow.projects.knowledgeBases.patch",
"httpMethod": "PATCH",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"request": {
"$ref": "GoogleCloudDialogflowV2beta1KnowledgeBase"
},
"path": "v2beta1/{+name}",
"parameters": {
"name": {
"type": "string",
"description": "The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`.",
"location": "path",
"required": true,
"pattern": "^projects/[^/]+/knowledgeBases/[^/]+$"
},
"updateMask": {
"type": "string",
"description": "Optional. Not specified means `update all`. Currently, only `display_name` can be updated, an InvalidArgument will be returned for attempting to update other fields.",
"format": "google-fieldmask",
"location": "query"
}
},
"parameterOrder": [
"name"
]
},
"create": {
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"id": "dialogflow.projects.knowledgeBases.create",
"httpMethod": "POST",
"parameters": {
"parent": {
"description": "Required. The project to create a knowledge base for. Format: `projects/`.",
"location": "path",
"required": true,
"type": "string",
"pattern": "^projects/[^/]+$"
}
},
"request": {
"$ref": "GoogleCloudDialogflowV2beta1KnowledgeBase"
},
"path": "v2beta1/{+parent}/knowledgeBases",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1KnowledgeBase"
},
"parameterOrder": [
"parent"
],
"description": "Creates a knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.",
"flatPath": "v2beta1/projects/{projectsId}/knowledgeBases"
},
"list": {
"parameterOrder": [
"parent"
],
"parameters": {
"pageSize": {
"description": "The maximum number of items to return in a single page. By default 10 and at most 100.",
"location": "query",
"format": "int32",
"type": "integer"
},
"parent": {
"description": "Required. The project to list of knowledge bases for. Format: `projects/`.",
"type": "string",
"location": "path",
"pattern": "^projects/[^/]+$",
"required": true
},
"pageToken": {
"type": "string",
"description": "The next_page_token value returned from a previous list request.",
"location": "query"
},
"filter": {
"type": "string",
"description": "The filter expression used to filter knowledge bases returned by the list method. The expression has the following syntax: [AND ] ... The following fields and operators are supported: * display_name with has(:) operator * language_code with equals(=) operator Examples: * 'language_code=en-us' matches knowledge bases with en-us language code. * 'display_name:articles' matches knowledge bases whose display name contains \"articles\". * 'display_name:\"Best Articles\"' matches knowledge bases whose display name contains \"Best Articles\". * 'language_code=en-gb AND display_name=articles' matches all knowledge bases whose display name contains \"articles\" and whose language code is \"en-gb\". Note: An empty filter string (i.e. \"\") is a no-op and will result in no filtering. For more information about filtering, see [API Filtering](https://aip.dev/160).",
"location": "query"
}
},
"flatPath": "v2beta1/projects/{projectsId}/knowledgeBases",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1ListKnowledgeBasesResponse"
},
"id": "dialogflow.projects.knowledgeBases.list",
"description": "Returns the list of all knowledge bases of the specified agent. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.",
"path": "v2beta1/{+parent}/knowledgeBases",
"httpMethod": "GET",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
]
},
"delete": {
"httpMethod": "DELETE",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"description": "Deletes the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.",
"flatPath": "v2beta1/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}",
"response": {
"$ref": "GoogleProtobufEmpty"
},
"parameterOrder": [
"name"
],
"path": "v2beta1/{+name}",
"parameters": {
"force": {
"type": "boolean",
"location": "query",
"description": "Optional. Force deletes the knowledge base. When set to true, any documents in the knowledge base are also deleted."
},
"name": {
"location": "path",
"description": "Required. The name of the knowledge base to delete. Format: `projects//knowledgeBases/`.",
"type": "string",
"required": true,
"pattern": "^projects/[^/]+/knowledgeBases/[^/]+$"
}
},
"id": "dialogflow.projects.knowledgeBases.delete"
},
"get": {
"id": "dialogflow.projects.knowledgeBases.get",
"flatPath": "v2beta1/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1KnowledgeBase"
},
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"pattern": "^projects/[^/]+/knowledgeBases/[^/]+$",
"location": "path",
"type": "string",
"required": true,
"description": "Required. The name of the knowledge base to retrieve. Format `projects//knowledgeBases/`."
}
},
"httpMethod": "GET",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"description": "Retrieves the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.",
"path": "v2beta1/{+name}"
}
}
},
"locations": {
"methods": {
"setAgent": {
"request": {
"$ref": "GoogleCloudDialogflowV2beta1Agent"
},
"parameters": {
"updateMask": {
"format": "google-fieldmask",
"type": "string",
"location": "query",
"description": "Optional. The mask to control which fields get updated."
},
"parent": {
"pattern": "^projects/[^/]+/locations/[^/]+$",
"description": "Required. The project of this agent. Format: `projects/` or `projects//locations/`",
"required": true,
"location": "path",
"type": "string"
}
},
"httpMethod": "POST",
"parameterOrder": [
"parent"
],
"id": "dialogflow.projects.locations.setAgent",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Agent"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent",
"path": "v2beta1/{+parent}/agent",
"description": "Creates/updates the specified agent."
},
"deleteAgent": {
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent",
"parameterOrder": [
"parent"
],
"httpMethod": "DELETE",
"response": {
"$ref": "GoogleProtobufEmpty"
},
"path": "v2beta1/{+parent}/agent",
"id": "dialogflow.projects.locations.deleteAgent",
"parameters": {
"parent": {
"location": "path",
"type": "string",
"required": true,
"description": "Required. The project that the agent to delete is associated with. Format: `projects/` or `projects//locations/`.",
"pattern": "^projects/[^/]+/locations/[^/]+$"
}
},
"description": "Deletes the specified agent."
},
"getAgent": {
"httpMethod": "GET",
"description": "Retrieves the specified agent.",
"parameters": {
"parent": {
"pattern": "^projects/[^/]+/locations/[^/]+$",
"location": "path",
"description": "Required. The project that the agent to fetch is associated with. Format: `projects/` or `projects//locations/`.",
"required": true,
"type": "string"
}
},
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent",
"path": "v2beta1/{+parent}/agent",
"id": "dialogflow.projects.locations.getAgent",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Agent"
},
"parameterOrder": [
"parent"
],
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
]
}
},
"resources": {
"operations": {
"methods": {
"cancel": {
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel",
"parameterOrder": [
"name"
],
"description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
"response": {
"$ref": "GoogleProtobufEmpty"
},
"id": "dialogflow.projects.locations.operations.cancel",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"httpMethod": "POST",
"path": "v2beta1/{+name}:cancel",
"parameters": {
"name": {
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$",
"type": "string",
"description": "The name of the operation resource to be cancelled.",
"required": true
}
}
},
"list": {
"path": "v2beta1/{+name}/operations",
"parameters": {
"filter": {
"type": "string",
"location": "query",
"description": "The standard list filter."
},
"name": {
"required": true,
"location": "path",
"type": "string",
"pattern": "^projects/[^/]+/locations/[^/]+$",
"description": "The name of the operation's parent resource."
},
"pageToken": {
"location": "query",
"description": "The standard list page token.",
"type": "string"
},
"pageSize": {
"type": "integer",
"location": "query",
"format": "int32",
"description": "The standard list page size."
}
},
"response": {
"$ref": "GoogleLongrunningListOperationsResponse"
},
"httpMethod": "GET",
"description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to override the binding to use different resource name schemes, such as `users/*/operations`. To override the binding, API services can add a binding such as `\"/v1/{name=users/*}/operations\"` to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id.",
"id": "dialogflow.projects.locations.operations.list",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameterOrder": [
"name"
],
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/operations"
},
"get": {
"path": "v2beta1/{+name}",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"response": {
"$ref": "GoogleLongrunningOperation"
},
"id": "dialogflow.projects.locations.operations.get",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"required": true,
"type": "string",
"pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$",
"location": "path",
"description": "The name of the operation resource."
}
},
"description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
"httpMethod": "GET"
}
}
},
"agent": {
"resources": {
"environments": {
"resources": {
"users": {
"resources": {
"sessions": {
"methods": {
"detectIntent": {
"id": "dialogflow.projects.locations.agent.environments.users.sessions.detectIntent",
"path": "v2beta1/{+session}:detectIntent",
"description": "Processes a natural language query and returns structured, actionable data as a result. This method is not idempotent, because it may cause contexts and session entity types to be updated, which in turn might affect results of future queries.",
"httpMethod": "POST",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1DetectIntentResponse"
},
"parameterOrder": [
"session"
],
"parameters": {
"session": {
"location": "path",
"required": true,
"description": "Required. The name of the session this query is sent to. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we are using \"-\". It's up to the API caller to choose an appropriate `Session ID` and `User Id`. They can be a random number or some type of user and session identifiers (preferably hashed). The length of the `Session ID` and `User ID` must not exceed 36 characters. For more information, see the [API interactions guide](https://cloud.google.com/dialogflow/docs/api-overview).",
"type": "string",
"pattern": "^projects/[^/]+/locations/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$"
}
},
"request": {
"$ref": "GoogleCloudDialogflowV2beta1DetectIntentRequest"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}:detectIntent"
},
"deleteContexts": {
"description": "Deletes all active contexts in the specified session.",
"parameterOrder": [
"parent"
],
"id": "dialogflow.projects.locations.agent.environments.users.sessions.deleteContexts",
"httpMethod": "DELETE",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"response": {
"$ref": "GoogleProtobufEmpty"
},
"path": "v2beta1/{+parent}/contexts",
"parameters": {
"parent": {
"type": "string",
"pattern": "^projects/[^/]+/locations/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$",
"required": true,
"description": "Required. The name of the session to delete all contexts from. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"location": "path"
}
},
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/contexts"
}
},
"resources": {
"entityTypes": {
"methods": {
"delete": {
"id": "dialogflow.projects.locations.agent.environments.users.sessions.entityTypes.delete",
"path": "v2beta1/{+name}",
"parameterOrder": [
"name"
],
"httpMethod": "DELETE",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes/{entityTypesId}",
"response": {
"$ref": "GoogleProtobufEmpty"
},
"parameters": {
"name": {
"type": "string",
"description": "Required. The name of the entity type to delete. Supported formats: - `projects//agent/sessions//entityTypes/` - `projects//locations//agent/sessions//entityTypes/` - `projects//agent/environments//users//sessions//entityTypes/` - `projects//locations//agent/environments/ /users//sessions//entityTypes/` If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/entityTypes/[^/]+$",
"required": true
}
},
"description": "Deletes the specified session entity type. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration."
},
"get": {
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes/{entityTypesId}",
"description": "Retrieves the specified session entity type. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Required. The name of the session entity type. Supported formats: - `projects//agent/sessions//entityTypes/` - `projects//locations//agent/sessions//entityTypes/` - `projects//agent/environments//users//sessions//entityTypes/` - `projects//locations//agent/environments/ /users//sessions//entityTypes/` If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"type": "string",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/entityTypes/[^/]+$",
"required": true
}
},
"path": "v2beta1/{+name}",
"id": "dialogflow.projects.locations.agent.environments.users.sessions.entityTypes.get",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
},
"httpMethod": "GET"
},
"list": {
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes",
"parameterOrder": [
"parent"
],
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"path": "v2beta1/{+parent}/entityTypes",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1ListSessionEntityTypesResponse"
},
"description": "Returns the list of all session entity types in the specified session. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.",
"id": "dialogflow.projects.locations.agent.environments.users.sessions.entityTypes.list",
"parameters": {
"pageToken": {
"description": "Optional. The next_page_token value returned from a previous list request.",
"location": "query",
"type": "string"
},
"parent": {
"location": "path",
"required": true,
"type": "string",
"pattern": "^projects/[^/]+/locations/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$",
"description": "Required. The session to list all session entity types from. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user."
},
"pageSize": {
"location": "query",
"description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.",
"type": "integer",
"format": "int32"
}
},
"httpMethod": "GET"
},
"patch": {
"response": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
},
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes/{entityTypesId}",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
},
"path": "v2beta1/{+name}",
"id": "dialogflow.projects.locations.agent.environments.users.sessions.entityTypes.patch",
"parameters": {
"updateMask": {
"type": "string",
"description": "Optional. The mask to control which fields get updated.",
"format": "google-fieldmask",
"location": "query"
},
"name": {
"type": "string",
"pattern": "^projects/[^/]+/locations/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/entityTypes/[^/]+$",
"description": "Required. The unique identifier of this session entity type. Supported formats: - `projects//agent/sessions//entityTypes/` - `projects//locations//agent/sessions//entityTypes/` - `projects//agent/environments//users//sessions//entityTypes/` - `projects//locations//agent/environments/ /users//sessions//entityTypes/` If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. `` must be the display name of an existing entity type in the same agent that will be overridden or supplemented.",
"location": "path",
"required": true
}
},
"parameterOrder": [
"name"
],
"description": "Updates the specified session entity type. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"httpMethod": "PATCH"
},
"create": {
"parameters": {
"parent": {
"location": "path",
"description": "Required. The session to create a session entity type for. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"required": true,
"pattern": "^projects/[^/]+/locations/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$",
"type": "string"
}
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"description": "Creates a session entity type. If the specified session entity type already exists, overrides the session entity type. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.",
"path": "v2beta1/{+parent}/entityTypes",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
},
"response": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
},
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes",
"id": "dialogflow.projects.locations.agent.environments.users.sessions.entityTypes.create",
"parameterOrder": [
"parent"
],
"httpMethod": "POST"
}
}
},
"contexts": {
"methods": {
"get": {
"parameters": {
"name": {
"pattern": "^projects/[^/]+/locations/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/contexts/[^/]+$",
"required": true,
"location": "path",
"type": "string",
"description": "Required. The name of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user."
}
},
"description": "Retrieves the specified context.",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"id": "dialogflow.projects.locations.agent.environments.users.sessions.contexts.get",
"parameterOrder": [
"name"
],
"httpMethod": "GET",
"path": "v2beta1/{+name}",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/contexts/{contextsId}"
},
"delete": {
"response": {
"$ref": "GoogleProtobufEmpty"
},
"description": "Deletes the specified context.",
"httpMethod": "DELETE",
"parameterOrder": [
"name"
],
"path": "v2beta1/{+name}",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/contexts/{contextsId}",
"parameters": {
"name": {
"location": "path",
"description": "Required. The name of the context to delete. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"required": true,
"pattern": "^projects/[^/]+/locations/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/contexts/[^/]+$",
"type": "string"
}
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"id": "dialogflow.projects.locations.agent.environments.users.sessions.contexts.delete"
},
"create": {
"request": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"path": "v2beta1/{+parent}/contexts",
"parameterOrder": [
"parent"
],
"httpMethod": "POST",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameters": {
"parent": {
"required": true,
"pattern": "^projects/[^/]+/locations/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$",
"type": "string",
"location": "path",
"description": "Required. The session to create a context for. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user."
}
},
"description": "Creates a context. If the specified context already exists, overrides the context.",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"id": "dialogflow.projects.locations.agent.environments.users.sessions.contexts.create",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/contexts"
},
"list": {
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/contexts",
"parameterOrder": [
"parent"
],
"response": {
"$ref": "GoogleCloudDialogflowV2beta1ListContextsResponse"
},
"path": "v2beta1/{+parent}/contexts",
"httpMethod": "GET",
"id": "dialogflow.projects.locations.agent.environments.users.sessions.contexts.list",
"parameters": {
"parent": {
"required": true,
"pattern": "^projects/[^/]+/locations/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$",
"type": "string",
"description": "Required. The session to list all contexts from. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"location": "path"
},
"pageSize": {
"location": "query",
"format": "int32",
"type": "integer",
"description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000."
},
"pageToken": {
"type": "string",
"location": "query",
"description": "Optional. The next_page_token value returned from a previous list request."
}
},
"description": "Returns the list of all contexts in the specified session."
},
"patch": {
"path": "v2beta1/{+name}",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/contexts/{contextsId}",
"description": "Updates the specified context.",
"httpMethod": "PATCH",
"parameters": {
"updateMask": {
"type": "string",
"format": "google-fieldmask",
"location": "query",
"description": "Optional. The mask to control which fields get updated."
},
"name": {
"pattern": "^projects/[^/]+/locations/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/contexts/[^/]+$",
"type": "string",
"description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`",
"required": true,
"location": "path"
}
},
"parameterOrder": [
"name"
],
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"id": "dialogflow.projects.locations.agent.environments.users.sessions.contexts.patch"
}
}
}
}
}
}
}
},
"methods": {
"list": {
"response": {
"$ref": "GoogleCloudDialogflowV2beta1ListEnvironmentsResponse"
},
"parameterOrder": [
"parent"
],
"description": "Returns the list of all non-draft environments of the specified agent.",
"parameters": {
"parent": {
"type": "string",
"pattern": "^projects/[^/]+/locations/[^/]+/agent$",
"location": "path",
"description": "Required. The agent to list all environments from. Format: - `projects//agent` - `projects//locations//agent`",
"required": true
},
"pageToken": {
"type": "string",
"description": "Optional. The next_page_token value returned from a previous list request.",
"location": "query"
},
"pageSize": {
"location": "query",
"description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.",
"format": "int32",
"type": "integer"
}
},
"httpMethod": "GET",
"path": "v2beta1/{+parent}/environments",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/environments",
"id": "dialogflow.projects.locations.agent.environments.list"
}
}
},
"entityTypes": {
"methods": {
"patch": {
"path": "v2beta1/{+name}",
"description": "Updates the specified entity type.",
"parameters": {
"updateMask": {
"description": "Optional. The mask to control which fields get updated.",
"format": "google-fieldmask",
"location": "query",
"type": "string"
},
"name": {
"description": "The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Supported formats: - `projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`",
"pattern": "^projects/[^/]+/locations/[^/]+/agent/entityTypes/[^/]+$",
"required": true,
"location": "path",
"type": "string"
},
"languageCode": {
"type": "string",
"description": "Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see [Multilingual intent and entity data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).",
"location": "query"
}
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"request": {
"$ref": "GoogleCloudDialogflowV2beta1EntityType"
},
"parameterOrder": [
"name"
],
"httpMethod": "PATCH",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1EntityType"
},
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/entityTypes/{entityTypesId}",
"id": "dialogflow.projects.locations.agent.entityTypes.patch"
},
"batchDelete": {
"path": "v2beta1/{+parent}/entityTypes:batchDelete",
"httpMethod": "POST",
"id": "dialogflow.projects.locations.agent.entityTypes.batchDelete",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1BatchDeleteEntityTypesRequest"
},
"response": {
"$ref": "GoogleLongrunningOperation"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/entityTypes:batchDelete",
"description": "Deletes entity types in the specified agent. Operation ",
"parameters": {
"parent": {
"required": true,
"description": "Required. The name of the agent to delete all entities types for. Supported formats: - `projects//agent`, - `projects//locations//agent`.",
"pattern": "^projects/[^/]+/locations/[^/]+/agent$",
"location": "path",
"type": "string"
}
},
"parameterOrder": [
"parent"
]
},
"batchUpdate": {
"path": "v2beta1/{+parent}/entityTypes:batchUpdate",
"response": {
"$ref": "GoogleLongrunningOperation"
},
"parameters": {
"parent": {
"description": "Required. The name of the agent to update or create entity types in. Supported formats: - `projects//agent` - `projects//locations//agent`",
"type": "string",
"location": "path",
"required": true,
"pattern": "^projects/[^/]+/locations/[^/]+/agent$"
}
},
"httpMethod": "POST",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1BatchUpdateEntityTypesRequest"
},
"id": "dialogflow.projects.locations.agent.entityTypes.batchUpdate",
"parameterOrder": [
"parent"
],
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/entityTypes:batchUpdate",
"description": "Updates/Creates multiple entity types in the specified agent. Operation "
},
"delete": {
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"response": {
"$ref": "GoogleProtobufEmpty"
},
"httpMethod": "DELETE",
"parameters": {
"name": {
"description": "Required. The name of the entity type to delete. Supported formats: - `projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`",
"required": true,
"location": "path",
"type": "string",
"pattern": "^projects/[^/]+/locations/[^/]+/agent/entityTypes/[^/]+$"
}
},
"description": "Deletes the specified entity type.",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/entityTypes/{entityTypesId}",
"id": "dialogflow.projects.locations.agent.entityTypes.delete",
"parameterOrder": [
"name"
],
"path": "v2beta1/{+name}"
},
"get": {
"parameterOrder": [
"name"
],
"id": "dialogflow.projects.locations.agent.entityTypes.get",
"parameters": {
"languageCode": {
"type": "string",
"location": "query",
"description": "Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see [Multilingual intent and entity data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity)."
},
"name": {
"pattern": "^projects/[^/]+/locations/[^/]+/agent/entityTypes/[^/]+$",
"required": true,
"type": "string",
"description": "Required. The name of the entity type. Supported formats: - `projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`",
"location": "path"
}
},
"description": "Retrieves the specified entity type.",
"path": "v2beta1/{+name}",
"httpMethod": "GET",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/entityTypes/{entityTypesId}",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1EntityType"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
]
},
"create": {
"path": "v2beta1/{+parent}/entityTypes",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/entityTypes",
"description": "Creates an entity type in the specified agent.",
"parameterOrder": [
"parent"
],
"request": {
"$ref": "GoogleCloudDialogflowV2beta1EntityType"
},
"parameters": {
"languageCode": {
"description": "Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see [Multilingual intent and entity data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).",
"location": "query",
"type": "string"
},
"parent": {
"description": "Required. The agent to create a entity type for. Supported formats: - `projects//agent` - `projects//locations//agent`",
"required": true,
"pattern": "^projects/[^/]+/locations/[^/]+/agent$",
"location": "path",
"type": "string"
}
},
"response": {
"$ref": "GoogleCloudDialogflowV2beta1EntityType"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"id": "dialogflow.projects.locations.agent.entityTypes.create",
"httpMethod": "POST"
},
"list": {
"parameterOrder": [
"parent"
],
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"httpMethod": "GET",
"id": "dialogflow.projects.locations.agent.entityTypes.list",
"path": "v2beta1/{+parent}/entityTypes",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1ListEntityTypesResponse"
},
"description": "Returns the list of all entity types in the specified agent.",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/entityTypes",
"parameters": {
"pageToken": {
"location": "query",
"type": "string",
"description": "Optional. The next_page_token value returned from a previous list request."
},
"languageCode": {
"location": "query",
"type": "string",
"description": "Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see [Multilingual intent and entity data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity)."
},
"pageSize": {
"location": "query",
"description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.",
"type": "integer",
"format": "int32"
},
"parent": {
"description": "Required. The agent to list all entity types from. Supported formats: - `projects//agent` - `projects//locations//agent`",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/agent$",
"required": true,
"type": "string"
}
}
}
},
"resources": {
"entities": {
"methods": {
"batchUpdate": {
"description": "Updates or creates multiple entities in the specified entity type. This method does not affect entities in the entity type that aren't explicitly specified in the request. Operation ",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1BatchUpdateEntitiesRequest"
},
"id": "dialogflow.projects.locations.agent.entityTypes.entities.batchUpdate",
"path": "v2beta1/{+parent}/entities:batchUpdate",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/entityTypes/{entityTypesId}/entities:batchUpdate",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"httpMethod": "POST",
"parameters": {
"parent": {
"pattern": "^projects/[^/]+/locations/[^/]+/agent/entityTypes/[^/]+$",
"description": "Required. The name of the entity type to update or create entities in. Supported formats: - `projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`",
"required": true,
"type": "string",
"location": "path"
}
},
"response": {
"$ref": "GoogleLongrunningOperation"
},
"parameterOrder": [
"parent"
]
},
"batchDelete": {
"httpMethod": "POST",
"parameterOrder": [
"parent"
],
"request": {
"$ref": "GoogleCloudDialogflowV2beta1BatchDeleteEntitiesRequest"
},
"id": "dialogflow.projects.locations.agent.entityTypes.entities.batchDelete",
"parameters": {
"parent": {
"type": "string",
"required": true,
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/agent/entityTypes/[^/]+$",
"description": "Required. The name of the entity type to delete entries for. Supported formats: - `projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`"
}
},
"response": {
"$ref": "GoogleLongrunningOperation"
},
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/entityTypes/{entityTypesId}/entities:batchDelete",
"path": "v2beta1/{+parent}/entities:batchDelete",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"description": "Deletes entities in the specified entity type. Operation "
},
"batchCreate": {
"parameters": {
"parent": {
"description": "Required. The name of the entity type to create entities in. Supported formats: - `projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`",
"location": "path",
"type": "string",
"required": true,
"pattern": "^projects/[^/]+/locations/[^/]+/agent/entityTypes/[^/]+$"
}
},
"description": "Creates multiple new entities in the specified entity type. Operation ",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/entityTypes/{entityTypesId}/entities:batchCreate",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"id": "dialogflow.projects.locations.agent.entityTypes.entities.batchCreate",
"httpMethod": "POST",
"path": "v2beta1/{+parent}/entities:batchCreate",
"response": {
"$ref": "GoogleLongrunningOperation"
},
"request": {
"$ref": "GoogleCloudDialogflowV2beta1BatchCreateEntitiesRequest"
},
"parameterOrder": [
"parent"
]
}
}
}
}
},
"sessions": {
"resources": {
"entityTypes": {
"methods": {
"create": {
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameterOrder": [
"parent"
],
"response": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
},
"id": "dialogflow.projects.locations.agent.sessions.entityTypes.create",
"httpMethod": "POST",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/sessions/{sessionsId}/entityTypes",
"description": "Creates a session entity type. If the specified session entity type already exists, overrides the session entity type. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.",
"path": "v2beta1/{+parent}/entityTypes",
"parameters": {
"parent": {
"required": true,
"type": "string",
"description": "Required. The session to create a session entity type for. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"pattern": "^projects/[^/]+/locations/[^/]+/agent/sessions/[^/]+$",
"location": "path"
}
},
"request": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
}
},
"patch": {
"parameterOrder": [
"name"
],
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameters": {
"updateMask": {
"type": "string",
"description": "Optional. The mask to control which fields get updated.",
"format": "google-fieldmask",
"location": "query"
},
"name": {
"type": "string",
"description": "Required. The unique identifier of this session entity type. Supported formats: - `projects//agent/sessions//entityTypes/` - `projects//locations//agent/sessions//entityTypes/` - `projects//agent/environments//users//sessions//entityTypes/` - `projects//locations//agent/environments/ /users//sessions//entityTypes/` If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. `` must be the display name of an existing entity type in the same agent that will be overridden or supplemented.",
"pattern": "^projects/[^/]+/locations/[^/]+/agent/sessions/[^/]+/entityTypes/[^/]+$",
"required": true,
"location": "path"
}
},
"description": "Updates the specified session entity type. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
},
"httpMethod": "PATCH",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/sessions/{sessionsId}/entityTypes/{entityTypesId}",
"path": "v2beta1/{+name}",
"id": "dialogflow.projects.locations.agent.sessions.entityTypes.patch",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
}
},
"list": {
"id": "dialogflow.projects.locations.agent.sessions.entityTypes.list",
"httpMethod": "GET",
"description": "Returns the list of all session entity types in the specified session. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.",
"parameters": {
"pageSize": {
"location": "query",
"format": "int32",
"description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.",
"type": "integer"
},
"parent": {
"type": "string",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/agent/sessions/[^/]+$",
"description": "Required. The session to list all session entity types from. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"required": true
},
"pageToken": {
"description": "Optional. The next_page_token value returned from a previous list request.",
"location": "query",
"type": "string"
}
},
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/sessions/{sessionsId}/entityTypes",
"parameterOrder": [
"parent"
],
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"response": {
"$ref": "GoogleCloudDialogflowV2beta1ListSessionEntityTypesResponse"
},
"path": "v2beta1/{+parent}/entityTypes"
},
"get": {
"response": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
},
"description": "Retrieves the specified session entity type. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.",
"parameterOrder": [
"name"
],
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"id": "dialogflow.projects.locations.agent.sessions.entityTypes.get",
"parameters": {
"name": {
"pattern": "^projects/[^/]+/locations/[^/]+/agent/sessions/[^/]+/entityTypes/[^/]+$",
"description": "Required. The name of the session entity type. Supported formats: - `projects//agent/sessions//entityTypes/` - `projects//locations//agent/sessions//entityTypes/` - `projects//agent/environments//users//sessions//entityTypes/` - `projects//locations//agent/environments/ /users//sessions//entityTypes/` If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"location": "path",
"type": "string",
"required": true
}
},
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/sessions/{sessionsId}/entityTypes/{entityTypesId}",
"httpMethod": "GET",
"path": "v2beta1/{+name}"
},
"delete": {
"id": "dialogflow.projects.locations.agent.sessions.entityTypes.delete",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/sessions/{sessionsId}/entityTypes/{entityTypesId}",
"httpMethod": "DELETE",
"parameters": {
"name": {
"description": "Required. The name of the entity type to delete. Supported formats: - `projects//agent/sessions//entityTypes/` - `projects//locations//agent/sessions//entityTypes/` - `projects//agent/environments//users//sessions//entityTypes/` - `projects//locations//agent/environments/ /users//sessions//entityTypes/` If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"type": "string",
"location": "path",
"required": true,
"pattern": "^projects/[^/]+/locations/[^/]+/agent/sessions/[^/]+/entityTypes/[^/]+$"
}
},
"response": {
"$ref": "GoogleProtobufEmpty"
},
"parameterOrder": [
"name"
],
"description": "Deletes the specified session entity type. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"path": "v2beta1/{+name}"
}
}
},
"contexts": {
"methods": {
"create": {
"description": "Creates a context. If the specified context already exists, overrides the context.",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"parameterOrder": [
"parent"
],
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"id": "dialogflow.projects.locations.agent.sessions.contexts.create",
"httpMethod": "POST",
"parameters": {
"parent": {
"required": true,
"type": "string",
"pattern": "^projects/[^/]+/locations/[^/]+/agent/sessions/[^/]+$",
"description": "Required. The session to create a context for. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"location": "path"
}
},
"path": "v2beta1/{+parent}/contexts",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/sessions/{sessionsId}/contexts",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
}
},
"list": {
"response": {
"$ref": "GoogleCloudDialogflowV2beta1ListContextsResponse"
},
"description": "Returns the list of all contexts in the specified session.",
"path": "v2beta1/{+parent}/contexts",
"httpMethod": "GET",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameters": {
"parent": {
"location": "path",
"type": "string",
"required": true,
"description": "Required. The session to list all contexts from. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"pattern": "^projects/[^/]+/locations/[^/]+/agent/sessions/[^/]+$"
},
"pageToken": {
"location": "query",
"type": "string",
"description": "Optional. The next_page_token value returned from a previous list request."
},
"pageSize": {
"format": "int32",
"type": "integer",
"location": "query",
"description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000."
}
},
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/sessions/{sessionsId}/contexts",
"id": "dialogflow.projects.locations.agent.sessions.contexts.list",
"parameterOrder": [
"parent"
]
},
"patch": {
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/sessions/{sessionsId}/contexts/{contextsId}",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"httpMethod": "PATCH",
"parameters": {
"name": {
"location": "path",
"required": true,
"pattern": "^projects/[^/]+/locations/[^/]+/agent/sessions/[^/]+/contexts/[^/]+$",
"description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`",
"type": "string"
},
"updateMask": {
"location": "query",
"description": "Optional. The mask to control which fields get updated.",
"format": "google-fieldmask",
"type": "string"
}
},
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"id": "dialogflow.projects.locations.agent.sessions.contexts.patch",
"description": "Updates the specified context.",
"path": "v2beta1/{+name}",
"parameterOrder": [
"name"
],
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
]
},
"get": {
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/sessions/{sessionsId}/contexts/{contextsId}",
"parameters": {
"name": {
"type": "string",
"pattern": "^projects/[^/]+/locations/[^/]+/agent/sessions/[^/]+/contexts/[^/]+$",
"location": "path",
"description": "Required. The name of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"required": true
}
},
"id": "dialogflow.projects.locations.agent.sessions.contexts.get",
"httpMethod": "GET",
"path": "v2beta1/{+name}",
"parameterOrder": [
"name"
],
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"description": "Retrieves the specified context.",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
}
},
"delete": {
"description": "Deletes the specified context.",
"id": "dialogflow.projects.locations.agent.sessions.contexts.delete",
"path": "v2beta1/{+name}",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/sessions/{sessionsId}/contexts/{contextsId}",
"parameters": {
"name": {
"pattern": "^projects/[^/]+/locations/[^/]+/agent/sessions/[^/]+/contexts/[^/]+$",
"location": "path",
"required": true,
"description": "Required. The name of the context to delete. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"type": "string"
}
},
"parameterOrder": [
"name"
],
"response": {
"$ref": "GoogleProtobufEmpty"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"httpMethod": "DELETE"
}
}
}
},
"methods": {
"detectIntent": {
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/sessions/{sessionsId}:detectIntent",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1DetectIntentRequest"
},
"path": "v2beta1/{+session}:detectIntent",
"parameterOrder": [
"session"
],
"description": "Processes a natural language query and returns structured, actionable data as a result. This method is not idempotent, because it may cause contexts and session entity types to be updated, which in turn might affect results of future queries.",
"parameters": {
"session": {
"pattern": "^projects/[^/]+/locations/[^/]+/agent/sessions/[^/]+$",
"type": "string",
"location": "path",
"required": true,
"description": "Required. The name of the session this query is sent to. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we are using \"-\". It's up to the API caller to choose an appropriate `Session ID` and `User Id`. They can be a random number or some type of user and session identifiers (preferably hashed). The length of the `Session ID` and `User ID` must not exceed 36 characters. For more information, see the [API interactions guide](https://cloud.google.com/dialogflow/docs/api-overview)."
}
},
"httpMethod": "POST",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1DetectIntentResponse"
},
"id": "dialogflow.projects.locations.agent.sessions.detectIntent",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
]
},
"deleteContexts": {
"response": {
"$ref": "GoogleProtobufEmpty"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameters": {
"parent": {
"description": "Required. The name of the session to delete all contexts from. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"required": true,
"type": "string",
"pattern": "^projects/[^/]+/locations/[^/]+/agent/sessions/[^/]+$",
"location": "path"
}
},
"httpMethod": "DELETE",
"description": "Deletes all active contexts in the specified session.",
"parameterOrder": [
"parent"
],
"id": "dialogflow.projects.locations.agent.sessions.deleteContexts",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/sessions/{sessionsId}/contexts",
"path": "v2beta1/{+parent}/contexts"
}
}
},
"intents": {
"methods": {
"batchUpdate": {
"id": "dialogflow.projects.locations.agent.intents.batchUpdate",
"httpMethod": "POST",
"description": "Updates/Creates multiple intents in the specified agent. Operation ",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/intents:batchUpdate",
"parameters": {
"parent": {
"type": "string",
"description": "Required. The name of the agent to update or create intents in. Supported formats: - `projects//agent` - `projects//locations//agent`",
"pattern": "^projects/[^/]+/locations/[^/]+/agent$",
"required": true,
"location": "path"
}
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameterOrder": [
"parent"
],
"request": {
"$ref": "GoogleCloudDialogflowV2beta1BatchUpdateIntentsRequest"
},
"path": "v2beta1/{+parent}/intents:batchUpdate",
"response": {
"$ref": "GoogleLongrunningOperation"
}
},
"get": {
"parameters": {
"name": {
"location": "path",
"type": "string",
"pattern": "^projects/[^/]+/locations/[^/]+/agent/intents/[^/]+$",
"required": true,
"description": "Required. The name of the intent. Supported formats: - `projects//agent/intents/` - `projects//locations//agent/intents/`"
},
"languageCode": {
"description": "Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see [Multilingual intent and entity data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).",
"location": "query",
"type": "string"
},
"intentView": {
"type": "string",
"enumDescriptions": [
"Training phrases field is not populated in the response.",
"All fields are populated."
],
"enum": [
"INTENT_VIEW_UNSPECIFIED",
"INTENT_VIEW_FULL"
],
"location": "query",
"description": "Optional. The resource view to apply to the returned intent."
}
},
"description": "Retrieves the specified intent.",
"path": "v2beta1/{+name}",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Intent"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"httpMethod": "GET",
"id": "dialogflow.projects.locations.agent.intents.get",
"parameterOrder": [
"name"
],
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/intents/{intentsId}"
},
"delete": {
"parameterOrder": [
"name"
],
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameters": {
"name": {
"location": "path",
"description": "Required. The name of the intent to delete. If this intent has direct or indirect followup intents, we also delete them. Supported formats: - `projects//agent/intents/` - `projects//locations//agent/intents/`",
"type": "string",
"required": true,
"pattern": "^projects/[^/]+/locations/[^/]+/agent/intents/[^/]+$"
}
},
"response": {
"$ref": "GoogleProtobufEmpty"
},
"path": "v2beta1/{+name}",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/intents/{intentsId}",
"id": "dialogflow.projects.locations.agent.intents.delete",
"httpMethod": "DELETE",
"description": "Deletes the specified intent and its direct or indirect followup intents."
},
"list": {
"response": {
"$ref": "GoogleCloudDialogflowV2beta1ListIntentsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"description": "Returns the list of all intents in the specified agent.",
"httpMethod": "GET",
"path": "v2beta1/{+parent}/intents",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/intents",
"parameters": {
"languageCode": {
"type": "string",
"location": "query",
"description": "Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see [Multilingual intent and entity data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity)."
},
"parent": {
"location": "path",
"type": "string",
"description": "Required. The agent to list all intents from. Format: `projects//agent`.",
"pattern": "^projects/[^/]+/locations/[^/]+/agent$",
"required": true
},
"intentView": {
"enum": [
"INTENT_VIEW_UNSPECIFIED",
"INTENT_VIEW_FULL"
],
"type": "string",
"location": "query",
"enumDescriptions": [
"Training phrases field is not populated in the response.",
"All fields are populated."
],
"description": "Optional. The resource view to apply to the returned intent."
},
"pageToken": {
"location": "query",
"description": "Optional. The next_page_token value returned from a previous list request.",
"type": "string"
},
"pageSize": {
"location": "query",
"description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.",
"format": "int32",
"type": "integer"
}
},
"parameterOrder": [
"parent"
],
"id": "dialogflow.projects.locations.agent.intents.list"
},
"patch": {
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/intents/{intentsId}",
"httpMethod": "PATCH",
"parameters": {
"languageCode": {
"location": "query",
"description": "Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see [Multilingual intent and entity data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).",
"type": "string"
},
"name": {
"required": true,
"pattern": "^projects/[^/]+/locations/[^/]+/agent/intents/[^/]+$",
"location": "path",
"description": "Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Supported formats: - `projects//agent/intents/` - `projects//locations//agent/intents/`",
"type": "string"
},
"intentView": {
"enumDescriptions": [
"Training phrases field is not populated in the response.",
"All fields are populated."
],
"type": "string",
"enum": [
"INTENT_VIEW_UNSPECIFIED",
"INTENT_VIEW_FULL"
],
"description": "Optional. The resource view to apply to the returned intent.",
"location": "query"
},
"updateMask": {
"location": "query",
"description": "Optional. The mask to control which fields get updated.",
"type": "string",
"format": "google-fieldmask"
}
},
"request": {
"$ref": "GoogleCloudDialogflowV2beta1Intent"
},
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Intent"
},
"description": "Updates the specified intent.",
"id": "dialogflow.projects.locations.agent.intents.patch",
"parameterOrder": [
"name"
],
"path": "v2beta1/{+name}",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
]
},
"create": {
"parameterOrder": [
"parent"
],
"parameters": {
"parent": {
"type": "string",
"required": true,
"description": "Required. The agent to create a intent for. Supported formats: - `projects//agent` - `projects//locations//agent`",
"pattern": "^projects/[^/]+/locations/[^/]+/agent$",
"location": "path"
},
"languageCode": {
"description": "Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see [Multilingual intent and entity data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).",
"location": "query",
"type": "string"
},
"intentView": {
"description": "Optional. The resource view to apply to the returned intent.",
"enumDescriptions": [
"Training phrases field is not populated in the response.",
"All fields are populated."
],
"location": "query",
"enum": [
"INTENT_VIEW_UNSPECIFIED",
"INTENT_VIEW_FULL"
],
"type": "string"
}
},
"description": "Creates an intent in the specified agent.",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/intents",
"id": "dialogflow.projects.locations.agent.intents.create",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Intent"
},
"request": {
"$ref": "GoogleCloudDialogflowV2beta1Intent"
},
"httpMethod": "POST",
"path": "v2beta1/{+parent}/intents"
},
"batchDelete": {
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/intents:batchDelete",
"id": "dialogflow.projects.locations.agent.intents.batchDelete",
"httpMethod": "POST",
"response": {
"$ref": "GoogleLongrunningOperation"
},
"parameterOrder": [
"parent"
],
"request": {
"$ref": "GoogleCloudDialogflowV2beta1BatchDeleteIntentsRequest"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"description": "Deletes intents in the specified agent. Operation ",
"parameters": {
"parent": {
"location": "path",
"description": "Required. The name of the agent to delete all entities types for. Supported formats: - `projects//agent` - `projects//locations//agent`",
"pattern": "^projects/[^/]+/locations/[^/]+/agent$",
"required": true,
"type": "string"
}
},
"path": "v2beta1/{+parent}/intents:batchDelete"
}
}
}
},
"methods": {
"import": {
"path": "v2beta1/{+parent}/agent:import",
"description": "Imports the specified agent from a ZIP file. Uploads new intents and entity types without deleting the existing ones. Intents and entity types with the same name are replaced with the new versions from ImportAgentRequest. After the import, the imported draft agent will be trained automatically (unless disabled in agent settings). However, once the import is done, training may not be completed yet. Please call TrainAgent and wait for the operation it returns in order to train explicitly. Operation An operation which tracks when importing is complete. It only tracks when the draft agent is updated not when it is done training.",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1ImportAgentRequest"
},
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent:import",
"id": "dialogflow.projects.locations.agent.import",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameterOrder": [
"parent"
],
"httpMethod": "POST",
"response": {
"$ref": "GoogleLongrunningOperation"
},
"parameters": {
"parent": {
"required": true,
"pattern": "^projects/[^/]+/locations/[^/]+$",
"type": "string",
"description": "Required. The project that the agent to import is associated with. Format: `projects/` or `projects//locations/`.",
"location": "path"
}
}
},
"updateFulfillment": {
"id": "dialogflow.projects.locations.agent.updateFulfillment",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/fulfillment",
"description": "Updates the fulfillment.",
"httpMethod": "PATCH",
"parameters": {
"name": {
"type": "string",
"pattern": "^projects/[^/]+/locations/[^/]+/agent/fulfillment$",
"location": "path",
"description": "Required. The unique identifier of the fulfillment. Supported formats: - `projects//agent/fulfillment` - `projects//locations//agent/fulfillment`",
"required": true
},
"updateMask": {
"location": "query",
"type": "string",
"format": "google-fieldmask",
"description": "Required. The mask to control which fields get updated. If the mask is not present, all fields will be updated."
}
},
"parameterOrder": [
"name"
],
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Fulfillment"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"request": {
"$ref": "GoogleCloudDialogflowV2beta1Fulfillment"
},
"path": "v2beta1/{+name}"
},
"getValidationResult": {
"parameterOrder": [
"parent"
],
"parameters": {
"languageCode": {
"type": "string",
"description": "Optional. The language for which you want a validation result. If not specified, the agent's default language is used. [Many languages](https://cloud.google.com/dialogflow/docs/reference/language) are supported. Note: languages must be enabled in the agent before they can be used.",
"location": "query"
},
"parent": {
"pattern": "^projects/[^/]+/locations/[^/]+$",
"required": true,
"location": "path",
"type": "string",
"description": "Required. The project that the agent is associated with. Format: `projects/` or `projects//locations/`."
}
},
"httpMethod": "GET",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"path": "v2beta1/{+parent}/agent/validationResult",
"description": "Gets agent validation result. Agent validation is performed during training time and is updated automatically when training is completed.",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1ValidationResult"
},
"id": "dialogflow.projects.locations.agent.getValidationResult",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/validationResult"
},
"export": {
"request": {
"$ref": "GoogleCloudDialogflowV2beta1ExportAgentRequest"
},
"parameters": {
"parent": {
"description": "Required. The project that the agent to export is associated with. Format: `projects/` or `projects//locations/`.",
"type": "string",
"pattern": "^projects/[^/]+/locations/[^/]+$",
"location": "path",
"required": true
}
},
"httpMethod": "POST",
"parameterOrder": [
"parent"
],
"description": "Exports the specified agent to a ZIP file. Operation ",
"path": "v2beta1/{+parent}/agent:export",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"id": "dialogflow.projects.locations.agent.export",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent:export",
"response": {
"$ref": "GoogleLongrunningOperation"
}
},
"train": {
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameterOrder": [
"parent"
],
"request": {
"$ref": "GoogleCloudDialogflowV2beta1TrainAgentRequest"
},
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent:train",
"response": {
"$ref": "GoogleLongrunningOperation"
},
"description": "Trains the specified agent. Operation ",
"parameters": {
"parent": {
"pattern": "^projects/[^/]+/locations/[^/]+$",
"description": "Required. The project that the agent to train is associated with. Format: `projects/` or `projects//locations/`.",
"type": "string",
"location": "path",
"required": true
}
},
"httpMethod": "POST",
"id": "dialogflow.projects.locations.agent.train",
"path": "v2beta1/{+parent}/agent:train"
},
"restore": {
"path": "v2beta1/{+parent}/agent:restore",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1RestoreAgentRequest"
},
"response": {
"$ref": "GoogleLongrunningOperation"
},
"parameters": {
"parent": {
"required": true,
"pattern": "^projects/[^/]+/locations/[^/]+$",
"type": "string",
"location": "path",
"description": "Required. The project that the agent to restore is associated with. Format: `projects/` or `projects//locations/`."
}
},
"description": "Restores the specified agent from a ZIP file. Replaces the current agent version with a new one. All the intents and entity types in the older version are deleted. After the restore, the restored draft agent will be trained automatically (unless disabled in agent settings). However, once the restore is done, training may not be completed yet. Please call TrainAgent and wait for the operation it returns in order to train explicitly. Operation An operation which tracks when restoring is complete. It only tracks when the draft agent is updated not when it is done training.",
"parameterOrder": [
"parent"
],
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent:restore",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"id": "dialogflow.projects.locations.agent.restore",
"httpMethod": "POST"
},
"getFulfillment": {
"id": "dialogflow.projects.locations.agent.getFulfillment",
"httpMethod": "GET",
"description": "Retrieves the fulfillment.",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/fulfillment",
"parameterOrder": [
"name"
],
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameters": {
"name": {
"required": true,
"pattern": "^projects/[^/]+/locations/[^/]+/agent/fulfillment$",
"type": "string",
"location": "path",
"description": "Required. The name of the fulfillment. Supported formats: - `projects//agent/fulfillment` - `projects//locations//agent/fulfillment`"
}
},
"path": "v2beta1/{+name}",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Fulfillment"
}
},
"search": {
"httpMethod": "GET",
"path": "v2beta1/{+parent}/agent:search",
"flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent:search",
"parameterOrder": [
"parent"
],
"response": {
"$ref": "GoogleCloudDialogflowV2beta1SearchAgentsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"description": "Returns the list of agents. Since there is at most one conversational agent per project, this method is useful primarily for listing all agents across projects the caller has access to. One can achieve that with a wildcard project collection id \"-\". Refer to [List Sub-Collections](https://cloud.google.com/apis/design/design_patterns#list_sub-collections).",
"parameters": {
"parent": {
"location": "path",
"type": "string",
"description": "Required. The project to list agents from. Format: `projects/` or `projects//locations/`.",
"pattern": "^projects/[^/]+/locations/[^/]+$",
"required": true
},
"pageSize": {
"type": "integer",
"description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.",
"format": "int32",
"location": "query"
},
"pageToken": {
"type": "string",
"description": "Optional. The next_page_token value returned from a previous list request.",
"location": "query"
}
},
"id": "dialogflow.projects.locations.agent.search"
}
}
}
}
},
"agent": {
"methods": {
"train": {
"flatPath": "v2beta1/projects/{projectsId}/agent:train",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1TrainAgentRequest"
},
"path": "v2beta1/{+parent}/agent:train",
"httpMethod": "POST",
"parameterOrder": [
"parent"
],
"id": "dialogflow.projects.agent.train",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"description": "Trains the specified agent. Operation ",
"response": {
"$ref": "GoogleLongrunningOperation"
},
"parameters": {
"parent": {
"type": "string",
"pattern": "^projects/[^/]+$",
"description": "Required. The project that the agent to train is associated with. Format: `projects/` or `projects//locations/`.",
"required": true,
"location": "path"
}
}
},
"getFulfillment": {
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"flatPath": "v2beta1/projects/{projectsId}/agent/fulfillment",
"parameters": {
"name": {
"type": "string",
"location": "path",
"pattern": "^projects/[^/]+/agent/fulfillment$",
"required": true,
"description": "Required. The name of the fulfillment. Supported formats: - `projects//agent/fulfillment` - `projects//locations//agent/fulfillment`"
}
},
"parameterOrder": [
"name"
],
"id": "dialogflow.projects.agent.getFulfillment",
"path": "v2beta1/{+name}",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Fulfillment"
},
"description": "Retrieves the fulfillment.",
"httpMethod": "GET"
},
"import": {
"response": {
"$ref": "GoogleLongrunningOperation"
},
"request": {
"$ref": "GoogleCloudDialogflowV2beta1ImportAgentRequest"
},
"parameters": {
"parent": {
"pattern": "^projects/[^/]+$",
"description": "Required. The project that the agent to import is associated with. Format: `projects/` or `projects//locations/`.",
"location": "path",
"required": true,
"type": "string"
}
},
"flatPath": "v2beta1/projects/{projectsId}/agent:import",
"path": "v2beta1/{+parent}/agent:import",
"description": "Imports the specified agent from a ZIP file. Uploads new intents and entity types without deleting the existing ones. Intents and entity types with the same name are replaced with the new versions from ImportAgentRequest. After the import, the imported draft agent will be trained automatically (unless disabled in agent settings). However, once the import is done, training may not be completed yet. Please call TrainAgent and wait for the operation it returns in order to train explicitly. Operation An operation which tracks when importing is complete. It only tracks when the draft agent is updated not when it is done training.",
"httpMethod": "POST",
"parameterOrder": [
"parent"
],
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"id": "dialogflow.projects.agent.import"
},
"updateFulfillment": {
"id": "dialogflow.projects.agent.updateFulfillment",
"description": "Updates the fulfillment.",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Fulfillment"
},
"path": "v2beta1/{+name}",
"flatPath": "v2beta1/projects/{projectsId}/agent/fulfillment",
"parameters": {
"updateMask": {
"description": "Required. The mask to control which fields get updated. If the mask is not present, all fields will be updated.",
"format": "google-fieldmask",
"location": "query",
"type": "string"
},
"name": {
"location": "path",
"type": "string",
"pattern": "^projects/[^/]+/agent/fulfillment$",
"description": "Required. The unique identifier of the fulfillment. Supported formats: - `projects//agent/fulfillment` - `projects//locations//agent/fulfillment`",
"required": true
}
},
"parameterOrder": [
"name"
],
"httpMethod": "PATCH",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1Fulfillment"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
]
},
"search": {
"flatPath": "v2beta1/projects/{projectsId}/agent:search",
"id": "dialogflow.projects.agent.search",
"description": "Returns the list of agents. Since there is at most one conversational agent per project, this method is useful primarily for listing all agents across projects the caller has access to. One can achieve that with a wildcard project collection id \"-\". Refer to [List Sub-Collections](https://cloud.google.com/apis/design/design_patterns#list_sub-collections).",
"parameterOrder": [
"parent"
],
"response": {
"$ref": "GoogleCloudDialogflowV2beta1SearchAgentsResponse"
},
"parameters": {
"parent": {
"location": "path",
"pattern": "^projects/[^/]+$",
"description": "Required. The project to list agents from. Format: `projects/` or `projects//locations/`.",
"type": "string",
"required": true
},
"pageToken": {
"description": "Optional. The next_page_token value returned from a previous list request.",
"location": "query",
"type": "string"
},
"pageSize": {
"format": "int32",
"type": "integer",
"description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.",
"location": "query"
}
},
"path": "v2beta1/{+parent}/agent:search",
"httpMethod": "GET",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
]
},
"getValidationResult": {
"flatPath": "v2beta1/projects/{projectsId}/agent/validationResult",
"path": "v2beta1/{+parent}/agent/validationResult",
"description": "Gets agent validation result. Agent validation is performed during training time and is updated automatically when training is completed.",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1ValidationResult"
},
"parameterOrder": [
"parent"
],
"httpMethod": "GET",
"id": "dialogflow.projects.agent.getValidationResult",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameters": {
"parent": {
"location": "path",
"description": "Required. The project that the agent is associated with. Format: `projects/` or `projects//locations/`.",
"type": "string",
"pattern": "^projects/[^/]+$",
"required": true
},
"languageCode": {
"description": "Optional. The language for which you want a validation result. If not specified, the agent's default language is used. [Many languages](https://cloud.google.com/dialogflow/docs/reference/language) are supported. Note: languages must be enabled in the agent before they can be used.",
"location": "query",
"type": "string"
}
}
},
"export": {
"httpMethod": "POST",
"path": "v2beta1/{+parent}/agent:export",
"response": {
"$ref": "GoogleLongrunningOperation"
},
"id": "dialogflow.projects.agent.export",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1ExportAgentRequest"
},
"description": "Exports the specified agent to a ZIP file. Operation ",
"parameters": {
"parent": {
"type": "string",
"location": "path",
"description": "Required. The project that the agent to export is associated with. Format: `projects/` or `projects//locations/`.",
"pattern": "^projects/[^/]+$",
"required": true
}
},
"flatPath": "v2beta1/projects/{projectsId}/agent:export",
"parameterOrder": [
"parent"
],
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
]
},
"restore": {
"response": {
"$ref": "GoogleLongrunningOperation"
},
"flatPath": "v2beta1/projects/{projectsId}/agent:restore",
"path": "v2beta1/{+parent}/agent:restore",
"id": "dialogflow.projects.agent.restore",
"parameterOrder": [
"parent"
],
"request": {
"$ref": "GoogleCloudDialogflowV2beta1RestoreAgentRequest"
},
"parameters": {
"parent": {
"description": "Required. The project that the agent to restore is associated with. Format: `projects/` or `projects//locations/`.",
"location": "path",
"required": true,
"type": "string",
"pattern": "^projects/[^/]+$"
}
},
"description": "Restores the specified agent from a ZIP file. Replaces the current agent version with a new one. All the intents and entity types in the older version are deleted. After the restore, the restored draft agent will be trained automatically (unless disabled in agent settings). However, once the restore is done, training may not be completed yet. Please call TrainAgent and wait for the operation it returns in order to train explicitly. Operation An operation which tracks when restoring is complete. It only tracks when the draft agent is updated not when it is done training.",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"httpMethod": "POST"
}
},
"resources": {
"intents": {
"methods": {
"batchUpdate": {
"description": "Updates/Creates multiple intents in the specified agent. Operation ",
"response": {
"$ref": "GoogleLongrunningOperation"
},
"parameters": {
"parent": {
"pattern": "^projects/[^/]+/agent$",
"type": "string",
"location": "path",
"required": true,
"description": "Required. The name of the agent to update or create intents in. Supported formats: - `projects//agent` - `projects//locations//agent`"
}
},
"id": "dialogflow.projects.agent.intents.batchUpdate",
"httpMethod": "POST",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1BatchUpdateIntentsRequest"
},
"path": "v2beta1/{+parent}/intents:batchUpdate",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameterOrder": [
"parent"
],
"flatPath": "v2beta1/projects/{projectsId}/agent/intents:batchUpdate"
},
"list": {
"httpMethod": "GET",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1ListIntentsResponse"
},
"id": "dialogflow.projects.agent.intents.list",
"path": "v2beta1/{+parent}/intents",
"parameters": {
"pageSize": {
"type": "integer",
"location": "query",
"description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.",
"format": "int32"
},
"parent": {
"required": true,
"description": "Required. The agent to list all intents from. Format: `projects//agent`.",
"type": "string",
"location": "path",
"pattern": "^projects/[^/]+/agent$"
},
"pageToken": {
"location": "query",
"type": "string",
"description": "Optional. The next_page_token value returned from a previous list request."
},
"intentView": {
"location": "query",
"enum": [
"INTENT_VIEW_UNSPECIFIED",
"INTENT_VIEW_FULL"
],
"enumDescriptions": [
"Training phrases field is not populated in the response.",
"All fields are populated."
],
"type": "string",
"description": "Optional. The resource view to apply to the returned intent."
},
"languageCode": {
"type": "string",
"location": "query",
"description": "Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see [Multilingual intent and entity data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity)."
}
},
"parameterOrder": [
"parent"
],
"description": "Returns the list of all intents in the specified agent.",
"flatPath": "v2beta1/projects/{projectsId}/agent/intents",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
]
},
"patch": {
"parameterOrder": [
"name"
],
"id": "dialogflow.projects.agent.intents.patch",
"httpMethod": "PATCH",
"path": "v2beta1/{+name}",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Intent"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"request": {
"$ref": "GoogleCloudDialogflowV2beta1Intent"
},
"flatPath": "v2beta1/projects/{projectsId}/agent/intents/{intentsId}",
"parameters": {
"languageCode": {
"location": "query",
"type": "string",
"description": "Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see [Multilingual intent and entity data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity)."
},
"name": {
"type": "string",
"pattern": "^projects/[^/]+/agent/intents/[^/]+$",
"description": "Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Supported formats: - `projects//agent/intents/` - `projects//locations//agent/intents/`",
"location": "path",
"required": true
},
"updateMask": {
"location": "query",
"description": "Optional. The mask to control which fields get updated.",
"type": "string",
"format": "google-fieldmask"
},
"intentView": {
"description": "Optional. The resource view to apply to the returned intent.",
"location": "query",
"type": "string",
"enum": [
"INTENT_VIEW_UNSPECIFIED",
"INTENT_VIEW_FULL"
],
"enumDescriptions": [
"Training phrases field is not populated in the response.",
"All fields are populated."
]
}
},
"description": "Updates the specified intent."
},
"get": {
"httpMethod": "GET",
"parameters": {
"languageCode": {
"location": "query",
"type": "string",
"description": "Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see [Multilingual intent and entity data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity)."
},
"name": {
"type": "string",
"pattern": "^projects/[^/]+/agent/intents/[^/]+$",
"location": "path",
"required": true,
"description": "Required. The name of the intent. Supported formats: - `projects//agent/intents/` - `projects//locations//agent/intents/`"
},
"intentView": {
"type": "string",
"enumDescriptions": [
"Training phrases field is not populated in the response.",
"All fields are populated."
],
"description": "Optional. The resource view to apply to the returned intent.",
"enum": [
"INTENT_VIEW_UNSPECIFIED",
"INTENT_VIEW_FULL"
],
"location": "query"
}
},
"description": "Retrieves the specified intent.",
"parameterOrder": [
"name"
],
"flatPath": "v2beta1/projects/{projectsId}/agent/intents/{intentsId}",
"id": "dialogflow.projects.agent.intents.get",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Intent"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"path": "v2beta1/{+name}"
},
"batchDelete": {
"path": "v2beta1/{+parent}/intents:batchDelete",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameterOrder": [
"parent"
],
"parameters": {
"parent": {
"type": "string",
"required": true,
"pattern": "^projects/[^/]+/agent$",
"location": "path",
"description": "Required. The name of the agent to delete all entities types for. Supported formats: - `projects//agent` - `projects//locations//agent`"
}
},
"request": {
"$ref": "GoogleCloudDialogflowV2beta1BatchDeleteIntentsRequest"
},
"response": {
"$ref": "GoogleLongrunningOperation"
},
"httpMethod": "POST",
"id": "dialogflow.projects.agent.intents.batchDelete",
"description": "Deletes intents in the specified agent. Operation ",
"flatPath": "v2beta1/projects/{projectsId}/agent/intents:batchDelete"
},
"delete": {
"flatPath": "v2beta1/projects/{projectsId}/agent/intents/{intentsId}",
"response": {
"$ref": "GoogleProtobufEmpty"
},
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"location": "path",
"description": "Required. The name of the intent to delete. If this intent has direct or indirect followup intents, we also delete them. Supported formats: - `projects//agent/intents/` - `projects//locations//agent/intents/`",
"type": "string",
"pattern": "^projects/[^/]+/agent/intents/[^/]+$",
"required": true
}
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"description": "Deletes the specified intent and its direct or indirect followup intents.",
"path": "v2beta1/{+name}",
"httpMethod": "DELETE",
"id": "dialogflow.projects.agent.intents.delete"
},
"create": {
"description": "Creates an intent in the specified agent.",
"parameterOrder": [
"parent"
],
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Intent"
},
"httpMethod": "POST",
"parameters": {
"languageCode": {
"location": "query",
"description": "Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see [Multilingual intent and entity data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).",
"type": "string"
},
"intentView": {
"description": "Optional. The resource view to apply to the returned intent.",
"enumDescriptions": [
"Training phrases field is not populated in the response.",
"All fields are populated."
],
"location": "query",
"type": "string",
"enum": [
"INTENT_VIEW_UNSPECIFIED",
"INTENT_VIEW_FULL"
]
},
"parent": {
"location": "path",
"description": "Required. The agent to create a intent for. Supported formats: - `projects//agent` - `projects//locations//agent`",
"required": true,
"type": "string",
"pattern": "^projects/[^/]+/agent$"
}
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"request": {
"$ref": "GoogleCloudDialogflowV2beta1Intent"
},
"path": "v2beta1/{+parent}/intents",
"flatPath": "v2beta1/projects/{projectsId}/agent/intents",
"id": "dialogflow.projects.agent.intents.create"
}
}
},
"sessions": {
"methods": {
"deleteContexts": {
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"id": "dialogflow.projects.agent.sessions.deleteContexts",
"parameters": {
"parent": {
"pattern": "^projects/[^/]+/agent/sessions/[^/]+$",
"description": "Required. The name of the session to delete all contexts from. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"required": true,
"location": "path",
"type": "string"
}
},
"parameterOrder": [
"parent"
],
"httpMethod": "DELETE",
"flatPath": "v2beta1/projects/{projectsId}/agent/sessions/{sessionsId}/contexts",
"path": "v2beta1/{+parent}/contexts",
"response": {
"$ref": "GoogleProtobufEmpty"
},
"description": "Deletes all active contexts in the specified session."
},
"detectIntent": {
"path": "v2beta1/{+session}:detectIntent",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1DetectIntentRequest"
},
"id": "dialogflow.projects.agent.sessions.detectIntent",
"httpMethod": "POST",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameterOrder": [
"session"
],
"description": "Processes a natural language query and returns structured, actionable data as a result. This method is not idempotent, because it may cause contexts and session entity types to be updated, which in turn might affect results of future queries.",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1DetectIntentResponse"
},
"parameters": {
"session": {
"location": "path",
"type": "string",
"description": "Required. The name of the session this query is sent to. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we are using \"-\". It's up to the API caller to choose an appropriate `Session ID` and `User Id`. They can be a random number or some type of user and session identifiers (preferably hashed). The length of the `Session ID` and `User ID` must not exceed 36 characters. For more information, see the [API interactions guide](https://cloud.google.com/dialogflow/docs/api-overview).",
"pattern": "^projects/[^/]+/agent/sessions/[^/]+$",
"required": true
}
},
"flatPath": "v2beta1/projects/{projectsId}/agent/sessions/{sessionsId}:detectIntent"
}
},
"resources": {
"entityTypes": {
"methods": {
"list": {
"id": "dialogflow.projects.agent.sessions.entityTypes.list",
"path": "v2beta1/{+parent}/entityTypes",
"flatPath": "v2beta1/projects/{projectsId}/agent/sessions/{sessionsId}/entityTypes",
"description": "Returns the list of all session entity types in the specified session. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1ListSessionEntityTypesResponse"
},
"httpMethod": "GET",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameters": {
"parent": {
"location": "path",
"description": "Required. The session to list all session entity types from. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"type": "string",
"required": true,
"pattern": "^projects/[^/]+/agent/sessions/[^/]+$"
},
"pageToken": {
"location": "query",
"description": "Optional. The next_page_token value returned from a previous list request.",
"type": "string"
},
"pageSize": {
"location": "query",
"type": "integer",
"description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.",
"format": "int32"
}
},
"parameterOrder": [
"parent"
]
},
"create": {
"description": "Creates a session entity type. If the specified session entity type already exists, overrides the session entity type. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.",
"flatPath": "v2beta1/projects/{projectsId}/agent/sessions/{sessionsId}/entityTypes",
"parameters": {
"parent": {
"required": true,
"location": "path",
"description": "Required. The session to create a session entity type for. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"type": "string",
"pattern": "^projects/[^/]+/agent/sessions/[^/]+$"
}
},
"id": "dialogflow.projects.agent.sessions.entityTypes.create",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
},
"httpMethod": "POST",
"parameterOrder": [
"parent"
],
"path": "v2beta1/{+parent}/entityTypes",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"request": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
}
},
"get": {
"httpMethod": "GET",
"parameterOrder": [
"name"
],
"description": "Retrieves the specified session entity type. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.",
"id": "dialogflow.projects.agent.sessions.entityTypes.get",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
},
"path": "v2beta1/{+name}",
"parameters": {
"name": {
"description": "Required. The name of the session entity type. Supported formats: - `projects//agent/sessions//entityTypes/` - `projects//locations//agent/sessions//entityTypes/` - `projects//agent/environments//users//sessions//entityTypes/` - `projects//locations//agent/environments/ /users//sessions//entityTypes/` If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"location": "path",
"type": "string",
"pattern": "^projects/[^/]+/agent/sessions/[^/]+/entityTypes/[^/]+$",
"required": true
}
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"flatPath": "v2beta1/projects/{projectsId}/agent/sessions/{sessionsId}/entityTypes/{entityTypesId}"
},
"patch": {
"httpMethod": "PATCH",
"parameters": {
"updateMask": {
"format": "google-fieldmask",
"description": "Optional. The mask to control which fields get updated.",
"type": "string",
"location": "query"
},
"name": {
"pattern": "^projects/[^/]+/agent/sessions/[^/]+/entityTypes/[^/]+$",
"description": "Required. The unique identifier of this session entity type. Supported formats: - `projects//agent/sessions//entityTypes/` - `projects//locations//agent/sessions//entityTypes/` - `projects//agent/environments//users//sessions//entityTypes/` - `projects//locations//agent/environments/ /users//sessions//entityTypes/` If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. `` must be the display name of an existing entity type in the same agent that will be overridden or supplemented.",
"location": "path",
"required": true,
"type": "string"
}
},
"flatPath": "v2beta1/projects/{projectsId}/agent/sessions/{sessionsId}/entityTypes/{entityTypesId}",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"response": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
},
"id": "dialogflow.projects.agent.sessions.entityTypes.patch",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
},
"path": "v2beta1/{+name}",
"parameterOrder": [
"name"
],
"description": "Updates the specified session entity type. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration."
},
"delete": {
"parameters": {
"name": {
"location": "path",
"pattern": "^projects/[^/]+/agent/sessions/[^/]+/entityTypes/[^/]+$",
"type": "string",
"required": true,
"description": "Required. The name of the entity type to delete. Supported formats: - `projects//agent/sessions//entityTypes/` - `projects//locations//agent/sessions//entityTypes/` - `projects//agent/environments//users//sessions//entityTypes/` - `projects//locations//agent/environments/ /users//sessions//entityTypes/` If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user."
}
},
"flatPath": "v2beta1/projects/{projectsId}/agent/sessions/{sessionsId}/entityTypes/{entityTypesId}",
"description": "Deletes the specified session entity type. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.",
"parameterOrder": [
"name"
],
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"id": "dialogflow.projects.agent.sessions.entityTypes.delete",
"httpMethod": "DELETE",
"response": {
"$ref": "GoogleProtobufEmpty"
},
"path": "v2beta1/{+name}"
}
}
},
"contexts": {
"methods": {
"delete": {
"id": "dialogflow.projects.agent.sessions.contexts.delete",
"response": {
"$ref": "GoogleProtobufEmpty"
},
"description": "Deletes the specified context.",
"path": "v2beta1/{+name}",
"parameters": {
"name": {
"type": "string",
"required": true,
"pattern": "^projects/[^/]+/agent/sessions/[^/]+/contexts/[^/]+$",
"description": "Required. The name of the context to delete. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"location": "path"
}
},
"parameterOrder": [
"name"
],
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"httpMethod": "DELETE",
"flatPath": "v2beta1/projects/{projectsId}/agent/sessions/{sessionsId}/contexts/{contextsId}"
},
"patch": {
"httpMethod": "PATCH",
"description": "Updates the specified context.",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"parameters": {
"name": {
"required": true,
"pattern": "^projects/[^/]+/agent/sessions/[^/]+/contexts/[^/]+$",
"description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`",
"location": "path",
"type": "string"
},
"updateMask": {
"type": "string",
"location": "query",
"description": "Optional. The mask to control which fields get updated.",
"format": "google-fieldmask"
}
},
"id": "dialogflow.projects.agent.sessions.contexts.patch",
"parameterOrder": [
"name"
],
"flatPath": "v2beta1/projects/{projectsId}/agent/sessions/{sessionsId}/contexts/{contextsId}",
"path": "v2beta1/{+name}",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
]
},
"create": {
"parameterOrder": [
"parent"
],
"parameters": {
"parent": {
"pattern": "^projects/[^/]+/agent/sessions/[^/]+$",
"location": "path",
"description": "Required. The session to create a context for. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"required": true,
"type": "string"
}
},
"httpMethod": "POST",
"flatPath": "v2beta1/projects/{projectsId}/agent/sessions/{sessionsId}/contexts",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"description": "Creates a context. If the specified context already exists, overrides the context.",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"id": "dialogflow.projects.agent.sessions.contexts.create",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"path": "v2beta1/{+parent}/contexts"
},
"get": {
"id": "dialogflow.projects.agent.sessions.contexts.get",
"parameterOrder": [
"name"
],
"flatPath": "v2beta1/projects/{projectsId}/agent/sessions/{sessionsId}/contexts/{contextsId}",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"httpMethod": "GET",
"description": "Retrieves the specified context.",
"parameters": {
"name": {
"pattern": "^projects/[^/]+/agent/sessions/[^/]+/contexts/[^/]+$",
"location": "path",
"type": "string",
"description": "Required. The name of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"required": true
}
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"path": "v2beta1/{+name}"
},
"list": {
"parameters": {
"parent": {
"required": true,
"type": "string",
"pattern": "^projects/[^/]+/agent/sessions/[^/]+$",
"location": "path",
"description": "Required. The session to list all contexts from. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user."
},
"pageSize": {
"format": "int32",
"type": "integer",
"description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.",
"location": "query"
},
"pageToken": {
"description": "Optional. The next_page_token value returned from a previous list request.",
"type": "string",
"location": "query"
}
},
"description": "Returns the list of all contexts in the specified session.",
"path": "v2beta1/{+parent}/contexts",
"parameterOrder": [
"parent"
],
"flatPath": "v2beta1/projects/{projectsId}/agent/sessions/{sessionsId}/contexts",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"httpMethod": "GET",
"id": "dialogflow.projects.agent.sessions.contexts.list",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1ListContextsResponse"
}
}
}
}
}
},
"environments": {
"resources": {
"users": {
"resources": {
"sessions": {
"methods": {
"deleteContexts": {
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"response": {
"$ref": "GoogleProtobufEmpty"
},
"path": "v2beta1/{+parent}/contexts",
"flatPath": "v2beta1/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/contexts",
"parameters": {
"parent": {
"required": true,
"description": "Required. The name of the session to delete all contexts from. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$",
"type": "string",
"location": "path"
}
},
"description": "Deletes all active contexts in the specified session.",
"httpMethod": "DELETE",
"id": "dialogflow.projects.agent.environments.users.sessions.deleteContexts",
"parameterOrder": [
"parent"
]
},
"detectIntent": {
"httpMethod": "POST",
"parameterOrder": [
"session"
],
"path": "v2beta1/{+session}:detectIntent",
"id": "dialogflow.projects.agent.environments.users.sessions.detectIntent",
"parameters": {
"session": {
"type": "string",
"description": "Required. The name of the session this query is sent to. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we are using \"-\". It's up to the API caller to choose an appropriate `Session ID` and `User Id`. They can be a random number or some type of user and session identifiers (preferably hashed). The length of the `Session ID` and `User ID` must not exceed 36 characters. For more information, see the [API interactions guide](https://cloud.google.com/dialogflow/docs/api-overview).",
"required": true,
"location": "path",
"pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$"
}
},
"flatPath": "v2beta1/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}:detectIntent",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1DetectIntentRequest"
},
"description": "Processes a natural language query and returns structured, actionable data as a result. This method is not idempotent, because it may cause contexts and session entity types to be updated, which in turn might affect results of future queries.",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"response": {
"$ref": "GoogleCloudDialogflowV2beta1DetectIntentResponse"
}
}
},
"resources": {
"entityTypes": {
"methods": {
"get": {
"path": "v2beta1/{+name}",
"parameterOrder": [
"name"
],
"description": "Retrieves the specified session entity type. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.",
"id": "dialogflow.projects.agent.environments.users.sessions.entityTypes.get",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"httpMethod": "GET",
"flatPath": "v2beta1/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes/{entityTypesId}",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
},
"parameters": {
"name": {
"description": "Required. The name of the session entity type. Supported formats: - `projects//agent/sessions//entityTypes/` - `projects//locations//agent/sessions//entityTypes/` - `projects//agent/environments//users//sessions//entityTypes/` - `projects//locations//agent/environments/ /users//sessions//entityTypes/` If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"type": "string",
"required": true,
"location": "path",
"pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/entityTypes/[^/]+$"
}
}
},
"create": {
"response": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
},
"path": "v2beta1/{+parent}/entityTypes",
"parameterOrder": [
"parent"
],
"id": "dialogflow.projects.agent.environments.users.sessions.entityTypes.create",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"description": "Creates a session entity type. If the specified session entity type already exists, overrides the session entity type. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.",
"flatPath": "v2beta1/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes",
"parameters": {
"parent": {
"description": "Required. The session to create a session entity type for. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"type": "string",
"pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$",
"required": true,
"location": "path"
}
},
"request": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
},
"httpMethod": "POST"
},
"patch": {
"httpMethod": "PATCH",
"id": "dialogflow.projects.agent.environments.users.sessions.entityTypes.patch",
"description": "Updates the specified session entity type. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.",
"path": "v2beta1/{+name}",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/entityTypes/[^/]+$",
"type": "string",
"location": "path",
"required": true,
"description": "Required. The unique identifier of this session entity type. Supported formats: - `projects//agent/sessions//entityTypes/` - `projects//locations//agent/sessions//entityTypes/` - `projects//agent/environments//users//sessions//entityTypes/` - `projects//locations//agent/environments/ /users//sessions//entityTypes/` If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. `` must be the display name of an existing entity type in the same agent that will be overridden or supplemented."
},
"updateMask": {
"type": "string",
"description": "Optional. The mask to control which fields get updated.",
"location": "query",
"format": "google-fieldmask"
}
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"request": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
},
"response": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
},
"flatPath": "v2beta1/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes/{entityTypesId}"
},
"list": {
"flatPath": "v2beta1/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes",
"httpMethod": "GET",
"description": "Returns the list of all session entity types in the specified session. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.",
"path": "v2beta1/{+parent}/entityTypes",
"id": "dialogflow.projects.agent.environments.users.sessions.entityTypes.list",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameterOrder": [
"parent"
],
"response": {
"$ref": "GoogleCloudDialogflowV2beta1ListSessionEntityTypesResponse"
},
"parameters": {
"pageToken": {
"description": "Optional. The next_page_token value returned from a previous list request.",
"type": "string",
"location": "query"
},
"parent": {
"type": "string",
"description": "Required. The session to list all session entity types from. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"location": "path",
"required": true,
"pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$"
},
"pageSize": {
"location": "query",
"description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.",
"format": "int32",
"type": "integer"
}
}
},
"delete": {
"path": "v2beta1/{+name}",
"parameterOrder": [
"name"
],
"description": "Deletes the specified session entity type. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.",
"parameters": {
"name": {
"description": "Required. The name of the entity type to delete. Supported formats: - `projects//agent/sessions//entityTypes/` - `projects//locations//agent/sessions//entityTypes/` - `projects//agent/environments//users//sessions//entityTypes/` - `projects//locations//agent/environments/ /users//sessions//entityTypes/` If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"required": true,
"type": "string",
"location": "path",
"pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/entityTypes/[^/]+$"
}
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"httpMethod": "DELETE",
"id": "dialogflow.projects.agent.environments.users.sessions.entityTypes.delete",
"response": {
"$ref": "GoogleProtobufEmpty"
},
"flatPath": "v2beta1/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes/{entityTypesId}"
}
}
},
"contexts": {
"methods": {
"list": {
"id": "dialogflow.projects.agent.environments.users.sessions.contexts.list",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1ListContextsResponse"
},
"parameters": {
"pageToken": {
"location": "query",
"type": "string",
"description": "Optional. The next_page_token value returned from a previous list request."
},
"parent": {
"location": "path",
"required": true,
"pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$",
"description": "Required. The session to list all contexts from. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"type": "string"
},
"pageSize": {
"description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.",
"type": "integer",
"location": "query",
"format": "int32"
}
},
"description": "Returns the list of all contexts in the specified session.",
"path": "v2beta1/{+parent}/contexts",
"flatPath": "v2beta1/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/contexts",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"httpMethod": "GET",
"parameterOrder": [
"parent"
]
},
"create": {
"parameterOrder": [
"parent"
],
"httpMethod": "POST",
"id": "dialogflow.projects.agent.environments.users.sessions.contexts.create",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"description": "Creates a context. If the specified context already exists, overrides the context.",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"parameters": {
"parent": {
"location": "path",
"pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$",
"required": true,
"type": "string",
"description": "Required. The session to create a context for. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user."
}
},
"flatPath": "v2beta1/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/contexts",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"path": "v2beta1/{+parent}/contexts"
},
"delete": {
"path": "v2beta1/{+name}",
"description": "Deletes the specified context.",
"httpMethod": "DELETE",
"parameterOrder": [
"name"
],
"id": "dialogflow.projects.agent.environments.users.sessions.contexts.delete",
"response": {
"$ref": "GoogleProtobufEmpty"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameters": {
"name": {
"location": "path",
"description": "Required. The name of the context to delete. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"type": "string",
"required": true,
"pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/contexts/[^/]+$"
}
},
"flatPath": "v2beta1/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/contexts/{contextsId}"
},
"patch": {
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"description": "Updates the specified context.",
"flatPath": "v2beta1/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/contexts/{contextsId}",
"path": "v2beta1/{+name}",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"request": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"httpMethod": "PATCH",
"id": "dialogflow.projects.agent.environments.users.sessions.contexts.patch",
"parameters": {
"name": {
"location": "path",
"description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`",
"type": "string",
"required": true,
"pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/contexts/[^/]+$"
},
"updateMask": {
"type": "string",
"location": "query",
"format": "google-fieldmask",
"description": "Optional. The mask to control which fields get updated."
}
},
"parameterOrder": [
"name"
]
},
"get": {
"parameterOrder": [
"name"
],
"httpMethod": "GET",
"parameters": {
"name": {
"description": "Required. The name of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user.",
"location": "path",
"required": true,
"pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/contexts/[^/]+$",
"type": "string"
}
},
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"description": "Retrieves the specified context.",
"path": "v2beta1/{+name}",
"id": "dialogflow.projects.agent.environments.users.sessions.contexts.get",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"flatPath": "v2beta1/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/contexts/{contextsId}"
}
}
}
}
}
}
}
},
"methods": {
"list": {
"parameters": {
"parent": {
"required": true,
"description": "Required. The agent to list all environments from. Format: - `projects//agent` - `projects//locations//agent`",
"pattern": "^projects/[^/]+/agent$",
"type": "string",
"location": "path"
},
"pageToken": {
"type": "string",
"description": "Optional. The next_page_token value returned from a previous list request.",
"location": "query"
},
"pageSize": {
"description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.",
"type": "integer",
"location": "query",
"format": "int32"
}
},
"response": {
"$ref": "GoogleCloudDialogflowV2beta1ListEnvironmentsResponse"
},
"description": "Returns the list of all non-draft environments of the specified agent.",
"id": "dialogflow.projects.agent.environments.list",
"httpMethod": "GET",
"path": "v2beta1/{+parent}/environments",
"parameterOrder": [
"parent"
],
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"flatPath": "v2beta1/projects/{projectsId}/agent/environments"
}
}
},
"knowledgeBases": {
"methods": {
"list": {
"flatPath": "v2beta1/projects/{projectsId}/agent/knowledgeBases",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"response": {
"$ref": "GoogleCloudDialogflowV2beta1ListKnowledgeBasesResponse"
},
"httpMethod": "GET",
"path": "v2beta1/{+parent}/knowledgeBases",
"parameters": {
"filter": {
"type": "string",
"location": "query",
"description": "The filter expression used to filter knowledge bases returned by the list method. The expression has the following syntax: [AND ] ... The following fields and operators are supported: * display_name with has(:) operator * language_code with equals(=) operator Examples: * 'language_code=en-us' matches knowledge bases with en-us language code. * 'display_name:articles' matches knowledge bases whose display name contains \"articles\". * 'display_name:\"Best Articles\"' matches knowledge bases whose display name contains \"Best Articles\". * 'language_code=en-gb AND display_name=articles' matches all knowledge bases whose display name contains \"articles\" and whose language code is \"en-gb\". Note: An empty filter string (i.e. \"\") is a no-op and will result in no filtering. For more information about filtering, see [API Filtering](https://aip.dev/160)."
},
"pageToken": {
"location": "query",
"description": "The next_page_token value returned from a previous list request.",
"type": "string"
},
"parent": {
"description": "Required. The project to list of knowledge bases for. Format: `projects/`.",
"required": true,
"type": "string",
"pattern": "^projects/[^/]+/agent$",
"location": "path"
},
"pageSize": {
"description": "The maximum number of items to return in a single page. By default 10 and at most 100.",
"location": "query",
"type": "integer",
"format": "int32"
}
},
"id": "dialogflow.projects.agent.knowledgeBases.list",
"parameterOrder": [
"parent"
],
"description": "Returns the list of all knowledge bases of the specified agent. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`."
},
"delete": {
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameterOrder": [
"name"
],
"path": "v2beta1/{+name}",
"httpMethod": "DELETE",
"id": "dialogflow.projects.agent.knowledgeBases.delete",
"response": {
"$ref": "GoogleProtobufEmpty"
},
"parameters": {
"force": {
"location": "query",
"type": "boolean",
"description": "Optional. Force deletes the knowledge base. When set to true, any documents in the knowledge base are also deleted."
},
"name": {
"pattern": "^projects/[^/]+/agent/knowledgeBases/[^/]+$",
"required": true,
"type": "string",
"description": "Required. The name of the knowledge base to delete. Format: `projects//knowledgeBases/`.",
"location": "path"
}
},
"flatPath": "v2beta1/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId}",
"description": "Deletes the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`."
},
"create": {
"request": {
"$ref": "GoogleCloudDialogflowV2beta1KnowledgeBase"
},
"flatPath": "v2beta1/projects/{projectsId}/agent/knowledgeBases",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"response": {
"$ref": "GoogleCloudDialogflowV2beta1KnowledgeBase"
},
"parameterOrder": [
"parent"
],
"description": "Creates a knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.",
"path": "v2beta1/{+parent}/knowledgeBases",
"httpMethod": "POST",
"parameters": {
"parent": {
"location": "path",
"pattern": "^projects/[^/]+/agent$",
"type": "string",
"description": "Required. The project to create a knowledge base for. Format: `projects/`.",
"required": true
}
},
"id": "dialogflow.projects.agent.knowledgeBases.create"
},
"get": {
"httpMethod": "GET",
"path": "v2beta1/{+name}",
"parameters": {
"name": {
"description": "Required. The name of the knowledge base to retrieve. Format `projects//knowledgeBases/`.",
"required": true,
"pattern": "^projects/[^/]+/agent/knowledgeBases/[^/]+$",
"type": "string",
"location": "path"
}
},
"description": "Retrieves the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"flatPath": "v2beta1/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId}",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1KnowledgeBase"
},
"parameterOrder": [
"name"
],
"id": "dialogflow.projects.agent.knowledgeBases.get"
},
"patch": {
"parameters": {
"name": {
"type": "string",
"required": true,
"description": "The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`.",
"location": "path",
"pattern": "^projects/[^/]+/agent/knowledgeBases/[^/]+$"
},
"updateMask": {
"location": "query",
"type": "string",
"description": "Optional. Not specified means `update all`. Currently, only `display_name` can be updated, an InvalidArgument will be returned for attempting to update other fields.",
"format": "google-fieldmask"
}
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"request": {
"$ref": "GoogleCloudDialogflowV2beta1KnowledgeBase"
},
"description": "Updates the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1KnowledgeBase"
},
"httpMethod": "PATCH",
"flatPath": "v2beta1/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId}",
"path": "v2beta1/{+name}",
"id": "dialogflow.projects.agent.knowledgeBases.patch",
"parameterOrder": [
"name"
]
}
},
"resources": {
"documents": {
"methods": {
"list": {
"response": {
"$ref": "GoogleCloudDialogflowV2beta1ListDocumentsResponse"
},
"path": "v2beta1/{+parent}/documents",
"parameters": {
"pageToken": {
"type": "string",
"location": "query",
"description": "The next_page_token value returned from a previous list request."
},
"filter": {
"type": "string",
"description": "The filter expression used to filter documents returned by the list method. The expression has the following syntax: [AND ] ... The following fields and operators are supported: * knowledge_types with has(:) operator * display_name with has(:) operator * state with equals(=) operator Examples: * \"knowledge_types:FAQ\" matches documents with FAQ knowledge type. * \"display_name:customer\" matches documents whose display name contains \"customer\". * \"state=ACTIVE\" matches documents with ACTIVE state. * \"knowledge_types:FAQ AND state=ACTIVE\" matches all active FAQ documents. For more information about filtering, see [API Filtering](https://aip.dev/160).",
"location": "query"
},
"parent": {
"description": "Required. The knowledge base to list all documents for. Format: `projects//knowledgeBases/`.",
"required": true,
"pattern": "^projects/[^/]+/agent/knowledgeBases/[^/]+$",
"type": "string",
"location": "path"
},
"pageSize": {
"type": "integer",
"location": "query",
"description": "The maximum number of items to return in a single page. By default 10 and at most 100.",
"format": "int32"
}
},
"id": "dialogflow.projects.agent.knowledgeBases.documents.list",
"flatPath": "v2beta1/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId}/documents",
"description": "Returns the list of all documents of the knowledge base. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`.",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameterOrder": [
"parent"
],
"httpMethod": "GET"
},
"delete": {
"parameters": {
"name": {
"pattern": "^projects/[^/]+/agent/knowledgeBases/[^/]+/documents/[^/]+$",
"description": "Required. The name of the document to delete. Format: `projects//knowledgeBases//documents/`.",
"type": "string",
"location": "path",
"required": true
}
},
"flatPath": "v2beta1/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId}/documents/{documentsId}",
"id": "dialogflow.projects.agent.knowledgeBases.documents.delete",
"path": "v2beta1/{+name}",
"httpMethod": "DELETE",
"parameterOrder": [
"name"
],
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"description": "Deletes the specified document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`.",
"response": {
"$ref": "GoogleLongrunningOperation"
}
},
"get": {
"path": "v2beta1/{+name}",
"id": "dialogflow.projects.agent.knowledgeBases.documents.get",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1Document"
},
"flatPath": "v2beta1/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId}/documents/{documentsId}",
"parameters": {
"name": {
"description": "Required. The name of the document to retrieve. Format `projects//knowledgeBases//documents/`.",
"required": true,
"pattern": "^projects/[^/]+/agent/knowledgeBases/[^/]+/documents/[^/]+$",
"type": "string",
"location": "path"
}
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"httpMethod": "GET",
"parameterOrder": [
"name"
],
"description": "Retrieves the specified document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`."
},
"reload": {
"id": "dialogflow.projects.agent.knowledgeBases.documents.reload",
"flatPath": "v2beta1/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId}/documents/{documentsId}:reload",
"description": "Reloads the specified document from its specified source, content_uri or content. The previously loaded content of the document will be deleted. Note: Even when the content of the document has not changed, there still may be side effects because of internal implementation changes. Note: If the document source is Google Cloud Storage URI, its metadata will be replaced with the custom metadata from Google Cloud Storage if the `import_gcs_custom_metadata` field is set to true in the request. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`.",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1ReloadDocumentRequest"
},
"parameters": {
"name": {
"pattern": "^projects/[^/]+/agent/knowledgeBases/[^/]+/documents/[^/]+$",
"description": "Required. The name of the document to reload. Format: `projects//knowledgeBases//documents/`",
"type": "string",
"required": true,
"location": "path"
}
},
"parameterOrder": [
"name"
],
"httpMethod": "POST",
"response": {
"$ref": "GoogleLongrunningOperation"
},
"path": "v2beta1/{+name}:reload",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
]
},
"create": {
"request": {
"$ref": "GoogleCloudDialogflowV2beta1Document"
},
"description": "Creates a new document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`.",
"response": {
"$ref": "GoogleLongrunningOperation"
},
"id": "dialogflow.projects.agent.knowledgeBases.documents.create",
"flatPath": "v2beta1/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId}/documents",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameterOrder": [
"parent"
],
"parameters": {
"parent": {
"required": true,
"pattern": "^projects/[^/]+/agent/knowledgeBases/[^/]+$",
"type": "string",
"location": "path",
"description": "Required. The knowledge base to create a document for. Format: `projects//knowledgeBases/`."
},
"importGcsCustomMetadata": {
"location": "query",
"type": "boolean",
"description": "Whether to import custom metadata from Google Cloud Storage. Only valid when the document source is Google Cloud Storage URI."
}
},
"path": "v2beta1/{+parent}/documents",
"httpMethod": "POST"
},
"patch": {
"description": "Updates the specified document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`.",
"flatPath": "v2beta1/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId}/documents/{documentsId}",
"id": "dialogflow.projects.agent.knowledgeBases.documents.patch",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"pattern": "^projects/[^/]+/agent/knowledgeBases/[^/]+/documents/[^/]+$",
"description": "Optional. The document resource name. The name must be empty when creating a document. Format: `projects//knowledgeBases//documents/`.",
"required": true,
"location": "path",
"type": "string"
},
"updateMask": {
"location": "query",
"description": "Optional. Not specified means `update all`. Currently, only `display_name` can be updated, an InvalidArgument will be returned for attempting to update other fields.",
"type": "string",
"format": "google-fieldmask"
}
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"path": "v2beta1/{+name}",
"httpMethod": "PATCH",
"response": {
"$ref": "GoogleLongrunningOperation"
},
"request": {
"$ref": "GoogleCloudDialogflowV2beta1Document"
}
}
}
}
}
},
"entityTypes": {
"methods": {
"delete": {
"description": "Deletes the specified entity type.",
"parameters": {
"name": {
"type": "string",
"description": "Required. The name of the entity type to delete. Supported formats: - `projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`",
"required": true,
"pattern": "^projects/[^/]+/agent/entityTypes/[^/]+$",
"location": "path"
}
},
"parameterOrder": [
"name"
],
"httpMethod": "DELETE",
"id": "dialogflow.projects.agent.entityTypes.delete",
"flatPath": "v2beta1/projects/{projectsId}/agent/entityTypes/{entityTypesId}",
"path": "v2beta1/{+name}",
"response": {
"$ref": "GoogleProtobufEmpty"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
]
},
"create": {
"parameters": {
"languageCode": {
"location": "query",
"description": "Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see [Multilingual intent and entity data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).",
"type": "string"
},
"parent": {
"required": true,
"description": "Required. The agent to create a entity type for. Supported formats: - `projects//agent` - `projects//locations//agent`",
"type": "string",
"pattern": "^projects/[^/]+/agent$",
"location": "path"
}
},
"flatPath": "v2beta1/projects/{projectsId}/agent/entityTypes",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1EntityType"
},
"parameterOrder": [
"parent"
],
"id": "dialogflow.projects.agent.entityTypes.create",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"path": "v2beta1/{+parent}/entityTypes",
"httpMethod": "POST",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1EntityType"
},
"description": "Creates an entity type in the specified agent."
},
"get": {
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"httpMethod": "GET",
"description": "Retrieves the specified entity type.",
"path": "v2beta1/{+name}",
"id": "dialogflow.projects.agent.entityTypes.get",
"parameterOrder": [
"name"
],
"parameters": {
"languageCode": {
"description": "Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see [Multilingual intent and entity data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).",
"location": "query",
"type": "string"
},
"name": {
"description": "Required. The name of the entity type. Supported formats: - `projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`",
"type": "string",
"location": "path",
"pattern": "^projects/[^/]+/agent/entityTypes/[^/]+$",
"required": true
}
},
"flatPath": "v2beta1/projects/{projectsId}/agent/entityTypes/{entityTypesId}",
"response": {
"$ref": "GoogleCloudDialogflowV2beta1EntityType"
}
},
"batchUpdate": {
"response": {
"$ref": "GoogleLongrunningOperation"
},
"parameterOrder": [
"parent"
],
"httpMethod": "POST",
"description": "Updates/Creates multiple entity types in the specified agent. Operation ",
"id": "dialogflow.projects.agent.entityTypes.batchUpdate",
"request": {
"$ref": "GoogleCloudDialogflowV2beta1BatchUpdateEntityTypesRequest"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameters": {
"parent": {
"type": "string",
"description": "Required. The name of the agent to update or create entity types in. Supported formats: - `projects//agent` - `projects//locations//agent`",
"required": true,
"pattern": "^projects/[^/]+/agent$",
"location": "path"
}
},
"flatPath": "v2beta1/projects/{projectsId}/agent/entityTypes:batchUpdate",
"path": "v2beta1/{+parent}/entityTypes:batchUpdate"
},
"list": {
"parameters": {
"pageSize": {
"location": "query",
"description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.",
"type": "integer",
"format": "int32"
},
"pageToken": {
"description": "Optional. The next_page_token value returned from a previous list request.",
"location": "query",
"type": "string"
},
"languageCode": {
"description": "Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see [Multilingual intent and entity data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).",
"location": "query",
"type": "string"
},
"parent": {
"pattern": "^projects/[^/]+/agent$",
"location": "path",
"required": true,
"description": "Required. The agent to list all entity types from. Supported formats: - `projects//agent` - `projects//locations//agent`",
"type": "string"
}
},
"response": {
"$ref": "GoogleCloudDialogflowV2beta1ListEntityTypesResponse"
},
"path": "v2beta1/{+parent}/entityTypes",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"flatPath": "v2beta1/projects/{projectsId}/agent/entityTypes",
"httpMethod": "GET",
"id": "dialogflow.projects.agent.entityTypes.list",
"description": "Returns the list of all entity types in the specified agent.",
"parameterOrder": [
"parent"
]
},
"patch": {
"request": {
"$ref": "GoogleCloudDialogflowV2beta1EntityType"
},
"path": "v2beta1/{+name}",
"flatPath": "v2beta1/projects/{projectsId}/agent/entityTypes/{entityTypesId}",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameters": {
"name": {
"pattern": "^projects/[^/]+/agent/entityTypes/[^/]+$",
"required": true,
"description": "The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Supported formats: - `projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`",
"location": "path",
"type": "string"
},
"languageCode": {
"description": "Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see [Multilingual intent and entity data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).",
"location": "query",
"type": "string"
},
"updateMask": {
"type": "string",
"format": "google-fieldmask",
"description": "Optional. The mask to control which fields get updated.",
"location": "query"
}
},
"httpMethod": "PATCH",
"id": "dialogflow.projects.agent.entityTypes.patch",
"parameterOrder": [
"name"
],
"response": {
"$ref": "GoogleCloudDialogflowV2beta1EntityType"
},
"description": "Updates the specified entity type."
},
"batchDelete": {
"id": "dialogflow.projects.agent.entityTypes.batchDelete",
"flatPath": "v2beta1/projects/{projectsId}/agent/entityTypes:batchDelete",
"parameters": {
"parent": {
"pattern": "^projects/[^/]+/agent$",
"type": "string",
"description": "Required. The name of the agent to delete all entities types for. Supported formats: - `projects//agent`, - `projects//locations//agent`.",
"location": "path",
"required": true
}
},
"description": "Deletes entity types in the specified agent. Operation ",
"response": {
"$ref": "GoogleLongrunningOperation"
},
"request": {
"$ref": "GoogleCloudDialogflowV2beta1BatchDeleteEntityTypesRequest"
},
"parameterOrder": [
"parent"
],
"path": "v2beta1/{+parent}/entityTypes:batchDelete",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"httpMethod": "POST"
}
},
"resources": {
"entities": {
"methods": {
"batchDelete": {
"id": "dialogflow.projects.agent.entityTypes.entities.batchDelete",
"path": "v2beta1/{+parent}/entities:batchDelete",
"parameterOrder": [
"parent"
],
"description": "Deletes entities in the specified entity type. Operation ",
"httpMethod": "POST",
"response": {
"$ref": "GoogleLongrunningOperation"
},
"request": {
"$ref": "GoogleCloudDialogflowV2beta1BatchDeleteEntitiesRequest"
},
"flatPath": "v2beta1/projects/{projectsId}/agent/entityTypes/{entityTypesId}/entities:batchDelete",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"parameters": {
"parent": {
"pattern": "^projects/[^/]+/agent/entityTypes/[^/]+$",
"description": "Required. The name of the entity type to delete entries for. Supported formats: - `projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`",
"type": "string",
"location": "path",
"required": true
}
}
},
"batchCreate": {
"path": "v2beta1/{+parent}/entities:batchCreate",
"parameters": {
"parent": {
"location": "path",
"pattern": "^projects/[^/]+/agent/entityTypes/[^/]+$",
"type": "string",
"required": true,
"description": "Required. The name of the entity type to create entities in. Supported formats: - `projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`"
}
},
"request": {
"$ref": "GoogleCloudDialogflowV2beta1BatchCreateEntitiesRequest"
},
"id": "dialogflow.projects.agent.entityTypes.entities.batchCreate",
"flatPath": "v2beta1/projects/{projectsId}/agent/entityTypes/{entityTypesId}/entities:batchCreate",
"response": {
"$ref": "GoogleLongrunningOperation"
},
"parameterOrder": [
"parent"
],
"httpMethod": "POST",
"description": "Creates multiple new entities in the specified entity type. Operation ",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
]
},
"batchUpdate": {
"request": {
"$ref": "GoogleCloudDialogflowV2beta1BatchUpdateEntitiesRequest"
},
"parameters": {
"parent": {
"pattern": "^projects/[^/]+/agent/entityTypes/[^/]+$",
"required": true,
"location": "path",
"type": "string",
"description": "Required. The name of the entity type to update or create entities in. Supported formats: - `projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`"
}
},
"parameterOrder": [
"parent"
],
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"httpMethod": "POST",
"flatPath": "v2beta1/projects/{projectsId}/agent/entityTypes/{entityTypesId}/entities:batchUpdate",
"response": {
"$ref": "GoogleLongrunningOperation"
},
"id": "dialogflow.projects.agent.entityTypes.entities.batchUpdate",
"path": "v2beta1/{+parent}/entities:batchUpdate",
"description": "Updates or creates multiple entities in the specified entity type. This method does not affect entities in the entity type that aren't explicitly specified in the request. Operation "
}
}
}
}
}
}
},
"operations": {
"methods": {
"get": {
"httpMethod": "GET",
"description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
"parameterOrder": [
"name"
],
"response": {
"$ref": "GoogleLongrunningOperation"
},
"flatPath": "v2beta1/projects/{projectsId}/operations/{operationsId}",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"path": "v2beta1/{+name}",
"id": "dialogflow.projects.operations.get",
"parameters": {
"name": {
"pattern": "^projects/[^/]+/operations/[^/]+$",
"required": true,
"description": "The name of the operation resource.",
"location": "path",
"type": "string"
}
}
},
"cancel": {
"id": "dialogflow.projects.operations.cancel",
"parameters": {
"name": {
"required": true,
"pattern": "^projects/[^/]+/operations/[^/]+$",
"description": "The name of the operation resource to be cancelled.",
"location": "path",
"type": "string"
}
},
"path": "v2beta1/{+name}:cancel",
"response": {
"$ref": "GoogleProtobufEmpty"
},
"description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"flatPath": "v2beta1/projects/{projectsId}/operations/{operationsId}:cancel",
"httpMethod": "POST",
"parameterOrder": [
"name"
]
},
"list": {
"httpMethod": "GET",
"parameterOrder": [
"name"
],
"parameters": {
"pageSize": {
"location": "query",
"description": "The standard list page size.",
"type": "integer",
"format": "int32"
},
"filter": {
"type": "string",
"description": "The standard list filter.",
"location": "query"
},
"pageToken": {
"location": "query",
"description": "The standard list page token.",
"type": "string"
},
"name": {
"location": "path",
"description": "The name of the operation's parent resource.",
"required": true,
"type": "string",
"pattern": "^projects/[^/]+$"
}
},
"response": {
"$ref": "GoogleLongrunningListOperationsResponse"
},
"description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to override the binding to use different resource name schemes, such as `users/*/operations`. To override the binding, API services can add a binding such as `\"/v1/{name=users/*}/operations\"` to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id.",
"path": "v2beta1/{+name}/operations",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/dialogflow"
],
"flatPath": "v2beta1/projects/{projectsId}/operations",
"id": "dialogflow.projects.operations.list"
}
}
}
}
}
},
"version_module": true,
"fullyEncodeReservedExpansion": true,
"mtlsRootUrl": "https://dialogflow.mtls.googleapis.com/",
"title": "Dialogflow API",
"rootUrl": "https://dialogflow.googleapis.com/",
"documentationLink": "https://cloud.google.com/dialogflow/",
"protocol": "rest",
"ownerName": "Google",
"baseUrl": "https://dialogflow.googleapis.com/",
"name": "dialogflow",
"kind": "discovery#restDescription",
"icons": {
"x32": "http://www.google.com/images/icons/product/search-32.gif",
"x16": "http://www.google.com/images/icons/product/search-16.gif"
},
"version": "v2beta1",
"description": "Builds conversational interfaces (for example, chatbots, and voice-powered apps and devices).",
"servicePath": "",
"schemas": {
"GoogleCloudDialogflowV2beta1KnowledgeOperationMetadata": {
"type": "object",
"properties": {
"state": {
"enum": [
"STATE_UNSPECIFIED",
"PENDING",
"RUNNING",
"DONE"
],
"description": "Required. Output only. The current state of this operation.",
"readOnly": true,
"enumDescriptions": [
"State unspecified.",
"The operation has been created.",
"The operation is currently running.",
"The operation is done, either cancelled or completed."
],
"type": "string"
}
},
"id": "GoogleCloudDialogflowV2beta1KnowledgeOperationMetadata",
"description": "Metadata in google::longrunning::Operation for Knowledge operations."
},
"GoogleCloudDialogflowV2beta1Sentiment": {
"description": "The sentiment, such as positive/negative feeling or association, for a unit of analysis, such as the query text.",
"type": "object",
"properties": {
"score": {
"type": "number",
"description": "Sentiment score between -1.0 (negative sentiment) and 1.0 (positive sentiment).",
"format": "float"
},
"magnitude": {
"type": "number",
"description": "A non-negative number in the [0, +inf) range, which represents the absolute magnitude of sentiment, regardless of score (positive or negative).",
"format": "float"
}
},
"id": "GoogleCloudDialogflowV2beta1Sentiment"
},
"GoogleCloudDialogflowV2beta1SynthesizeSpeechConfig": {
"description": "Configuration of how speech should be synthesized.",
"type": "object",
"id": "GoogleCloudDialogflowV2beta1SynthesizeSpeechConfig",
"properties": {
"effectsProfileId": {
"items": {
"type": "string"
},
"type": "array",
"description": "Optional. An identifier which selects 'audio effects' profiles that are applied on (post synthesized) text to speech. Effects are applied on top of each other in the order they are given."
},
"speakingRate": {
"description": "Optional. Speaking rate/speed, in the range [0.25, 4.0]. 1.0 is the normal native speed supported by the specific voice. 2.0 is twice as fast, and 0.5 is half as fast. If unset(0.0), defaults to the native 1.0 speed. Any other values \u003c 0.25 or \u003e 4.0 will return an error.",
"type": "number",
"format": "double"
},
"volumeGainDb": {
"format": "double",
"description": "Optional. Volume gain (in dB) of the normal native volume supported by the specific voice, in the range [-96.0, 16.0]. If unset, or set to a value of 0.0 (dB), will play at normal native signal amplitude. A value of -6.0 (dB) will play at approximately half the amplitude of the normal native signal amplitude. A value of +6.0 (dB) will play at approximately twice the amplitude of the normal native signal amplitude. We strongly recommend not to exceed +10 (dB) as there's usually no effective increase in loudness for any value greater than that.",
"type": "number"
},
"voice": {
"description": "Optional. The desired voice of the synthesized audio.",
"$ref": "GoogleCloudDialogflowV2beta1VoiceSelectionParams"
},
"pitch": {
"format": "double",
"description": "Optional. Speaking pitch, in the range [-20.0, 20.0]. 20 means increase 20 semitones from the original pitch. -20 means decrease 20 semitones from the original pitch.",
"type": "number"
}
}
},
"GoogleCloudDialogflowV2IntentMessageImage": {
"type": "object",
"properties": {
"accessibilityText": {
"type": "string",
"description": "Optional. A text description of the image to be used for accessibility, e.g., screen readers."
},
"imageUri": {
"description": "Optional. The public URI to an image file.",
"type": "string"
}
},
"description": "The image response message.",
"id": "GoogleCloudDialogflowV2IntentMessageImage"
},
"GoogleCloudDialogflowCxV3beta1WebhookResponse": {
"type": "object",
"id": "GoogleCloudDialogflowCxV3beta1WebhookResponse",
"properties": {
"fulfillmentResponse": {
"$ref": "GoogleCloudDialogflowCxV3beta1WebhookResponseFulfillmentResponse",
"description": "The fulfillment response to send to the user. This field can be omitted by the webhook if it does not intend to send any response to the user."
},
"targetPage": {
"type": "string",
"description": "The target page to transition to. Format: `projects//locations//agents//flows//pages/`."
},
"sessionInfo": {
"$ref": "GoogleCloudDialogflowCxV3beta1SessionInfo",
"description": "Information about session status. This field can be omitted by the webhook if it does not intend to modify session status."
},
"pageInfo": {
"$ref": "GoogleCloudDialogflowCxV3beta1PageInfo",
"description": "Information about page status. This field can be omitted by the webhook if it does not intend to modify page status."
},
"payload": {
"description": "Value to append directly to QueryResult.webhook_payloads.",
"additionalProperties": {
"type": "any",
"description": "Properties of the object."
},
"type": "object"
},
"targetFlow": {
"type": "string",
"description": "The target flow to transition to. Format: `projects//locations//agents//flows/`."
}
},
"description": "The response message for a webhook call."
},
"GoogleCloudDialogflowV2beta1IntentMessageTelephonyPlayAudio": {
"type": "object",
"properties": {
"audioUri": {
"type": "string",
"description": "Required. URI to a Google Cloud Storage object containing the audio to play, e.g., \"gs://bucket/object\". The object must contain a single channel (mono) of linear PCM audio (2 bytes / sample) at 8kHz. This object must be readable by the `[email protected]` service account where is the number of the Telephony Gateway project (usually the same as the Dialogflow agent project). If the Google Cloud Storage bucket is in the Telephony Gateway project, this permission is added by default when enabling the Dialogflow V2 API. For audio from other sources, consider using the `TelephonySynthesizeSpeech` message with SSML."
}
},
"description": "Plays audio from a file in Telephony Gateway.",
"id": "GoogleCloudDialogflowV2beta1IntentMessageTelephonyPlayAudio"
},
"GoogleProtobufEmpty": {
"type": "object",
"properties": {},
"id": "GoogleProtobufEmpty",
"description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`."
},
"GoogleCloudDialogflowCxV3beta1ResponseMessageEndInteraction": {
"type": "object",
"properties": {},
"description": "Indicates that interaction with the Dialogflow agent has ended. This message is generated by Dialogflow only and not supposed to be defined by the user.",
"id": "GoogleCloudDialogflowCxV3beta1ResponseMessageEndInteraction"
},
"GoogleCloudDialogflowV2beta1IntentMessageBasicCard": {
"properties": {
"formattedText": {
"type": "string",
"description": "Required, unless image is present. The body text of the card."
},
"buttons": {
"type": "array",
"description": "Optional. The collection of card buttons.",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageBasicCardButton"
}
},
"subtitle": {
"type": "string",
"description": "Optional. The subtitle of the card."
},
"image": {
"description": "Optional. The image for the card.",
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageImage"
},
"title": {
"description": "Optional. The title of the card.",
"type": "string"
}
},
"type": "object",
"id": "GoogleCloudDialogflowV2beta1IntentMessageBasicCard",
"description": "The basic card message. Useful for displaying information."
},
"GoogleCloudDialogflowV2beta1ValidationError": {
"type": "object",
"properties": {
"entries": {
"items": {
"type": "string"
},
"description": "The names of the entries that the error is associated with. Format: - \"projects//agent\", if the error is associated with the entire agent. - \"projects//agent/intents/\", if the error is associated with certain intents. - \"projects//agent/intents//trainingPhrases/\", if the error is associated with certain intent training phrases. - \"projects//agent/intents//parameters/\", if the error is associated with certain intent parameters. - \"projects//agent/entities/\", if the error is associated with certain entities.",
"type": "array"
},
"errorMessage": {
"description": "The detailed error messsage.",
"type": "string"
},
"severity": {
"enumDescriptions": [
"Not specified. This value should never be used.",
"The agent doesn't follow Dialogflow best practicies.",
"The agent may not behave as expected.",
"The agent may experience partial failures.",
"The agent may completely fail."
],
"type": "string",
"enum": [
"SEVERITY_UNSPECIFIED",
"INFO",
"WARNING",
"ERROR",
"CRITICAL"
],
"description": "The severity of the error."
}
},
"description": "Represents a single validation error.",
"id": "GoogleCloudDialogflowV2beta1ValidationError"
},
"GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech": {
"id": "GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech",
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "The raw text to be synthesized."
},
"ssml": {
"description": "The SSML to be synthesized. For more information, see [SSML](https://developers.google.com/actions/reference/ssml).",
"type": "string"
}
},
"description": "Synthesizes speech and plays back the synthesized audio to the caller in Telephony Gateway. Telephony Gateway takes the synthesizer settings from `DetectIntentResponse.output_audio_config` which can either be set at request-level or can come from the agent-level synthesizer config."
},
"GoogleCloudDialogflowCxV3ResponseMessageMixedAudio": {
"type": "object",
"id": "GoogleCloudDialogflowCxV3ResponseMessageMixedAudio",
"properties": {
"segments": {
"items": {
"$ref": "GoogleCloudDialogflowCxV3ResponseMessageMixedAudioSegment"
},
"type": "array",
"description": "Segments this audio response is composed of."
}
},
"description": "Represents an audio message that is composed of both segments synthesized from the Dialogflow agent prompts and ones hosted externally at the specified URIs. The external URIs are specified via play_audio. This message is generated by Dialogflow only and not supposed to be defined by the user."
},
"GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestion": {
"type": "object",
"description": "Rich Business Messaging (RBM) suggestion. Suggestions allow user to easily select/click a predefined response or perform an action (like opening a web uri).",
"properties": {
"action": {
"description": "Predefined client side actions that user can choose",
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedAction"
},
"reply": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedReply",
"description": "Predefined replies for user to select instead of typing"
}
},
"id": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestion"
},
"GoogleCloudDialogflowCxV3ResponseMessagePlayAudio": {
"properties": {
"allowPlaybackInterruption": {
"readOnly": true,
"description": "Output only. Whether the playback of this message can be interrupted by the end user's speech and the client can then starts the next Dialogflow request.",
"type": "boolean"
},
"audioUri": {
"description": "Required. URI of the audio clip. Dialogflow does not impose any validation on this value. It is specific to the client that reads it.",
"type": "string"
}
},
"description": "Specifies an audio clip to be played by the client as part of the response.",
"type": "object",
"id": "GoogleCloudDialogflowCxV3ResponseMessagePlayAudio"
},
"GoogleCloudDialogflowV2beta1ListEntityTypesResponse": {
"properties": {
"entityTypes": {
"type": "array",
"description": "The list of agent entity types. There will be a maximum number of items returned based on the page_size field in the request.",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1EntityType"
}
},
"nextPageToken": {
"type": "string",
"description": "Token to retrieve the next page of results, or empty if there are no more results in the list."
}
},
"type": "object",
"id": "GoogleCloudDialogflowV2beta1ListEntityTypesResponse",
"description": "The response message for EntityTypes.ListEntityTypes."
},
"GoogleCloudDialogflowV2ExportAgentResponse": {
"id": "GoogleCloudDialogflowV2ExportAgentResponse",
"properties": {
"agentUri": {
"type": "string",
"description": "The URI to a file containing the exported agent. This field is populated only if `agent_uri` is specified in `ExportAgentRequest`."
},
"agentContent": {
"type": "string",
"description": "Zip compressed raw byte content for agent.",
"format": "byte"
}
},
"description": "The response message for Agents.ExportAgent.",
"type": "object"
},
"GoogleCloudDialogflowV2beta1DetectIntentRequest": {
"description": "The request to detect user's intent.",
"properties": {
"outputAudioConfigMask": {
"format": "google-fieldmask",
"type": "string",
"description": "Mask for output_audio_config indicating which settings in this request-level config should override speech synthesizer settings defined at agent-level. If unspecified or empty, output_audio_config replaces the agent-level config in its entirety."
},
"outputAudioConfig": {
"description": "Instructs the speech synthesizer how to generate the output audio. If this field is not set and agent-level speech synthesizer is not configured, no output audio is generated.",
"$ref": "GoogleCloudDialogflowV2beta1OutputAudioConfig"
},
"queryParams": {
"description": "The parameters of this query.",
"$ref": "GoogleCloudDialogflowV2beta1QueryParameters"
},
"inputAudio": {
"type": "string",
"format": "byte",
"description": "The natural language speech audio to be processed. This field should be populated iff `query_input` is set to an input audio config. A single request can contain up to 1 minute of speech audio data."
},
"queryInput": {
"description": "Required. The input specification. It can be set to: 1. an audio config which instructs the speech recognizer how to process the speech audio, 2. a conversational query in the form of text, or 3. an event that specifies which intent to trigger.",
"$ref": "GoogleCloudDialogflowV2beta1QueryInput"
}
},
"id": "GoogleCloudDialogflowV2beta1DetectIntentRequest",
"type": "object"
},
"GoogleCloudDialogflowV2beta1ListIntentsResponse": {
"id": "GoogleCloudDialogflowV2beta1ListIntentsResponse",
"description": "The response message for Intents.ListIntents.",
"type": "object",
"properties": {
"nextPageToken": {
"type": "string",
"description": "Token to retrieve the next page of results, or empty if there are no more results in the list."
},
"intents": {
"description": "The list of agent intents. There will be a maximum number of items returned based on the page_size field in the request.",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1Intent"
},
"type": "array"
}
}
},
"GoogleCloudDialogflowV2beta1IntentMessageBasicCardButton": {
"id": "GoogleCloudDialogflowV2beta1IntentMessageBasicCardButton",
"properties": {
"title": {
"type": "string",
"description": "Required. The title of the button."
},
"openUriAction": {
"description": "Required. Action to take when a user taps on the button.",
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageBasicCardButtonOpenUriAction"
}
},
"type": "object",
"description": "The button object that appears at the bottom of a card."
},
"GoogleCloudDialogflowV2beta1IntentMessageImage": {
"type": "object",
"id": "GoogleCloudDialogflowV2beta1IntentMessageImage",
"properties": {
"imageUri": {
"description": "Optional. The public URI to an image file.",
"type": "string"
},
"accessibilityText": {
"type": "string",
"description": "A text description of the image to be used for accessibility, e.g., screen readers. Required if image_uri is set for CarouselSelect."
}
},
"description": "The image response message."
},
"GoogleCloudDialogflowV2IntentMessageTableCard": {
"type": "object",
"id": "GoogleCloudDialogflowV2IntentMessageTableCard",
"properties": {
"title": {
"description": "Required. Title of the card.",
"type": "string"
},
"image": {
"$ref": "GoogleCloudDialogflowV2IntentMessageImage",
"description": "Optional. Image which should be displayed on the card."
},
"buttons": {
"items": {
"$ref": "GoogleCloudDialogflowV2IntentMessageBasicCardButton"
},
"description": "Optional. List of buttons for the card.",
"type": "array"
},
"subtitle": {
"description": "Optional. Subtitle to the title.",
"type": "string"
},
"rows": {
"description": "Optional. Rows in this table of data.",
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2IntentMessageTableCardRow"
}
},
"columnProperties": {
"items": {
"$ref": "GoogleCloudDialogflowV2IntentMessageColumnProperties"
},
"description": "Optional. Display properties for the columns in this table.",
"type": "array"
}
},
"description": "Table card for Actions on Google."
},
"GoogleCloudDialogflowCxV3beta1WebhookRequest": {
"id": "GoogleCloudDialogflowCxV3beta1WebhookRequest",
"type": "object",
"properties": {
"fulfillmentInfo": {
"$ref": "GoogleCloudDialogflowCxV3beta1WebhookRequestFulfillmentInfo",
"description": "Always present. Information about the fulfillment that triggered this webhook call."
},
"sessionInfo": {
"$ref": "GoogleCloudDialogflowCxV3beta1SessionInfo",
"description": "Information about session status."
},
"detectIntentResponseId": {
"description": "Always present. The unique identifier of the DetectIntentResponse that will be returned to the API caller.",
"type": "string"
},
"messages": {
"description": "The list of rich message responses to present to the user. Webhook can choose to append or replace this list in WebhookResponse.fulfillment_response;",
"items": {
"$ref": "GoogleCloudDialogflowCxV3beta1ResponseMessage"
},
"type": "array"
},
"payload": {
"type": "object",
"description": "Custom data set in QueryParameters.payload.",
"additionalProperties": {
"description": "Properties of the object.",
"type": "any"
}
},
"pageInfo": {
"$ref": "GoogleCloudDialogflowCxV3beta1PageInfo",
"description": "Information about page status."
},
"intentInfo": {
"$ref": "GoogleCloudDialogflowCxV3beta1WebhookRequestIntentInfo",
"description": "Information about the last matched intent."
}
},
"description": "The request message for a webhook call."
},
"GoogleCloudDialogflowV2EntityTypeEntity": {
"description": "An **entity entry** for an associated entity type.",
"type": "object",
"properties": {
"value": {
"description": "Required. The primary value associated with this entity entry. For example, if the entity type is *vegetable*, the value could be *scallions*. For `KIND_MAP` entity types: * A reference value to be used in place of synonyms. For `KIND_LIST` entity types: * A string that can contain references to other entity types (with or without aliases).",
"type": "string"
},
"synonyms": {
"description": "Required. A collection of value synonyms. For example, if the entity type is *vegetable*, and `value` is *scallions*, a synonym could be *green onions*. For `KIND_LIST` entity types: * This collection must contain exactly one synonym equal to `value`.",
"items": {
"type": "string"
},
"type": "array"
}
},
"id": "GoogleCloudDialogflowV2EntityTypeEntity"
},
"GoogleCloudDialogflowV2beta1TextInput": {
"type": "object",
"id": "GoogleCloudDialogflowV2beta1TextInput",
"description": "Represents the natural language text to be processed.",
"properties": {
"languageCode": {
"description": "Required. The language of this conversational query. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes. Note that queries in the same session do not necessarily need to specify the same language.",
"type": "string"
},
"text": {
"type": "string",
"description": "Required. The UTF-8 encoded natural language text to be processed. Text length must not exceed 256 characters."
}
}
},
"GoogleCloudDialogflowV2beta1ValidationResult": {
"properties": {
"validationErrors": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1ValidationError"
},
"type": "array",
"description": "Contains all validation errors."
}
},
"id": "GoogleCloudDialogflowV2beta1ValidationResult",
"type": "object",
"description": "Represents the output of agent validation."
},
"GoogleCloudDialogflowV2beta1ListKnowledgeBasesResponse": {
"type": "object",
"description": "Response message for KnowledgeBases.ListKnowledgeBases.",
"properties": {
"knowledgeBases": {
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1KnowledgeBase"
},
"description": "The list of knowledge bases."
},
"nextPageToken": {
"type": "string",
"description": "Token to retrieve the next page of results, or empty if there are no more results in the list."
}
},
"id": "GoogleCloudDialogflowV2beta1ListKnowledgeBasesResponse"
},
"GoogleCloudDialogflowV2IntentMessageBrowseCarouselCardBrowseCarouselCardItemOpenUrlAction": {
"description": "Actions on Google action to open a given url.",
"properties": {
"urlTypeHint": {
"enumDescriptions": [
"Unspecified",
"Url would be an amp action",
"URL that points directly to AMP content, or to a canonical URL which refers to AMP content via ."
],
"enum": [
"URL_TYPE_HINT_UNSPECIFIED",
"AMP_ACTION",
"AMP_CONTENT"
],
"type": "string",
"description": "Optional. Specifies the type of viewer that is used when opening the URL. Defaults to opening via web browser."
},
"url": {
"description": "Required. URL",
"type": "string"
}
},
"type": "object",
"id": "GoogleCloudDialogflowV2IntentMessageBrowseCarouselCardBrowseCarouselCardItemOpenUrlAction"
},
"GoogleCloudDialogflowV2QueryResult": {
"type": "object",
"description": "Represents the result of conversational query or event processing.",
"id": "GoogleCloudDialogflowV2QueryResult",
"properties": {
"queryText": {
"description": "The original conversational query text: - If natural language text was provided as input, `query_text` contains a copy of the input. - If natural language speech audio was provided as input, `query_text` contains the speech recognition result. If speech recognizer produced multiple alternatives, a particular one is picked. - If automatic spell correction is enabled, `query_text` will contain the corrected user input.",
"type": "string"
},
"diagnosticInfo": {
"additionalProperties": {
"type": "any",
"description": "Properties of the object."
},
"type": "object",
"description": "Free-form diagnostic information for the associated detect intent request. The fields of this data can change without notice, so you should not write code that depends on its structure. The data may contain: - webhook call latency - webhook errors"
},
"webhookPayload": {
"additionalProperties": {
"description": "Properties of the object.",
"type": "any"
},
"description": "If the query was fulfilled by a webhook call, this field is set to the value of the `payload` field returned in the webhook response.",
"type": "object"
},
"sentimentAnalysisResult": {
"description": "The sentiment analysis result, which depends on the `sentiment_analysis_request_config` specified in the request.",
"$ref": "GoogleCloudDialogflowV2SentimentAnalysisResult"
},
"fulfillmentMessages": {
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2IntentMessage"
},
"description": "The collection of rich messages to present to the user."
},
"outputContexts": {
"description": "The collection of output contexts. If applicable, `output_contexts.parameters` contains entries with name `.original` containing the original parameter values before the query.",
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2Context"
}
},
"languageCode": {
"type": "string",
"description": "The language that was triggered during intent detection. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes."
},
"speechRecognitionConfidence": {
"format": "float",
"description": "The Speech recognition confidence between 0.0 and 1.0. A higher number indicates an estimated greater likelihood that the recognized words are correct. The default of 0.0 is a sentinel value indicating that confidence was not set. This field is not guaranteed to be accurate or set. In particular this field isn't set for StreamingDetectIntent since the streaming endpoint has separate confidence estimates per portion of the audio in StreamingRecognitionResult.",
"type": "number"
},
"intentDetectionConfidence": {
"description": "The intent detection confidence. Values range from 0.0 (completely uncertain) to 1.0 (completely certain). This value is for informational purpose only and is only used to help match the best intent within the classification threshold. This value may change for the same end-user expression at any time due to a model retraining or change in implementation. If there are `multiple knowledge_answers` messages, this value is set to the greatest `knowledgeAnswers.match_confidence` value in the list.",
"type": "number",
"format": "float"
},
"parameters": {
"type": "object",
"additionalProperties": {
"description": "Properties of the object.",
"type": "any"
},
"description": "The collection of extracted parameters. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: string or number, depending on parameter value type - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value"
},
"webhookSource": {
"type": "string",
"description": "If the query was fulfilled by a webhook call, this field is set to the value of the `source` field returned in the webhook response."
},
"fulfillmentText": {
"type": "string",
"description": "The text to be pronounced to the user or shown on the screen. Note: This is a legacy field, `fulfillment_messages` should be preferred."
},
"action": {
"type": "string",
"description": "The action name from the matched intent."
},
"intent": {
"description": "The intent that matched the conversational query. Some, not all fields are filled in this message, including but not limited to: `name`, `display_name`, `end_interaction` and `is_fallback`.",
"$ref": "GoogleCloudDialogflowV2Intent"
},
"allRequiredParamsPresent": {
"type": "boolean",
"description": "This field is set to: - `false` if the matched intent has required parameters and not all of the required parameter values have been collected. - `true` if all required parameter values have been collected, or if the matched intent doesn't contain any required parameters."
}
}
},
"GoogleCloudDialogflowV2beta1Agent": {
"type": "object",
"description": "A Dialogflow agent is a virtual agent that handles conversations with your end-users. It is a natural language understanding module that understands the nuances of human language. Dialogflow translates end-user text or audio during a conversation to structured data that your apps and services can understand. You design and build a Dialogflow agent to handle the types of conversations required for your system. For more information about agents, see the [Agent guide](https://cloud.google.com/dialogflow/docs/agents-overview).",
"properties": {
"matchMode": {
"enumDescriptions": [
"Not specified.",
"Best for agents with a small number of examples in intents and/or wide use of templates syntax and composite entities.",
"Can be used for agents with a large number of examples in intents, especially the ones using @sys.any or very large custom entities."
],
"description": "Optional. Determines how intents are detected from user queries.",
"type": "string",
"enum": [
"MATCH_MODE_UNSPECIFIED",
"MATCH_MODE_HYBRID",
"MATCH_MODE_ML_ONLY"
]
},
"avatarUri": {
"description": "Optional. The URI of the agent's avatar. Avatars are used throughout the Dialogflow console and in the self-hosted [Web Demo](https://cloud.google.com/dialogflow/docs/integrations/web-demo) integration.",
"type": "string"
},
"tier": {
"enum": [
"TIER_UNSPECIFIED",
"TIER_STANDARD",
"TIER_ENTERPRISE",
"TIER_ENTERPRISE_PLUS"
],
"type": "string",
"description": "Optional. The agent tier. If not specified, TIER_STANDARD is assumed.",
"enumDescriptions": [
"Not specified. This value should never be used.",
"Standard tier.",
"Enterprise tier (Essentials).",
"Enterprise tier (Plus)."
]
},
"apiVersion": {
"enum": [
"API_VERSION_UNSPECIFIED",
"API_VERSION_V1",
"API_VERSION_V2",
"API_VERSION_V2_BETA_1"
],
"enumDescriptions": [
"Not specified.",
"Legacy V1 API.",
"V2 API.",
"V2beta1 API."
],
"type": "string",
"description": "Optional. API version displayed in Dialogflow console. If not specified, V2 API is assumed. Clients are free to query different service endpoints for different API versions. However, bots connectors and webhook calls will follow the specified API version."
},
"description": {
"description": "Optional. The description of this agent. The maximum length is 500 characters. If exceeded, the request is rejected.",
"type": "string"
},
"timeZone": {
"type": "string",
"description": "Required. The time zone of this agent from the [time zone database](https://www.iana.org/time-zones), e.g., America/New_York, Europe/Paris."
},
"displayName": {
"type": "string",
"description": "Required. The name of this agent."
},
"classificationThreshold": {
"description": "Optional. To filter out false positive results and still get variety in matched natural language inputs for your agent, you can tune the machine learning classification threshold. If the returned score value is less than the threshold value, then a fallback intent will be triggered or, if there are no fallback intents defined, no intent will be triggered. The score values range from 0.0 (completely uncertain) to 1.0 (completely certain). If set to 0.0, the default of 0.3 is used.",
"type": "number",
"format": "float"
},
"defaultLanguageCode": {
"description": "Required. The default language of the agent as a language tag. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes. This field cannot be set by the `Update` method.",
"type": "string"
},
"parent": {
"description": "Required. The project of this agent. Format: `projects/` or `projects//locations/`",
"type": "string"
},
"supportedLanguageCodes": {
"description": "Optional. The list of all languages supported by this agent (except for the `default_language_code`).",
"type": "array",
"items": {
"type": "string"
}
},
"enableLogging": {
"type": "boolean",
"description": "Optional. Determines whether this agent should log conversation queries."
}
},
"id": "GoogleCloudDialogflowV2beta1Agent"
},
"GoogleCloudDialogflowV2SentimentAnalysisResult": {
"id": "GoogleCloudDialogflowV2SentimentAnalysisResult",
"properties": {
"queryTextSentiment": {
"description": "The sentiment analysis result for `query_text`.",
"$ref": "GoogleCloudDialogflowV2Sentiment"
}
},
"type": "object",
"description": "The result of sentiment analysis. Sentiment analysis inspects user input and identifies the prevailing subjective opinion, especially to determine a user's attitude as positive, negative, or neutral. For Participants.DetectIntent, it needs to be configured in DetectIntentRequest.query_params. For Participants.StreamingDetectIntent, it needs to be configured in StreamingDetectIntentRequest.query_params. And for Participants.AnalyzeContent and Participants.StreamingAnalyzeContent, it needs to be configured in ConversationProfile.human_agent_assistant_config"
},
"GoogleCloudDialogflowV2beta1BatchUpdateEntitiesRequest": {
"description": "The request message for EntityTypes.BatchUpdateEntities.",
"type": "object",
"id": "GoogleCloudDialogflowV2beta1BatchUpdateEntitiesRequest",
"properties": {
"entities": {
"description": "Required. The entities to update or create.",
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1EntityTypeEntity"
}
},
"languageCode": {
"description": "Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see [Multilingual intent and entity data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).",
"type": "string"
},
"updateMask": {
"type": "string",
"description": "Optional. The mask to control which fields get updated.",
"format": "google-fieldmask"
}
}
},
"GoogleCloudDialogflowCxV3WebhookRequest": {
"id": "GoogleCloudDialogflowCxV3WebhookRequest",
"type": "object",
"properties": {
"pageInfo": {
"$ref": "GoogleCloudDialogflowCxV3PageInfo",
"description": "Information about page status."
},
"detectIntentResponseId": {
"description": "Always present. The unique identifier of the DetectIntentResponse that will be returned to the API caller.",
"type": "string"
},
"fulfillmentInfo": {
"description": "Always present. Information about the fulfillment that triggered this webhook call.",
"$ref": "GoogleCloudDialogflowCxV3WebhookRequestFulfillmentInfo"
},
"intentInfo": {
"$ref": "GoogleCloudDialogflowCxV3WebhookRequestIntentInfo",
"description": "Information about the last matched intent."
},
"messages": {
"items": {
"$ref": "GoogleCloudDialogflowCxV3ResponseMessage"
},
"type": "array",
"description": "The list of rich message responses to present to the user. Webhook can choose to append or replace this list in WebhookResponse.fulfillment_response;"
},
"payload": {
"additionalProperties": {
"description": "Properties of the object.",
"type": "any"
},
"type": "object",
"description": "Custom data set in QueryParameters.payload."
},
"sessionInfo": {
"$ref": "GoogleCloudDialogflowCxV3SessionInfo",
"description": "Information about session status."
}
},
"description": "The request message for a webhook call."
},
"GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionDial": {
"id": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionDial",
"description": "Opens the user's default dialer app with the specified phone number but does not dial automatically.",
"properties": {
"phoneNumber": {
"description": "Required. The phone number to fill in the default dialer app. This field should be in [E.164](https://en.wikipedia.org/wiki/E.164) format. An example of a correctly formatted phone number: +15556767888.",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudDialogflowV2IntentMessageBrowseCarouselCardBrowseCarouselCardItem": {
"type": "object",
"properties": {
"title": {
"description": "Required. Title of the carousel item. Maximum of two lines of text.",
"type": "string"
},
"footer": {
"type": "string",
"description": "Optional. Text that appears at the bottom of the Browse Carousel Card. Maximum of one line of text."
},
"image": {
"description": "Optional. Hero image for the carousel item.",
"$ref": "GoogleCloudDialogflowV2IntentMessageImage"
},
"openUriAction": {
"description": "Required. Action to present to the user.",
"$ref": "GoogleCloudDialogflowV2IntentMessageBrowseCarouselCardBrowseCarouselCardItemOpenUrlAction"
},
"description": {
"description": "Optional. Description of the carousel item. Maximum of four lines of text.",
"type": "string"
}
},
"id": "GoogleCloudDialogflowV2IntentMessageBrowseCarouselCardBrowseCarouselCardItem",
"description": "Browsing carousel tile"
},
"GoogleCloudDialogflowV2IntentMessageBasicCard": {
"id": "GoogleCloudDialogflowV2IntentMessageBasicCard",
"type": "object",
"description": "The basic card message. Useful for displaying information.",
"properties": {
"title": {
"type": "string",
"description": "Optional. The title of the card."
},
"image": {
"description": "Optional. The image for the card.",
"$ref": "GoogleCloudDialogflowV2IntentMessageImage"
},
"buttons": {
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2IntentMessageBasicCardButton"
},
"description": "Optional. The collection of card buttons."
},
"subtitle": {
"type": "string",
"description": "Optional. The subtitle of the card."
},
"formattedText": {
"description": "Required, unless image is present. The body text of the card.",
"type": "string"
}
}
},
"GoogleCloudDialogflowCxV3SessionInfo": {
"description": "Represents session information communicated to and from the webhook.",
"properties": {
"session": {
"description": "Always present for WebhookRequest. Ignored for WebhookResponse. The unique identifier of the session. This field can be used by the webhook to identify a user. Format: `projects//locations//agents//sessions/`.",
"type": "string"
},
"parameters": {
"additionalProperties": {
"type": "any"
},
"type": "object",
"description": "Optional for WebhookRequest. Optional for WebhookResponse. All parameters collected from forms and intents during the session. Parameters can be created, updated, or removed by the webhook. To remove a parameter from the session, the webhook should explicitly set the parameter value to null in WebhookResponse. The map is keyed by parameters' display names."
}
},
"type": "object",
"id": "GoogleCloudDialogflowCxV3SessionInfo"
},
"GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia": {
"id": "GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia",
"type": "object",
"description": "Rich Business Messaging (RBM) Media displayed in Cards The following media-types are currently supported: Image Types * image/jpeg * image/jpg' * image/gif * image/png Video Types * video/h263 * video/m4v * video/mp4 * video/mpeg * video/mpeg4 * video/webm",
"properties": {
"fileUri": {
"description": "Required. Publicly reachable URI of the file. The RBM platform determines the MIME type of the file from the content-type field in the HTTP headers when the platform fetches the file. The content-type field must be present and accurate in the HTTP response from the URL.",
"type": "string"
},
"height": {
"description": "Required for cards with vertical orientation. The height of the media within a rich card with a vertical layout. For a standalone card with horizontal layout, height is not customizable, and this field is ignored.",
"type": "string",
"enum": [
"HEIGHT_UNSPECIFIED",
"SHORT",
"MEDIUM",
"TALL"
],
"enumDescriptions": [
"Not specified.",
"112 DP.",
"168 DP.",
"264 DP. Not available for rich card carousels when the card width is set to small."
]
},
"thumbnailUri": {
"type": "string",
"description": "Optional. Publicly reachable URI of the thumbnail.If you don't provide a thumbnail URI, the RBM platform displays a blank placeholder thumbnail until the user's device downloads the file. Depending on the user's setting, the file may not download automatically and may require the user to tap a download button."
}
}
},
"GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudio": {
"id": "GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudio",
"type": "object",
"properties": {
"segments": {
"items": {
"$ref": "GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudioSegment"
},
"description": "Segments this audio response is composed of.",
"type": "array"
}
},
"description": "Represents an audio message that is composed of both segments synthesized from the Dialogflow agent prompts and ones hosted externally at the specified URIs. The external URIs are specified via play_audio. This message is generated by Dialogflow only and not supposed to be defined by the user."
},
"GoogleCloudDialogflowCxV3ResponseMessageConversationSuccess": {
"description": "Indicates that the conversation succeeded, i.e., the bot handled the issue that the customer talked to it about. Dialogflow only uses this to determine which conversations should be counted as successful and doesn't process the metadata in this message in any way. Note that Dialogflow also considers conversations that get to the conversation end page as successful even if they don't return ConversationSuccess. You may set this, for example: * In the entry_fulfillment of a Page if entering the page indicates that the conversation succeeded. * In a webhook response when you determine that you handled the customer issue.",
"type": "object",
"id": "GoogleCloudDialogflowCxV3ResponseMessageConversationSuccess",
"properties": {
"metadata": {
"type": "object",
"description": "Custom metadata. Dialogflow doesn't impose any structure on this.",
"additionalProperties": {
"description": "Properties of the object.",
"type": "any"
}
}
}
},
"GoogleCloudDialogflowV2beta1KnowledgeBase": {
"type": "object",
"description": "A knowledge base represents a collection of knowledge documents that you provide to Dialogflow. Your knowledge documents contain information that may be useful during conversations with end-users. Some Dialogflow features use knowledge bases when looking for a response to an end-user input. For more information, see the [knowledge base guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases). Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.",
"id": "GoogleCloudDialogflowV2beta1KnowledgeBase",
"properties": {
"displayName": {
"description": "Required. The display name of the knowledge base. The name must be 1024 bytes or less; otherwise, the creation request fails.",
"type": "string"
},
"name": {
"description": "The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`.",
"type": "string"
},
"languageCode": {
"description": "Language which represents the KnowledgeBase. When the KnowledgeBase is created/updated, this is populated for all non en-us languages. If not populated, the default language en-us applies.",
"type": "string"
}
}
},
"GoogleCloudDialogflowCxV3beta1ResponseMessageText": {
"type": "object",
"properties": {
"allowPlaybackInterruption": {
"type": "boolean",
"readOnly": true,
"description": "Output only. Whether the playback of this message can be interrupted by the end user's speech and the client can then starts the next Dialogflow request."
},
"text": {
"items": {
"type": "string"
},
"type": "array",
"description": "Required. A collection of text responses."
}
},
"description": "The text response message.",
"id": "GoogleCloudDialogflowCxV3beta1ResponseMessageText"
},
"GoogleCloudDialogflowV2beta1ListEnvironmentsResponse": {
"properties": {
"nextPageToken": {
"type": "string",
"description": "Token to retrieve the next page of results, or empty if there are no more results in the list."
},
"environments": {
"description": "The list of agent environments. There will be a maximum number of items returned based on the page_size field in the request.",
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1Environment"
}
}
},
"type": "object",
"id": "GoogleCloudDialogflowV2beta1ListEnvironmentsResponse",
"description": "The response message for Environments.ListEnvironments."
},
"GoogleCloudDialogflowCxV3WebhookRequestIntentInfo": {
"id": "GoogleCloudDialogflowCxV3WebhookRequestIntentInfo",
"properties": {
"lastMatchedIntent": {
"description": "Always present. The unique identifier of the last matched intent. Format: `projects//locations//agents//intents/`.",
"type": "string"
},
"parameters": {
"type": "object",
"description": "Parameters identified as a result of intent matching. This is a map of the name of the identified parameter to the value of the parameter identified from the user's utterance. All parameters defined in the matched intent that are identified will be surfaced here.",
"additionalProperties": {
"$ref": "GoogleCloudDialogflowCxV3WebhookRequestIntentInfoIntentParameterValue"
}
}
},
"type": "object",
"description": "Represents intent information communicated to the webhook."
},
"GoogleCloudDialogflowV2IntentMessageCarouselSelect": {
"properties": {
"items": {
"description": "Required. Carousel items.",
"items": {
"$ref": "GoogleCloudDialogflowV2IntentMessageCarouselSelectItem"
},
"type": "array"
}
},
"type": "object",
"description": "The card for presenting a carousel of options to select from.",
"id": "GoogleCloudDialogflowV2IntentMessageCarouselSelect"
},
"GoogleCloudDialogflowV2BatchUpdateEntityTypesResponse": {
"properties": {
"entityTypes": {
"description": "The collection of updated or created entity types.",
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2EntityType"
}
}
},
"type": "object",
"description": "The response message for EntityTypes.BatchUpdateEntityTypes.",
"id": "GoogleCloudDialogflowV2BatchUpdateEntityTypesResponse"
},
"GoogleLongrunningListOperationsResponse": {
"properties": {
"nextPageToken": {
"type": "string",
"description": "The standard List next-page token."
},
"operations": {
"description": "A list of operations that matches the specified filter in the request.",
"items": {
"$ref": "GoogleLongrunningOperation"
},
"type": "array"
}
},
"id": "GoogleLongrunningListOperationsResponse",
"type": "object",
"description": "The response message for Operations.ListOperations."
},
"GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionOpenUri": {
"properties": {
"uri": {
"description": "Required. The uri to open on the user device",
"type": "string"
}
},
"type": "object",
"id": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionOpenUri",
"description": "Opens the user's default web browser app to the specified uri If the user has an app installed that is registered as the default handler for the URL, then this app will be opened instead, and its icon will be used in the suggested action UI."
},
"GoogleCloudDialogflowV2beta1IntentMessageCarouselSelectItem": {
"description": "An item in the carousel.",
"properties": {
"description": {
"description": "Optional. The body text of the card.",
"type": "string"
},
"title": {
"description": "Required. Title of the carousel item.",
"type": "string"
},
"image": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageImage",
"description": "Optional. The image to display."
},
"info": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageSelectItemInfo",
"description": "Required. Additional info about the option item."
}
},
"id": "GoogleCloudDialogflowV2beta1IntentMessageCarouselSelectItem",
"type": "object"
},
"GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionShareLocation": {
"id": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionShareLocation",
"type": "object",
"properties": {},
"description": "Opens the device's location chooser so the user can pick a location to send back to the agent."
},
"GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCardBrowseCarouselCardItemOpenUrlAction": {
"description": "Actions on Google action to open a given url.",
"properties": {
"urlTypeHint": {
"type": "string",
"enumDescriptions": [
"Unspecified",
"Url would be an amp action",
"URL that points directly to AMP content, or to a canonical URL which refers to AMP content via ."
],
"enum": [
"URL_TYPE_HINT_UNSPECIFIED",
"AMP_ACTION",
"AMP_CONTENT"
],
"description": "Optional. Specifies the type of viewer that is used when opening the URL. Defaults to opening via web browser."
},
"url": {
"type": "string",
"description": "Required. URL"
}
},
"type": "object",
"id": "GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCardBrowseCarouselCardItemOpenUrlAction"
},
"GoogleCloudDialogflowCxV3PageInfoFormInfo": {
"type": "object",
"id": "GoogleCloudDialogflowCxV3PageInfoFormInfo",
"properties": {
"parameterInfo": {
"type": "array",
"description": "Optional for both WebhookRequest and WebhookResponse. The parameters contained in the form. Note that the webhook cannot add or remove any form parameter.",
"items": {
"$ref": "GoogleCloudDialogflowCxV3PageInfoFormInfoParameterInfo"
}
}
},
"description": "Represents form information."
},
"GoogleCloudDialogflowV2beta1SubAgent": {
"description": "Contains basic configuration for a sub-agent.",
"properties": {
"environment": {
"description": "Optional. The unique identifier (`environment name` in dialogflow console) of this sub-agent environment. Assumes draft environment if `environment` is not set.",
"type": "string"
},
"project": {
"description": "Required. The project of this agent. Format: `projects/` or `projects//locations/`.",
"type": "string"
}
},
"id": "GoogleCloudDialogflowV2beta1SubAgent",
"type": "object"
},
"GoogleCloudDialogflowV2beta1IntentMessageTableCardRow": {
"type": "object",
"properties": {
"cells": {
"type": "array",
"description": "Optional. List of cells that make up this row.",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageTableCardCell"
}
},
"dividerAfter": {
"type": "boolean",
"description": "Optional. Whether to add a visual divider after this row."
}
},
"id": "GoogleCloudDialogflowV2beta1IntentMessageTableCardRow",
"description": "Row of TableCard."
},
"GoogleCloudDialogflowV2beta1RestoreAgentRequest": {
"id": "GoogleCloudDialogflowV2beta1RestoreAgentRequest",
"properties": {
"agentUri": {
"description": "The URI to a Google Cloud Storage file containing the agent to restore. Note: The URI must start with \"gs://\".",
"type": "string"
},
"agentContent": {
"type": "string",
"description": "Zip compressed raw byte content for agent.",
"format": "byte"
}
},
"description": "The request message for Agents.RestoreAgent.",
"type": "object"
},
"GoogleCloudDialogflowV2beta1BatchDeleteEntityTypesRequest": {
"type": "object",
"properties": {
"entityTypeNames": {
"description": "Required. The names entity types to delete. All names must point to the same agent as `parent`.",
"items": {
"type": "string"
},
"type": "array"
}
},
"description": "The request message for EntityTypes.BatchDeleteEntityTypes.",
"id": "GoogleCloudDialogflowV2beta1BatchDeleteEntityTypesRequest"
},
"GoogleCloudDialogflowV2beta1Environment": {
"id": "GoogleCloudDialogflowV2beta1Environment",
"type": "object",
"description": "You can create multiple versions of your agent and publish them to separate environments. When you edit an agent, you are editing the draft agent. At any point, you can save the draft agent as an agent version, which is an immutable snapshot of your agent. When you save the draft agent, it is published to the default environment. When you create agent versions, you can publish them to custom environments. You can create a variety of custom environments for: - testing - development - production - etc. For more information, see the [versions and environments guide](https://cloud.google.com/dialogflow/docs/agents-versions).",
"properties": {
"name": {
"readOnly": true,
"type": "string",
"description": "Output only. The unique identifier of this agent environment. Supported formats: - `projects//agent/environments/` - `projects//locations//agent/environments/`"
},
"description": {
"description": "Optional. The developer-provided description for this environment. The maximum length is 500 characters. If exceeded, the request is rejected.",
"type": "string"
},
"state": {
"description": "Output only. The state of this environment. This field is read-only, i.e., it cannot be set by create and update methods.",
"readOnly": true,
"enum": [
"STATE_UNSPECIFIED",
"STOPPED",
"LOADING",
"RUNNING"
],
"enumDescriptions": [
"Not specified. This value is not used.",
"Stopped.",
"Loading.",
"Running."
],
"type": "string"
},
"agentVersion": {
"type": "string",
"description": "Optional. The agent version loaded into this environment. Supported formats: - `projects//agent/versions/` - `projects//locations//agent/versions/`"
},
"updateTime": {
"readOnly": true,
"description": "Output only. The last update time of this environment. This field is read-only, i.e., it cannot be set by create and update methods.",
"type": "string",
"format": "google-datetime"
}
}
},
"GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText": {
"id": "GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText",
"properties": {
"ssml": {
"description": "The SSML text to be synthesized. For more information, see [SSML](/speech/text-to-speech/docs/ssml).",
"type": "string"
},
"text": {
"type": "string",
"description": "The raw text to be synthesized."
},
"allowPlaybackInterruption": {
"type": "boolean",
"description": "Output only. Whether the playback of this message can be interrupted by the end user's speech and the client can then starts the next Dialogflow request.",
"readOnly": true
}
},
"type": "object",
"description": "A text or ssml response that is preferentially used for TTS output audio synthesis, as described in the comment on the ResponseMessage message."
},
"GoogleCloudDialogflowV2beta1Intent": {
"description": "An intent categorizes an end-user's intention for one conversation turn. For each agent, you define many intents, where your combined intents can handle a complete conversation. When an end-user writes or says something, referred to as an end-user expression or end-user input, Dialogflow matches the end-user input to the best intent in your agent. Matching an intent is also known as intent classification. For more information, see the [intent guide](https://cloud.google.com/dialogflow/docs/intents-overview).",
"type": "object",
"id": "GoogleCloudDialogflowV2beta1Intent",
"properties": {
"resetContexts": {
"description": "Optional. Indicates whether to delete all contexts in the current session when this intent is matched.",
"type": "boolean"
},
"rootFollowupIntentName": {
"readOnly": true,
"description": "Output only. The unique identifier of the root intent in the chain of followup intents. It identifies the correct followup intents chain for this intent. Format: `projects//agent/intents/`.",
"type": "string"
},
"endInteraction": {
"description": "Optional. Indicates that this intent ends an interaction. Some integrations (e.g., Actions on Google or Dialogflow phone gateway) use this information to close interaction with an end user. Default is false.",
"type": "boolean"
},
"action": {
"type": "string",
"description": "Optional. The name of the action associated with the intent. Note: The action name must not contain whitespaces."
},
"outputContexts": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"type": "array",
"description": "Optional. The collection of contexts that are activated when the intent is matched. Context messages in this collection should not set the parameters field. Setting the `lifespan_count` to 0 will reset the context when the intent is matched. Format: `projects//agent/sessions/-/contexts/`."
},
"trainingPhrases": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1IntentTrainingPhrase"
},
"type": "array",
"description": "Optional. The collection of examples that the agent is trained on."
},
"mlEnabled": {
"description": "Optional. Indicates whether Machine Learning is enabled for the intent. Note: If `ml_enabled` setting is set to false, then this intent is not taken into account during inference in `ML ONLY` match mode. Also, auto-markup in the UI is turned off. DEPRECATED! Please use `ml_disabled` field instead. NOTE: If both `ml_enabled` and `ml_disabled` are either not set or false, then the default value is determined as follows: - Before April 15th, 2018 the default is: ml_enabled = false / ml_disabled = true. - After April 15th, 2018 the default is: ml_enabled = true / ml_disabled = false.",
"type": "boolean"
},
"defaultResponsePlatforms": {
"items": {
"type": "string",
"enumDescriptions": [
"Not specified.",
"Facebook.",
"Slack.",
"Telegram.",
"Kik.",
"Skype.",
"Line.",
"Viber.",
"Google Assistant See [Dialogflow webhook format](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)",
"Telephony Gateway.",
"Google Hangouts."
],
"enum": [
"PLATFORM_UNSPECIFIED",
"FACEBOOK",
"SLACK",
"TELEGRAM",
"KIK",
"SKYPE",
"LINE",
"VIBER",
"ACTIONS_ON_GOOGLE",
"TELEPHONY",
"GOOGLE_HANGOUTS"
]
},
"type": "array",
"description": "Optional. The list of platforms for which the first responses will be copied from the messages in PLATFORM_UNSPECIFIED (i.e. default platform)."
},
"messages": {
"description": "Optional. The collection of rich messages corresponding to the `Response` field in the Dialogflow console.",
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessage"
}
},
"name": {
"description": "Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Supported formats: - `projects//agent/intents/` - `projects//locations//agent/intents/`",
"type": "string"
},
"inputContextNames": {
"type": "array",
"description": "Optional. The list of context names required for this intent to be triggered. Formats: - `projects//agent/sessions/-/contexts/` - `projects//locations//agent/sessions/-/contexts/`",
"items": {
"type": "string"
}
},
"webhookState": {
"description": "Optional. Indicates whether webhooks are enabled for the intent.",
"enumDescriptions": [
"Webhook is disabled in the agent and in the intent.",
"Webhook is enabled in the agent and in the intent.",
"Webhook is enabled in the agent and in the intent. Also, each slot filling prompt is forwarded to the webhook."
],
"enum": [
"WEBHOOK_STATE_UNSPECIFIED",
"WEBHOOK_STATE_ENABLED",
"WEBHOOK_STATE_ENABLED_FOR_SLOT_FILLING"
],
"type": "string"
},
"isFallback": {
"description": "Optional. Indicates whether this is a fallback intent.",
"type": "boolean"
},
"displayName": {
"description": "Required. The name of this intent.",
"type": "string"
},
"followupIntentInfo": {
"readOnly": true,
"description": "Output only. Information about all followup intents that have this intent as a direct or indirect parent. We populate this field only in the output.",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1IntentFollowupIntentInfo"
},
"type": "array"
},
"parameters": {
"description": "Optional. The collection of parameters associated with the intent.",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1IntentParameter"
},
"type": "array"
},
"priority": {
"format": "int32",
"type": "integer",
"description": "Optional. The priority of this intent. Higher numbers represent higher priorities. - If the supplied value is unspecified or 0, the service translates the value to 500,000, which corresponds to the `Normal` priority in the console. - If the supplied value is negative, the intent is ignored in runtime detect intent requests."
},
"mlDisabled": {
"description": "Optional. Indicates whether Machine Learning is disabled for the intent. Note: If `ml_disabled` setting is set to true, then this intent is not taken into account during inference in `ML ONLY` match mode. Also, auto-markup in the UI is turned off.",
"type": "boolean"
},
"events": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional. The collection of event names that trigger the intent. If the collection of input contexts is not empty, all of the contexts must be present in the active user session for an event to trigger this intent. Event names are limited to 150 characters."
},
"parentFollowupIntentName": {
"type": "string",
"description": "Optional. The unique identifier of the parent intent in the chain of followup intents. You can set this field when creating an intent, for example with CreateIntent or BatchUpdateIntents, in order to make this intent a followup intent. It identifies the parent followup intent. Format: `projects//agent/intents/`."
}
}
},
"GoogleCloudDialogflowV2beta1GcsSource": {
"id": "GoogleCloudDialogflowV2beta1GcsSource",
"properties": {
"uri": {
"type": "string",
"description": "Required. The Google Cloud Storage URIs for the inputs. A URI is of the form: gs://bucket/object-prefix-or-name Whether a prefix or name is used depends on the use case."
}
},
"description": "Google Cloud Storage location for single input.",
"type": "object"
},
"GoogleCloudDialogflowV2IntentTrainingPhrasePart": {
"description": "Represents a part of a training phrase.",
"id": "GoogleCloudDialogflowV2IntentTrainingPhrasePart",
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Required. The text for this part."
},
"userDefined": {
"type": "boolean",
"description": "Optional. Indicates whether the text was manually annotated. This field is set to true when the Dialogflow Console is used to manually annotate the part. When creating an annotated part with the API, you must set this to true."
},
"entityType": {
"description": "Optional. The entity type name prefixed with `@`. This field is required for annotated parts of the training phrase.",
"type": "string"
},
"alias": {
"description": "Optional. The parameter name for the value extracted from the annotated part of the example. This field is required for annotated parts of the training phrase.",
"type": "string"
}
}
},
"GoogleCloudDialogflowV2AnnotatedMessagePart": {
"properties": {
"entityType": {
"description": "The [Dialogflow system entity type](https://cloud.google.com/dialogflow/docs/reference/system-entities) of this message part. If this is empty, Dialogflow could not annotate the phrase part with a system entity.",
"type": "string"
},
"formattedValue": {
"description": "The [Dialogflow system entity formatted value ](https://cloud.google.com/dialogflow/docs/reference/system-entities) of this message part. For example for a system entity of type `@sys.unit-currency`, this may contain: { \"amount\": 5, \"currency\": \"USD\" } ",
"type": "any"
},
"text": {
"type": "string",
"description": "A part of a message possibly annotated with an entity."
}
},
"type": "object",
"description": "Represents a part of a message possibly annotated with an entity. The part can be an entity or purely a part of the message between two entities or message start/end.",
"id": "GoogleCloudDialogflowV2AnnotatedMessagePart"
},
"GoogleCloudDialogflowV2beta1QueryInput": {
"description": "Represents the query input. It can contain either: 1. An audio config which instructs the speech recognizer how to process the speech audio. 2. A conversational query in the form of text. 3. An event that specifies which intent to trigger.",
"type": "object",
"id": "GoogleCloudDialogflowV2beta1QueryInput",
"properties": {
"event": {
"$ref": "GoogleCloudDialogflowV2beta1EventInput",
"description": "The event to be processed."
},
"audioConfig": {
"description": "Instructs the speech recognizer how to process the speech audio.",
"$ref": "GoogleCloudDialogflowV2beta1InputAudioConfig"
},
"text": {
"description": "The natural language text to be processed.",
"$ref": "GoogleCloudDialogflowV2beta1TextInput"
}
}
},
"GoogleCloudDialogflowV2beta1KnowledgeAnswersAnswer": {
"description": "An answer from Knowledge Connector.",
"properties": {
"matchConfidence": {
"format": "float",
"type": "number",
"description": "The system's confidence score that this Knowledge answer is a good match for this conversational query. The range is from 0.0 (completely uncertain) to 1.0 (completely certain). Note: The confidence score is likely to vary somewhat (possibly even for identical requests), as the underlying model is under constant improvement. It may be deprecated in the future. We recommend using `match_confidence_level` which should be generally more stable."
},
"matchConfidenceLevel": {
"description": "The system's confidence level that this knowledge answer is a good match for this conversational query. NOTE: The confidence level for a given `` pair may change without notice, as it depends on models that are constantly being improved. However, it will change less frequently than the confidence score below, and should be preferred for referencing the quality of an answer.",
"type": "string",
"enum": [
"MATCH_CONFIDENCE_LEVEL_UNSPECIFIED",
"LOW",
"MEDIUM",
"HIGH"
],
"enumDescriptions": [
"Not specified.",
"Indicates that the confidence is low.",
"Indicates our confidence is medium.",
"Indicates our confidence is high."
]
},
"answer": {
"type": "string",
"description": "The piece of text from the `source` knowledge base document that answers this conversational query."
},
"source": {
"description": "Indicates which Knowledge Document this answer was extracted from. Format: `projects//knowledgeBases//documents/`.",
"type": "string"
},
"faqQuestion": {
"description": "The corresponding FAQ question if the answer was extracted from a FAQ Document, empty otherwise.",
"type": "string"
}
},
"type": "object",
"id": "GoogleCloudDialogflowV2beta1KnowledgeAnswersAnswer"
},
"GoogleCloudDialogflowV2beta1VoiceSelectionParams": {
"properties": {
"ssmlGender": {
"enum": [
"SSML_VOICE_GENDER_UNSPECIFIED",
"SSML_VOICE_GENDER_MALE",
"SSML_VOICE_GENDER_FEMALE",
"SSML_VOICE_GENDER_NEUTRAL"
],
"enumDescriptions": [
"An unspecified gender, which means that the client doesn't care which gender the selected voice will have.",
"A male voice.",
"A female voice.",
"A gender-neutral voice."
],
"description": "Optional. The preferred gender of the voice. If not set, the service will choose a voice based on the other parameters such as language_code and name. Note that this is only a preference, not requirement. If a voice of the appropriate gender is not available, the synthesizer should substitute a voice with a different gender rather than failing the request.",
"type": "string"
},
"name": {
"description": "Optional. The name of the voice. If not set, the service will choose a voice based on the other parameters such as language_code and ssml_gender.",
"type": "string"
}
},
"type": "object",
"id": "GoogleCloudDialogflowV2beta1VoiceSelectionParams",
"description": "Description of which voice to use for speech synthesis."
},
"GoogleCloudDialogflowV2beta1IntentMessageCardButton": {
"id": "GoogleCloudDialogflowV2beta1IntentMessageCardButton",
"description": "Optional. Contains information about a button.",
"properties": {
"text": {
"type": "string",
"description": "Optional. The text to show on the button."
},
"postback": {
"type": "string",
"description": "Optional. The text to send back to the Dialogflow API or a URI to open."
}
},
"type": "object"
},
"GoogleCloudDialogflowV2IntentMessageSuggestion": {
"id": "GoogleCloudDialogflowV2IntentMessageSuggestion",
"description": "The suggestion chip message that the user can tap to quickly post a reply to the conversation.",
"type": "object",
"properties": {
"title": {
"description": "Required. The text shown the in the suggestion chip.",
"type": "string"
}
}
},
"GoogleCloudDialogflowCxV3beta1ExportAgentResponse": {
"description": "The response message for Agents.ExportAgent.",
"properties": {
"agentContent": {
"description": "Uncompressed raw byte content for agent.",
"format": "byte",
"type": "string"
},
"agentUri": {
"description": "The URI to a file containing the exported agent. This field is populated only if `agent_uri` is specified in ExportAgentRequest.",
"type": "string"
}
},
"id": "GoogleCloudDialogflowCxV3beta1ExportAgentResponse",
"type": "object"
},
"GoogleCloudDialogflowV2IntentMessageSimpleResponses": {
"id": "GoogleCloudDialogflowV2IntentMessageSimpleResponses",
"description": "The collection of simple response candidates. This message in `QueryResult.fulfillment_messages` and `WebhookResponse.fulfillment_messages` should contain only one `SimpleResponse`.",
"properties": {
"simpleResponses": {
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2IntentMessageSimpleResponse"
},
"description": "Required. The list of simple responses."
}
},
"type": "object"
},
"GoogleCloudDialogflowV2beta1ExportAgentResponse": {
"type": "object",
"id": "GoogleCloudDialogflowV2beta1ExportAgentResponse",
"description": "The response message for Agents.ExportAgent.",
"properties": {
"agentUri": {
"type": "string",
"description": "The URI to a file containing the exported agent. This field is populated only if `agent_uri` is specified in `ExportAgentRequest`."
},
"agentContent": {
"description": "Zip compressed raw byte content for agent.",
"type": "string",
"format": "byte"
}
}
},
"GoogleCloudDialogflowV2IntentParameter": {
"description": "Represents intent parameters.",
"type": "object",
"id": "GoogleCloudDialogflowV2IntentParameter",
"properties": {
"name": {
"type": "string",
"description": "The unique identifier of this parameter."
},
"entityTypeDisplayName": {
"description": "Optional. The name of the entity type, prefixed with `@`, that describes values of the parameter. If the parameter is required, this must be provided.",
"type": "string"
},
"defaultValue": {
"description": "Optional. The default value to use when the `value` yields an empty result. Default values can be extracted from contexts by using the following syntax: `#context_name.parameter_name`.",
"type": "string"
},
"displayName": {
"type": "string",
"description": "Required. The name of the parameter."
},
"isList": {
"type": "boolean",
"description": "Optional. Indicates whether the parameter represents a list of values."
},
"mandatory": {
"type": "boolean",
"description": "Optional. Indicates whether the parameter is required. That is, whether the intent cannot be completed without collecting the parameter value."
},
"value": {
"type": "string",
"description": "Optional. The definition of the parameter value. It can be: - a constant string, - a parameter value defined as `$parameter_name`, - an original parameter value defined as `$parameter_name.original`, - a parameter value from some context defined as `#context_name.parameter_name`."
},
"prompts": {
"items": {
"type": "string"
},
"type": "array",
"description": "Optional. The collection of prompts that the agent can present to the user in order to collect a value for the parameter."
}
}
},
"GoogleCloudDialogflowV2beta1DetectIntentResponse": {
"type": "object",
"id": "GoogleCloudDialogflowV2beta1DetectIntentResponse",
"properties": {
"outputAudio": {
"type": "string",
"description": "The audio data bytes encoded as specified in the request. Note: The output audio is generated based on the values of default platform text responses found in the `query_result.fulfillment_messages` field. If multiple default text responses exist, they will be concatenated when generating audio. If no default platform text responses exist, the generated audio content will be empty. In some scenarios, multiple output audio fields may be present in the response structure. In these cases, only the top-most-level audio output has content.",
"format": "byte"
},
"webhookStatus": {
"$ref": "GoogleRpcStatus",
"description": "Specifies the status of the webhook request."
},
"outputAudioConfig": {
"$ref": "GoogleCloudDialogflowV2beta1OutputAudioConfig",
"description": "The config used by the speech synthesizer to generate the output audio."
},
"responseId": {
"type": "string",
"description": "The unique identifier of the response. It can be used to locate a response in the training example set or for reporting issues."
},
"alternativeQueryResults": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1QueryResult"
},
"description": "If Knowledge Connectors are enabled, there could be more than one result returned for a given query or event, and this field will contain all results except for the top one, which is captured in query_result. The alternative results are ordered by decreasing `QueryResult.intent_detection_confidence`. If Knowledge Connectors are disabled, this field will be empty until multiple responses for regular intents are supported, at which point those additional results will be surfaced here.",
"type": "array"
},
"queryResult": {
"description": "The selected results of the conversational query or event processing. See `alternative_query_results` for additional potential results.",
"$ref": "GoogleCloudDialogflowV2beta1QueryResult"
}
},
"description": "The message returned from the DetectIntent method."
},
"GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo": {
"id": "GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo",
"properties": {
"justCollected": {
"description": "Optional for WebhookRequest. Ignored for WebhookResponse. Indicates if the parameter value was just collected on the last conversation turn.",
"type": "boolean"
},
"displayName": {
"description": "Always present for WebhookRequest. Required for WebhookResponse. The human-readable name of the parameter, unique within the form. This field cannot be modified by the webhook.",
"type": "string"
},
"value": {
"description": "Optional for both WebhookRequest and WebhookResponse. The value of the parameter. This field can be set by the webhook to change the parameter value.",
"type": "any"
},
"state": {
"enum": [
"PARAMETER_STATE_UNSPECIFIED",
"EMPTY",
"INVALID",
"FILLED"
],
"type": "string",
"description": "Always present for WebhookRequest. Required for WebhookResponse. The state of the parameter. This field can be set to INVALID by the webhook to invalidate the parameter; other values set by the webhook will be ignored.",
"enumDescriptions": [
"Not specified. This value should be never used.",
"Indicates that the parameter does not have a value.",
"Indicates that the parameter value is invalid. This field can be used by the webhook to invalidate the parameter and ask the server to collect it from the user again.",
"Indicates that the parameter has a value."
]
},
"required": {
"type": "boolean",
"description": "Optional for both WebhookRequest and WebhookResponse. Indicates whether the parameter is required. Optional parameters will not trigger prompts; however, they are filled if the user specifies them. Required parameters must be filled before form filling concludes."
}
},
"description": "Represents parameter information.",
"type": "object"
},
"GoogleCloudDialogflowV2Intent": {
"description": "An intent categorizes an end-user's intention for one conversation turn. For each agent, you define many intents, where your combined intents can handle a complete conversation. When an end-user writes or says something, referred to as an end-user expression or end-user input, Dialogflow matches the end-user input to the best intent in your agent. Matching an intent is also known as intent classification. For more information, see the [intent guide](https://cloud.google.com/dialogflow/docs/intents-overview).",
"id": "GoogleCloudDialogflowV2Intent",
"type": "object",
"properties": {
"trainingPhrases": {
"items": {
"$ref": "GoogleCloudDialogflowV2IntentTrainingPhrase"
},
"type": "array",
"description": "Optional. The collection of examples that the agent is trained on."
},
"inputContextNames": {
"description": "Optional. The list of context names required for this intent to be triggered. Format: `projects//agent/sessions/-/contexts/`.",
"type": "array",
"items": {
"type": "string"
}
},
"displayName": {
"type": "string",
"description": "Required. The name of this intent."
},
"webhookState": {
"enumDescriptions": [
"Webhook is disabled in the agent and in the intent.",
"Webhook is enabled in the agent and in the intent.",
"Webhook is enabled in the agent and in the intent. Also, each slot filling prompt is forwarded to the webhook."
],
"type": "string",
"enum": [
"WEBHOOK_STATE_UNSPECIFIED",
"WEBHOOK_STATE_ENABLED",
"WEBHOOK_STATE_ENABLED_FOR_SLOT_FILLING"
],
"description": "Optional. Indicates whether webhooks are enabled for the intent."
},
"isFallback": {
"type": "boolean",
"description": "Optional. Indicates whether this is a fallback intent."
},
"priority": {
"type": "integer",
"description": "Optional. The priority of this intent. Higher numbers represent higher priorities. - If the supplied value is unspecified or 0, the service translates the value to 500,000, which corresponds to the `Normal` priority in the console. - If the supplied value is negative, the intent is ignored in runtime detect intent requests.",
"format": "int32"
},
"parentFollowupIntentName": {
"type": "string",
"description": "Read-only after creation. The unique identifier of the parent intent in the chain of followup intents. You can set this field when creating an intent, for example with CreateIntent or BatchUpdateIntents, in order to make this intent a followup intent. It identifies the parent followup intent. Format: `projects//agent/intents/`."
},
"followupIntentInfo": {
"description": "Read-only. Information about all followup intents that have this intent as a direct or indirect parent. We populate this field only in the output.",
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2IntentFollowupIntentInfo"
}
},
"resetContexts": {
"description": "Optional. Indicates whether to delete all contexts in the current session when this intent is matched.",
"type": "boolean"
},
"name": {
"description": "Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`.",
"type": "string"
},
"defaultResponsePlatforms": {
"type": "array",
"description": "Optional. The list of platforms for which the first responses will be copied from the messages in PLATFORM_UNSPECIFIED (i.e. default platform).",
"items": {
"enumDescriptions": [
"Default platform.",
"Facebook.",
"Slack.",
"Telegram.",
"Kik.",
"Skype.",
"Line.",
"Viber.",
"Google Assistant See [Dialogflow webhook format](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)",
"Google Hangouts."
],
"enum": [
"PLATFORM_UNSPECIFIED",
"FACEBOOK",
"SLACK",
"TELEGRAM",
"KIK",
"SKYPE",
"LINE",
"VIBER",
"ACTIONS_ON_GOOGLE",
"GOOGLE_HANGOUTS"
],
"type": "string"
}
},
"mlDisabled": {
"type": "boolean",
"description": "Optional. Indicates whether Machine Learning is disabled for the intent. Note: If `ml_disabled` setting is set to true, then this intent is not taken into account during inference in `ML ONLY` match mode. Also, auto-markup in the UI is turned off."
},
"messages": {
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2IntentMessage"
},
"description": "Optional. The collection of rich messages corresponding to the `Response` field in the Dialogflow console."
},
"action": {
"description": "Optional. The name of the action associated with the intent. Note: The action name must not contain whitespaces.",
"type": "string"
},
"parameters": {
"items": {
"$ref": "GoogleCloudDialogflowV2IntentParameter"
},
"type": "array",
"description": "Optional. The collection of parameters associated with the intent."
},
"rootFollowupIntentName": {
"description": "Read-only. The unique identifier of the root intent in the chain of followup intents. It identifies the correct followup intents chain for this intent. We populate this field only in the output. Format: `projects//agent/intents/`.",
"type": "string"
},
"events": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional. The collection of event names that trigger the intent. If the collection of input contexts is not empty, all of the contexts must be present in the active user session for an event to trigger this intent. Event names are limited to 150 characters."
},
"outputContexts": {
"type": "array",
"description": "Optional. The collection of contexts that are activated when the intent is matched. Context messages in this collection should not set the parameters field. Setting the `lifespan_count` to 0 will reset the context when the intent is matched. Format: `projects//agent/sessions/-/contexts/`.",
"items": {
"$ref": "GoogleCloudDialogflowV2Context"
}
}
}
},
"GoogleCloudDialogflowV2beta1ListSessionEntityTypesResponse": {
"description": "The response message for SessionEntityTypes.ListSessionEntityTypes.",
"type": "object",
"id": "GoogleCloudDialogflowV2beta1ListSessionEntityTypesResponse",
"properties": {
"nextPageToken": {
"type": "string",
"description": "Token to retrieve the next page of results, or empty if there are no more results in the list."
},
"sessionEntityTypes": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
},
"type": "array",
"description": "The list of session entity types. There will be a maximum number of items returned based on the page_size field in the request."
}
}
},
"GoogleCloudDialogflowV2beta1IntentMessageBasicCardButtonOpenUriAction": {
"description": "Opens the given URI.",
"type": "object",
"id": "GoogleCloudDialogflowV2beta1IntentMessageBasicCardButtonOpenUriAction",
"properties": {
"uri": {
"type": "string",
"description": "Required. The HTTP or HTTPS scheme URI."
}
}
},
"GoogleCloudDialogflowV2beta1IntentMessageRbmCardContent": {
"properties": {
"description": {
"type": "string",
"description": "Optional. Description of the card (at most 2000 bytes). At least one of the title, description or media must be set."
},
"media": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia",
"description": "Optional. However at least one of the title, description or media must be set. Media (image, GIF or a video) to include in the card."
},
"title": {
"description": "Optional. Title of the card (at most 200 bytes). At least one of the title, description or media must be set.",
"type": "string"
},
"suggestions": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestion"
},
"type": "array",
"description": "Optional. List of suggestions to include in the card."
}
},
"description": "Rich Business Messaging (RBM) Card content",
"type": "object",
"id": "GoogleCloudDialogflowV2beta1IntentMessageRbmCardContent"
},
"GoogleCloudDialogflowV2beta1WebhookResponse": {
"type": "object",
"id": "GoogleCloudDialogflowV2beta1WebhookResponse",
"properties": {
"payload": {
"description": "Optional. This field can be used to pass custom data from your webhook to the integration or API caller. Arbitrary JSON objects are supported. When provided, Dialogflow uses this field to populate QueryResult.webhook_payload sent to the integration or API caller. This field is also used by the [Google Assistant integration](https://cloud.google.com/dialogflow/docs/integrations/aog) for rich response messages. See the format definition at [Google Assistant Dialogflow webhook format](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)",
"additionalProperties": {
"type": "any",
"description": "Properties of the object."
},
"type": "object"
},
"fulfillmentMessages": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessage"
},
"description": "Optional. The rich response messages intended for the end-user. When provided, Dialogflow uses this field to populate QueryResult.fulfillment_messages sent to the integration or API caller.",
"type": "array"
},
"endInteraction": {
"type": "boolean",
"description": "Optional. Indicates that this intent ends an interaction. Some integrations (e.g., Actions on Google or Dialogflow phone gateway) use this information to close interaction with an end user. Default is false."
},
"fulfillmentText": {
"type": "string",
"description": "Optional. The text response message intended for the end-user. It is recommended to use `fulfillment_messages.text.text[0]` instead. When provided, Dialogflow uses this field to populate QueryResult.fulfillment_text sent to the integration or API caller."
},
"sessionEntityTypes": {
"description": "Optional. Additional session entity types to replace or extend developer entity types with. The entity synonyms apply to all languages and persist for the session. Setting this data from a webhook overwrites the session entity types that have been set using `detectIntent`, `streamingDetectIntent` or SessionEntityType management methods.",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
},
"type": "array"
},
"source": {
"type": "string",
"description": "Optional. A custom field used to identify the webhook source. Arbitrary strings are supported. When provided, Dialogflow uses this field to populate QueryResult.webhook_source sent to the integration or API caller."
},
"outputContexts": {
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"description": "Optional. The collection of output contexts that will overwrite currently active contexts for the session and reset their lifespans. When provided, Dialogflow uses this field to populate QueryResult.output_contexts sent to the integration or API caller."
},
"followupEventInput": {
"$ref": "GoogleCloudDialogflowV2beta1EventInput",
"description": "Optional. Invokes the supplied events. When this field is set, Dialogflow ignores the `fulfillment_text`, `fulfillment_messages`, and `payload` fields."
}
},
"description": "The response message for a webhook call. This response is validated by the Dialogflow server. If validation fails, an error will be returned in the QueryResult.diagnostic_info field. Setting JSON fields to an empty value with the wrong type is a common error. To avoid this error: - Use `\"\"` for empty strings - Use `{}` or `null` for empty objects - Use `[]` or `null` for empty arrays For more information, see the [Protocol Buffers Language Guide](https://developers.google.com/protocol-buffers/docs/proto3#json)."
},
"GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedAction": {
"type": "object",
"properties": {
"postbackData": {
"type": "string",
"description": "Opaque payload that the Dialogflow receives in a user event when the user taps the suggested action. This data will be also forwarded to webhook to allow performing custom business logic."
},
"openUrl": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionOpenUri",
"description": "Suggested client side action: Open a URI on device"
},
"dial": {
"description": "Suggested client side action: Dial a phone number",
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionDial"
},
"text": {
"description": "Text to display alongside the action.",
"type": "string"
},
"shareLocation": {
"description": "Suggested client side action: Share user location",
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionShareLocation"
}
},
"id": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedAction",
"description": "Rich Business Messaging (RBM) suggested client-side action that the user can choose from the card."
},
"GoogleCloudDialogflowCxV3beta1PageInfoFormInfo": {
"type": "object",
"properties": {
"parameterInfo": {
"items": {
"$ref": "GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo"
},
"description": "Optional for both WebhookRequest and WebhookResponse. The parameters contained in the form. Note that the webhook cannot add or remove any form parameter.",
"type": "array"
}
},
"id": "GoogleCloudDialogflowCxV3beta1PageInfoFormInfo",
"description": "Represents form information."
},
"GoogleCloudDialogflowCxV3beta1WebhookResponseFulfillmentResponse": {
"type": "object",
"description": "Represents a fulfillment response to the user.",
"id": "GoogleCloudDialogflowCxV3beta1WebhookResponseFulfillmentResponse",
"properties": {
"messages": {
"type": "array",
"description": "The list of rich message responses to present to the user.",
"items": {
"$ref": "GoogleCloudDialogflowCxV3beta1ResponseMessage"
}
},
"mergeBehavior": {
"type": "string",
"enum": [
"MERGE_BEHAVIOR_UNSPECIFIED",
"APPEND",
"REPLACE"
],
"enumDescriptions": [
"Not specified. `APPEND` will be used.",
"`messages` will be appended to the list of messages waiting to be sent to the user.",
"`messages` will replace the list of messages waiting to be sent to the user."
],
"description": "Merge behavior for `messages`."
}
}
},
"GoogleCloudDialogflowV2beta1IntentMessageSelectItemInfo": {
"type": "object",
"description": "Additional info about the select item for when it is triggered in a dialog.",
"id": "GoogleCloudDialogflowV2beta1IntentMessageSelectItemInfo",
"properties": {
"synonyms": {
"description": "Optional. A list of synonyms that can also be used to trigger this item in dialog.",
"items": {
"type": "string"
},
"type": "array"
},
"key": {
"description": "Required. A unique key that will be sent back to the agent if this response is given.",
"type": "string"
}
}
},
"GoogleCloudDialogflowV2beta1ImportAgentRequest": {
"properties": {
"agentUri": {
"description": "The URI to a Google Cloud Storage file containing the agent to import. Note: The URI must start with \"gs://\".",
"type": "string"
},
"agentContent": {
"format": "byte",
"type": "string",
"description": "Zip compressed raw byte content for agent."
}
},
"id": "GoogleCloudDialogflowV2beta1ImportAgentRequest",
"description": "The request message for Agents.ImportAgent.",
"type": "object"
},
"GoogleCloudDialogflowV2IntentTrainingPhrase": {
"type": "object",
"id": "GoogleCloudDialogflowV2IntentTrainingPhrase",
"description": "Represents an example that the agent is trained on.",
"properties": {
"name": {
"description": "Output only. The unique identifier of this training phrase.",
"type": "string"
},
"parts": {
"items": {
"$ref": "GoogleCloudDialogflowV2IntentTrainingPhrasePart"
},
"description": "Required. The ordered list of training phrase parts. The parts are concatenated in order to form the training phrase. Note: The API does not automatically annotate training phrases like the Dialogflow Console does. Note: Do not forget to include whitespace at part boundaries, so the training phrase is well formatted when the parts are concatenated. If the training phrase does not need to be annotated with parameters, you just need a single part with only the Part.text field set. If you want to annotate the training phrase, you must create multiple parts, where the fields of each part are populated in one of two ways: - `Part.text` is set to a part of the phrase that has no parameters. - `Part.text` is set to a part of the phrase that you want to annotate, and the `entity_type`, `alias`, and `user_defined` fields are all set.",
"type": "array"
},
"type": {
"type": "string",
"description": "Required. The type of the training phrase.",
"enumDescriptions": [
"Not specified. This value should never be used.",
"Examples do not contain @-prefixed entity type names, but example parts can be annotated with entity types.",
"Templates are not annotated with entity types, but they can contain @-prefixed entity type names as substrings. Template mode has been deprecated. Example mode is the only supported way to create new training phrases. If you have existing training phrases that you've created in template mode, those will continue to work."
],
"enum": [
"TYPE_UNSPECIFIED",
"EXAMPLE",
"TEMPLATE"
]
},
"timesAddedCount": {
"type": "integer",
"description": "Optional. Indicates how many times this example was added to the intent. Each time a developer adds an existing sample by editing an intent or training, this counter is increased.",
"format": "int32"
}
}
},
"GoogleCloudDialogflowV2beta1InputAudioConfig": {
"properties": {
"model": {
"description": "Which Speech model to select for the given request. Select the model best suited to your domain to get best results. If a model is not explicitly specified, then we auto-select a model based on the parameters in the InputAudioConfig. If enhanced speech model is enabled for the agent and an enhanced version of the specified model for the language does not exist, then the speech is recognized using the standard version of the specified model. Refer to [Cloud Speech API documentation](https://cloud.google.com/speech-to-text/docs/basics#select-model) for more details.",
"type": "string"
},
"enableWordInfo": {
"description": "If `true`, Dialogflow returns SpeechWordInfo in StreamingRecognitionResult with information about the recognized speech words, e.g. start and end time offsets. If false or unspecified, Speech doesn't return any word-level information.",
"type": "boolean"
},
"modelVariant": {
"description": "Which variant of the Speech model to use.",
"enum": [
"SPEECH_MODEL_VARIANT_UNSPECIFIED",
"USE_BEST_AVAILABLE",
"USE_STANDARD",
"USE_ENHANCED"
],
"enumDescriptions": [
"No model variant specified. In this case Dialogflow defaults to USE_BEST_AVAILABLE.",
"Use the best available variant of the Speech model that the caller is eligible for. Please see the [Dialogflow docs](https://cloud.google.com/dialogflow/docs/data-logging) for how to make your project eligible for enhanced models.",
"Use standard model variant even if an enhanced model is available. See the [Cloud Speech documentation](https://cloud.google.com/speech-to-text/docs/enhanced-models) for details about enhanced models.",
"Use an enhanced model variant: * If an enhanced variant does not exist for the given model and request language, Dialogflow falls back to the standard variant. The [Cloud Speech documentation](https://cloud.google.com/speech-to-text/docs/enhanced-models) describes which models have enhanced variants. * If the API caller isn't eligible for enhanced models, Dialogflow returns an error. Please see the [Dialogflow docs](https://cloud.google.com/dialogflow/docs/data-logging) for how to make your project eligible."
],
"type": "string"
},
"singleUtterance": {
"description": "If `false` (default), recognition does not cease until the client closes the stream. If `true`, the recognizer will detect a single spoken utterance in input audio. Recognition ceases when it detects the audio's voice has stopped or paused. In this case, once a detected intent is received, the client should close the stream and start a new request with a new stream as needed. Note: This setting is relevant only for streaming methods. Note: When specified, InputAudioConfig.single_utterance takes precedence over StreamingDetectIntentRequest.single_utterance.",
"type": "boolean"
},
"audioEncoding": {
"type": "string",
"description": "Required. Audio encoding of the audio content to process.",
"enumDescriptions": [
"Not specified.",
"Uncompressed 16-bit signed little-endian samples (Linear PCM).",
"[`FLAC`](https://xiph.org/flac/documentation.html) (Free Lossless Audio Codec) is the recommended encoding because it is lossless (therefore recognition is not compromised) and requires only about half the bandwidth of `LINEAR16`. `FLAC` stream encoding supports 16-bit and 24-bit samples, however, not all fields in `STREAMINFO` are supported.",
"8-bit samples that compand 14-bit audio samples using G.711 PCMU/mu-law.",
"Adaptive Multi-Rate Narrowband codec. `sample_rate_hertz` must be 8000.",
"Adaptive Multi-Rate Wideband codec. `sample_rate_hertz` must be 16000.",
"Opus encoded audio frames in Ogg container ([OggOpus](https://wiki.xiph.org/OggOpus)). `sample_rate_hertz` must be 16000.",
"Although the use of lossy encodings is not recommended, if a very low bitrate encoding is required, `OGG_OPUS` is highly preferred over Speex encoding. The [Speex](https://speex.org/) encoding supported by Dialogflow API has a header byte in each block, as in MIME type `audio/x-speex-with-header-byte`. It is a variant of the RTP Speex encoding defined in [RFC 5574](https://tools.ietf.org/html/rfc5574). The stream is a sequence of blocks, one block per RTP packet. Each block starts with a byte containing the length of the block, in bytes, followed by one or more frames of Speex data, padded to an integral number of bytes (octets) as specified in RFC 5574. In other words, each RTP header is replaced with a single byte containing the block length. Only Speex wideband is supported. `sample_rate_hertz` must be 16000."
],
"enum": [
"AUDIO_ENCODING_UNSPECIFIED",
"AUDIO_ENCODING_LINEAR_16",
"AUDIO_ENCODING_FLAC",
"AUDIO_ENCODING_MULAW",
"AUDIO_ENCODING_AMR",
"AUDIO_ENCODING_AMR_WB",
"AUDIO_ENCODING_OGG_OPUS",
"AUDIO_ENCODING_SPEEX_WITH_HEADER_BYTE"
]
},
"phraseHints": {
"items": {
"type": "string"
},
"description": "A list of strings containing words and phrases that the speech recognizer should recognize with higher likelihood. See [the Cloud Speech documentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-hints) for more details. This field is deprecated. Please use [speech_contexts]() instead. If you specify both [phrase_hints]() and [speech_contexts](), Dialogflow will treat the [phrase_hints]() as a single additional [SpeechContext]().",
"type": "array"
},
"languageCode": {
"type": "string",
"description": "Required. The language of the supplied audio. Dialogflow does not do translations. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes. Note that queries in the same session do not necessarily need to specify the same language."
},
"sampleRateHertz": {
"format": "int32",
"description": "Required. Sample rate (in Hertz) of the audio content sent in the query. Refer to [Cloud Speech API documentation](https://cloud.google.com/speech-to-text/docs/basics) for more details.",
"type": "integer"
},
"speechContexts": {
"description": "Context information to assist speech recognition. See [the Cloud Speech documentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-hints) for more details.",
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1SpeechContext"
}
}
},
"id": "GoogleCloudDialogflowV2beta1InputAudioConfig",
"description": "Instructs the speech recognizer on how to process the audio content.",
"type": "object"
},
"GoogleCloudDialogflowV2SessionEntityType": {
"type": "object",
"id": "GoogleCloudDialogflowV2SessionEntityType",
"description": "A session represents a conversation between a Dialogflow agent and an end-user. You can create special entities, called session entities, during a session. Session entities can extend or replace custom entity types and only exist during the session that they were created for. All session data, including session entities, is stored by Dialogflow for 20 minutes. For more information, see the [session entity guide](https://cloud.google.com/dialogflow/docs/entities-session).",
"properties": {
"entities": {
"items": {
"$ref": "GoogleCloudDialogflowV2EntityTypeEntity"
},
"description": "Required. The collection of entities associated with this session entity type.",
"type": "array"
},
"entityOverrideMode": {
"enumDescriptions": [
"Not specified. This value should be never used.",
"The collection of session entities overrides the collection of entities in the corresponding custom entity type.",
"The collection of session entities extends the collection of entities in the corresponding custom entity type. Note: Even in this override mode calls to `ListSessionEntityTypes`, `GetSessionEntityType`, `CreateSessionEntityType` and `UpdateSessionEntityType` only return the additional entities added in this session entity type. If you want to get the supplemented list, please call EntityTypes.GetEntityType on the custom entity type and merge."
],
"description": "Required. Indicates whether the additional data should override or supplement the custom entity type definition.",
"type": "string",
"enum": [
"ENTITY_OVERRIDE_MODE_UNSPECIFIED",
"ENTITY_OVERRIDE_MODE_OVERRIDE",
"ENTITY_OVERRIDE_MODE_SUPPLEMENT"
]
},
"name": {
"type": "string",
"description": "Required. The unique identifier of this session entity type. Format: `projects//agent/sessions//entityTypes/`, or `projects//agent/environments//users//sessions//entityTypes/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. `` must be the display name of an existing entity type in the same agent that will be overridden or supplemented."
}
}
},
"GoogleCloudDialogflowV2BatchUpdateIntentsResponse": {
"type": "object",
"id": "GoogleCloudDialogflowV2BatchUpdateIntentsResponse",
"description": "The response message for Intents.BatchUpdateIntents.",
"properties": {
"intents": {
"items": {
"$ref": "GoogleCloudDialogflowV2Intent"
},
"type": "array",
"description": "The collection of updated or created intents."
}
}
},
"GoogleCloudDialogflowV2IntentMessageBrowseCarouselCard": {
"id": "GoogleCloudDialogflowV2IntentMessageBrowseCarouselCard",
"type": "object",
"description": "Browse Carousel Card for Actions on Google. https://developers.google.com/actions/assistant/responses#browsing_carousel",
"properties": {
"imageDisplayOptions": {
"enumDescriptions": [
"Fill the gaps between the image and the image container with gray bars.",
"Fill the gaps between the image and the image container with gray bars.",
"Fill the gaps between the image and the image container with white bars.",
"Image is scaled such that the image width and height match or exceed the container dimensions. This may crop the top and bottom of the image if the scaled image height is greater than the container height, or crop the left and right of the image if the scaled image width is greater than the container width. This is similar to \"Zoom Mode\" on a widescreen TV when playing a 4:3 video.",
"Pad the gaps between image and image frame with a blurred copy of the same image."
],
"enum": [
"IMAGE_DISPLAY_OPTIONS_UNSPECIFIED",
"GRAY",
"WHITE",
"CROPPED",
"BLURRED_BACKGROUND"
],
"description": "Optional. Settings for displaying the image. Applies to every image in items.",
"type": "string"
},
"items": {
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2IntentMessageBrowseCarouselCardBrowseCarouselCardItem"
},
"description": "Required. List of items in the Browse Carousel Card. Minimum of two items, maximum of ten."
}
}
},
"GoogleCloudDialogflowV2beta1IntentMessageRbmStandaloneCard": {
"properties": {
"cardOrientation": {
"enumDescriptions": [
"Not specified.",
"Horizontal layout.",
"Vertical layout."
],
"type": "string",
"enum": [
"CARD_ORIENTATION_UNSPECIFIED",
"HORIZONTAL",
"VERTICAL"
],
"description": "Required. Orientation of the card."
},
"thumbnailImageAlignment": {
"type": "string",
"description": "Required if orientation is horizontal. Image preview alignment for standalone cards with horizontal layout.",
"enum": [
"THUMBNAIL_IMAGE_ALIGNMENT_UNSPECIFIED",
"LEFT",
"RIGHT"
],
"enumDescriptions": [
"Not specified.",
"Thumbnail preview is left-aligned.",
"Thumbnail preview is right-aligned."
]
},
"cardContent": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageRbmCardContent",
"description": "Required. Card content."
}
},
"description": "Standalone Rich Business Messaging (RBM) rich card. Rich cards allow you to respond to users with more vivid content, e.g. with media and suggestions. You can group multiple rich cards into one using RbmCarouselCard but carousel cards will give you less control over the card layout.",
"id": "GoogleCloudDialogflowV2beta1IntentMessageRbmStandaloneCard",
"type": "object"
},
"GoogleCloudDialogflowV2IntentMessageSelectItemInfo": {
"description": "Additional info about the select item for when it is triggered in a dialog.",
"properties": {
"synonyms": {
"items": {
"type": "string"
},
"description": "Optional. A list of synonyms that can also be used to trigger this item in dialog.",
"type": "array"
},
"key": {
"type": "string",
"description": "Required. A unique key that will be sent back to the agent if this response is given."
}
},
"type": "object",
"id": "GoogleCloudDialogflowV2IntentMessageSelectItemInfo"
},
"GoogleCloudDialogflowV2IntentMessageMediaContent": {
"description": "The media content card for Actions on Google.",
"id": "GoogleCloudDialogflowV2IntentMessageMediaContent",
"type": "object",
"properties": {
"mediaType": {
"description": "Optional. What type of media is the content (ie \"audio\").",
"enumDescriptions": [
"Unspecified.",
"Response media type is audio."
],
"type": "string",
"enum": [
"RESPONSE_MEDIA_TYPE_UNSPECIFIED",
"AUDIO"
]
},
"mediaObjects": {
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2IntentMessageMediaContentResponseMediaObject"
},
"description": "Required. List of media objects."
}
}
},
"GoogleCloudDialogflowV2beta1EventInput": {
"id": "GoogleCloudDialogflowV2beta1EventInput",
"type": "object",
"properties": {
"languageCode": {
"description": "Required. The language of this query. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes. Note that queries in the same session do not necessarily need to specify the same language.",
"type": "string"
},
"name": {
"type": "string",
"description": "Required. The unique identifier of the event."
},
"parameters": {
"additionalProperties": {
"type": "any",
"description": "Properties of the object."
},
"description": "The collection of parameters associated with the event. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: string or number, depending on parameter value type - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value",
"type": "object"
}
},
"description": "Events allow for matching intents by event name instead of the natural language input. For instance, input `` can trigger a personalized welcome response. The parameter `name` may be used by the agent in the response: `\"Hello #welcome_event.name! What can I do for you today?\"`."
},
"GoogleCloudDialogflowV2MessageAnnotation": {
"description": "Represents the result of annotation for the message.",
"properties": {
"containEntities": {
"description": "Indicates whether the text message contains entities.",
"type": "boolean"
},
"parts": {
"description": "The collection of annotated message parts ordered by their position in the message. You can recover the annotated message by concatenating [AnnotatedMessagePart.text].",
"items": {
"$ref": "GoogleCloudDialogflowV2AnnotatedMessagePart"
},
"type": "array"
}
},
"id": "GoogleCloudDialogflowV2MessageAnnotation",
"type": "object"
},
"GoogleCloudDialogflowV2OriginalDetectIntentRequest": {
"properties": {
"payload": {
"description": "Optional. This field is set to the value of the `QueryParameters.payload` field passed in the request. Some integrations that query a Dialogflow agent may provide additional information in the payload. In particular, for the Dialogflow Phone Gateway integration, this field has the form: { \"telephony\": { \"caller_id\": \"+18558363987\" } } Note: The caller ID field (`caller_id`) will be redacted for Trial Edition agents and populated with the caller ID in [E.164 format](https://en.wikipedia.org/wiki/E.164) for Essentials Edition agents.",
"additionalProperties": {
"type": "any",
"description": "Properties of the object."
},
"type": "object"
},
"version": {
"type": "string",
"description": "Optional. The version of the protocol used for this request. This field is AoG-specific."
},
"source": {
"type": "string",
"description": "The source of this request, e.g., `google`, `facebook`, `slack`. It is set by Dialogflow-owned servers."
}
},
"description": "Represents the contents of the original request that was passed to the `[Streaming]DetectIntent` call.",
"id": "GoogleCloudDialogflowV2OriginalDetectIntentRequest",
"type": "object"
},
"GoogleCloudDialogflowCxV3beta1ResponseMessageLiveAgentHandoff": {
"type": "object",
"description": "Indicates that the conversation should be handed off to a live agent. Dialogflow only uses this to determine which conversations were handed off to a human agent for measurement purposes. What else to do with this signal is up to you and your handoff procedures. You may set this, for example: * In the entry_fulfillment of a Page if entering the page indicates something went extremely wrong in the conversation. * In a webhook response when you determine that the customer issue can only be handled by a human.",
"id": "GoogleCloudDialogflowCxV3beta1ResponseMessageLiveAgentHandoff",
"properties": {
"metadata": {
"additionalProperties": {
"type": "any",
"description": "Properties of the object."
},
"type": "object",
"description": "Custom metadata for your handoff procedure. Dialogflow doesn't impose any structure on this."
}
}
},
"GoogleCloudDialogflowV2IntentMessageTableCardRow": {
"type": "object",
"id": "GoogleCloudDialogflowV2IntentMessageTableCardRow",
"description": "Row of TableCard.",
"properties": {
"dividerAfter": {
"type": "boolean",
"description": "Optional. Whether to add a visual divider after this row."
},
"cells": {
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2IntentMessageTableCardCell"
},
"description": "Optional. List of cells that make up this row."
}
}
},
"GoogleCloudDialogflowV2IntentMessageCarouselSelectItem": {
"description": "An item in the carousel.",
"id": "GoogleCloudDialogflowV2IntentMessageCarouselSelectItem",
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Required. Title of the carousel item."
},
"image": {
"$ref": "GoogleCloudDialogflowV2IntentMessageImage",
"description": "Optional. The image to display."
},
"description": {
"description": "Optional. The body text of the card.",
"type": "string"
},
"info": {
"$ref": "GoogleCloudDialogflowV2IntentMessageSelectItemInfo",
"description": "Required. Additional info about the option item."
}
}
},
"GoogleCloudDialogflowCxV3beta1PageInfo": {
"description": "Represents page information communicated to and from the webhook.",
"properties": {
"currentPage": {
"type": "string",
"description": "Always present for WebhookRequest. Ignored for WebhookResponse. The unique identifier of the current page. Format: `projects//locations//agents//flows//pages/`."
},
"formInfo": {
"description": "Optional for both WebhookRequest and WebhookResponse. Information about the form.",
"$ref": "GoogleCloudDialogflowCxV3beta1PageInfoFormInfo"
}
},
"id": "GoogleCloudDialogflowCxV3beta1PageInfo",
"type": "object"
},
"GoogleCloudDialogflowV2IntentMessageColumnProperties": {
"properties": {
"header": {
"type": "string",
"description": "Required. Column heading."
},
"horizontalAlignment": {
"description": "Optional. Defines text alignment for all cells in this column.",
"type": "string",
"enum": [
"HORIZONTAL_ALIGNMENT_UNSPECIFIED",
"LEADING",
"CENTER",
"TRAILING"
],
"enumDescriptions": [
"Text is aligned to the leading edge of the column.",
"Text is aligned to the leading edge of the column.",
"Text is centered in the column.",
"Text is aligned to the trailing edge of the column."
]
}
},
"id": "GoogleCloudDialogflowV2IntentMessageColumnProperties",
"description": "Column properties for TableCard.",
"type": "object"
},
"GoogleCloudDialogflowV2beta1WebhookRequest": {
"id": "GoogleCloudDialogflowV2beta1WebhookRequest",
"properties": {
"queryResult": {
"description": "The result of the conversational query or event processing. Contains the same value as `[Streaming]DetectIntentResponse.query_result`.",
"$ref": "GoogleCloudDialogflowV2beta1QueryResult"
},
"session": {
"type": "string",
"description": "The unique identifier of detectIntent request session. Can be used to identify end-user inside webhook implementation. Supported formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/environments//users//sessions/`, - `projects//locations//agent/environments//users//sessions/`,"
},
"originalDetectIntentRequest": {
"description": "Optional. The contents of the original request that was passed to `[Streaming]DetectIntent` call.",
"$ref": "GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest"
},
"responseId": {
"description": "The unique identifier of the response. Contains the same value as `[Streaming]DetectIntentResponse.response_id`.",
"type": "string"
},
"alternativeQueryResults": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1QueryResult"
},
"description": "Alternative query results from KnowledgeService.",
"type": "array"
}
},
"description": "The request message for a webhook call.",
"type": "object"
},
"GoogleCloudDialogflowV2beta1EntityType": {
"description": "Each intent parameter has a type, called the entity type, which dictates exactly how data from an end-user expression is extracted. Dialogflow provides predefined system entities that can match many common types of data. For example, there are system entities for matching dates, times, colors, email addresses, and so on. You can also create your own custom entities for matching custom data. For example, you could define a vegetable entity that can match the types of vegetables available for purchase with a grocery store agent. For more information, see the [Entity guide](https://cloud.google.com/dialogflow/docs/entities-overview).",
"type": "object",
"properties": {
"kind": {
"enum": [
"KIND_UNSPECIFIED",
"KIND_MAP",
"KIND_LIST",
"KIND_REGEXP"
],
"enumDescriptions": [
"Not specified. This value should be never used.",
"Map entity types allow mapping of a group of synonyms to a reference value.",
"List entity types contain a set of entries that do not map to reference values. However, list entity types can contain references to other entity types (with or without aliases).",
"Regexp entity types allow to specify regular expressions in entries values."
],
"type": "string",
"description": "Required. Indicates the kind of entity type."
},
"autoExpansionMode": {
"enumDescriptions": [
"Auto expansion disabled for the entity.",
"Allows an agent to recognize values that have not been explicitly listed in the entity."
],
"description": "Optional. Indicates whether the entity type can be automatically expanded.",
"type": "string",
"enum": [
"AUTO_EXPANSION_MODE_UNSPECIFIED",
"AUTO_EXPANSION_MODE_DEFAULT"
]
},
"name": {
"type": "string",
"description": "The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Supported formats: - `projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`"
},
"displayName": {
"type": "string",
"description": "Required. The name of the entity type."
},
"entities": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1EntityTypeEntity"
},
"description": "Optional. The collection of entity entries associated with the entity type.",
"type": "array"
},
"enableFuzzyExtraction": {
"type": "boolean",
"description": "Optional. Enables fuzzy entity extraction during classification."
}
},
"id": "GoogleCloudDialogflowV2beta1EntityType"
},
"GoogleCloudDialogflowV2beta1IntentParameter": {
"type": "object",
"description": "Represents intent parameters.",
"id": "GoogleCloudDialogflowV2beta1IntentParameter",
"properties": {
"value": {
"description": "Optional. The definition of the parameter value. It can be: - a constant string, - a parameter value defined as `$parameter_name`, - an original parameter value defined as `$parameter_name.original`, - a parameter value from some context defined as `#context_name.parameter_name`.",
"type": "string"
},
"prompts": {
"description": "Optional. The collection of prompts that the agent can present to the user in order to collect a value for the parameter.",
"items": {
"type": "string"
},
"type": "array"
},
"name": {
"description": "The unique identifier of this parameter.",
"type": "string"
},
"defaultValue": {
"type": "string",
"description": "Optional. The default value to use when the `value` yields an empty result. Default values can be extracted from contexts by using the following syntax: `#context_name.parameter_name`."
},
"entityTypeDisplayName": {
"description": "Optional. The name of the entity type, prefixed with `@`, that describes values of the parameter. If the parameter is required, this must be provided.",
"type": "string"
},
"displayName": {
"description": "Required. The name of the parameter.",
"type": "string"
},
"isList": {
"description": "Optional. Indicates whether the parameter represents a list of values.",
"type": "boolean"
},
"mandatory": {
"description": "Optional. Indicates whether the parameter is required. That is, whether the intent cannot be completed without collecting the parameter value.",
"type": "boolean"
}
}
},
"GoogleCloudDialogflowV2beta1IntentMessageMediaContent": {
"description": "The media content card for Actions on Google.",
"type": "object",
"id": "GoogleCloudDialogflowV2beta1IntentMessageMediaContent",
"properties": {
"mediaType": {
"description": "Optional. What type of media is the content (ie \"audio\").",
"enumDescriptions": [
"Unspecified.",
"Response media type is audio."
],
"type": "string",
"enum": [
"RESPONSE_MEDIA_TYPE_UNSPECIFIED",
"AUDIO"
]
},
"mediaObjects": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageMediaContentResponseMediaObject"
},
"description": "Required. List of media objects.",
"type": "array"
}
}
},
"GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest": {
"properties": {
"version": {
"description": "Optional. The version of the protocol used for this request. This field is AoG-specific.",
"type": "string"
},
"payload": {
"type": "object",
"description": "Optional. This field is set to the value of the `QueryParameters.payload` field passed in the request. Some integrations that query a Dialogflow agent may provide additional information in the payload. In particular, for the Dialogflow Phone Gateway integration, this field has the form: { \"telephony\": { \"caller_id\": \"+18558363987\" } } Note: The caller ID field (`caller_id`) will be redacted for Trial Edition agents and populated with the caller ID in [E.164 format](https://en.wikipedia.org/wiki/E.164) for Essentials Edition agents.",
"additionalProperties": {
"type": "any",
"description": "Properties of the object."
}
},
"source": {
"type": "string",
"description": "The source of this request, e.g., `google`, `facebook`, `slack`. It is set by Dialogflow-owned servers."
}
},
"description": "Represents the contents of the original request that was passed to the `[Streaming]DetectIntent` call.",
"type": "object",
"id": "GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest"
},
"GoogleCloudDialogflowV2beta1BatchUpdateIntentsResponse": {
"id": "GoogleCloudDialogflowV2beta1BatchUpdateIntentsResponse",
"type": "object",
"description": "The response message for Intents.BatchUpdateIntents.",
"properties": {
"intents": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1Intent"
},
"description": "The collection of updated or created intents.",
"type": "array"
}
}
},
"GoogleCloudDialogflowCxV3beta1CreateVersionOperationMetadata": {
"description": "Metadata associated with the long running operation for Versions.CreateVersion.",
"properties": {
"version": {
"type": "string",
"description": "Name of the created version. Format: `projects//locations//agents//flows//versions/`."
}
},
"type": "object",
"id": "GoogleCloudDialogflowCxV3beta1CreateVersionOperationMetadata"
},
"GoogleCloudDialogflowV2beta1IntentMessageListSelectItem": {
"description": "An item in the list.",
"id": "GoogleCloudDialogflowV2beta1IntentMessageListSelectItem",
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Required. The title of the list item."
},
"image": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageImage",
"description": "Optional. The image to display."
},
"description": {
"type": "string",
"description": "Optional. The main text describing the item."
},
"info": {
"description": "Required. Additional information about this option.",
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageSelectItemInfo"
}
}
},
"GoogleCloudDialogflowV2beta1IntentMessageCard": {
"description": "The card response message.",
"properties": {
"imageUri": {
"type": "string",
"description": "Optional. The public URI to an image file for the card."
},
"title": {
"description": "Optional. The title of the card.",
"type": "string"
},
"buttons": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageCardButton"
},
"description": "Optional. The collection of card buttons.",
"type": "array"
},
"subtitle": {
"description": "Optional. The subtitle of the card.",
"type": "string"
}
},
"type": "object",
"id": "GoogleCloudDialogflowV2beta1IntentMessageCard"
},
"GoogleCloudDialogflowV2beta1SpeechContext": {
"type": "object",
"properties": {
"phrases": {
"description": "Optional. A list of strings containing words and phrases that the speech recognizer should recognize with higher likelihood. This list can be used to: * improve accuracy for words and phrases you expect the user to say, e.g. typical commands for your Dialogflow agent * add additional words to the speech recognizer vocabulary * ... See the [Cloud Speech documentation](https://cloud.google.com/speech-to-text/quotas) for usage limits.",
"items": {
"type": "string"
},
"type": "array"
},
"boost": {
"format": "float",
"type": "number",
"description": "Optional. Boost for this context compared to other contexts: * If the boost is positive, Dialogflow will increase the probability that the phrases in this context are recognized over similar sounding phrases. * If the boost is unspecified or non-positive, Dialogflow will not apply any boost. Dialogflow recommends that you use boosts in the range (0, 20] and that you find a value that fits your use case with binary search."
}
},
"description": "Hints for the speech recognizer to help with recognition in a specific conversation state.",
"id": "GoogleCloudDialogflowV2beta1SpeechContext"
},
"GoogleCloudDialogflowCxV3beta1ResponseMessageConversationSuccess": {
"description": "Indicates that the conversation succeeded, i.e., the bot handled the issue that the customer talked to it about. Dialogflow only uses this to determine which conversations should be counted as successful and doesn't process the metadata in this message in any way. Note that Dialogflow also considers conversations that get to the conversation end page as successful even if they don't return ConversationSuccess. You may set this, for example: * In the entry_fulfillment of a Page if entering the page indicates that the conversation succeeded. * In a webhook response when you determine that you handled the customer issue.",
"id": "GoogleCloudDialogflowCxV3beta1ResponseMessageConversationSuccess",
"type": "object",
"properties": {
"metadata": {
"type": "object",
"additionalProperties": {
"description": "Properties of the object.",
"type": "any"
},
"description": "Custom metadata. Dialogflow doesn't impose any structure on this."
}
}
},
"GoogleCloudDialogflowV2beta1BatchCreateEntitiesRequest": {
"properties": {
"languageCode": {
"type": "string",
"description": "Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see [Multilingual intent and entity data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity)."
},
"entities": {
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1EntityTypeEntity"
},
"description": "Required. The entities to create."
}
},
"id": "GoogleCloudDialogflowV2beta1BatchCreateEntitiesRequest",
"type": "object",
"description": "The request message for EntityTypes.BatchCreateEntities."
},
"GoogleCloudDialogflowV2IntentMessage": {
"description": "A rich response message. Corresponds to the intent `Response` field in the Dialogflow console. For more information, see [Rich response messages](https://cloud.google.com/dialogflow/docs/intents-rich-messages).",
"type": "object",
"properties": {
"quickReplies": {
"$ref": "GoogleCloudDialogflowV2IntentMessageQuickReplies",
"description": "The quick replies response."
},
"mediaContent": {
"description": "The media content card for Actions on Google.",
"$ref": "GoogleCloudDialogflowV2IntentMessageMediaContent"
},
"basicCard": {
"description": "The basic card response for Actions on Google.",
"$ref": "GoogleCloudDialogflowV2IntentMessageBasicCard"
},
"image": {
"$ref": "GoogleCloudDialogflowV2IntentMessageImage",
"description": "The image response."
},
"tableCard": {
"description": "Table card for Actions on Google.",
"$ref": "GoogleCloudDialogflowV2IntentMessageTableCard"
},
"carouselSelect": {
"description": "The carousel card response for Actions on Google.",
"$ref": "GoogleCloudDialogflowV2IntentMessageCarouselSelect"
},
"browseCarouselCard": {
"$ref": "GoogleCloudDialogflowV2IntentMessageBrowseCarouselCard",
"description": "Browse carousel card for Actions on Google."
},
"text": {
"description": "The text response.",
"$ref": "GoogleCloudDialogflowV2IntentMessageText"
},
"suggestions": {
"description": "The suggestion chips for Actions on Google.",
"$ref": "GoogleCloudDialogflowV2IntentMessageSuggestions"
},
"platform": {
"description": "Optional. The platform that this message is intended for.",
"type": "string",
"enum": [
"PLATFORM_UNSPECIFIED",
"FACEBOOK",
"SLACK",
"TELEGRAM",
"KIK",
"SKYPE",
"LINE",
"VIBER",
"ACTIONS_ON_GOOGLE",
"GOOGLE_HANGOUTS"
],
"enumDescriptions": [
"Default platform.",
"Facebook.",
"Slack.",
"Telegram.",
"Kik.",
"Skype.",
"Line.",
"Viber.",
"Google Assistant See [Dialogflow webhook format](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)",
"Google Hangouts."
]
},
"simpleResponses": {
"$ref": "GoogleCloudDialogflowV2IntentMessageSimpleResponses",
"description": "The voice and text-only responses for Actions on Google."
},
"linkOutSuggestion": {
"description": "The link out suggestion chip for Actions on Google.",
"$ref": "GoogleCloudDialogflowV2IntentMessageLinkOutSuggestion"
},
"listSelect": {
"description": "The list card response for Actions on Google.",
"$ref": "GoogleCloudDialogflowV2IntentMessageListSelect"
},
"card": {
"description": "The card response.",
"$ref": "GoogleCloudDialogflowV2IntentMessageCard"
},
"payload": {
"additionalProperties": {
"description": "Properties of the object.",
"type": "any"
},
"type": "object",
"description": "A custom platform-specific response."
}
},
"id": "GoogleCloudDialogflowV2IntentMessage"
},
"GoogleCloudDialogflowV2beta1IntentMessageSimpleResponses": {
"type": "object",
"properties": {
"simpleResponses": {
"type": "array",
"description": "Required. The list of simple responses.",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageSimpleResponse"
}
}
},
"description": "The collection of simple response candidates. This message in `QueryResult.fulfillment_messages` and `WebhookResponse.fulfillment_messages` should contain only one `SimpleResponse`.",
"id": "GoogleCloudDialogflowV2beta1IntentMessageSimpleResponses"
},
"GoogleCloudDialogflowV2WebhookRequest": {
"type": "object",
"id": "GoogleCloudDialogflowV2WebhookRequest",
"properties": {
"responseId": {
"description": "The unique identifier of the response. Contains the same value as `[Streaming]DetectIntentResponse.response_id`.",
"type": "string"
},
"session": {
"description": "The unique identifier of detectIntent request session. Can be used to identify end-user inside webhook implementation. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`.",
"type": "string"
},
"originalDetectIntentRequest": {
"$ref": "GoogleCloudDialogflowV2OriginalDetectIntentRequest",
"description": "Optional. The contents of the original request that was passed to `[Streaming]DetectIntent` call."
},
"queryResult": {
"$ref": "GoogleCloudDialogflowV2QueryResult",
"description": "The result of the conversational query or event processing. Contains the same value as `[Streaming]DetectIntentResponse.query_result`."
}
},
"description": "The request message for a webhook call."
},
"GoogleCloudDialogflowV2beta1IntentMessageLinkOutSuggestion": {
"properties": {
"uri": {
"description": "Required. The URI of the app or site to open when the user taps the suggestion chip.",
"type": "string"
},
"destinationName": {
"type": "string",
"description": "Required. The name of the app or site this chip is linking to."
}
},
"description": "The suggestion chip message that allows the user to jump out to the app or website associated with this agent.",
"id": "GoogleCloudDialogflowV2beta1IntentMessageLinkOutSuggestion",
"type": "object"
},
"GoogleCloudDialogflowV2beta1FulfillmentFeature": {
"properties": {
"type": {
"enumDescriptions": [
"Feature type not specified.",
"Fulfillment is enabled for SmallTalk."
],
"description": "The type of the feature that enabled for fulfillment.",
"type": "string",
"enum": [
"TYPE_UNSPECIFIED",
"SMALLTALK"
]
}
},
"id": "GoogleCloudDialogflowV2beta1FulfillmentFeature",
"description": "Whether fulfillment is enabled for the specific feature.",
"type": "object"
},
"GoogleCloudDialogflowV2IntentMessageBasicCardButtonOpenUriAction": {
"properties": {
"uri": {
"type": "string",
"description": "Required. The HTTP or HTTPS scheme URI."
}
},
"type": "object",
"description": "Opens the given URI.",
"id": "GoogleCloudDialogflowV2IntentMessageBasicCardButtonOpenUriAction"
},
"GoogleCloudDialogflowV2beta1IntentMessage": {
"id": "GoogleCloudDialogflowV2beta1IntentMessage",
"type": "object",
"description": "Corresponds to the `Response` field in the Dialogflow console.",
"properties": {
"tableCard": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageTableCard",
"description": "Table card for Actions on Google."
},
"text": {
"description": "Returns a text response.",
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageText"
},
"telephonySynthesizeSpeech": {
"description": "Synthesizes speech in Telephony Gateway.",
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech"
},
"carouselSelect": {
"description": "Displays a carousel card for Actions on Google.",
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageCarouselSelect"
},
"simpleResponses": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageSimpleResponses",
"description": "Returns a voice or text-only response for Actions on Google."
},
"telephonyTransferCall": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageTelephonyTransferCall",
"description": "Transfers the call in Telephony Gateway."
},
"basicCard": {
"description": "Displays a basic card for Actions on Google.",
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageBasicCard"
},
"quickReplies": {
"description": "Displays quick replies.",
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageQuickReplies"
},
"telephonyPlayAudio": {
"description": "Plays audio from a file in Telephony Gateway.",
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageTelephonyPlayAudio"
},
"rbmText": {
"description": "Rich Business Messaging (RBM) text response. RBM allows businesses to send enriched and branded versions of SMS. See https://jibe.google.com/business-messaging.",
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageRbmText"
},
"browseCarouselCard": {
"description": "Browse carousel card for Actions on Google.",
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCard"
},
"suggestions": {
"description": "Displays suggestion chips for Actions on Google.",
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageSuggestions"
},
"image": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageImage",
"description": "Displays an image."
},
"rbmCarouselRichCard": {
"description": "Rich Business Messaging (RBM) carousel rich card response.",
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageRbmCarouselCard"
},
"linkOutSuggestion": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageLinkOutSuggestion",
"description": "Displays a link out suggestion chip for Actions on Google."
},
"payload": {
"description": "A custom platform-specific response.",
"additionalProperties": {
"description": "Properties of the object.",
"type": "any"
},
"type": "object"
},
"listSelect": {
"description": "Displays a list card for Actions on Google.",
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageListSelect"
},
"card": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageCard",
"description": "Displays a card."
},
"rbmStandaloneRichCard": {
"description": "Standalone Rich Business Messaging (RBM) rich card response.",
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageRbmStandaloneCard"
},
"mediaContent": {
"description": "The media content card for Actions on Google.",
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageMediaContent"
},
"platform": {
"description": "Optional. The platform that this message is intended for.",
"type": "string",
"enum": [
"PLATFORM_UNSPECIFIED",
"FACEBOOK",
"SLACK",
"TELEGRAM",
"KIK",
"SKYPE",
"LINE",
"VIBER",
"ACTIONS_ON_GOOGLE",
"TELEPHONY",
"GOOGLE_HANGOUTS"
],
"enumDescriptions": [
"Not specified.",
"Facebook.",
"Slack.",
"Telegram.",
"Kik.",
"Skype.",
"Line.",
"Viber.",
"Google Assistant See [Dialogflow webhook format](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)",
"Telephony Gateway.",
"Google Hangouts."
]
}
}
},
"GoogleCloudDialogflowV2WebhookResponse": {
"type": "object",
"properties": {
"fulfillmentMessages": {
"description": "Optional. The rich response messages intended for the end-user. When provided, Dialogflow uses this field to populate QueryResult.fulfillment_messages sent to the integration or API caller.",
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2IntentMessage"
}
},
"fulfillmentText": {
"type": "string",
"description": "Optional. The text response message intended for the end-user. It is recommended to use `fulfillment_messages.text.text[0]` instead. When provided, Dialogflow uses this field to populate QueryResult.fulfillment_text sent to the integration or API caller."
},
"sessionEntityTypes": {
"items": {
"$ref": "GoogleCloudDialogflowV2SessionEntityType"
},
"type": "array",
"description": "Optional. Additional session entity types to replace or extend developer entity types with. The entity synonyms apply to all languages and persist for the session. Setting this data from a webhook overwrites the session entity types that have been set using `detectIntent`, `streamingDetectIntent` or SessionEntityType management methods."
},
"outputContexts": {
"description": "Optional. The collection of output contexts that will overwrite currently active contexts for the session and reset their lifespans. When provided, Dialogflow uses this field to populate QueryResult.output_contexts sent to the integration or API caller.",
"items": {
"$ref": "GoogleCloudDialogflowV2Context"
},
"type": "array"
},
"source": {
"description": "Optional. A custom field used to identify the webhook source. Arbitrary strings are supported. When provided, Dialogflow uses this field to populate QueryResult.webhook_source sent to the integration or API caller.",
"type": "string"
},
"followupEventInput": {
"$ref": "GoogleCloudDialogflowV2EventInput",
"description": "Optional. Invokes the supplied events. When this field is set, Dialogflow ignores the `fulfillment_text`, `fulfillment_messages`, and `payload` fields."
},
"payload": {
"additionalProperties": {
"type": "any",
"description": "Properties of the object."
},
"description": "Optional. This field can be used to pass custom data from your webhook to the integration or API caller. Arbitrary JSON objects are supported. When provided, Dialogflow uses this field to populate QueryResult.webhook_payload sent to the integration or API caller. This field is also used by the [Google Assistant integration](https://cloud.google.com/dialogflow/docs/integrations/aog) for rich response messages. See the format definition at [Google Assistant Dialogflow webhook format](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)",
"type": "object"
}
},
"description": "The response message for a webhook call. This response is validated by the Dialogflow server. If validation fails, an error will be returned in the QueryResult.diagnostic_info field. Setting JSON fields to an empty value with the wrong type is a common error. To avoid this error: - Use `\"\"` for empty strings - Use `{}` or `null` for empty objects - Use `[]` or `null` for empty arrays For more information, see the [Protocol Buffers Language Guide](https://developers.google.com/protocol-buffers/docs/proto3#json).",
"id": "GoogleCloudDialogflowV2WebhookResponse"
},
"GoogleCloudDialogflowV2EntityType": {
"properties": {
"kind": {
"enum": [
"KIND_UNSPECIFIED",
"KIND_MAP",
"KIND_LIST",
"KIND_REGEXP"
],
"description": "Required. Indicates the kind of entity type.",
"enumDescriptions": [
"Not specified. This value should be never used.",
"Map entity types allow mapping of a group of synonyms to a reference value.",
"List entity types contain a set of entries that do not map to reference values. However, list entity types can contain references to other entity types (with or without aliases).",
"Regexp entity types allow to specify regular expressions in entries values."
],
"type": "string"
},
"displayName": {
"type": "string",
"description": "Required. The name of the entity type."
},
"name": {
"description": "The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`.",
"type": "string"
},
"entities": {
"type": "array",
"description": "Optional. The collection of entity entries associated with the entity type.",
"items": {
"$ref": "GoogleCloudDialogflowV2EntityTypeEntity"
}
},
"enableFuzzyExtraction": {
"type": "boolean",
"description": "Optional. Enables fuzzy entity extraction during classification."
},
"autoExpansionMode": {
"enumDescriptions": [
"Auto expansion disabled for the entity.",
"Allows an agent to recognize values that have not been explicitly listed in the entity."
],
"enum": [
"AUTO_EXPANSION_MODE_UNSPECIFIED",
"AUTO_EXPANSION_MODE_DEFAULT"
],
"description": "Optional. Indicates whether the entity type can be automatically expanded.",
"type": "string"
}
},
"type": "object",
"id": "GoogleCloudDialogflowV2EntityType",
"description": "Each intent parameter has a type, called the entity type, which dictates exactly how data from an end-user expression is extracted. Dialogflow provides predefined system entities that can match many common types of data. For example, there are system entities for matching dates, times, colors, email addresses, and so on. You can also create your own custom entities for matching custom data. For example, you could define a vegetable entity that can match the types of vegetables available for purchase with a grocery store agent. For more information, see the [Entity guide](https://cloud.google.com/dialogflow/docs/entities-overview)."
},
"GoogleCloudDialogflowV2beta1IntentMessageText": {
"type": "object",
"properties": {
"text": {
"description": "Optional. The collection of the agent's responses.",
"items": {
"type": "string"
},
"type": "array"
}
},
"id": "GoogleCloudDialogflowV2beta1IntentMessageText",
"description": "The text response message."
},
"GoogleCloudDialogflowV2beta1IntentMessageRbmText": {
"id": "GoogleCloudDialogflowV2beta1IntentMessageRbmText",
"properties": {
"text": {
"description": "Required. Text sent and displayed to the user.",
"type": "string"
},
"rbmSuggestion": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestion"
},
"type": "array",
"description": "Optional. One or more suggestions to show to the user."
}
},
"type": "object",
"description": "Rich Business Messaging (RBM) text response with suggestions."
},
"GoogleCloudDialogflowV2beta1OutputAudioConfig": {
"type": "object",
"description": "Instructs the speech synthesizer how to generate the output audio content. If this audio config is supplied in a request, it overrides all existing text-to-speech settings applied to the agent.",
"id": "GoogleCloudDialogflowV2beta1OutputAudioConfig",
"properties": {
"sampleRateHertz": {
"format": "int32",
"type": "integer",
"description": "The synthesis sample rate (in hertz) for this audio. If not provided, then the synthesizer will use the default sample rate based on the audio encoding. If this is different from the voice's natural sample rate, then the synthesizer will honor this request by converting to the desired sample rate (which might result in worse audio quality)."
},
"audioEncoding": {
"enumDescriptions": [
"Not specified.",
"Uncompressed 16-bit signed little-endian samples (Linear PCM). Audio content returned as LINEAR16 also contains a WAV header.",
"MP3 audio at 32kbps.",
"Opus encoded audio wrapped in an ogg container. The result will be a file which can be played natively on Android, and in browsers (at least Chrome and Firefox). The quality of the encoding is considerably higher than MP3 while using approximately the same bitrate."
],
"type": "string",
"enum": [
"OUTPUT_AUDIO_ENCODING_UNSPECIFIED",
"OUTPUT_AUDIO_ENCODING_LINEAR_16",
"OUTPUT_AUDIO_ENCODING_MP3",
"OUTPUT_AUDIO_ENCODING_OGG_OPUS"
],
"description": "Required. Audio encoding of the synthesized audio content."
},
"synthesizeSpeechConfig": {
"description": "Configuration of how speech should be synthesized.",
"$ref": "GoogleCloudDialogflowV2beta1SynthesizeSpeechConfig"
}
}
},
"GoogleCloudDialogflowV2beta1IntentTrainingPhrase": {
"description": "Represents an example that the agent is trained on.",
"type": "object",
"id": "GoogleCloudDialogflowV2beta1IntentTrainingPhrase",
"properties": {
"name": {
"type": "string",
"description": "Output only. The unique identifier of this training phrase."
},
"parts": {
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1IntentTrainingPhrasePart"
},
"description": "Required. The ordered list of training phrase parts. The parts are concatenated in order to form the training phrase. Note: The API does not automatically annotate training phrases like the Dialogflow Console does. Note: Do not forget to include whitespace at part boundaries, so the training phrase is well formatted when the parts are concatenated. If the training phrase does not need to be annotated with parameters, you just need a single part with only the Part.text field set. If you want to annotate the training phrase, you must create multiple parts, where the fields of each part are populated in one of two ways: - `Part.text` is set to a part of the phrase that has no parameters. - `Part.text` is set to a part of the phrase that you want to annotate, and the `entity_type`, `alias`, and `user_defined` fields are all set."
},
"timesAddedCount": {
"description": "Optional. Indicates how many times this example was added to the intent. Each time a developer adds an existing sample by editing an intent or training, this counter is increased.",
"format": "int32",
"type": "integer"
},
"type": {
"enumDescriptions": [
"Not specified. This value should never be used.",
"Examples do not contain @-prefixed entity type names, but example parts can be annotated with entity types.",
"Templates are not annotated with entity types, but they can contain @-prefixed entity type names as substrings. Template mode has been deprecated. Example mode is the only supported way to create new training phrases. If you have existing training phrases that you've created in template mode, those will continue to work."
],
"type": "string",
"description": "Required. The type of the training phrase.",
"enum": [
"TYPE_UNSPECIFIED",
"EXAMPLE",
"TEMPLATE"
]
}
}
},
"GoogleCloudDialogflowV2beta1IntentMessageSuggestions": {
"id": "GoogleCloudDialogflowV2beta1IntentMessageSuggestions",
"type": "object",
"description": "The collection of suggestions.",
"properties": {
"suggestions": {
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageSuggestion"
},
"description": "Required. The list of suggested replies."
}
}
},
"GoogleCloudDialogflowV2IntentFollowupIntentInfo": {
"type": "object",
"id": "GoogleCloudDialogflowV2IntentFollowupIntentInfo",
"description": "Represents a single followup intent in the chain.",
"properties": {
"parentFollowupIntentName": {
"type": "string",
"description": "The unique identifier of the followup intent's parent. Format: `projects//agent/intents/`."
},
"followupIntentName": {
"description": "The unique identifier of the followup intent. Format: `projects//agent/intents/`.",
"type": "string"
}
}
},
"GoogleCloudDialogflowV2Message": {
"description": "Represents a message posted into a conversation.",
"id": "GoogleCloudDialogflowV2Message",
"type": "object",
"properties": {
"participant": {
"description": "Output only. The participant that sends this message.",
"type": "string",
"readOnly": true
},
"content": {
"description": "Required. The message content.",
"type": "string"
},
"messageAnnotation": {
"$ref": "GoogleCloudDialogflowV2MessageAnnotation",
"description": "Output only. The annotation for the message.",
"readOnly": true
},
"participantRole": {
"enum": [
"ROLE_UNSPECIFIED",
"HUMAN_AGENT",
"AUTOMATED_AGENT",
"END_USER"
],
"readOnly": true,
"description": "Output only. The role of the participant.",
"enumDescriptions": [
"Participant role not set.",
"Participant is a human agent.",
"Participant is an automated agent, such as a Dialogflow agent.",
"Participant is an end user that has called or chatted with Dialogflow services."
],
"type": "string"
},
"languageCode": {
"type": "string",
"description": "Optional. The message language. This should be a [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. Example: \"en-US\"."
},
"name": {
"description": "The unique identifier of the message. Format: `projects//conversations//messages/`.",
"type": "string"
},
"createTime": {
"format": "google-datetime",
"readOnly": true,
"type": "string",
"description": "Output only. The time when the message was created."
}
}
},
"GoogleCloudDialogflowV2IntentMessageSuggestions": {
"properties": {
"suggestions": {
"description": "Required. The list of suggested replies.",
"items": {
"$ref": "GoogleCloudDialogflowV2IntentMessageSuggestion"
},
"type": "array"
}
},
"id": "GoogleCloudDialogflowV2IntentMessageSuggestions",
"type": "object",
"description": "The collection of suggestions."
},
"GoogleCloudDialogflowCxV3ResponseMessageMixedAudioSegment": {
"description": "Represents one segment of audio.",
"type": "object",
"properties": {
"allowPlaybackInterruption": {
"type": "boolean",
"readOnly": true,
"description": "Output only. Whether the playback of this segment can be interrupted by the end user's speech and the client should then start the next Dialogflow request."
},
"uri": {
"type": "string",
"description": "Client-specific URI that points to an audio clip accessible to the client. Dialogflow does not impose any validation on it."
},
"audio": {
"type": "string",
"format": "byte",
"description": "Raw audio synthesized from the Dialogflow agent's response using the output config specified in the request."
}
},
"id": "GoogleCloudDialogflowCxV3ResponseMessageMixedAudioSegment"
},
"GoogleCloudDialogflowCxV3beta1ResponseMessagePlayAudio": {
"description": "Specifies an audio clip to be played by the client as part of the response.",
"properties": {
"audioUri": {
"description": "Required. URI of the audio clip. Dialogflow does not impose any validation on this value. It is specific to the client that reads it.",
"type": "string"
},
"allowPlaybackInterruption": {
"type": "boolean",
"readOnly": true,
"description": "Output only. Whether the playback of this message can be interrupted by the end user's speech and the client can then starts the next Dialogflow request."
}
},
"id": "GoogleCloudDialogflowCxV3beta1ResponseMessagePlayAudio",
"type": "object"
},
"GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCardBrowseCarouselCardItem": {
"properties": {
"description": {
"description": "Optional. Description of the carousel item. Maximum of four lines of text.",
"type": "string"
},
"footer": {
"description": "Optional. Text that appears at the bottom of the Browse Carousel Card. Maximum of one line of text.",
"type": "string"
},
"image": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageImage",
"description": "Optional. Hero image for the carousel item."
},
"title": {
"type": "string",
"description": "Required. Title of the carousel item. Maximum of two lines of text."
},
"openUriAction": {
"description": "Required. Action to present to the user.",
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCardBrowseCarouselCardItemOpenUrlAction"
}
},
"description": "Browsing carousel tile",
"type": "object",
"id": "GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCardBrowseCarouselCardItem"
},
"GoogleCloudDialogflowV2beta1ListContextsResponse": {
"id": "GoogleCloudDialogflowV2beta1ListContextsResponse",
"properties": {
"contexts": {
"description": "The list of contexts. There will be a maximum number of items returned based on the page_size field in the request.",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"type": "array"
},
"nextPageToken": {
"type": "string",
"description": "Token to retrieve the next page of results, or empty if there are no more results in the list."
}
},
"type": "object",
"description": "The response message for Contexts.ListContexts."
},
"GoogleCloudDialogflowV2IntentMessageLinkOutSuggestion": {
"type": "object",
"description": "The suggestion chip message that allows the user to jump out to the app or website associated with this agent.",
"properties": {
"uri": {
"description": "Required. The URI of the app or site to open when the user taps the suggestion chip.",
"type": "string"
},
"destinationName": {
"type": "string",
"description": "Required. The name of the app or site this chip is linking to."
}
},
"id": "GoogleCloudDialogflowV2IntentMessageLinkOutSuggestion"
},
"GoogleCloudDialogflowV2beta1QueryResult": {
"properties": {
"fulfillmentText": {
"description": "The text to be pronounced to the user or shown on the screen. Note: This is a legacy field, `fulfillment_messages` should be preferred.",
"type": "string"
},
"sentimentAnalysisResult": {
"$ref": "GoogleCloudDialogflowV2beta1SentimentAnalysisResult",
"description": "The sentiment analysis result, which depends on the `sentiment_analysis_request_config` specified in the request."
},
"intentDetectionConfidence": {
"description": "The intent detection confidence. Values range from 0.0 (completely uncertain) to 1.0 (completely certain). This value is for informational purpose only and is only used to help match the best intent within the classification threshold. This value may change for the same end-user expression at any time due to a model retraining or change in implementation. If there are `multiple knowledge_answers` messages, this value is set to the greatest `knowledgeAnswers.match_confidence` value in the list.",
"format": "float",
"type": "number"
},
"knowledgeAnswers": {
"$ref": "GoogleCloudDialogflowV2beta1KnowledgeAnswers",
"description": "The result from Knowledge Connector (if any), ordered by decreasing `KnowledgeAnswers.match_confidence`."
},
"queryText": {
"type": "string",
"description": "The original conversational query text: - If natural language text was provided as input, `query_text` contains a copy of the input. - If natural language speech audio was provided as input, `query_text` contains the speech recognition result. If speech recognizer produced multiple alternatives, a particular one is picked. - If automatic spell correction is enabled, `query_text` will contain the corrected user input."
},
"allRequiredParamsPresent": {
"description": "This field is set to: - `false` if the matched intent has required parameters and not all of the required parameter values have been collected. - `true` if all required parameter values have been collected, or if the matched intent doesn't contain any required parameters.",
"type": "boolean"
},
"webhookSource": {
"type": "string",
"description": "If the query was fulfilled by a webhook call, this field is set to the value of the `source` field returned in the webhook response."
},
"parameters": {
"type": "object",
"additionalProperties": {
"type": "any",
"description": "Properties of the object."
},
"description": "The collection of extracted parameters. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: string or number, depending on parameter value type - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value"
},
"diagnosticInfo": {
"type": "object",
"description": "Free-form diagnostic information for the associated detect intent request. The fields of this data can change without notice, so you should not write code that depends on its structure. The data may contain: - webhook call latency - webhook errors",
"additionalProperties": {
"description": "Properties of the object.",
"type": "any"
}
},
"webhookPayload": {
"additionalProperties": {
"description": "Properties of the object.",
"type": "any"
},
"type": "object",
"description": "If the query was fulfilled by a webhook call, this field is set to the value of the `payload` field returned in the webhook response."
},
"outputContexts": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"type": "array",
"description": "The collection of output contexts. If applicable, `output_contexts.parameters` contains entries with name `.original` containing the original parameter values before the query."
},
"fulfillmentMessages": {
"description": "The collection of rich messages to present to the user.",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessage"
},
"type": "array"
},
"intent": {
"$ref": "GoogleCloudDialogflowV2beta1Intent",
"description": "The intent that matched the conversational query. Some, not all fields are filled in this message, including but not limited to: `name`, `display_name`, `end_interaction` and `is_fallback`."
},
"speechRecognitionConfidence": {
"format": "float",
"type": "number",
"description": "The Speech recognition confidence between 0.0 and 1.0. A higher number indicates an estimated greater likelihood that the recognized words are correct. The default of 0.0 is a sentinel value indicating that confidence was not set. This field is not guaranteed to be accurate or set. In particular this field isn't set for StreamingDetectIntent since the streaming endpoint has separate confidence estimates per portion of the audio in StreamingRecognitionResult."
},
"action": {
"description": "The action name from the matched intent.",
"type": "string"
},
"languageCode": {
"type": "string",
"description": "The language that was triggered during intent detection. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes."
}
},
"id": "GoogleCloudDialogflowV2beta1QueryResult",
"type": "object",
"description": "Represents the result of conversational query or event processing."
},
"GoogleCloudDialogflowV2beta1Document": {
"description": "A knowledge document to be used by a KnowledgeBase. For more information, see the [knowledge base guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases). Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`.",
"id": "GoogleCloudDialogflowV2beta1Document",
"type": "object",
"properties": {
"mimeType": {
"description": "Required. The MIME type of this document.",
"type": "string"
},
"latestReloadStatus": {
"$ref": "GoogleCloudDialogflowV2beta1DocumentReloadStatus",
"readOnly": true,
"description": "Output only. The time and status of the latest reload. This reload may have been triggered automatically or manually and may not have succeeded."
},
"content": {
"description": "The raw content of the document. This field is only permitted for EXTRACTIVE_QA and FAQ knowledge types. Note: This field is in the process of being deprecated, please use raw_content instead.",
"type": "string"
},
"enableAutoReload": {
"type": "boolean",
"description": "Optional. If true, we try to automatically reload the document every day (at a time picked by the system). If false or unspecified, we don't try to automatically reload the document. Currently you can only enable automatic reload for documents sourced from a public url, see `source` field for the source types. Reload status can be tracked in `latest_reload_status`. If a reload fails, we will keep the document unchanged. If a reload fails with internal errors, the system will try to reload the document on the next day. If a reload fails with non-retriable errors (e.g. PERMISION_DENIED), the system will not try to reload the document anymore. You need to manually reload the document successfully by calling `ReloadDocument` and clear the errors."
},
"displayName": {
"description": "Required. The display name of the document. The name must be 1024 bytes or less; otherwise, the creation request fails.",
"type": "string"
},
"rawContent": {
"type": "string",
"description": "The raw content of the document. This field is only permitted for EXTRACTIVE_QA and FAQ knowledge types.",
"format": "byte"
},
"contentUri": {
"description": "The URI where the file content is located. For documents stored in Google Cloud Storage, these URIs must have the form `gs:///`. NOTE: External URLs must correspond to public webpages, i.e., they must be indexed by Google Search. In particular, URLs for showing documents in Google Cloud Storage (i.e. the URL in your browser) are not supported. Instead use the `gs://` format URI described above.",
"type": "string"
},
"name": {
"description": "Optional. The document resource name. The name must be empty when creating a document. Format: `projects//knowledgeBases//documents/`.",
"type": "string"
},
"knowledgeTypes": {
"type": "array",
"description": "Required. The knowledge type of document content.",
"items": {
"type": "string",
"enumDescriptions": [
"The type is unspecified or arbitrary.",
"The document content contains question and answer pairs as either HTML or CSV. Typical FAQ HTML formats are parsed accurately, but unusual formats may fail to be parsed. CSV must have questions in the first column and answers in the second, with no header. Because of this explicit format, they are always parsed accurately.",
"Documents for which unstructured text is extracted and used for question answering."
],
"enum": [
"KNOWLEDGE_TYPE_UNSPECIFIED",
"FAQ",
"EXTRACTIVE_QA"
]
}
}
}
},
"GoogleCloudDialogflowV2IntentMessageCardButton": {
"description": "Contains information about a button.",
"type": "object",
"id": "GoogleCloudDialogflowV2IntentMessageCardButton",
"properties": {
"text": {
"type": "string",
"description": "Optional. The text to show on the button."
},
"postback": {
"type": "string",
"description": "Optional. The text to send back to the Dialogflow API or a URI to open."
}
}
},
"GoogleCloudDialogflowV2beta1IntentTrainingPhrasePart": {
"description": "Represents a part of a training phrase.",
"type": "object",
"properties": {
"alias": {
"type": "string",
"description": "Optional. The parameter name for the value extracted from the annotated part of the example. This field is required for annotated parts of the training phrase."
},
"text": {
"description": "Required. The text for this part.",
"type": "string"
},
"entityType": {
"type": "string",
"description": "Optional. The entity type name prefixed with `@`. This field is required for annotated parts of the training phrase."
},
"userDefined": {
"type": "boolean",
"description": "Optional. Indicates whether the text was manually annotated. This field is set to true when the Dialogflow Console is used to manually annotate the part. When creating an annotated part with the API, you must set this to true."
}
},
"id": "GoogleCloudDialogflowV2beta1IntentTrainingPhrasePart"
},
"GoogleCloudDialogflowV2beta1IntentMessageCarouselSelect": {
"description": "The card for presenting a carousel of options to select from.",
"id": "GoogleCloudDialogflowV2beta1IntentMessageCarouselSelect",
"type": "object",
"properties": {
"items": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageCarouselSelectItem"
},
"type": "array",
"description": "Required. Carousel items."
}
}
},
"GoogleCloudDialogflowCxV3ResponseMessage": {
"properties": {
"mixedAudio": {
"$ref": "GoogleCloudDialogflowCxV3ResponseMessageMixedAudio",
"readOnly": true,
"description": "Output only. An audio response message composed of both the synthesized Dialogflow agent responses and responses defined via play_audio. This message is generated by Dialogflow only and not supposed to be defined by the user."
},
"endInteraction": {
"description": "Output only. A signal that indicates the interaction with the Dialogflow agent has ended. This message is generated by Dialogflow only when the conversation reaches `END_SESSION` or `END_PAGE` page. It is not supposed to be defined by the user. It's guaranteed that there is at most one such message in each response.",
"$ref": "GoogleCloudDialogflowCxV3ResponseMessageEndInteraction",
"readOnly": true
},
"payload": {
"description": "Returns a response containing a custom, platform-specific payload.",
"type": "object",
"additionalProperties": {
"type": "any",
"description": "Properties of the object."
}
},
"liveAgentHandoff": {
"$ref": "GoogleCloudDialogflowCxV3ResponseMessageLiveAgentHandoff",
"description": "Hands off conversation to a human agent."
},
"conversationSuccess": {
"$ref": "GoogleCloudDialogflowCxV3ResponseMessageConversationSuccess",
"description": "Indicates that the conversation succeeded."
},
"outputAudioText": {
"description": "A text or ssml response that is preferentially used for TTS output audio synthesis, as described in the comment on the ResponseMessage message.",
"$ref": "GoogleCloudDialogflowCxV3ResponseMessageOutputAudioText"
},
"playAudio": {
"description": "Signal that the client should play an audio clip hosted at a client-specific URI. Dialogflow uses this to construct mixed_audio. However, Dialogflow itself does not try to read or process the URI in any way.",
"$ref": "GoogleCloudDialogflowCxV3ResponseMessagePlayAudio"
},
"text": {
"$ref": "GoogleCloudDialogflowCxV3ResponseMessageText",
"description": "Returns a text response."
}
},
"type": "object",
"description": "Represents a response message that can be returned by a conversational agent. Response messages are also used for output audio synthesis. The approach is as follows: * If at least one OutputAudioText response is present, then all OutputAudioText responses are linearly concatenated, and the result is used for output audio synthesis. * If the OutputAudioText responses are a mixture of text and SSML, then the concatenated result is treated as SSML; otherwise, the result is treated as either text or SSML as appropriate. The agent designer should ideally use either text or SSML consistently throughout the bot design. * Otherwise, all Text responses are linearly concatenated, and the result is used for output audio synthesis. This approach allows for more sophisticated user experience scenarios, where the text displayed to the user may differ from what is heard.",
"id": "GoogleCloudDialogflowCxV3ResponseMessage"
},
"GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCard": {
"id": "GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCard",
"type": "object",
"description": "Browse Carousel Card for Actions on Google. https://developers.google.com/actions/assistant/responses#browsing_carousel",
"properties": {
"imageDisplayOptions": {
"type": "string",
"enumDescriptions": [
"Fill the gaps between the image and the image container with gray bars.",
"Fill the gaps between the image and the image container with gray bars.",
"Fill the gaps between the image and the image container with white bars.",
"Image is scaled such that the image width and height match or exceed the container dimensions. This may crop the top and bottom of the image if the scaled image height is greater than the container height, or crop the left and right of the image if the scaled image width is greater than the container width. This is similar to \"Zoom Mode\" on a widescreen TV when playing a 4:3 video.",
"Pad the gaps between image and image frame with a blurred copy of the same image."
],
"description": "Optional. Settings for displaying the image. Applies to every image in items.",
"enum": [
"IMAGE_DISPLAY_OPTIONS_UNSPECIFIED",
"GRAY",
"WHITE",
"CROPPED",
"BLURRED_BACKGROUND"
]
},
"items": {
"description": "Required. List of items in the Browse Carousel Card. Minimum of two items, maximum of ten.",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCardBrowseCarouselCardItem"
},
"type": "array"
}
}
},
"GoogleCloudDialogflowCxV3WebhookResponseFulfillmentResponse": {
"id": "GoogleCloudDialogflowCxV3WebhookResponseFulfillmentResponse",
"properties": {
"messages": {
"type": "array",
"description": "The list of rich message responses to present to the user.",
"items": {
"$ref": "GoogleCloudDialogflowCxV3ResponseMessage"
}
},
"mergeBehavior": {
"description": "Merge behavior for `messages`.",
"type": "string",
"enum": [
"MERGE_BEHAVIOR_UNSPECIFIED",
"APPEND",
"REPLACE"
],
"enumDescriptions": [
"Not specified. `APPEND` will be used.",
"`messages` will be appended to the list of messages waiting to be sent to the user.",
"`messages` will replace the list of messages waiting to be sent to the user."
]
}
},
"type": "object",
"description": "Represents a fulfillment response to the user."
},
"GoogleCloudDialogflowV2EventInput": {
"type": "object",
"id": "GoogleCloudDialogflowV2EventInput",
"properties": {
"name": {
"type": "string",
"description": "Required. The unique identifier of the event."
},
"parameters": {
"description": "The collection of parameters associated with the event. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: string or number, depending on parameter value type - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value",
"additionalProperties": {
"type": "any",
"description": "Properties of the object."
},
"type": "object"
},
"languageCode": {
"description": "Required. The language of this query. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes. Note that queries in the same session do not necessarily need to specify the same language.",
"type": "string"
}
},
"description": "Events allow for matching intents by event name instead of the natural language input. For instance, input `` can trigger a personalized welcome response. The parameter `name` may be used by the agent in the response: `\"Hello #welcome_event.name! What can I do for you today?\"`."
},
"GoogleCloudDialogflowCxV3WebhookResponse": {
"properties": {
"sessionInfo": {
"description": "Information about session status. This field can be omitted by the webhook if it does not intend to modify session status.",
"$ref": "GoogleCloudDialogflowCxV3SessionInfo"
},
"payload": {
"type": "object",
"additionalProperties": {
"type": "any",
"description": "Properties of the object."
},
"description": "Value to append directly to QueryResult.webhook_payloads."
},
"targetPage": {
"description": "The target page to transition to. Format: `projects//locations//agents//flows//pages/`.",
"type": "string"
},
"pageInfo": {
"$ref": "GoogleCloudDialogflowCxV3PageInfo",
"description": "Information about page status. This field can be omitted by the webhook if it does not intend to modify page status."
},
"fulfillmentResponse": {
"$ref": "GoogleCloudDialogflowCxV3WebhookResponseFulfillmentResponse",
"description": "The fulfillment response to send to the user. This field can be omitted by the webhook if it does not intend to send any response to the user."
},
"targetFlow": {
"description": "The target flow to transition to. Format: `projects//locations//agents//flows/`.",
"type": "string"
}
},
"type": "object",
"id": "GoogleCloudDialogflowCxV3WebhookResponse",
"description": "The response message for a webhook call."
},
"GoogleCloudDialogflowV2beta1IntentMessageTelephonyTransferCall": {
"description": "Transfers the call in Telephony Gateway.",
"properties": {
"phoneNumber": {
"type": "string",
"description": "Required. The phone number to transfer the call to in [E.164 format](https://en.wikipedia.org/wiki/E.164). We currently only allow transferring to US numbers (+1xxxyyyzzzz)."
}
},
"id": "GoogleCloudDialogflowV2beta1IntentMessageTelephonyTransferCall",
"type": "object"
},
"GoogleCloudDialogflowV2beta1QueryParameters": {
"type": "object",
"id": "GoogleCloudDialogflowV2beta1QueryParameters",
"description": "Represents the parameters of the conversational query.",
"properties": {
"resetContexts": {
"type": "boolean",
"description": "Specifies whether to delete all contexts in the current session before the new ones are activated."
},
"timeZone": {
"type": "string",
"description": "The time zone of this conversational query from the [time zone database](https://www.iana.org/time-zones), e.g., America/New_York, Europe/Paris. If not provided, the time zone specified in agent settings is used."
},
"contexts": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1Context"
},
"description": "The collection of contexts to be activated before this query is executed.",
"type": "array"
},
"sessionEntityTypes": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1SessionEntityType"
},
"type": "array",
"description": "Additional session entity types to replace or extend developer entity types with. The entity synonyms apply to all languages and persist for the session of this query."
},
"knowledgeBaseNames": {
"items": {
"type": "string"
},
"description": "KnowledgeBases to get alternative results from. If not set, the KnowledgeBases enabled in the agent (through UI) will be used. Format: `projects//knowledgeBases/`.",
"type": "array"
},
"webhookHeaders": {
"description": "This field can be used to pass HTTP headers for a webhook call. These headers will be sent to webhook along with the headers that have been configured through Dialogflow web console. The headers defined within this field will overwrite the headers configured through Dialogflow console if there is a conflict. Header names are case-insensitive. Google's specified headers are not allowed. Including: \"Host\", \"Content-Length\", \"Connection\", \"From\", \"User-Agent\", \"Accept-Encoding\", \"If-Modified-Since\", \"If-None-Match\", \"X-Forwarded-For\", etc.",
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"payload": {
"additionalProperties": {
"type": "any",
"description": "Properties of the object."
},
"type": "object",
"description": "This field can be used to pass custom data to your webhook. Arbitrary JSON objects are supported. If supplied, the value is used to populate the `WebhookRequest.original_detect_intent_request.payload` field sent to your webhook."
},
"geoLocation": {
"$ref": "GoogleTypeLatLng",
"description": "The geo location of this conversational query."
},
"subAgents": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1SubAgent"
},
"description": "For mega agent query, directly specify which sub agents to query. If any specified sub agent is not linked to the mega agent, an error will be returned. If empty, Dialogflow will decide which sub agents to query. If specified for a non-mega-agent query, will be silently ignored.",
"type": "array"
},
"sentimentAnalysisRequestConfig": {
"description": "Configures the type of sentiment analysis to perform. If not provided, sentiment analysis is not performed. Note: Sentiment Analysis is only currently available for Essentials Edition agents.",
"$ref": "GoogleCloudDialogflowV2beta1SentimentAnalysisRequestConfig"
}
}
},
"GoogleCloudDialogflowV2beta1ListDocumentsResponse": {
"type": "object",
"description": "Response message for Documents.ListDocuments.",
"id": "GoogleCloudDialogflowV2beta1ListDocumentsResponse",
"properties": {
"nextPageToken": {
"type": "string",
"description": "Token to retrieve the next page of results, or empty if there are no more results in the list."
},
"documents": {
"description": "The list of documents.",
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1Document"
}
}
}
},
"GoogleCloudDialogflowV2beta1IntentMessageMediaContentResponseMediaObject": {
"id": "GoogleCloudDialogflowV2beta1IntentMessageMediaContentResponseMediaObject",
"type": "object",
"description": "Response media object for media content card.",
"properties": {
"name": {
"description": "Required. Name of media card.",
"type": "string"
},
"description": {
"description": "Optional. Description of media card.",
"type": "string"
},
"icon": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageImage",
"description": "Optional. Icon to display above media content."
},
"largeImage": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageImage",
"description": "Optional. Image to display above media content."
},
"contentUrl": {
"description": "Required. Url where the media is stored.",
"type": "string"
}
}
},
"GoogleCloudDialogflowV2beta1IntentMessageTableCardCell": {
"id": "GoogleCloudDialogflowV2beta1IntentMessageTableCardCell",
"type": "object",
"description": "Cell of TableCardRow.",
"properties": {
"text": {
"description": "Required. Text in this cell.",
"type": "string"
}
}
},
"GoogleCloudDialogflowV2beta1EntityTypeEntity": {
"properties": {
"synonyms": {
"type": "array",
"description": "Required. A collection of value synonyms. For example, if the entity type is *vegetable*, and `value` is *scallions*, a synonym could be *green onions*. For `KIND_LIST` entity types: * This collection must contain exactly one synonym equal to `value`.",
"items": {
"type": "string"
}
},
"value": {
"description": "Required. The primary value associated with this entity entry. For example, if the entity type is *vegetable*, the value could be *scallions*. For `KIND_MAP` entity types: * A reference value to be used in place of synonyms. For `KIND_LIST` entity types: * A string that can contain references to other entity types (with or without aliases).",
"type": "string"
}
},
"id": "GoogleCloudDialogflowV2beta1EntityTypeEntity",
"description": "An **entity entry** for an associated entity type.",
"type": "object"
},
"GoogleCloudDialogflowV2beta1IntentBatch": {
"type": "object",
"description": "This message is a wrapper around a collection of intents.",
"properties": {
"intents": {
"description": "A collection of intents.",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1Intent"
},
"type": "array"
}
},
"id": "GoogleCloudDialogflowV2beta1IntentBatch"
},
"GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedReply": {
"properties": {
"postbackData": {
"description": "Opaque payload that the Dialogflow receives in a user event when the user taps the suggested reply. This data will be also forwarded to webhook to allow performing custom business logic.",
"type": "string"
},
"text": {
"type": "string",
"description": "Suggested reply text."
}
},
"description": "Rich Business Messaging (RBM) suggested reply that the user can click instead of typing in their own response.",
"id": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedReply",
"type": "object"
},
"GoogleCloudDialogflowV2beta1KnowledgeAnswers": {
"type": "object",
"properties": {
"answers": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1KnowledgeAnswersAnswer"
},
"type": "array",
"description": "A list of answers from Knowledge Connector."
}
},
"id": "GoogleCloudDialogflowV2beta1KnowledgeAnswers",
"description": "Represents the result of querying a Knowledge base."
},
"GoogleCloudDialogflowCxV3ResponseMessageOutputAudioText": {
"type": "object",
"id": "GoogleCloudDialogflowCxV3ResponseMessageOutputAudioText",
"description": "A text or ssml response that is preferentially used for TTS output audio synthesis, as described in the comment on the ResponseMessage message.",
"properties": {
"ssml": {
"type": "string",
"description": "The SSML text to be synthesized. For more information, see [SSML](/speech/text-to-speech/docs/ssml)."
},
"text": {
"description": "The raw text to be synthesized.",
"type": "string"
},
"allowPlaybackInterruption": {
"readOnly": true,
"description": "Output only. Whether the playback of this message can be interrupted by the end user's speech and the client can then starts the next Dialogflow request.",
"type": "boolean"
}
}
},
"GoogleCloudDialogflowCxV3ResponseMessageText": {
"type": "object",
"id": "GoogleCloudDialogflowCxV3ResponseMessageText",
"properties": {
"text": {
"items": {
"type": "string"
},
"type": "array",
"description": "Required. A collection of text responses."
},
"allowPlaybackInterruption": {
"description": "Output only. Whether the playback of this message can be interrupted by the end user's speech and the client can then starts the next Dialogflow request.",
"type": "boolean",
"readOnly": true
}
},
"description": "The text response message."
},
"GoogleCloudDialogflowV2beta1IntentMessageSuggestion": {
"description": "The suggestion chip message that the user can tap to quickly post a reply to the conversation.",
"id": "GoogleCloudDialogflowV2beta1IntentMessageSuggestion",
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Required. The text shown the in the suggestion chip."
}
}
},
"GoogleCloudDialogflowV2IntentMessageListSelect": {
"properties": {
"subtitle": {
"type": "string",
"description": "Optional. Subtitle of the list."
},
"title": {
"type": "string",
"description": "Optional. The overall title of the list."
},
"items": {
"items": {
"$ref": "GoogleCloudDialogflowV2IntentMessageListSelectItem"
},
"description": "Required. List items.",
"type": "array"
}
},
"description": "The card for presenting a list of options to select from.",
"id": "GoogleCloudDialogflowV2IntentMessageListSelect",
"type": "object"
},
"GoogleCloudDialogflowV2beta1BatchUpdateEntityTypesRequest": {
"id": "GoogleCloudDialogflowV2beta1BatchUpdateEntityTypesRequest",
"type": "object",
"description": "The request message for EntityTypes.BatchUpdateEntityTypes.",
"properties": {
"entityTypeBatchUri": {
"description": "The URI to a Google Cloud Storage file containing entity types to update or create. The file format can either be a serialized proto (of EntityBatch type) or a JSON object. Note: The URI must start with \"gs://\".",
"type": "string"
},
"entityTypeBatchInline": {
"description": "The collection of entity types to update or create.",
"$ref": "GoogleCloudDialogflowV2beta1EntityTypeBatch"
},
"languageCode": {
"type": "string",
"description": "Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see [Multilingual intent and entity data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity)."
},
"updateMask": {
"description": "Optional. The mask to control which fields get updated.",
"type": "string",
"format": "google-fieldmask"
}
}
},
"GoogleCloudDialogflowV2IntentMessageMediaContentResponseMediaObject": {
"properties": {
"icon": {
"$ref": "GoogleCloudDialogflowV2IntentMessageImage",
"description": "Optional. Icon to display above media content."
},
"description": {
"type": "string",
"description": "Optional. Description of media card."
},
"contentUrl": {
"type": "string",
"description": "Required. Url where the media is stored."
},
"largeImage": {
"description": "Optional. Image to display above media content.",
"$ref": "GoogleCloudDialogflowV2IntentMessageImage"
},
"name": {
"description": "Required. Name of media card.",
"type": "string"
}
},
"id": "GoogleCloudDialogflowV2IntentMessageMediaContentResponseMediaObject",
"type": "object",
"description": "Response media object for media content card."
},
"GoogleCloudDialogflowCxV3PageInfo": {
"properties": {
"currentPage": {
"type": "string",
"description": "Always present for WebhookRequest. Ignored for WebhookResponse. The unique identifier of the current page. Format: `projects//locations//agents//flows//pages/`."
},
"formInfo": {
"description": "Optional for both WebhookRequest and WebhookResponse. Information about the form.",
"$ref": "GoogleCloudDialogflowCxV3PageInfoFormInfo"
}
},
"id": "GoogleCloudDialogflowCxV3PageInfo",
"type": "object",
"description": "Represents page information communicated to and from the webhook."
},
"GoogleCloudDialogflowV2IntentMessageSimpleResponse": {
"id": "GoogleCloudDialogflowV2IntentMessageSimpleResponse",
"properties": {
"ssml": {
"description": "One of text_to_speech or ssml must be provided. Structured spoken response to the user in the SSML format. Mutually exclusive with text_to_speech.",
"type": "string"
},
"displayText": {
"type": "string",
"description": "Optional. The text to display."
},
"textToSpeech": {
"type": "string",
"description": "One of text_to_speech or ssml must be provided. The plain text of the speech output. Mutually exclusive with ssml."
}
},
"description": "The simple response message containing speech or text.",
"type": "object"
},
"GoogleCloudDialogflowV2beta1IntentMessageListSelect": {
"properties": {
"items": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageListSelectItem"
},
"type": "array",
"description": "Required. List items."
},
"subtitle": {
"type": "string",
"description": "Optional. Subtitle of the list."
},
"title": {
"description": "Optional. The overall title of the list.",
"type": "string"
}
},
"type": "object",
"description": "The card for presenting a list of options to select from.",
"id": "GoogleCloudDialogflowV2beta1IntentMessageListSelect"
},
"GoogleCloudDialogflowV2beta1EntityTypeBatch": {
"properties": {
"entityTypes": {
"description": "A collection of entity types.",
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1EntityType"
}
}
},
"type": "object",
"id": "GoogleCloudDialogflowV2beta1EntityTypeBatch",
"description": "This message is a wrapper around a collection of entity types."
},
"GoogleCloudDialogflowV2beta1SearchAgentsResponse": {
"id": "GoogleCloudDialogflowV2beta1SearchAgentsResponse",
"properties": {
"nextPageToken": {
"description": "Token to retrieve the next page of results, or empty if there are no more results in the list.",
"type": "string"
},
"agents": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1Agent"
},
"type": "array",
"description": "The list of agents. There will be a maximum number of items returned based on the page_size field in the request."
}
},
"type": "object",
"description": "The response message for Agents.SearchAgents."
},
"GoogleCloudDialogflowCxV3beta1WebhookRequestFulfillmentInfo": {
"description": "Represents fulfillment information communicated to the webhook.",
"id": "GoogleCloudDialogflowCxV3beta1WebhookRequestFulfillmentInfo",
"type": "object",
"properties": {
"tag": {
"description": "Always present. The tag used to identify which fulfillment is being called.",
"type": "string"
}
}
},
"GoogleCloudDialogflowV2IntentMessageBasicCardButton": {
"description": "The button object that appears at the bottom of a card.",
"properties": {
"title": {
"type": "string",
"description": "Required. The title of the button."
},
"openUriAction": {
"description": "Required. Action to take when a user taps on the button.",
"$ref": "GoogleCloudDialogflowV2IntentMessageBasicCardButtonOpenUriAction"
}
},
"type": "object",
"id": "GoogleCloudDialogflowV2IntentMessageBasicCardButton"
},
"GoogleCloudDialogflowV2beta1BatchUpdateEntityTypesResponse": {
"id": "GoogleCloudDialogflowV2beta1BatchUpdateEntityTypesResponse",
"properties": {
"entityTypes": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1EntityType"
},
"description": "The collection of updated or created entity types.",
"type": "array"
}
},
"description": "The response message for EntityTypes.BatchUpdateEntityTypes.",
"type": "object"
},
"GoogleCloudDialogflowCxV3beta1WebhookRequestIntentInfoIntentParameterValue": {
"type": "object",
"id": "GoogleCloudDialogflowCxV3beta1WebhookRequestIntentInfoIntentParameterValue",
"description": "Represents a value for an intent parameter.",
"properties": {
"originalValue": {
"description": "Always present. Original text value extracted from user utterance.",
"type": "string"
},
"resolvedValue": {
"description": "Always present. Structured value for the parameter extracted from user utterance.",
"type": "any"
}
}
},
"GoogleCloudDialogflowV2beta1ReloadDocumentRequest": {
"description": "Request message for Documents.ReloadDocument.",
"properties": {
"importGcsCustomMetadata": {
"type": "boolean",
"description": "Whether to import custom metadata from Google Cloud Storage. Only valid when the document source is Google Cloud Storage URI."
},
"gcsSource": {
"description": "The path for a Cloud Storage source file for reloading document content. If not provided, the Document's existing source will be reloaded.",
"$ref": "GoogleCloudDialogflowV2beta1GcsSource"
}
},
"id": "GoogleCloudDialogflowV2beta1ReloadDocumentRequest",
"type": "object"
},
"GoogleCloudDialogflowV2beta1DocumentReloadStatus": {
"properties": {
"status": {
"$ref": "GoogleRpcStatus",
"description": "Output only. The status of a reload attempt or the initial load."
},
"time": {
"format": "google-datetime",
"type": "string",
"description": "Output only. The time of a reload attempt. This reload may have been triggered automatically or manually and may not have succeeded."
}
},
"type": "object",
"description": "The status of a reload attempt.",
"id": "GoogleCloudDialogflowV2beta1DocumentReloadStatus"
},
"GoogleCloudDialogflowV2IntentMessageText": {
"type": "object",
"properties": {
"text": {
"items": {
"type": "string"
},
"description": "Optional. The collection of the agent's responses.",
"type": "array"
}
},
"description": "The text response message.",
"id": "GoogleCloudDialogflowV2IntentMessageText"
},
"GoogleCloudDialogflowV2beta1BatchUpdateIntentsRequest": {
"id": "GoogleCloudDialogflowV2beta1BatchUpdateIntentsRequest",
"description": "The request message for Intents.BatchUpdateIntents.",
"properties": {
"intentView": {
"enumDescriptions": [
"Training phrases field is not populated in the response.",
"All fields are populated."
],
"type": "string",
"enum": [
"INTENT_VIEW_UNSPECIFIED",
"INTENT_VIEW_FULL"
],
"description": "Optional. The resource view to apply to the returned intent."
},
"intentBatchInline": {
"description": "The collection of intents to update or create.",
"$ref": "GoogleCloudDialogflowV2beta1IntentBatch"
},
"intentBatchUri": {
"type": "string",
"description": "The URI to a Google Cloud Storage file containing intents to update or create. The file format can either be a serialized proto (of IntentBatch type) or JSON object. Note: The URI must start with \"gs://\"."
},
"languageCode": {
"description": "Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see [Multilingual intent and entity data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).",
"type": "string"
},
"updateMask": {
"description": "Optional. The mask to control which fields get updated.",
"format": "google-fieldmask",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudDialogflowV2beta1BatchDeleteIntentsRequest": {
"id": "GoogleCloudDialogflowV2beta1BatchDeleteIntentsRequest",
"properties": {
"intents": {
"description": "Required. The collection of intents to delete. Only intent `name` must be filled in.",
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1Intent"
}
}
},
"description": "The request message for Intents.BatchDeleteIntents.",
"type": "object"
},
"GoogleCloudDialogflowV2beta1ExportAgentRequest": {
"type": "object",
"description": "The request message for Agents.ExportAgent.",
"properties": {
"agentUri": {
"type": "string",
"description": "Optional. The [Google Cloud Storage](https://cloud.google.com/storage/docs/) URI to export the agent to. The format of this URI must be `gs:///`. If left unspecified, the serialized agent is returned inline."
}
},
"id": "GoogleCloudDialogflowV2beta1ExportAgentRequest"
},
"GoogleCloudDialogflowV2beta1SentimentAnalysisRequestConfig": {
"properties": {
"analyzeQueryTextSentiment": {
"type": "boolean",
"description": "Instructs the service to perform sentiment analysis on `query_text`. If not provided, sentiment analysis is not performed on `query_text`."
}
},
"type": "object",
"description": "Configures the types of sentiment analysis to perform.",
"id": "GoogleCloudDialogflowV2beta1SentimentAnalysisRequestConfig"
},
"GoogleCloudDialogflowV2beta1FulfillmentGenericWebService": {
"properties": {
"isCloudFunction": {
"type": "boolean",
"description": "Indicates if generic web service is created through Cloud Functions integration. Defaults to false."
},
"uri": {
"type": "string",
"description": "Required. The fulfillment URI for receiving POST requests. It must use https protocol."
},
"password": {
"type": "string",
"description": "The password for HTTP Basic authentication."
},
"username": {
"description": "The user name for HTTP Basic authentication.",
"type": "string"
},
"requestHeaders": {
"type": "object",
"additionalProperties": {
"type": "string"
},
"description": "The HTTP request headers to send together with fulfillment requests."
}
},
"description": "Represents configuration for a generic web service. Dialogflow supports two mechanisms for authentications: - Basic authentication with username and password. - Authentication with additional authentication headers. More information could be found at: https://cloud.google.com/dialogflow/docs/fulfillment-configure.",
"id": "GoogleCloudDialogflowV2beta1FulfillmentGenericWebService",
"type": "object"
},
"GoogleCloudDialogflowCxV3PageInfoFormInfoParameterInfo": {
"description": "Represents parameter information.",
"id": "GoogleCloudDialogflowCxV3PageInfoFormInfoParameterInfo",
"properties": {
"required": {
"description": "Optional for both WebhookRequest and WebhookResponse. Indicates whether the parameter is required. Optional parameters will not trigger prompts; however, they are filled if the user specifies them. Required parameters must be filled before form filling concludes.",
"type": "boolean"
},
"state": {
"description": "Always present for WebhookRequest. Required for WebhookResponse. The state of the parameter. This field can be set to INVALID by the webhook to invalidate the parameter; other values set by the webhook will be ignored.",
"enum": [
"PARAMETER_STATE_UNSPECIFIED",
"EMPTY",
"INVALID",
"FILLED"
],
"enumDescriptions": [
"Not specified. This value should be never used.",
"Indicates that the parameter does not have a value.",
"Indicates that the parameter value is invalid. This field can be used by the webhook to invalidate the parameter and ask the server to collect it from the user again.",
"Indicates that the parameter has a value."
],
"type": "string"
},
"displayName": {
"description": "Always present for WebhookRequest. Required for WebhookResponse. The human-readable name of the parameter, unique within the form. This field cannot be modified by the webhook.",
"type": "string"
},
"justCollected": {
"description": "Optional for WebhookRequest. Ignored for WebhookResponse. Indicates if the parameter value was just collected on the last conversation turn.",
"type": "boolean"
},
"value": {
"type": "any",
"description": "Optional for both WebhookRequest and WebhookResponse. The value of the parameter. This field can be set by the webhook to change the parameter value."
}
},
"type": "object"
},
"GoogleCloudDialogflowCxV3WebhookRequestIntentInfoIntentParameterValue": {
"id": "GoogleCloudDialogflowCxV3WebhookRequestIntentInfoIntentParameterValue",
"description": "Represents a value for an intent parameter.",
"type": "object",
"properties": {
"resolvedValue": {
"type": "any",
"description": "Always present. Structured value for the parameter extracted from user utterance."
},
"originalValue": {
"description": "Always present. Original text value extracted from user utterance.",
"type": "string"
}
}
},
"GoogleCloudDialogflowCxV3WebhookRequestFulfillmentInfo": {
"description": "Represents fulfillment information communicated to the webhook.",
"properties": {
"tag": {
"type": "string",
"description": "Always present. The tag used to identify which fulfillment is being called."
}
},
"id": "GoogleCloudDialogflowCxV3WebhookRequestFulfillmentInfo",
"type": "object"
},
"GoogleCloudDialogflowV2ConversationEvent": {
"description": "Represents a notification sent to Pub/Sub subscribers for conversation lifecycle events.",
"type": "object",
"properties": {
"type": {
"enum": [
"TYPE_UNSPECIFIED",
"CONVERSATION_STARTED",
"CONVERSATION_FINISHED",
"HUMAN_INTERVENTION_NEEDED",
"NEW_MESSAGE",
"UNRECOVERABLE_ERROR"
],
"type": "string",
"enumDescriptions": [
"Type not set.",
"A new conversation has been opened. This is fired when a telephone call is answered, or a conversation is created via the API.",
"An existing conversation has closed. This is fired when a telephone call is terminated, or a conversation is closed via the API.",
"An existing conversation has received notification from Dialogflow that human intervention is required.",
"An existing conversation has received a new message, either from API or telephony. It is configured in ConversationProfile.new_message_event_notification_config",
"Unrecoverable error during a telephone call. In general non-recoverable errors only occur if something was misconfigured in the ConversationProfile corresponding to the call. After a non-recoverable error, Dialogflow may stop responding. We don't fire this event: * in an API call because we can directly return the error, or, * when we can recover from an error."
],
"description": "The type of the event that this notification refers to."
},
"conversation": {
"description": "The unique identifier of the conversation this notification refers to. Format: `projects//conversations/`.",
"type": "string"
},
"newMessagePayload": {
"$ref": "GoogleCloudDialogflowV2Message",
"description": "Payload of NEW_MESSAGE event."
},
"errorStatus": {
"description": "More detailed information about an error. Only set for type UNRECOVERABLE_ERROR_IN_PHONE_CALL.",
"$ref": "GoogleRpcStatus"
}
},
"id": "GoogleCloudDialogflowV2ConversationEvent"
},
"GoogleTypeLatLng": {
"description": "An object that represents a latitude/longitude pair. This is expressed as a pair of doubles to represent degrees latitude and degrees longitude. Unless specified otherwise, this must conform to the WGS84 standard. Values must be within normalized ranges.",
"type": "object",
"properties": {
"latitude": {
"format": "double",
"type": "number",
"description": "The latitude in degrees. It must be in the range [-90.0, +90.0]."
},
"longitude": {
"type": "number",
"format": "double",
"description": "The longitude in degrees. It must be in the range [-180.0, +180.0]."
}
},
"id": "GoogleTypeLatLng"
},
"GoogleCloudDialogflowV2beta1IntentMessageTableCard": {
"properties": {
"image": {
"description": "Optional. Image which should be displayed on the card.",
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageImage"
},
"title": {
"type": "string",
"description": "Required. Title of the card."
},
"buttons": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageBasicCardButton"
},
"type": "array",
"description": "Optional. List of buttons for the card."
},
"rows": {
"description": "Optional. Rows in this table of data.",
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageTableCardRow"
}
},
"subtitle": {
"type": "string",
"description": "Optional. Subtitle to the title."
},
"columnProperties": {
"type": "array",
"description": "Optional. Display properties for the columns in this table.",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageColumnProperties"
}
}
},
"type": "object",
"id": "GoogleCloudDialogflowV2beta1IntentMessageTableCard",
"description": "Table card for Actions on Google."
},
"GoogleCloudDialogflowV2beta1Context": {
"type": "object",
"id": "GoogleCloudDialogflowV2beta1Context",
"properties": {
"name": {
"description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`",
"type": "string"
},
"parameters": {
"additionalProperties": {
"description": "Properties of the object.",
"type": "any"
},
"type": "object",
"description": "Optional. The collection of parameters associated with this context. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: string or number, depending on parameter value type - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value"
},
"lifespanCount": {
"format": "int32",
"type": "integer",
"description": "Optional. The number of conversational query requests after which the context expires. The default is `0`. If set to `0`, the context expires immediately. Contexts expire automatically after 20 minutes if there are no matching queries."
}
},
"description": "Dialogflow contexts are similar to natural language context. If a person says to you \"they are orange\", you need context in order to understand what \"they\" is referring to. Similarly, for Dialogflow to handle an end-user expression like that, it needs to be provided with context in order to correctly match an intent. Using contexts, you can control the flow of a conversation. You can configure contexts for an intent by setting input and output contexts, which are identified by string names. When an intent is matched, any configured output contexts for that intent become active. While any contexts are active, Dialogflow is more likely to match intents that are configured with input contexts that correspond to the currently active contexts. For more information about context, see the [Contexts guide](https://cloud.google.com/dialogflow/docs/contexts-overview)."
},
"GoogleCloudDialogflowV2beta1SentimentAnalysisResult": {
"type": "object",
"properties": {
"queryTextSentiment": {
"$ref": "GoogleCloudDialogflowV2beta1Sentiment",
"description": "The sentiment analysis result for `query_text`."
}
},
"description": "The result of sentiment analysis. Sentiment analysis inspects user input and identifies the prevailing subjective opinion, especially to determine a user's attitude as positive, negative, or neutral. For Participants.DetectIntent, it needs to be configured in DetectIntentRequest.query_params. For Participants.StreamingDetectIntent, it needs to be configured in StreamingDetectIntentRequest.query_params. And for Participants.AnalyzeContent and Participants.StreamingAnalyzeContent, it needs to be configured in ConversationProfile.human_agent_assistant_config",
"id": "GoogleCloudDialogflowV2beta1SentimentAnalysisResult"
},
"GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudioSegment": {
"id": "GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudioSegment",
"properties": {
"audio": {
"description": "Raw audio synthesized from the Dialogflow agent's response using the output config specified in the request.",
"type": "string",
"format": "byte"
},
"uri": {
"type": "string",
"description": "Client-specific URI that points to an audio clip accessible to the client. Dialogflow does not impose any validation on it."
},
"allowPlaybackInterruption": {
"type": "boolean",
"readOnly": true,
"description": "Output only. Whether the playback of this segment can be interrupted by the end user's speech and the client should then start the next Dialogflow request."
}
},
"description": "Represents one segment of audio.",
"type": "object"
},
"GoogleCloudDialogflowV2Sentiment": {
"type": "object",
"properties": {
"magnitude": {
"type": "number",
"format": "float",
"description": "A non-negative number in the [0, +inf) range, which represents the absolute magnitude of sentiment, regardless of score (positive or negative)."
},
"score": {
"description": "Sentiment score between -1.0 (negative sentiment) and 1.0 (positive sentiment).",
"format": "float",
"type": "number"
}
},
"description": "The sentiment, such as positive/negative feeling or association, for a unit of analysis, such as the query text.",
"id": "GoogleCloudDialogflowV2Sentiment"
},
"GoogleCloudDialogflowV2beta1IntentMessageRbmCarouselCard": {
"properties": {
"cardContents": {
"description": "Required. The cards in the carousel. A carousel must have at least 2 cards and at most 10.",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1IntentMessageRbmCardContent"
},
"type": "array"
},
"cardWidth": {
"description": "Required. The width of the cards in the carousel.",
"enumDescriptions": [
"Not specified.",
"120 DP. Note that tall media cannot be used.",
"232 DP."
],
"enum": [
"CARD_WIDTH_UNSPECIFIED",
"SMALL",
"MEDIUM"
],
"type": "string"
}
},
"type": "object",
"description": "Carousel Rich Business Messaging (RBM) rich card. Rich cards allow you to respond to users with more vivid content, e.g. with media and suggestions. If you want to show a single card with more control over the layout, please use RbmStandaloneCard instead.",
"id": "GoogleCloudDialogflowV2beta1IntentMessageRbmCarouselCard"
},
"GoogleCloudDialogflowV2beta1BatchDeleteEntitiesRequest": {
"properties": {
"languageCode": {
"type": "string",
"description": "Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see [Multilingual intent and entity data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity)."
},
"entityValues": {
"description": "Required. The reference `values` of the entities to delete. Note that these are not fully-qualified names, i.e. they don't start with `projects/`.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object",
"id": "GoogleCloudDialogflowV2beta1BatchDeleteEntitiesRequest",
"description": "The request message for EntityTypes.BatchDeleteEntities."
},
"GoogleCloudDialogflowV2beta1SessionEntityType": {
"description": "A session represents a conversation between a Dialogflow agent and an end-user. You can create special entities, called session entities, during a session. Session entities can extend or replace custom entity types and only exist during the session that they were created for. All session data, including session entities, is stored by Dialogflow for 20 minutes. For more information, see the [session entity guide](https://cloud.google.com/dialogflow/docs/entities-session).",
"id": "GoogleCloudDialogflowV2beta1SessionEntityType",
"properties": {
"entities": {
"description": "Required. The collection of entities associated with this session entity type.",
"type": "array",
"items": {
"$ref": "GoogleCloudDialogflowV2beta1EntityTypeEntity"
}
},
"entityOverrideMode": {
"enum": [
"ENTITY_OVERRIDE_MODE_UNSPECIFIED",
"ENTITY_OVERRIDE_MODE_OVERRIDE",
"ENTITY_OVERRIDE_MODE_SUPPLEMENT"
],
"enumDescriptions": [
"Not specified. This value should be never used.",
"The collection of session entities overrides the collection of entities in the corresponding custom entity type.",
"The collection of session entities extends the collection of entities in the corresponding custom entity type. Note: Even in this override mode calls to `ListSessionEntityTypes`, `GetSessionEntityType`, `CreateSessionEntityType` and `UpdateSessionEntityType` only return the additional entities added in this session entity type. If you want to get the supplemented list, please call EntityTypes.GetEntityType on the custom entity type and merge."
],
"type": "string",
"description": "Required. Indicates whether the additional data should override or supplement the custom entity type definition."
},
"name": {
"description": "Required. The unique identifier of this session entity type. Supported formats: - `projects//agent/sessions//entityTypes/` - `projects//locations//agent/sessions//entityTypes/` - `projects//agent/environments//users//sessions//entityTypes/` - `projects//locations//agent/environments/ /users//sessions//entityTypes/` If `Location ID` is not specified we assume default 'us' location. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. `` must be the display name of an existing entity type in the same agent that will be overridden or supplemented.",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudDialogflowV2IntentMessageListSelectItem": {
"description": "An item in the list.",
"properties": {
"title": {
"type": "string",
"description": "Required. The title of the list item."
},
"description": {
"description": "Optional. The main text describing the item.",
"type": "string"
},
"info": {
"description": "Required. Additional information about this option.",
"$ref": "GoogleCloudDialogflowV2IntentMessageSelectItemInfo"
},
"image": {
"description": "Optional. The image to display.",
"$ref": "GoogleCloudDialogflowV2IntentMessageImage"
}
},
"id": "GoogleCloudDialogflowV2IntentMessageListSelectItem",
"type": "object"
},
"GoogleCloudDialogflowV2beta1IntentMessageQuickReplies": {
"description": "The quick replies response message.",
"properties": {
"title": {
"type": "string",
"description": "Optional. The title of the collection of quick replies."
},
"quickReplies": {
"type": "array",
"description": "Optional. The collection of quick replies.",
"items": {
"type": "string"
}
}
},
"type": "object",
"id": "GoogleCloudDialogflowV2beta1IntentMessageQuickReplies"
},
"GoogleCloudDialogflowCxV3beta1SessionInfo": {
"id": "GoogleCloudDialogflowCxV3beta1SessionInfo",
"type": "object",
"description": "Represents session information communicated to and from the webhook.",
"properties": {
"parameters": {
"type": "object",
"additionalProperties": {
"type": "any"
},
"description": "Optional for WebhookRequest. Optional for WebhookResponse. All parameters collected from forms and intents during the session. Parameters can be created, updated, or removed by the webhook. To remove a parameter from the session, the webhook should explicitly set the parameter value to null in WebhookResponse. The map is keyed by parameters' display names."
},
"session": {
"description": "Always present for WebhookRequest. Ignored for WebhookResponse. The unique identifier of the session. This field can be used by the webhook to identify a user. Format: `projects//locations//agents//sessions/`.",
"type": "string"
}
}
},
"GoogleCloudDialogflowCxV3ResponseMessageLiveAgentHandoff": {
"description": "Indicates that the conversation should be handed off to a live agent. Dialogflow only uses this to determine which conversations were handed off to a human agent for measurement purposes. What else to do with this signal is up to you and your handoff procedures. You may set this, for example: * In the entry_fulfillment of a Page if entering the page indicates something went extremely wrong in the conversation. * In a webhook response when you determine that the customer issue can only be handled by a human.",
"properties": {
"metadata": {
"description": "Custom metadata for your handoff procedure. Dialogflow doesn't impose any structure on this.",
"type": "object",
"additionalProperties": {
"type": "any",
"description": "Properties of the object."
}
}
},
"type": "object",
"id": "GoogleCloudDialogflowCxV3ResponseMessageLiveAgentHandoff"
},
"GoogleCloudDialogflowV2beta1Fulfillment": {
"description": "By default, your agent responds to a matched intent with a static response. As an alternative, you can provide a more dynamic response by using fulfillment. When you enable fulfillment for an intent, Dialogflow responds to that intent by calling a service that you define. For example, if an end-user wants to schedule a haircut on Friday, your service can check your database and respond to the end-user with availability information for Friday. For more information, see the [fulfillment guide](https://cloud.google.com/dialogflow/docs/fulfillment-overview).",
"type": "object",
"id": "GoogleCloudDialogflowV2beta1Fulfillment",
"properties": {
"enabled": {
"description": "Whether fulfillment is enabled.",
"type": "boolean"
},
"displayName": {
"type": "string",
"description": "The human-readable name of the fulfillment, unique within the agent."
},
"name": {
"type": "string",
"description": "Required. The unique identifier of the fulfillment. Supported formats: - `projects//agent/fulfillment` - `projects//locations//agent/fulfillment`"
},
"genericWebService": {
"$ref": "GoogleCloudDialogflowV2beta1FulfillmentGenericWebService",
"description": "Configuration for a generic web service."
},
"features": {
"items": {
"$ref": "GoogleCloudDialogflowV2beta1FulfillmentFeature"
},
"description": "The field defines whether the fulfillment is enabled for certain features.",
"type": "array"
}
}
},
"GoogleCloudDialogflowV2beta1TrainAgentRequest": {
"id": "GoogleCloudDialogflowV2beta1TrainAgentRequest",
"properties": {},
"type": "object",
"description": "The request message for Agents.TrainAgent."
},
"GoogleCloudDialogflowV2Context": {
"type": "object",
"id": "GoogleCloudDialogflowV2Context",
"description": "Dialogflow contexts are similar to natural language context. If a person says to you \"they are orange\", you need context in order to understand what \"they\" is referring to. Similarly, for Dialogflow to handle an end-user expression like that, it needs to be provided with context in order to correctly match an intent. Using contexts, you can control the flow of a conversation. You can configure contexts for an intent by setting input and output contexts, which are identified by string names. When an intent is matched, any configured output contexts for that intent become active. While any contexts are active, Dialogflow is more likely to match intents that are configured with input contexts that correspond to the currently active contexts. For more information about context, see the [Contexts guide](https://cloud.google.com/dialogflow/docs/contexts-overview).",
"properties": {
"lifespanCount": {
"type": "integer",
"description": "Optional. The number of conversational query requests after which the context expires. The default is `0`. If set to `0`, the context expires immediately. Contexts expire automatically after 20 minutes if there are no matching queries.",
"format": "int32"
},
"name": {
"type": "string",
"description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`"
},
"parameters": {
"type": "object",
"additionalProperties": {
"description": "Properties of the object.",
"type": "any"
},
"description": "Optional. The collection of parameters associated with this context. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: string or number, depending on parameter value type - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value"
}
}
},
"GoogleCloudDialogflowCxV3beta1ResponseMessage": {
"description": "Represents a response message that can be returned by a conversational agent. Response messages are also used for output audio synthesis. The approach is as follows: * If at least one OutputAudioText response is present, then all OutputAudioText responses are linearly concatenated, and the result is used for output audio synthesis. * If the OutputAudioText responses are a mixture of text and SSML, then the concatenated result is treated as SSML; otherwise, the result is treated as either text or SSML as appropriate. The agent designer should ideally use either text or SSML consistently throughout the bot design. * Otherwise, all Text responses are linearly concatenated, and the result is used for output audio synthesis. This approach allows for more sophisticated user experience scenarios, where the text displayed to the user may differ from what is heard.",
"id": "GoogleCloudDialogflowCxV3beta1ResponseMessage",
"type": "object",
"properties": {
"liveAgentHandoff": {
"$ref": "GoogleCloudDialogflowCxV3beta1ResponseMessageLiveAgentHandoff",
"description": "Hands off conversation to a human agent."
},
"outputAudioText": {
"description": "A text or ssml response that is preferentially used for TTS output audio synthesis, as described in the comment on the ResponseMessage message.",
"$ref": "GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText"
},
"conversationSuccess": {
"description": "Indicates that the conversation succeeded.",
"$ref": "GoogleCloudDialogflowCxV3beta1ResponseMessageConversationSuccess"
},
"playAudio": {
"$ref": "GoogleCloudDialogflowCxV3beta1ResponseMessagePlayAudio",
"description": "Signal that the client should play an audio clip hosted at a client-specific URI. Dialogflow uses this to construct mixed_audio. However, Dialogflow itself does not try to read or process the URI in any way."
},
"payload": {
"type": "object",
"description": "Returns a response containing a custom, platform-specific payload.",
"additionalProperties": {
"type": "any",
"description": "Properties of the object."
}
},
"text": {
"$ref": "GoogleCloudDialogflowCxV3beta1ResponseMessageText",
"description": "Returns a text response."
},
"mixedAudio": {
"$ref": "GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudio",
"readOnly": true,
"description": "Output only. An audio response message composed of both the synthesized Dialogflow agent responses and responses defined via play_audio. This message is generated by Dialogflow only and not supposed to be defined by the user."
},
"endInteraction": {
"readOnly": true,
"$ref": "GoogleCloudDialogflowCxV3beta1ResponseMessageEndInteraction",
"description": "Output only. A signal that indicates the interaction with the Dialogflow agent has ended. This message is generated by Dialogflow only when the conversation reaches `END_SESSION` or `END_PAGE` page. It is not supposed to be defined by the user. It's guaranteed that there is at most one such message in each response."
}
}
},
"GoogleCloudDialogflowV2beta1IntentFollowupIntentInfo": {
"properties": {
"followupIntentName": {
"type": "string",
"description": "The unique identifier of the followup intent. Format: `projects//agent/intents/`."
},
"parentFollowupIntentName": {
"type": "string",
"description": "The unique identifier of the followup intent's parent. Format: `projects//agent/intents/`."
}
},
"type": "object",
"description": "Represents a single followup intent in the chain.",
"id": "GoogleCloudDialogflowV2beta1IntentFollowupIntentInfo"
},
"GoogleLongrunningOperation": {
"id": "GoogleLongrunningOperation",
"description": "This resource represents a long-running operation that is the result of a network API call.",
"properties": {
"error": {
"description": "The error result of the operation in case of failure or cancellation.",
"$ref": "GoogleRpcStatus"
},
"name": {
"description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.",
"type": "string"
},
"metadata": {
"additionalProperties": {
"type": "any",
"description": "Properties of the object. Contains field @type with type URL."
},
"description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.",
"type": "object"
},
"done": {
"type": "boolean",
"description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available."
},
"response": {
"description": "The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.",
"additionalProperties": {
"type": "any",
"description": "Properties of the object. Contains field @type with type URL."
},
"type": "object"
}
},
"type": "object"
},
"GoogleCloudDialogflowV2beta1IntentMessageSimpleResponse": {
"properties": {
"displayText": {
"type": "string",
"description": "Optional. The text to display."
},
"ssml": {
"description": "One of text_to_speech or ssml must be provided. Structured spoken response to the user in the SSML format. Mutually exclusive with text_to_speech.",
"type": "string"
},
"textToSpeech": {
"description": "One of text_to_speech or ssml must be provided. The plain text of the speech output. Mutually exclusive with ssml.",
"type": "string"
}
},
"type": "object",
"description": "The simple response message containing speech or text.",
"id": "GoogleCloudDialogflowV2beta1IntentMessageSimpleResponse"
},
"GoogleCloudDialogflowV2beta1IntentMessageColumnProperties": {
"type": "object",
"id": "GoogleCloudDialogflowV2beta1IntentMessageColumnProperties",
"description": "Column properties for TableCard.",
"properties": {
"header": {
"description": "Required. Column heading.",
"type": "string"
},
"horizontalAlignment": {
"description": "Optional. Defines text alignment for all cells in this column.",
"type": "string",
"enum": [
"HORIZONTAL_ALIGNMENT_UNSPECIFIED",
"LEADING",
"CENTER",
"TRAILING"
],
"enumDescriptions": [
"Text is aligned to the leading edge of the column.",
"Text is aligned to the leading edge of the column.",
"Text is centered in the column.",
"Text is aligned to the trailing edge of the column."
]
}
}
},
"GoogleCloudDialogflowV2IntentMessageQuickReplies": {
"id": "GoogleCloudDialogflowV2IntentMessageQuickReplies",
"type": "object",
"properties": {
"quickReplies": {
"type": "array",
"description": "Optional. The collection of quick replies.",
"items": {
"type": "string"
}
},
"title": {
"description": "Optional. The title of the collection of quick replies.",
"type": "string"
}
},
"description": "The quick replies response message."
},
"GoogleCloudDialogflowV2IntentMessageTableCardCell": {
"description": "Cell of TableCardRow.",
"properties": {
"text": {
"type": "string",
"description": "Required. Text in this cell."
}
},
"type": "object",
"id": "GoogleCloudDialogflowV2IntentMessageTableCardCell"
},
"GoogleRpcStatus": {
"description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).",
"properties": {
"code": {
"format": "int32",
"description": "The status code, which should be an enum value of google.rpc.Code.",
"type": "integer"
},
"details": {
"items": {
"additionalProperties": {
"type": "any",
"description": "Properties of the object. Contains field @type with type URL."
},
"type": "object"
},
"description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.",
"type": "array"
},
"message": {
"description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.",
"type": "string"
}
},
"id": "GoogleRpcStatus",
"type": "object"
},
"GoogleCloudDialogflowCxV3beta1WebhookRequestIntentInfo": {
"properties": {
"parameters": {
"additionalProperties": {
"$ref": "GoogleCloudDialogflowCxV3beta1WebhookRequestIntentInfoIntentParameterValue"
},
"description": "Parameters identified as a result of intent matching. This is a map of the name of the identified parameter to the value of the parameter identified from the user's utterance. All parameters defined in the matched intent that are identified will be surfaced here.",
"type": "object"
},
"lastMatchedIntent": {
"type": "string",
"description": "Always present. The unique identifier of the last matched intent. Format: `projects//locations//agents//intents/`."
}
},
"type": "object",
"id": "GoogleCloudDialogflowCxV3beta1WebhookRequestIntentInfo",
"description": "Represents intent information communicated to the webhook."
},
"GoogleCloudDialogflowV2IntentMessageCard": {
"description": "The card response message.",
"type": "object",
"id": "GoogleCloudDialogflowV2IntentMessageCard",
"properties": {
"buttons": {
"items": {
"$ref": "GoogleCloudDialogflowV2IntentMessageCardButton"
},
"description": "Optional. The collection of card buttons.",
"type": "array"
},
"imageUri": {
"type": "string",
"description": "Optional. The public URI to an image file for the card."
},
"subtitle": {
"description": "Optional. The subtitle of the card.",
"type": "string"
},
"title": {
"type": "string",
"description": "Optional. The title of the card."
}
}
},
"GoogleCloudDialogflowCxV3ResponseMessageEndInteraction": {
"properties": {},
"type": "object",
"id": "GoogleCloudDialogflowCxV3ResponseMessageEndInteraction",
"description": "Indicates that interaction with the Dialogflow agent has ended. This message is generated by Dialogflow only and not supposed to be defined by the user."
}
},
"parameters": {
"access_token": {
"location": "query",
"description": "OAuth access token.",
"type": "string"
},
"key": {
"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
"type": "string",
"location": "query"
},
"upload_protocol": {
"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
"location": "query",
"type": "string"
},
"uploadType": {
"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
"type": "string",
"location": "query"
},
"quotaUser": {
"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
"type": "string",
"location": "query"
},
"oauth_token": {
"location": "query",
"type": "string",
"description": "OAuth 2.0 token for the current user."
},
"fields": {
"description": "Selector specifying which fields to include in a partial response.",
"type": "string",
"location": "query"
},
"prettyPrint": {
"description": "Returns response with indentations and line breaks.",
"default": "true",
"type": "boolean",
"location": "query"
},
"$.xgafv": {
"enum": [
"1",
"2"
],
"description": "V1 error format.",
"enumDescriptions": [
"v1 error format",
"v2 error format"
],
"location": "query",
"type": "string"
},
"callback": {
"location": "query",
"type": "string",
"description": "JSONP"
},
"alt": {
"enum": [
"json",
"media",
"proto"
],
"enumDescriptions": [
"Responses with Content-Type of application/json",
"Media download with context-dependent Content-Type",
"Responses with Content-Type of application/x-protobuf"
],
"description": "Data format for response.",
"type": "string",
"default": "json",
"location": "query"
}
},
"batchPath": "batch",
"auth": {
"oauth2": {
"scopes": {
"https://www.googleapis.com/auth/dialogflow": {
"description": "View, manage and query your Dialogflow agents"
},
"https://www.googleapis.com/auth/cloud-platform": {
"description": "View and manage your data across Google Cloud Platform services"
}
}
}
},
"basePath": "",
"discoveryVersion": "v1",
"revision": "20201116"
}