type: google.api.Service
config_version: 3
name: dialogflow.googleapis.com
title: Dialogflow API

apis:
- name: google.cloud.dialogflow.v2beta1.Agents
- name: google.cloud.dialogflow.v2beta1.Contexts
- name: google.cloud.dialogflow.v2beta1.Documents
- name: google.cloud.dialogflow.v2beta1.EntityTypes
- name: google.cloud.dialogflow.v2beta1.Intents
- name: google.cloud.dialogflow.v2beta1.KnowledgeBases
- name: google.cloud.dialogflow.v2beta1.SessionEntityTypes
- name: google.cloud.dialogflow.v2beta1.Sessions

types:
- name: google.cloud.dialogflow.v2beta1.ExportAgentResponse
- name: google.cloud.dialogflow.v2beta1.BatchUpdateEntityTypesResponse
- name: google.cloud.dialogflow.v2beta1.BatchUpdateIntentsResponse
- name: google.cloud.dialogflow.v2beta1.KnowledgeOperationMetadata
- name: google.cloud.dialogflow.v2beta1.OriginalDetectIntentRequest
- name: google.cloud.dialogflow.v2beta1.WebhookRequest
- name: google.cloud.dialogflow.v2beta1.WebhookResponse

documentation:
  summary: |-
    An end-to-end development suite for conversational interfaces (e.g.,
    chatbots, voice-powered apps and devices).
  overview: |-
    [Dialogflow](http://dialogflow.com/) is a natural language understanding
    platform that makes it easy for you to design and integrate a conversational
    user interface into your mobile app, web application, device, bot, and so
    on. Using Dialogflow you can provide users new and engaging ways to interact
    with your product using both voice recognition and text input.

    For information on how Dialogflow agents, intents, entities, and so on work,
    see the [Dialogflow getting started
    guide](https://dialogflow.com/docs/getting-started/basics) in the
    dialogflow.com documentation.

    ## Dialogflow Editions

    Dialogflow is available in two editions: Standard and Enterprise. For
    information on the difference in Dialogflow editions, see [Dialogflow
    Editions](https://cloud.google.com/dialogflow-enterprise/docs/editions).

    ## The Dialogflow API

    The Dialogflow API provides a REST and gRPC API that you can use to
    incorporate the Dialogflow into your product. After you have created a
    Google Cloud project and a Dialogflow agent, you can use the API to create
    intents, entities, and so on, and then pass user input to your Dialogflow
    agent to determine user intent using the
    [detectIntent](https://cloud.google.com/dialogflow-enterprise/docs/reference/rest/v2beta1/projects.agent.sessions/detectIntent)
    REST API, or the
    [StreamingDetectIntentRequest](https://cloud.google.com/dialogflow-enterprise/docs/reference/rpc/google.cloud.dialogflow.v2beta1#google.cloud.dialogflow.v2beta1.StreamingDetectIntentRequest)
    gRPC API.

    ## Getting Started

    *   For information on setting up a Google Cloud Platform project and
    creating an agent using the Dialogflow Enterprise Edition, see
    [Quickstart](https://cloud.google.com/dialogflow-enterprise/docs/quickstart).

    *   For information on creating an agent using the Dialogflow Standard
    Edition, see [Building Your First
    Agent](https://dialogflow.com/docs/getting-started/building-your-first-agent)

backend:
  rules:
  - selector: google.longrunning.Operations.GetOperation
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Agents.GetAgent
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Agents.SearchAgents
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Agents.TrainAgent
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Agents.ExportAgent
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Agents.ImportAgent
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Agents.RestoreAgent
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Contexts.ListContexts
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Contexts.GetContext
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Contexts.CreateContext
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Contexts.UpdateContext
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Contexts.DeleteContext
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Contexts.DeleteAllContexts
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Documents.ListDocuments
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Documents.GetDocument
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Documents.CreateDocument
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Documents.DeleteDocument
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.EntityTypes.ListEntityTypes
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.EntityTypes.GetEntityType
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.EntityTypes.CreateEntityType
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.EntityTypes.UpdateEntityType
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.EntityTypes.DeleteEntityType
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.EntityTypes.BatchUpdateEntityTypes
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.EntityTypes.BatchDeleteEntityTypes
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.EntityTypes.BatchCreateEntities
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.EntityTypes.BatchUpdateEntities
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.EntityTypes.BatchDeleteEntities
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Intents.ListIntents
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Intents.GetIntent
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Intents.CreateIntent
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Intents.UpdateIntent
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Intents.DeleteIntent
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Intents.BatchUpdateIntents
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Intents.BatchDeleteIntents
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.KnowledgeBases.ListKnowledgeBases
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.KnowledgeBases.GetKnowledgeBase
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.KnowledgeBases.CreateKnowledgeBase
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.KnowledgeBases.DeleteKnowledgeBase
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.SessionEntityTypes.ListSessionEntityTypes
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.SessionEntityTypes.GetSessionEntityType
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.SessionEntityTypes.CreateSessionEntityType
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.SessionEntityTypes.UpdateSessionEntityType
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.SessionEntityTypes.DeleteSessionEntityType
    deadline: 60.0
  - selector: google.cloud.dialogflow.v2beta1.Sessions.DetectIntent
    deadline: 230.0
  - selector: google.cloud.dialogflow.v2beta1.Sessions.StreamingDetectIntent
    deadline: 230.0

http:
  rules:
  - selector: google.longrunning.Operations.GetOperation
    get: '/v2beta1/{name=projects/*/operations/*}'
    additional_bindings:
    - get: '/v2/{name=projects/*/operations/*}'


authentication:
  rules:
  - selector: '*'
    oauth:
      canonical_scopes: |-
        https://www.googleapis.com/auth/cloud-platform
