From 1ec8d2bd8e1ba7acbb22998d922ecf210ac3436a Mon Sep 17 00:00:00 2001 From: yoshi-automation Date: Wed, 5 Aug 2020 04:21:11 -0700 Subject: [PATCH] feat(dialogflow): update the API #### dialogflow:v2 The following keys were added: - resources.projects.resources.agent.resources.intents.methods.create.parameters.intentView.enumDescriptions - resources.projects.resources.agent.resources.intents.methods.get.parameters.intentView.enumDescriptions - resources.projects.resources.agent.resources.intents.methods.list.parameters.intentView.enumDescriptions - resources.projects.resources.agent.resources.intents.methods.patch.parameters.intentView.enumDescriptions - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessage.properties.endInteraction.readOnly - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessage.properties.mixedAudio.readOnly - schemas.GoogleCloudDialogflowV2Environment.properties.name.readOnly - schemas.GoogleCloudDialogflowV2Environment.properties.state.readOnly - schemas.GoogleCloudDialogflowV2Environment.properties.updateTime.readOnly - schemas.GoogleCloudDialogflowV2Intent.properties.defaultResponsePlatforms.items.enumDescriptions - schemas.GoogleCloudDialogflowV2Message.properties.createTime.readOnly - schemas.GoogleCloudDialogflowV2Message.properties.messageAnnotation.readOnly - schemas.GoogleCloudDialogflowV2Message.properties.participant.readOnly - schemas.GoogleCloudDialogflowV2Message.properties.participantRole.readOnly - schemas.GoogleCloudDialogflowV2beta1AnnotatedConversationDataset.properties.completedExampleCount.readOnly - schemas.GoogleCloudDialogflowV2beta1AnnotatedConversationDataset.properties.createTime.readOnly - schemas.GoogleCloudDialogflowV2beta1AnnotatedConversationDataset.properties.exampleCount.readOnly - schemas.GoogleCloudDialogflowV2beta1AnnotatedConversationDataset.properties.name.readOnly - schemas.GoogleCloudDialogflowV2beta1AnnotatedConversationDataset.properties.questionTypeName.readOnly - schemas.GoogleCloudDialogflowV2beta1Intent.properties.defaultResponsePlatforms.items.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1Intent.properties.followupIntentInfo.readOnly - schemas.GoogleCloudDialogflowV2beta1Intent.properties.rootFollowupIntentName.readOnly - schemas.GoogleCloudDialogflowV2beta1KnowledgeOperationMetadata.properties.state.readOnly The following keys were changed: - resources.projects.methods.deleteAgent.parameters.parent.description - resources.projects.methods.getAgent.parameters.parent.description - resources.projects.methods.setAgent.parameters.parent.description - resources.projects.resources.agent.methods.export.description - resources.projects.resources.agent.methods.export.parameters.parent.description - resources.projects.resources.agent.methods.getFulfillment.parameters.name.description - resources.projects.resources.agent.methods.getValidationResult.description - resources.projects.resources.agent.methods.getValidationResult.parameters.languageCode.description - resources.projects.resources.agent.methods.getValidationResult.parameters.parent.description - resources.projects.resources.agent.methods.import.description - resources.projects.resources.agent.methods.import.parameters.parent.description - resources.projects.resources.agent.methods.restore.description - resources.projects.resources.agent.methods.restore.parameters.parent.description - resources.projects.resources.agent.methods.search.description - resources.projects.resources.agent.methods.search.parameters.pageSize.description - resources.projects.resources.agent.methods.search.parameters.parent.description - resources.projects.resources.agent.methods.train.description - resources.projects.resources.agent.methods.train.parameters.parent.description - resources.projects.resources.agent.methods.updateFulfillment.parameters.name.description - resources.projects.resources.agent.methods.updateFulfillment.parameters.updateMask.description - resources.projects.resources.agent.resources.entityTypes.methods.batchDelete.description - resources.projects.resources.agent.resources.entityTypes.methods.batchDelete.parameters.parent.description - resources.projects.resources.agent.resources.entityTypes.methods.batchUpdate.description - resources.projects.resources.agent.resources.entityTypes.methods.batchUpdate.parameters.parent.description - resources.projects.resources.agent.resources.entityTypes.methods.create.parameters.languageCode.description - resources.projects.resources.agent.resources.entityTypes.methods.create.parameters.parent.description - resources.projects.resources.agent.resources.entityTypes.methods.delete.parameters.name.description - resources.projects.resources.agent.resources.entityTypes.methods.get.parameters.languageCode.description - resources.projects.resources.agent.resources.entityTypes.methods.get.parameters.name.description - resources.projects.resources.agent.resources.entityTypes.methods.list.parameters.languageCode.description - resources.projects.resources.agent.resources.entityTypes.methods.list.parameters.pageSize.description - resources.projects.resources.agent.resources.entityTypes.methods.list.parameters.parent.description - resources.projects.resources.agent.resources.entityTypes.methods.patch.parameters.languageCode.description - resources.projects.resources.agent.resources.entityTypes.methods.patch.parameters.name.description - resources.projects.resources.agent.resources.entityTypes.resources.entities.methods.batchCreate.description - resources.projects.resources.agent.resources.entityTypes.resources.entities.methods.batchCreate.parameters.parent.description - resources.projects.resources.agent.resources.entityTypes.resources.entities.methods.batchDelete.description - resources.projects.resources.agent.resources.entityTypes.resources.entities.methods.batchDelete.parameters.parent.description - resources.projects.resources.agent.resources.entityTypes.resources.entities.methods.batchUpdate.description - resources.projects.resources.agent.resources.entityTypes.resources.entities.methods.batchUpdate.parameters.parent.description - resources.projects.resources.agent.resources.environments.methods.list.parameters.pageSize.description - resources.projects.resources.agent.resources.environments.methods.list.parameters.parent.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.methods.deleteContexts.parameters.parent.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.methods.detectIntent.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.methods.detectIntent.parameters.session.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.contexts.methods.create.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.contexts.methods.create.parameters.parent.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.contexts.methods.delete.parameters.name.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.contexts.methods.get.parameters.name.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.contexts.methods.list.parameters.pageSize.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.contexts.methods.list.parameters.parent.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.contexts.methods.patch.parameters.name.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.create.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.create.parameters.parent.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.delete.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.delete.parameters.name.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.get.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.get.parameters.name.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.list.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.list.parameters.pageSize.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.list.parameters.parent.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.patch.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.patch.parameters.name.description - resources.projects.resources.agent.resources.intents.methods.batchDelete.description - resources.projects.resources.agent.resources.intents.methods.batchDelete.parameters.parent.description - resources.projects.resources.agent.resources.intents.methods.batchUpdate.description - resources.projects.resources.agent.resources.intents.methods.batchUpdate.parameters.parent.description - resources.projects.resources.agent.resources.intents.methods.create.parameters.languageCode.description - resources.projects.resources.agent.resources.intents.methods.create.parameters.parent.description - resources.projects.resources.agent.resources.intents.methods.delete.parameters.name.description - resources.projects.resources.agent.resources.intents.methods.get.parameters.languageCode.description - resources.projects.resources.agent.resources.intents.methods.get.parameters.name.description - resources.projects.resources.agent.resources.intents.methods.list.parameters.languageCode.description - resources.projects.resources.agent.resources.intents.methods.list.parameters.pageSize.description - resources.projects.resources.agent.resources.intents.methods.list.parameters.parent.description - resources.projects.resources.agent.resources.intents.methods.patch.parameters.languageCode.description - resources.projects.resources.agent.resources.intents.methods.patch.parameters.name.description - resources.projects.resources.agent.resources.sessions.methods.deleteContexts.parameters.parent.description - resources.projects.resources.agent.resources.sessions.methods.detectIntent.description - resources.projects.resources.agent.resources.sessions.methods.detectIntent.parameters.session.description - resources.projects.resources.agent.resources.sessions.resources.contexts.methods.create.description - resources.projects.resources.agent.resources.sessions.resources.contexts.methods.create.parameters.parent.description - resources.projects.resources.agent.resources.sessions.resources.contexts.methods.delete.parameters.name.description - resources.projects.resources.agent.resources.sessions.resources.contexts.methods.get.parameters.name.description - resources.projects.resources.agent.resources.sessions.resources.contexts.methods.list.parameters.pageSize.description - resources.projects.resources.agent.resources.sessions.resources.contexts.methods.list.parameters.parent.description - resources.projects.resources.agent.resources.sessions.resources.contexts.methods.patch.parameters.name.description - resources.projects.resources.agent.resources.sessions.resources.entityTypes.methods.create.description - resources.projects.resources.agent.resources.sessions.resources.entityTypes.methods.create.parameters.parent.description - resources.projects.resources.agent.resources.sessions.resources.entityTypes.methods.delete.description - resources.projects.resources.agent.resources.sessions.resources.entityTypes.methods.delete.parameters.name.description - resources.projects.resources.agent.resources.sessions.resources.entityTypes.methods.get.description - resources.projects.resources.agent.resources.sessions.resources.entityTypes.methods.get.parameters.name.description - resources.projects.resources.agent.resources.sessions.resources.entityTypes.methods.list.description - resources.projects.resources.agent.resources.sessions.resources.entityTypes.methods.list.parameters.pageSize.description - resources.projects.resources.agent.resources.sessions.resources.entityTypes.methods.list.parameters.parent.description - resources.projects.resources.agent.resources.sessions.resources.entityTypes.methods.patch.description - resources.projects.resources.agent.resources.sessions.resources.entityTypes.methods.patch.parameters.name.description - resources.projects.resources.locations.resources.operations.methods.cancel.description - resources.projects.resources.locations.resources.operations.methods.get.description - resources.projects.resources.locations.resources.operations.methods.list.description - resources.projects.resources.operations.methods.cancel.description - resources.projects.resources.operations.methods.get.description - resources.projects.resources.operations.methods.list.description - schemas.GoogleCloudDialogflowCxV3beta1ExportAgentResponse.properties.agentUri.description - schemas.GoogleCloudDialogflowCxV3beta1PageInfo.properties.currentPage.description - schemas.GoogleCloudDialogflowCxV3beta1PageInfo.properties.formInfo.description - schemas.GoogleCloudDialogflowCxV3beta1PageInfoFormInfo.properties.parameterInfo.description - schemas.GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo.properties.displayName.description - schemas.GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo.properties.justCollected.description - schemas.GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo.properties.required.description - schemas.GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo.properties.state.description - schemas.GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo.properties.state.enumDescriptions - schemas.GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo.properties.value.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessage.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessage.properties.endInteraction.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessage.properties.mixedAudio.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessage.properties.outputAudioText.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessage.properties.playAudio.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageConversationSuccess.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageEndInteraction.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageHumanAgentHandoff.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageHumanAgentHandoff.properties.metadata.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageLiveAgentHandoff.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageLiveAgentHandoff.properties.metadata.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudio.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudioSegment.properties.allowPlaybackInterruption.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudioSegment.properties.audio.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudioSegment.properties.uri.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText.properties.ssml.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessagePlayAudio.properties.allowPlaybackInterruption.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessagePlayAudio.properties.audioUri.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageText.properties.allowPlaybackInterruption.description - schemas.GoogleCloudDialogflowCxV3beta1SessionInfo.properties.parameters.description - schemas.GoogleCloudDialogflowCxV3beta1SessionInfo.properties.session.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookRequest.properties.detectIntentResponseId.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookRequest.properties.fulfillmentInfo.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookRequest.properties.messages.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookRequestFulfillmentInfo.properties.tag.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookRequestIntentInfo.properties.lastMatchedIntent.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookRequestIntentInfo.properties.parameters.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookRequestIntentInfoIntentParameterValue.properties.resolvedValue.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookResponse.properties.fulfillmentResponse.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookResponse.properties.pageInfo.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookResponse.properties.sessionInfo.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookResponse.properties.targetFlow.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookResponse.properties.targetPage.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookResponseFulfillmentResponse.properties.mergeBehavior.enumDescriptions - schemas.GoogleCloudDialogflowV2Agent.description - schemas.GoogleCloudDialogflowV2Agent.properties.apiVersion.description - schemas.GoogleCloudDialogflowV2Agent.properties.avatarUri.description - schemas.GoogleCloudDialogflowV2Agent.properties.classificationThreshold.description - schemas.GoogleCloudDialogflowV2Agent.properties.defaultLanguageCode.description - schemas.GoogleCloudDialogflowV2Agent.properties.description.description - schemas.GoogleCloudDialogflowV2Agent.properties.matchMode.enumDescriptions - schemas.GoogleCloudDialogflowV2Agent.properties.parent.description - schemas.GoogleCloudDialogflowV2Agent.properties.supportedLanguageCodes.description - schemas.GoogleCloudDialogflowV2Agent.properties.timeZone.description - schemas.GoogleCloudDialogflowV2AnnotatedMessagePart.description - schemas.GoogleCloudDialogflowV2AnnotatedMessagePart.properties.entityType.description - schemas.GoogleCloudDialogflowV2AnnotatedMessagePart.properties.formattedValue.description - schemas.GoogleCloudDialogflowV2BatchCreateEntitiesRequest.properties.languageCode.description - schemas.GoogleCloudDialogflowV2BatchDeleteEntitiesRequest.properties.entityValues.description - schemas.GoogleCloudDialogflowV2BatchDeleteEntitiesRequest.properties.languageCode.description - schemas.GoogleCloudDialogflowV2BatchDeleteEntityTypesRequest.properties.entityTypeNames.description - schemas.GoogleCloudDialogflowV2BatchDeleteIntentsRequest.properties.intents.description - schemas.GoogleCloudDialogflowV2BatchUpdateEntitiesRequest.properties.languageCode.description - schemas.GoogleCloudDialogflowV2BatchUpdateEntityTypesRequest.properties.entityTypeBatchUri.description - schemas.GoogleCloudDialogflowV2BatchUpdateEntityTypesRequest.properties.languageCode.description - schemas.GoogleCloudDialogflowV2BatchUpdateIntentsRequest.properties.intentBatchUri.description - schemas.GoogleCloudDialogflowV2BatchUpdateIntentsRequest.properties.languageCode.description - schemas.GoogleCloudDialogflowV2Context.description - schemas.GoogleCloudDialogflowV2Context.properties.lifespanCount.description - schemas.GoogleCloudDialogflowV2Context.properties.name.description - schemas.GoogleCloudDialogflowV2Context.properties.parameters.description - schemas.GoogleCloudDialogflowV2ConversationEvent.description - schemas.GoogleCloudDialogflowV2ConversationEvent.properties.conversation.description - schemas.GoogleCloudDialogflowV2ConversationEvent.properties.errorStatus.description - schemas.GoogleCloudDialogflowV2ConversationEvent.properties.type.enumDescriptions - schemas.GoogleCloudDialogflowV2DetectIntentRequest.properties.inputAudio.description - schemas.GoogleCloudDialogflowV2DetectIntentRequest.properties.outputAudioConfig.description - schemas.GoogleCloudDialogflowV2DetectIntentRequest.properties.outputAudioConfigMask.description - schemas.GoogleCloudDialogflowV2DetectIntentRequest.properties.queryInput.description - schemas.GoogleCloudDialogflowV2DetectIntentResponse.properties.outputAudio.description - schemas.GoogleCloudDialogflowV2DetectIntentResponse.properties.queryResult.description - schemas.GoogleCloudDialogflowV2DetectIntentResponse.properties.responseId.description - schemas.GoogleCloudDialogflowV2EntityType.description - schemas.GoogleCloudDialogflowV2EntityType.properties.autoExpansionMode.description - schemas.GoogleCloudDialogflowV2EntityType.properties.autoExpansionMode.enumDescriptions - schemas.GoogleCloudDialogflowV2EntityType.properties.kind.enumDescriptions - schemas.GoogleCloudDialogflowV2EntityType.properties.name.description - schemas.GoogleCloudDialogflowV2EntityTypeEntity.properties.synonyms.description - schemas.GoogleCloudDialogflowV2EntityTypeEntity.properties.value.description - schemas.GoogleCloudDialogflowV2Environment.description - schemas.GoogleCloudDialogflowV2Environment.properties.agentVersion.description - schemas.GoogleCloudDialogflowV2Environment.properties.description.description - schemas.GoogleCloudDialogflowV2Environment.properties.name.description - schemas.GoogleCloudDialogflowV2Environment.properties.state.description - schemas.GoogleCloudDialogflowV2Environment.properties.updateTime.description - schemas.GoogleCloudDialogflowV2EventInput.description - schemas.GoogleCloudDialogflowV2EventInput.properties.languageCode.description - schemas.GoogleCloudDialogflowV2EventInput.properties.parameters.description - schemas.GoogleCloudDialogflowV2ExportAgentRequest.properties.agentUri.description - schemas.GoogleCloudDialogflowV2ExportAgentResponse.properties.agentUri.description - schemas.GoogleCloudDialogflowV2Fulfillment.description - schemas.GoogleCloudDialogflowV2Fulfillment.properties.name.description - schemas.GoogleCloudDialogflowV2FulfillmentGenericWebService.description - schemas.GoogleCloudDialogflowV2FulfillmentGenericWebService.properties.isCloudFunction.description - schemas.GoogleCloudDialogflowV2FulfillmentGenericWebService.properties.uri.description - schemas.GoogleCloudDialogflowV2ImportAgentRequest.properties.agentUri.description - schemas.GoogleCloudDialogflowV2InputAudioConfig.properties.audioEncoding.enumDescriptions - schemas.GoogleCloudDialogflowV2InputAudioConfig.properties.enableWordInfo.description - schemas.GoogleCloudDialogflowV2InputAudioConfig.properties.languageCode.description - schemas.GoogleCloudDialogflowV2InputAudioConfig.properties.model.description - schemas.GoogleCloudDialogflowV2InputAudioConfig.properties.modelVariant.enumDescriptions - schemas.GoogleCloudDialogflowV2InputAudioConfig.properties.phraseHints.description - schemas.GoogleCloudDialogflowV2InputAudioConfig.properties.sampleRateHertz.description - schemas.GoogleCloudDialogflowV2InputAudioConfig.properties.singleUtterance.description - schemas.GoogleCloudDialogflowV2InputAudioConfig.properties.speechContexts.description - schemas.GoogleCloudDialogflowV2Intent.description - schemas.GoogleCloudDialogflowV2Intent.properties.action.description - schemas.GoogleCloudDialogflowV2Intent.properties.defaultResponsePlatforms.description - schemas.GoogleCloudDialogflowV2Intent.properties.defaultResponsePlatforms.enumDescriptions - schemas.GoogleCloudDialogflowV2Intent.properties.events.description - schemas.GoogleCloudDialogflowV2Intent.properties.followupIntentInfo.description - schemas.GoogleCloudDialogflowV2Intent.properties.inputContextNames.description - schemas.GoogleCloudDialogflowV2Intent.properties.messages.description - schemas.GoogleCloudDialogflowV2Intent.properties.mlDisabled.description - schemas.GoogleCloudDialogflowV2Intent.properties.name.description - schemas.GoogleCloudDialogflowV2Intent.properties.outputContexts.description - schemas.GoogleCloudDialogflowV2Intent.properties.parentFollowupIntentName.description - schemas.GoogleCloudDialogflowV2Intent.properties.priority.description - schemas.GoogleCloudDialogflowV2Intent.properties.resetContexts.description - schemas.GoogleCloudDialogflowV2Intent.properties.rootFollowupIntentName.description - schemas.GoogleCloudDialogflowV2Intent.properties.trainingPhrases.description - schemas.GoogleCloudDialogflowV2Intent.properties.webhookState.enumDescriptions - schemas.GoogleCloudDialogflowV2IntentFollowupIntentInfo.properties.followupIntentName.description - schemas.GoogleCloudDialogflowV2IntentFollowupIntentInfo.properties.parentFollowupIntentName.description - schemas.GoogleCloudDialogflowV2IntentMessage.description - schemas.GoogleCloudDialogflowV2IntentMessage.properties.platform.enumDescriptions - schemas.GoogleCloudDialogflowV2IntentMessageBrowseCarouselCard.description - schemas.GoogleCloudDialogflowV2IntentMessageBrowseCarouselCard.properties.imageDisplayOptions.description - schemas.GoogleCloudDialogflowV2IntentMessageBrowseCarouselCard.properties.imageDisplayOptions.enumDescriptions - schemas.GoogleCloudDialogflowV2IntentMessageBrowseCarouselCard.properties.items.description - schemas.GoogleCloudDialogflowV2IntentMessageBrowseCarouselCardBrowseCarouselCardItem.properties.description.description - schemas.GoogleCloudDialogflowV2IntentMessageBrowseCarouselCardBrowseCarouselCardItem.properties.footer.description - schemas.GoogleCloudDialogflowV2IntentMessageBrowseCarouselCardBrowseCarouselCardItemOpenUrlAction.properties.urlTypeHint.description - schemas.GoogleCloudDialogflowV2IntentMessageBrowseCarouselCardBrowseCarouselCardItemOpenUrlAction.properties.urlTypeHint.enumDescriptions - schemas.GoogleCloudDialogflowV2IntentMessageCardButton.properties.postback.description - schemas.GoogleCloudDialogflowV2IntentMessageImage.properties.accessibilityText.description - schemas.GoogleCloudDialogflowV2IntentMessageLinkOutSuggestion.description - schemas.GoogleCloudDialogflowV2IntentMessageLinkOutSuggestion.properties.uri.description - schemas.GoogleCloudDialogflowV2IntentMessageSelectItemInfo.description - schemas.GoogleCloudDialogflowV2IntentMessageSelectItemInfo.properties.key.description - schemas.GoogleCloudDialogflowV2IntentMessageSelectItemInfo.properties.synonyms.description - schemas.GoogleCloudDialogflowV2IntentMessageSimpleResponse.properties.ssml.description - schemas.GoogleCloudDialogflowV2IntentMessageSimpleResponse.properties.textToSpeech.description - schemas.GoogleCloudDialogflowV2IntentMessageSimpleResponses.description - schemas.GoogleCloudDialogflowV2IntentMessageSuggestion.description - schemas.GoogleCloudDialogflowV2IntentParameter.properties.defaultValue.description - schemas.GoogleCloudDialogflowV2IntentParameter.properties.entityTypeDisplayName.description - schemas.GoogleCloudDialogflowV2IntentParameter.properties.mandatory.description - schemas.GoogleCloudDialogflowV2IntentParameter.properties.prompts.description - schemas.GoogleCloudDialogflowV2IntentParameter.properties.value.description - schemas.GoogleCloudDialogflowV2IntentTrainingPhrase.properties.parts.description - schemas.GoogleCloudDialogflowV2IntentTrainingPhrase.properties.timesAddedCount.description - schemas.GoogleCloudDialogflowV2IntentTrainingPhrase.properties.type.enumDescriptions - schemas.GoogleCloudDialogflowV2IntentTrainingPhrasePart.properties.alias.description - schemas.GoogleCloudDialogflowV2IntentTrainingPhrasePart.properties.entityType.description - schemas.GoogleCloudDialogflowV2IntentTrainingPhrasePart.properties.userDefined.description - schemas.GoogleCloudDialogflowV2ListContextsResponse.properties.contexts.description - schemas.GoogleCloudDialogflowV2ListContextsResponse.properties.nextPageToken.description - schemas.GoogleCloudDialogflowV2ListEntityTypesResponse.properties.entityTypes.description - schemas.GoogleCloudDialogflowV2ListEntityTypesResponse.properties.nextPageToken.description - schemas.GoogleCloudDialogflowV2ListEnvironmentsResponse.properties.environments.description - schemas.GoogleCloudDialogflowV2ListEnvironmentsResponse.properties.nextPageToken.description - schemas.GoogleCloudDialogflowV2ListIntentsResponse.properties.intents.description - schemas.GoogleCloudDialogflowV2ListIntentsResponse.properties.nextPageToken.description - schemas.GoogleCloudDialogflowV2ListSessionEntityTypesResponse.properties.nextPageToken.description - schemas.GoogleCloudDialogflowV2ListSessionEntityTypesResponse.properties.sessionEntityTypes.description - schemas.GoogleCloudDialogflowV2Message.properties.languageCode.description - schemas.GoogleCloudDialogflowV2Message.properties.name.description - schemas.GoogleCloudDialogflowV2Message.properties.participantRole.enumDescriptions - schemas.GoogleCloudDialogflowV2MessageAnnotation.properties.parts.description - schemas.GoogleCloudDialogflowV2OriginalDetectIntentRequest.description - schemas.GoogleCloudDialogflowV2OriginalDetectIntentRequest.properties.payload.description - schemas.GoogleCloudDialogflowV2OriginalDetectIntentRequest.properties.source.description - schemas.GoogleCloudDialogflowV2OriginalDetectIntentRequest.properties.version.description - schemas.GoogleCloudDialogflowV2OutputAudioConfig.description - schemas.GoogleCloudDialogflowV2OutputAudioConfig.properties.audioEncoding.enumDescriptions - schemas.GoogleCloudDialogflowV2OutputAudioConfig.properties.sampleRateHertz.description - schemas.GoogleCloudDialogflowV2QueryInput.description - schemas.GoogleCloudDialogflowV2QueryParameters.properties.contexts.description - schemas.GoogleCloudDialogflowV2QueryParameters.properties.payload.description - schemas.GoogleCloudDialogflowV2QueryParameters.properties.resetContexts.description - schemas.GoogleCloudDialogflowV2QueryParameters.properties.sentimentAnalysisRequestConfig.description - schemas.GoogleCloudDialogflowV2QueryParameters.properties.sessionEntityTypes.description - schemas.GoogleCloudDialogflowV2QueryParameters.properties.timeZone.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.allRequiredParamsPresent.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.diagnosticInfo.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.fulfillmentText.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.intent.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.intentDetectionConfidence.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.languageCode.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.outputContexts.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.parameters.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.queryText.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.sentimentAnalysisResult.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.speechRecognitionConfidence.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.webhookPayload.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.webhookSource.description - schemas.GoogleCloudDialogflowV2RestoreAgentRequest.properties.agentUri.description - schemas.GoogleCloudDialogflowV2SearchAgentsResponse.properties.agents.description - schemas.GoogleCloudDialogflowV2SearchAgentsResponse.properties.nextPageToken.description - schemas.GoogleCloudDialogflowV2Sentiment.description - schemas.GoogleCloudDialogflowV2Sentiment.properties.magnitude.description - schemas.GoogleCloudDialogflowV2Sentiment.properties.score.description - schemas.GoogleCloudDialogflowV2SentimentAnalysisRequestConfig.properties.analyzeQueryTextSentiment.description - schemas.GoogleCloudDialogflowV2SentimentAnalysisResult.description - schemas.GoogleCloudDialogflowV2SessionEntityType.description - schemas.GoogleCloudDialogflowV2SessionEntityType.properties.entities.description - schemas.GoogleCloudDialogflowV2SessionEntityType.properties.entityOverrideMode.description - schemas.GoogleCloudDialogflowV2SessionEntityType.properties.entityOverrideMode.enumDescriptions - schemas.GoogleCloudDialogflowV2SessionEntityType.properties.name.description - schemas.GoogleCloudDialogflowV2SpeechContext.description - schemas.GoogleCloudDialogflowV2SpeechContext.properties.boost.description - schemas.GoogleCloudDialogflowV2SpeechContext.properties.phrases.description - schemas.GoogleCloudDialogflowV2SynthesizeSpeechConfig.properties.effectsProfileId.description - schemas.GoogleCloudDialogflowV2SynthesizeSpeechConfig.properties.pitch.description - schemas.GoogleCloudDialogflowV2SynthesizeSpeechConfig.properties.speakingRate.description - schemas.GoogleCloudDialogflowV2SynthesizeSpeechConfig.properties.volumeGainDb.description - schemas.GoogleCloudDialogflowV2TextInput.properties.languageCode.description - schemas.GoogleCloudDialogflowV2TextInput.properties.text.description - schemas.GoogleCloudDialogflowV2ValidationError.properties.entries.description - schemas.GoogleCloudDialogflowV2VoiceSelectionParams.properties.name.description - schemas.GoogleCloudDialogflowV2VoiceSelectionParams.properties.ssmlGender.description - schemas.GoogleCloudDialogflowV2VoiceSelectionParams.properties.ssmlGender.enumDescriptions - schemas.GoogleCloudDialogflowV2WebhookRequest.properties.originalDetectIntentRequest.description - schemas.GoogleCloudDialogflowV2WebhookRequest.properties.queryResult.description - schemas.GoogleCloudDialogflowV2WebhookRequest.properties.responseId.description - schemas.GoogleCloudDialogflowV2WebhookRequest.properties.session.description - schemas.GoogleCloudDialogflowV2WebhookResponse.description - schemas.GoogleCloudDialogflowV2WebhookResponse.properties.followupEventInput.description - schemas.GoogleCloudDialogflowV2WebhookResponse.properties.fulfillmentMessages.description - schemas.GoogleCloudDialogflowV2WebhookResponse.properties.fulfillmentText.description - schemas.GoogleCloudDialogflowV2WebhookResponse.properties.outputContexts.description - schemas.GoogleCloudDialogflowV2WebhookResponse.properties.payload.description - schemas.GoogleCloudDialogflowV2WebhookResponse.properties.sessionEntityTypes.description - schemas.GoogleCloudDialogflowV2WebhookResponse.properties.source.description - schemas.GoogleCloudDialogflowV2beta1AnnotatedConversationDataset.description - schemas.GoogleCloudDialogflowV2beta1AnnotatedConversationDataset.properties.completedExampleCount.description - schemas.GoogleCloudDialogflowV2beta1AnnotatedConversationDataset.properties.description.description - schemas.GoogleCloudDialogflowV2beta1AnnotatedConversationDataset.properties.displayName.description - schemas.GoogleCloudDialogflowV2beta1AnnotatedConversationDataset.properties.name.description - schemas.GoogleCloudDialogflowV2beta1AnnotatedConversationDataset.properties.questionTypeName.description - schemas.GoogleCloudDialogflowV2beta1Context.description - schemas.GoogleCloudDialogflowV2beta1Context.properties.lifespanCount.description - schemas.GoogleCloudDialogflowV2beta1Context.properties.name.description - schemas.GoogleCloudDialogflowV2beta1Context.properties.parameters.description - schemas.GoogleCloudDialogflowV2beta1EntityType.description - schemas.GoogleCloudDialogflowV2beta1EntityType.properties.autoExpansionMode.description - schemas.GoogleCloudDialogflowV2beta1EntityType.properties.autoExpansionMode.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1EntityType.properties.kind.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1EntityType.properties.name.description - schemas.GoogleCloudDialogflowV2beta1EntityTypeEntity.properties.synonyms.description - schemas.GoogleCloudDialogflowV2beta1EntityTypeEntity.properties.value.description - schemas.GoogleCloudDialogflowV2beta1EventInput.description - schemas.GoogleCloudDialogflowV2beta1EventInput.properties.languageCode.description - schemas.GoogleCloudDialogflowV2beta1EventInput.properties.parameters.description - schemas.GoogleCloudDialogflowV2beta1ExportAgentResponse.properties.agentUri.description - schemas.GoogleCloudDialogflowV2beta1Intent.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.action.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.defaultResponsePlatforms.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.defaultResponsePlatforms.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1Intent.properties.endInteraction.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.events.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.followupIntentInfo.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.inputContextNames.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.messages.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.mlDisabled.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.mlEnabled.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.name.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.outputContexts.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.parentFollowupIntentName.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.priority.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.resetContexts.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.rootFollowupIntentName.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.trainingPhrases.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.webhookState.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1IntentFollowupIntentInfo.properties.followupIntentName.description - schemas.GoogleCloudDialogflowV2beta1IntentFollowupIntentInfo.properties.parentFollowupIntentName.description - schemas.GoogleCloudDialogflowV2beta1IntentMessage.properties.platform.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1IntentMessage.properties.rbmText.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCard.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCard.properties.imageDisplayOptions.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCard.properties.imageDisplayOptions.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCard.properties.items.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCardBrowseCarouselCardItem.properties.description.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCardBrowseCarouselCardItem.properties.footer.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCardBrowseCarouselCardItemOpenUrlAction.properties.urlTypeHint.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCardBrowseCarouselCardItemOpenUrlAction.properties.urlTypeHint.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1IntentMessageCardButton.properties.postback.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageImage.properties.accessibilityText.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageLinkOutSuggestion.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageLinkOutSuggestion.properties.uri.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmCardContent.properties.description.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmCardContent.properties.media.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmCardContent.properties.title.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia.properties.fileUri.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia.properties.height.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia.properties.height.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia.properties.thumbnailUri.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmCarouselCard.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmCarouselCard.properties.cardContents.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmStandaloneCard.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmStandaloneCard.properties.thumbnailImageAlignment.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedAction.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedAction.properties.postbackData.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionDial.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionDial.properties.phoneNumber.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionOpenUri.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionShareLocation.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedReply.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedReply.properties.postbackData.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestion.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageSelectItemInfo.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageSelectItemInfo.properties.key.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageSelectItemInfo.properties.synonyms.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageSimpleResponse.properties.ssml.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageSimpleResponse.properties.textToSpeech.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageSimpleResponses.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageSuggestion.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageTelephonyPlayAudio.properties.audioUri.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech.properties.ssml.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageTelephonyTransferCall.properties.phoneNumber.description - schemas.GoogleCloudDialogflowV2beta1IntentParameter.properties.defaultValue.description - schemas.GoogleCloudDialogflowV2beta1IntentParameter.properties.entityTypeDisplayName.description - schemas.GoogleCloudDialogflowV2beta1IntentParameter.properties.mandatory.description - schemas.GoogleCloudDialogflowV2beta1IntentParameter.properties.prompts.description - schemas.GoogleCloudDialogflowV2beta1IntentParameter.properties.value.description - schemas.GoogleCloudDialogflowV2beta1IntentTrainingPhrase.properties.parts.description - schemas.GoogleCloudDialogflowV2beta1IntentTrainingPhrase.properties.timesAddedCount.description - schemas.GoogleCloudDialogflowV2beta1IntentTrainingPhrase.properties.type.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1IntentTrainingPhrasePart.properties.alias.description - schemas.GoogleCloudDialogflowV2beta1IntentTrainingPhrasePart.properties.entityType.description - schemas.GoogleCloudDialogflowV2beta1IntentTrainingPhrasePart.properties.userDefined.description - schemas.GoogleCloudDialogflowV2beta1KnowledgeAnswersAnswer.properties.answer.description - schemas.GoogleCloudDialogflowV2beta1KnowledgeAnswersAnswer.properties.faqQuestion.description - schemas.GoogleCloudDialogflowV2beta1KnowledgeAnswersAnswer.properties.matchConfidence.description - schemas.GoogleCloudDialogflowV2beta1KnowledgeAnswersAnswer.properties.matchConfidenceLevel.description - schemas.GoogleCloudDialogflowV2beta1KnowledgeAnswersAnswer.properties.source.description - schemas.GoogleCloudDialogflowV2beta1LabelConversationResponse.description - schemas.GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest.description - schemas.GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest.properties.payload.description - schemas.GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest.properties.source.description - schemas.GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest.properties.version.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.allRequiredParamsPresent.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.diagnosticInfo.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.fulfillmentText.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.intent.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.intentDetectionConfidence.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.knowledgeAnswers.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.languageCode.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.outputContexts.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.parameters.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.queryText.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.sentimentAnalysisResult.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.speechRecognitionConfidence.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.webhookPayload.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.webhookSource.description - schemas.GoogleCloudDialogflowV2beta1Sentiment.description - schemas.GoogleCloudDialogflowV2beta1Sentiment.properties.magnitude.description - schemas.GoogleCloudDialogflowV2beta1Sentiment.properties.score.description - schemas.GoogleCloudDialogflowV2beta1SentimentAnalysisResult.description - schemas.GoogleCloudDialogflowV2beta1SessionEntityType.description - schemas.GoogleCloudDialogflowV2beta1SessionEntityType.properties.entities.description - schemas.GoogleCloudDialogflowV2beta1SessionEntityType.properties.entityOverrideMode.description - schemas.GoogleCloudDialogflowV2beta1SessionEntityType.properties.entityOverrideMode.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1SessionEntityType.properties.name.description - schemas.GoogleCloudDialogflowV2beta1WebhookRequest.properties.originalDetectIntentRequest.description - schemas.GoogleCloudDialogflowV2beta1WebhookRequest.properties.queryResult.description - schemas.GoogleCloudDialogflowV2beta1WebhookRequest.properties.responseId.description - schemas.GoogleCloudDialogflowV2beta1WebhookRequest.properties.session.description - schemas.GoogleCloudDialogflowV2beta1WebhookResponse.description - schemas.GoogleCloudDialogflowV2beta1WebhookResponse.properties.endInteraction.description - schemas.GoogleCloudDialogflowV2beta1WebhookResponse.properties.followupEventInput.description - schemas.GoogleCloudDialogflowV2beta1WebhookResponse.properties.fulfillmentMessages.description - schemas.GoogleCloudDialogflowV2beta1WebhookResponse.properties.fulfillmentText.description - schemas.GoogleCloudDialogflowV2beta1WebhookResponse.properties.outputContexts.description - schemas.GoogleCloudDialogflowV2beta1WebhookResponse.properties.payload.description - schemas.GoogleCloudDialogflowV2beta1WebhookResponse.properties.sessionEntityTypes.description - schemas.GoogleCloudDialogflowV2beta1WebhookResponse.properties.source.description - schemas.GoogleCloudDialogflowV3alpha1ExportAgentResponse.properties.agentUri.description - schemas.GoogleLongrunningOperation.description - schemas.GoogleLongrunningOperation.properties.done.description - schemas.GoogleLongrunningOperation.properties.metadata.description - schemas.GoogleLongrunningOperation.properties.name.description - schemas.GoogleLongrunningOperation.properties.response.description - schemas.GoogleProtobufEmpty.description - schemas.GoogleRpcStatus.description - schemas.GoogleRpcStatus.properties.details.description - schemas.GoogleRpcStatus.properties.message.description - schemas.GoogleTypeLatLng.description #### dialogflow:v2beta1 The following keys were added: - resources.projects.resources.agent.resources.intents.methods.create.parameters.intentView.enumDescriptions - resources.projects.resources.agent.resources.intents.methods.get.parameters.intentView.enumDescriptions - resources.projects.resources.agent.resources.intents.methods.list.parameters.intentView.enumDescriptions - resources.projects.resources.agent.resources.intents.methods.patch.parameters.intentView.enumDescriptions - resources.projects.resources.locations.resources.agent.resources.intents.methods.create.parameters.intentView.enumDescriptions - resources.projects.resources.locations.resources.agent.resources.intents.methods.get.parameters.intentView.enumDescriptions - resources.projects.resources.locations.resources.agent.resources.intents.methods.list.parameters.intentView.enumDescriptions - resources.projects.resources.locations.resources.agent.resources.intents.methods.patch.parameters.intentView.enumDescriptions - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessage.properties.endInteraction.readOnly - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessage.properties.mixedAudio.readOnly - schemas.GoogleCloudDialogflowV2Intent.properties.defaultResponsePlatforms.items.enumDescriptions - schemas.GoogleCloudDialogflowV2Message.properties.createTime.readOnly - schemas.GoogleCloudDialogflowV2Message.properties.messageAnnotation.readOnly - schemas.GoogleCloudDialogflowV2Message.properties.participant.readOnly - schemas.GoogleCloudDialogflowV2Message.properties.participantRole.readOnly - schemas.GoogleCloudDialogflowV2beta1AnnotatedConversationDataset.properties.completedExampleCount.readOnly - schemas.GoogleCloudDialogflowV2beta1AnnotatedConversationDataset.properties.createTime.readOnly - schemas.GoogleCloudDialogflowV2beta1AnnotatedConversationDataset.properties.exampleCount.readOnly - schemas.GoogleCloudDialogflowV2beta1AnnotatedConversationDataset.properties.name.readOnly - schemas.GoogleCloudDialogflowV2beta1AnnotatedConversationDataset.properties.questionTypeName.readOnly - schemas.GoogleCloudDialogflowV2beta1Document.properties.knowledgeTypes.items.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1Document.properties.latestReloadStatus.readOnly - schemas.GoogleCloudDialogflowV2beta1Environment.properties.name.readOnly - schemas.GoogleCloudDialogflowV2beta1Environment.properties.state.readOnly - schemas.GoogleCloudDialogflowV2beta1Environment.properties.updateTime.readOnly - schemas.GoogleCloudDialogflowV2beta1Intent.properties.defaultResponsePlatforms.items.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1Intent.properties.followupIntentInfo.readOnly - schemas.GoogleCloudDialogflowV2beta1Intent.properties.rootFollowupIntentName.readOnly - schemas.GoogleCloudDialogflowV2beta1KnowledgeOperationMetadata.properties.state.readOnly The following keys were changed: - resources.projects.methods.deleteAgent.parameters.parent.description - resources.projects.methods.getAgent.parameters.parent.description - resources.projects.methods.setAgent.parameters.parent.description - resources.projects.resources.agent.methods.export.description - resources.projects.resources.agent.methods.export.parameters.parent.description - resources.projects.resources.agent.methods.getFulfillment.parameters.name.description - resources.projects.resources.agent.methods.getValidationResult.description - resources.projects.resources.agent.methods.getValidationResult.parameters.languageCode.description - resources.projects.resources.agent.methods.getValidationResult.parameters.parent.description - resources.projects.resources.agent.methods.import.description - resources.projects.resources.agent.methods.import.parameters.parent.description - resources.projects.resources.agent.methods.restore.description - resources.projects.resources.agent.methods.restore.parameters.parent.description - resources.projects.resources.agent.methods.search.description - resources.projects.resources.agent.methods.search.parameters.pageSize.description - resources.projects.resources.agent.methods.search.parameters.parent.description - resources.projects.resources.agent.methods.train.description - resources.projects.resources.agent.methods.train.parameters.parent.description - resources.projects.resources.agent.methods.updateFulfillment.parameters.name.description - resources.projects.resources.agent.methods.updateFulfillment.parameters.updateMask.description - resources.projects.resources.agent.resources.entityTypes.methods.batchDelete.description - resources.projects.resources.agent.resources.entityTypes.methods.batchDelete.parameters.parent.description - resources.projects.resources.agent.resources.entityTypes.methods.batchUpdate.description - resources.projects.resources.agent.resources.entityTypes.methods.batchUpdate.parameters.parent.description - resources.projects.resources.agent.resources.entityTypes.methods.create.parameters.languageCode.description - resources.projects.resources.agent.resources.entityTypes.methods.create.parameters.parent.description - resources.projects.resources.agent.resources.entityTypes.methods.delete.parameters.name.description - resources.projects.resources.agent.resources.entityTypes.methods.get.parameters.languageCode.description - resources.projects.resources.agent.resources.entityTypes.methods.get.parameters.name.description - resources.projects.resources.agent.resources.entityTypes.methods.list.parameters.languageCode.description - resources.projects.resources.agent.resources.entityTypes.methods.list.parameters.pageSize.description - resources.projects.resources.agent.resources.entityTypes.methods.list.parameters.parent.description - resources.projects.resources.agent.resources.entityTypes.methods.patch.parameters.languageCode.description - resources.projects.resources.agent.resources.entityTypes.methods.patch.parameters.name.description - resources.projects.resources.agent.resources.entityTypes.resources.entities.methods.batchCreate.description - resources.projects.resources.agent.resources.entityTypes.resources.entities.methods.batchCreate.parameters.parent.description - resources.projects.resources.agent.resources.entityTypes.resources.entities.methods.batchDelete.description - resources.projects.resources.agent.resources.entityTypes.resources.entities.methods.batchDelete.parameters.parent.description - resources.projects.resources.agent.resources.entityTypes.resources.entities.methods.batchUpdate.description - resources.projects.resources.agent.resources.entityTypes.resources.entities.methods.batchUpdate.parameters.parent.description - resources.projects.resources.agent.resources.environments.methods.list.parameters.pageSize.description - resources.projects.resources.agent.resources.environments.methods.list.parameters.parent.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.methods.deleteContexts.parameters.parent.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.methods.detectIntent.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.methods.detectIntent.parameters.session.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.contexts.methods.create.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.contexts.methods.create.parameters.parent.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.contexts.methods.delete.parameters.name.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.contexts.methods.get.parameters.name.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.contexts.methods.list.parameters.pageSize.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.contexts.methods.list.parameters.parent.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.contexts.methods.patch.parameters.name.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.create.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.create.parameters.parent.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.delete.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.delete.parameters.name.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.get.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.get.parameters.name.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.list.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.list.parameters.pageSize.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.list.parameters.parent.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.patch.description - resources.projects.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.patch.parameters.name.description - resources.projects.resources.agent.resources.intents.methods.batchDelete.description - resources.projects.resources.agent.resources.intents.methods.batchDelete.parameters.parent.description - resources.projects.resources.agent.resources.intents.methods.batchUpdate.description - resources.projects.resources.agent.resources.intents.methods.batchUpdate.parameters.parent.description - resources.projects.resources.agent.resources.intents.methods.create.parameters.languageCode.description - resources.projects.resources.agent.resources.intents.methods.create.parameters.parent.description - resources.projects.resources.agent.resources.intents.methods.delete.parameters.name.description - resources.projects.resources.agent.resources.intents.methods.get.parameters.languageCode.description - resources.projects.resources.agent.resources.intents.methods.get.parameters.name.description - resources.projects.resources.agent.resources.intents.methods.list.parameters.languageCode.description - resources.projects.resources.agent.resources.intents.methods.list.parameters.pageSize.description - resources.projects.resources.agent.resources.intents.methods.list.parameters.parent.description - resources.projects.resources.agent.resources.intents.methods.patch.parameters.languageCode.description - resources.projects.resources.agent.resources.intents.methods.patch.parameters.name.description - resources.projects.resources.agent.resources.knowledgeBases.methods.create.description - resources.projects.resources.agent.resources.knowledgeBases.methods.create.parameters.parent.description - resources.projects.resources.agent.resources.knowledgeBases.methods.delete.description - resources.projects.resources.agent.resources.knowledgeBases.methods.delete.parameters.force.description - resources.projects.resources.agent.resources.knowledgeBases.methods.delete.parameters.name.description - resources.projects.resources.agent.resources.knowledgeBases.methods.get.description - resources.projects.resources.agent.resources.knowledgeBases.methods.get.parameters.name.description - resources.projects.resources.agent.resources.knowledgeBases.methods.list.description - resources.projects.resources.agent.resources.knowledgeBases.methods.list.parameters.pageSize.description - resources.projects.resources.agent.resources.knowledgeBases.methods.list.parameters.parent.description - resources.projects.resources.agent.resources.knowledgeBases.methods.patch.description - resources.projects.resources.agent.resources.knowledgeBases.methods.patch.parameters.name.description - resources.projects.resources.agent.resources.knowledgeBases.methods.patch.parameters.updateMask.description - resources.projects.resources.agent.resources.knowledgeBases.resources.documents.methods.create.description - resources.projects.resources.agent.resources.knowledgeBases.resources.documents.methods.create.parameters.parent.description - resources.projects.resources.agent.resources.knowledgeBases.resources.documents.methods.delete.description - resources.projects.resources.agent.resources.knowledgeBases.resources.documents.methods.delete.parameters.name.description - resources.projects.resources.agent.resources.knowledgeBases.resources.documents.methods.get.description - resources.projects.resources.agent.resources.knowledgeBases.resources.documents.methods.get.parameters.name.description - resources.projects.resources.agent.resources.knowledgeBases.resources.documents.methods.list.description - resources.projects.resources.agent.resources.knowledgeBases.resources.documents.methods.list.parameters.pageSize.description - resources.projects.resources.agent.resources.knowledgeBases.resources.documents.methods.list.parameters.parent.description - resources.projects.resources.agent.resources.knowledgeBases.resources.documents.methods.patch.description - resources.projects.resources.agent.resources.knowledgeBases.resources.documents.methods.patch.parameters.name.description - resources.projects.resources.agent.resources.knowledgeBases.resources.documents.methods.patch.parameters.updateMask.description - resources.projects.resources.agent.resources.knowledgeBases.resources.documents.methods.reload.description - resources.projects.resources.agent.resources.knowledgeBases.resources.documents.methods.reload.parameters.name.description - resources.projects.resources.agent.resources.sessions.methods.deleteContexts.parameters.parent.description - resources.projects.resources.agent.resources.sessions.methods.detectIntent.description - resources.projects.resources.agent.resources.sessions.methods.detectIntent.parameters.session.description - resources.projects.resources.agent.resources.sessions.resources.contexts.methods.create.description - resources.projects.resources.agent.resources.sessions.resources.contexts.methods.create.parameters.parent.description - resources.projects.resources.agent.resources.sessions.resources.contexts.methods.delete.parameters.name.description - resources.projects.resources.agent.resources.sessions.resources.contexts.methods.get.parameters.name.description - resources.projects.resources.agent.resources.sessions.resources.contexts.methods.list.parameters.pageSize.description - resources.projects.resources.agent.resources.sessions.resources.contexts.methods.list.parameters.parent.description - resources.projects.resources.agent.resources.sessions.resources.contexts.methods.patch.parameters.name.description - resources.projects.resources.agent.resources.sessions.resources.entityTypes.methods.create.description - resources.projects.resources.agent.resources.sessions.resources.entityTypes.methods.create.parameters.parent.description - resources.projects.resources.agent.resources.sessions.resources.entityTypes.methods.delete.description - resources.projects.resources.agent.resources.sessions.resources.entityTypes.methods.delete.parameters.name.description - resources.projects.resources.agent.resources.sessions.resources.entityTypes.methods.get.description - resources.projects.resources.agent.resources.sessions.resources.entityTypes.methods.get.parameters.name.description - resources.projects.resources.agent.resources.sessions.resources.entityTypes.methods.list.description - resources.projects.resources.agent.resources.sessions.resources.entityTypes.methods.list.parameters.pageSize.description - resources.projects.resources.agent.resources.sessions.resources.entityTypes.methods.list.parameters.parent.description - resources.projects.resources.agent.resources.sessions.resources.entityTypes.methods.patch.description - resources.projects.resources.agent.resources.sessions.resources.entityTypes.methods.patch.parameters.name.description - resources.projects.resources.knowledgeBases.methods.create.description - resources.projects.resources.knowledgeBases.methods.create.parameters.parent.description - resources.projects.resources.knowledgeBases.methods.delete.description - resources.projects.resources.knowledgeBases.methods.delete.parameters.force.description - resources.projects.resources.knowledgeBases.methods.delete.parameters.name.description - resources.projects.resources.knowledgeBases.methods.get.description - resources.projects.resources.knowledgeBases.methods.get.parameters.name.description - resources.projects.resources.knowledgeBases.methods.list.description - resources.projects.resources.knowledgeBases.methods.list.parameters.pageSize.description - resources.projects.resources.knowledgeBases.methods.list.parameters.parent.description - resources.projects.resources.knowledgeBases.methods.patch.description - resources.projects.resources.knowledgeBases.methods.patch.parameters.name.description - resources.projects.resources.knowledgeBases.methods.patch.parameters.updateMask.description - resources.projects.resources.knowledgeBases.resources.documents.methods.create.description - resources.projects.resources.knowledgeBases.resources.documents.methods.create.parameters.parent.description - resources.projects.resources.knowledgeBases.resources.documents.methods.delete.description - resources.projects.resources.knowledgeBases.resources.documents.methods.delete.parameters.name.description - resources.projects.resources.knowledgeBases.resources.documents.methods.get.description - resources.projects.resources.knowledgeBases.resources.documents.methods.get.parameters.name.description - resources.projects.resources.knowledgeBases.resources.documents.methods.list.description - resources.projects.resources.knowledgeBases.resources.documents.methods.list.parameters.pageSize.description - resources.projects.resources.knowledgeBases.resources.documents.methods.list.parameters.parent.description - resources.projects.resources.knowledgeBases.resources.documents.methods.patch.description - resources.projects.resources.knowledgeBases.resources.documents.methods.patch.parameters.name.description - resources.projects.resources.knowledgeBases.resources.documents.methods.patch.parameters.updateMask.description - resources.projects.resources.knowledgeBases.resources.documents.methods.reload.description - resources.projects.resources.knowledgeBases.resources.documents.methods.reload.parameters.name.description - resources.projects.resources.locations.methods.deleteAgent.parameters.parent.description - resources.projects.resources.locations.methods.getAgent.parameters.parent.description - resources.projects.resources.locations.methods.setAgent.parameters.parent.description - resources.projects.resources.locations.resources.agent.methods.export.description - resources.projects.resources.locations.resources.agent.methods.export.parameters.parent.description - resources.projects.resources.locations.resources.agent.methods.getFulfillment.parameters.name.description - resources.projects.resources.locations.resources.agent.methods.import.description - resources.projects.resources.locations.resources.agent.methods.import.parameters.parent.description - resources.projects.resources.locations.resources.agent.methods.restore.description - resources.projects.resources.locations.resources.agent.methods.restore.parameters.parent.description - resources.projects.resources.locations.resources.agent.methods.search.description - resources.projects.resources.locations.resources.agent.methods.search.parameters.pageSize.description - resources.projects.resources.locations.resources.agent.methods.search.parameters.parent.description - resources.projects.resources.locations.resources.agent.methods.train.description - resources.projects.resources.locations.resources.agent.methods.train.parameters.parent.description - resources.projects.resources.locations.resources.agent.methods.updateFulfillment.parameters.name.description - resources.projects.resources.locations.resources.agent.methods.updateFulfillment.parameters.updateMask.description - resources.projects.resources.locations.resources.agent.resources.entityTypes.methods.batchDelete.description - resources.projects.resources.locations.resources.agent.resources.entityTypes.methods.batchDelete.parameters.parent.description - resources.projects.resources.locations.resources.agent.resources.entityTypes.methods.batchUpdate.description - resources.projects.resources.locations.resources.agent.resources.entityTypes.methods.batchUpdate.parameters.parent.description - resources.projects.resources.locations.resources.agent.resources.entityTypes.methods.create.parameters.languageCode.description - resources.projects.resources.locations.resources.agent.resources.entityTypes.methods.create.parameters.parent.description - resources.projects.resources.locations.resources.agent.resources.entityTypes.methods.delete.parameters.name.description - resources.projects.resources.locations.resources.agent.resources.entityTypes.methods.get.parameters.languageCode.description - resources.projects.resources.locations.resources.agent.resources.entityTypes.methods.get.parameters.name.description - resources.projects.resources.locations.resources.agent.resources.entityTypes.methods.list.parameters.languageCode.description - resources.projects.resources.locations.resources.agent.resources.entityTypes.methods.list.parameters.pageSize.description - resources.projects.resources.locations.resources.agent.resources.entityTypes.methods.list.parameters.parent.description - resources.projects.resources.locations.resources.agent.resources.entityTypes.methods.patch.parameters.languageCode.description - resources.projects.resources.locations.resources.agent.resources.entityTypes.methods.patch.parameters.name.description - resources.projects.resources.locations.resources.agent.resources.entityTypes.resources.entities.methods.batchCreate.description - resources.projects.resources.locations.resources.agent.resources.entityTypes.resources.entities.methods.batchCreate.parameters.parent.description - resources.projects.resources.locations.resources.agent.resources.entityTypes.resources.entities.methods.batchDelete.description - resources.projects.resources.locations.resources.agent.resources.entityTypes.resources.entities.methods.batchDelete.parameters.parent.description - resources.projects.resources.locations.resources.agent.resources.entityTypes.resources.entities.methods.batchUpdate.description - resources.projects.resources.locations.resources.agent.resources.entityTypes.resources.entities.methods.batchUpdate.parameters.parent.description - resources.projects.resources.locations.resources.agent.resources.environments.methods.list.parameters.pageSize.description - resources.projects.resources.locations.resources.agent.resources.environments.methods.list.parameters.parent.description - resources.projects.resources.locations.resources.agent.resources.environments.resources.users.resources.sessions.methods.deleteContexts.parameters.parent.description - resources.projects.resources.locations.resources.agent.resources.environments.resources.users.resources.sessions.methods.detectIntent.description - resources.projects.resources.locations.resources.agent.resources.environments.resources.users.resources.sessions.methods.detectIntent.parameters.session.description - resources.projects.resources.locations.resources.agent.resources.environments.resources.users.resources.sessions.resources.contexts.methods.create.description - resources.projects.resources.locations.resources.agent.resources.environments.resources.users.resources.sessions.resources.contexts.methods.create.parameters.parent.description - resources.projects.resources.locations.resources.agent.resources.environments.resources.users.resources.sessions.resources.contexts.methods.delete.parameters.name.description - resources.projects.resources.locations.resources.agent.resources.environments.resources.users.resources.sessions.resources.contexts.methods.get.parameters.name.description - resources.projects.resources.locations.resources.agent.resources.environments.resources.users.resources.sessions.resources.contexts.methods.list.parameters.pageSize.description - resources.projects.resources.locations.resources.agent.resources.environments.resources.users.resources.sessions.resources.contexts.methods.list.parameters.parent.description - resources.projects.resources.locations.resources.agent.resources.environments.resources.users.resources.sessions.resources.contexts.methods.patch.parameters.name.description - resources.projects.resources.locations.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.create.description - resources.projects.resources.locations.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.create.parameters.parent.description - resources.projects.resources.locations.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.delete.description - resources.projects.resources.locations.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.delete.parameters.name.description - resources.projects.resources.locations.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.get.description - resources.projects.resources.locations.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.get.parameters.name.description - resources.projects.resources.locations.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.list.description - resources.projects.resources.locations.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.list.parameters.pageSize.description - resources.projects.resources.locations.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.list.parameters.parent.description - resources.projects.resources.locations.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.patch.description - resources.projects.resources.locations.resources.agent.resources.environments.resources.users.resources.sessions.resources.entityTypes.methods.patch.parameters.name.description - resources.projects.resources.locations.resources.agent.resources.intents.methods.batchDelete.description - resources.projects.resources.locations.resources.agent.resources.intents.methods.batchDelete.parameters.parent.description - resources.projects.resources.locations.resources.agent.resources.intents.methods.batchUpdate.description - resources.projects.resources.locations.resources.agent.resources.intents.methods.batchUpdate.parameters.parent.description - resources.projects.resources.locations.resources.agent.resources.intents.methods.create.parameters.languageCode.description - resources.projects.resources.locations.resources.agent.resources.intents.methods.create.parameters.parent.description - resources.projects.resources.locations.resources.agent.resources.intents.methods.delete.parameters.name.description - resources.projects.resources.locations.resources.agent.resources.intents.methods.get.parameters.languageCode.description - resources.projects.resources.locations.resources.agent.resources.intents.methods.get.parameters.name.description - resources.projects.resources.locations.resources.agent.resources.intents.methods.list.parameters.languageCode.description - resources.projects.resources.locations.resources.agent.resources.intents.methods.list.parameters.pageSize.description - resources.projects.resources.locations.resources.agent.resources.intents.methods.list.parameters.parent.description - resources.projects.resources.locations.resources.agent.resources.intents.methods.patch.parameters.languageCode.description - resources.projects.resources.locations.resources.agent.resources.intents.methods.patch.parameters.name.description - resources.projects.resources.locations.resources.agent.resources.sessions.methods.deleteContexts.parameters.parent.description - resources.projects.resources.locations.resources.agent.resources.sessions.methods.detectIntent.description - resources.projects.resources.locations.resources.agent.resources.sessions.methods.detectIntent.parameters.session.description - resources.projects.resources.locations.resources.agent.resources.sessions.resources.contexts.methods.create.description - resources.projects.resources.locations.resources.agent.resources.sessions.resources.contexts.methods.create.parameters.parent.description - resources.projects.resources.locations.resources.agent.resources.sessions.resources.contexts.methods.delete.parameters.name.description - resources.projects.resources.locations.resources.agent.resources.sessions.resources.contexts.methods.get.parameters.name.description - resources.projects.resources.locations.resources.agent.resources.sessions.resources.contexts.methods.list.parameters.pageSize.description - resources.projects.resources.locations.resources.agent.resources.sessions.resources.contexts.methods.list.parameters.parent.description - resources.projects.resources.locations.resources.agent.resources.sessions.resources.contexts.methods.patch.parameters.name.description - resources.projects.resources.locations.resources.agent.resources.sessions.resources.entityTypes.methods.create.description - resources.projects.resources.locations.resources.agent.resources.sessions.resources.entityTypes.methods.create.parameters.parent.description - resources.projects.resources.locations.resources.agent.resources.sessions.resources.entityTypes.methods.delete.description - resources.projects.resources.locations.resources.agent.resources.sessions.resources.entityTypes.methods.delete.parameters.name.description - resources.projects.resources.locations.resources.agent.resources.sessions.resources.entityTypes.methods.get.description - resources.projects.resources.locations.resources.agent.resources.sessions.resources.entityTypes.methods.get.parameters.name.description - resources.projects.resources.locations.resources.agent.resources.sessions.resources.entityTypes.methods.list.description - resources.projects.resources.locations.resources.agent.resources.sessions.resources.entityTypes.methods.list.parameters.pageSize.description - resources.projects.resources.locations.resources.agent.resources.sessions.resources.entityTypes.methods.list.parameters.parent.description - resources.projects.resources.locations.resources.agent.resources.sessions.resources.entityTypes.methods.patch.description - resources.projects.resources.locations.resources.agent.resources.sessions.resources.entityTypes.methods.patch.parameters.name.description - resources.projects.resources.locations.resources.operations.methods.cancel.description - resources.projects.resources.locations.resources.operations.methods.get.description - resources.projects.resources.locations.resources.operations.methods.list.description - resources.projects.resources.operations.methods.cancel.description - resources.projects.resources.operations.methods.get.description - resources.projects.resources.operations.methods.list.description - schemas.GoogleCloudDialogflowCxV3beta1ExportAgentResponse.properties.agentUri.description - schemas.GoogleCloudDialogflowCxV3beta1PageInfo.properties.currentPage.description - schemas.GoogleCloudDialogflowCxV3beta1PageInfo.properties.formInfo.description - schemas.GoogleCloudDialogflowCxV3beta1PageInfoFormInfo.properties.parameterInfo.description - schemas.GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo.properties.displayName.description - schemas.GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo.properties.justCollected.description - schemas.GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo.properties.required.description - schemas.GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo.properties.state.description - schemas.GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo.properties.state.enumDescriptions - schemas.GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo.properties.value.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessage.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessage.properties.endInteraction.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessage.properties.mixedAudio.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessage.properties.outputAudioText.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessage.properties.playAudio.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageConversationSuccess.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageEndInteraction.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageHumanAgentHandoff.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageHumanAgentHandoff.properties.metadata.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageLiveAgentHandoff.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageLiveAgentHandoff.properties.metadata.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudio.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudioSegment.properties.allowPlaybackInterruption.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudioSegment.properties.audio.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudioSegment.properties.uri.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText.properties.ssml.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessagePlayAudio.properties.allowPlaybackInterruption.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessagePlayAudio.properties.audioUri.description - schemas.GoogleCloudDialogflowCxV3beta1ResponseMessageText.properties.allowPlaybackInterruption.description - schemas.GoogleCloudDialogflowCxV3beta1SessionInfo.properties.parameters.description - schemas.GoogleCloudDialogflowCxV3beta1SessionInfo.properties.session.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookRequest.properties.detectIntentResponseId.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookRequest.properties.fulfillmentInfo.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookRequest.properties.messages.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookRequestFulfillmentInfo.properties.tag.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookRequestIntentInfo.properties.lastMatchedIntent.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookRequestIntentInfo.properties.parameters.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookRequestIntentInfoIntentParameterValue.properties.resolvedValue.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookResponse.properties.fulfillmentResponse.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookResponse.properties.pageInfo.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookResponse.properties.sessionInfo.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookResponse.properties.targetFlow.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookResponse.properties.targetPage.description - schemas.GoogleCloudDialogflowCxV3beta1WebhookResponseFulfillmentResponse.properties.mergeBehavior.enumDescriptions - schemas.GoogleCloudDialogflowV2AnnotatedMessagePart.description - schemas.GoogleCloudDialogflowV2AnnotatedMessagePart.properties.entityType.description - schemas.GoogleCloudDialogflowV2AnnotatedMessagePart.properties.formattedValue.description - schemas.GoogleCloudDialogflowV2Context.description - schemas.GoogleCloudDialogflowV2Context.properties.lifespanCount.description - schemas.GoogleCloudDialogflowV2Context.properties.name.description - schemas.GoogleCloudDialogflowV2Context.properties.parameters.description - schemas.GoogleCloudDialogflowV2ConversationEvent.description - schemas.GoogleCloudDialogflowV2ConversationEvent.properties.conversation.description - schemas.GoogleCloudDialogflowV2ConversationEvent.properties.errorStatus.description - schemas.GoogleCloudDialogflowV2ConversationEvent.properties.type.enumDescriptions - schemas.GoogleCloudDialogflowV2EntityType.description - schemas.GoogleCloudDialogflowV2EntityType.properties.autoExpansionMode.description - schemas.GoogleCloudDialogflowV2EntityType.properties.autoExpansionMode.enumDescriptions - schemas.GoogleCloudDialogflowV2EntityType.properties.kind.enumDescriptions - schemas.GoogleCloudDialogflowV2EntityType.properties.name.description - schemas.GoogleCloudDialogflowV2EntityTypeEntity.properties.synonyms.description - schemas.GoogleCloudDialogflowV2EntityTypeEntity.properties.value.description - schemas.GoogleCloudDialogflowV2EventInput.description - schemas.GoogleCloudDialogflowV2EventInput.properties.languageCode.description - schemas.GoogleCloudDialogflowV2EventInput.properties.parameters.description - schemas.GoogleCloudDialogflowV2ExportAgentResponse.properties.agentUri.description - schemas.GoogleCloudDialogflowV2Intent.description - schemas.GoogleCloudDialogflowV2Intent.properties.action.description - schemas.GoogleCloudDialogflowV2Intent.properties.defaultResponsePlatforms.description - schemas.GoogleCloudDialogflowV2Intent.properties.defaultResponsePlatforms.enumDescriptions - schemas.GoogleCloudDialogflowV2Intent.properties.events.description - schemas.GoogleCloudDialogflowV2Intent.properties.followupIntentInfo.description - schemas.GoogleCloudDialogflowV2Intent.properties.inputContextNames.description - schemas.GoogleCloudDialogflowV2Intent.properties.messages.description - schemas.GoogleCloudDialogflowV2Intent.properties.mlDisabled.description - schemas.GoogleCloudDialogflowV2Intent.properties.name.description - schemas.GoogleCloudDialogflowV2Intent.properties.outputContexts.description - schemas.GoogleCloudDialogflowV2Intent.properties.parentFollowupIntentName.description - schemas.GoogleCloudDialogflowV2Intent.properties.priority.description - schemas.GoogleCloudDialogflowV2Intent.properties.resetContexts.description - schemas.GoogleCloudDialogflowV2Intent.properties.rootFollowupIntentName.description - schemas.GoogleCloudDialogflowV2Intent.properties.trainingPhrases.description - schemas.GoogleCloudDialogflowV2Intent.properties.webhookState.enumDescriptions - schemas.GoogleCloudDialogflowV2IntentFollowupIntentInfo.properties.followupIntentName.description - schemas.GoogleCloudDialogflowV2IntentFollowupIntentInfo.properties.parentFollowupIntentName.description - schemas.GoogleCloudDialogflowV2IntentMessage.description - schemas.GoogleCloudDialogflowV2IntentMessage.properties.platform.enumDescriptions - schemas.GoogleCloudDialogflowV2IntentMessageBrowseCarouselCard.description - schemas.GoogleCloudDialogflowV2IntentMessageBrowseCarouselCard.properties.imageDisplayOptions.description - schemas.GoogleCloudDialogflowV2IntentMessageBrowseCarouselCard.properties.imageDisplayOptions.enumDescriptions - schemas.GoogleCloudDialogflowV2IntentMessageBrowseCarouselCard.properties.items.description - schemas.GoogleCloudDialogflowV2IntentMessageBrowseCarouselCardBrowseCarouselCardItem.properties.description.description - schemas.GoogleCloudDialogflowV2IntentMessageBrowseCarouselCardBrowseCarouselCardItem.properties.footer.description - schemas.GoogleCloudDialogflowV2IntentMessageBrowseCarouselCardBrowseCarouselCardItemOpenUrlAction.properties.urlTypeHint.description - schemas.GoogleCloudDialogflowV2IntentMessageBrowseCarouselCardBrowseCarouselCardItemOpenUrlAction.properties.urlTypeHint.enumDescriptions - schemas.GoogleCloudDialogflowV2IntentMessageCardButton.properties.postback.description - schemas.GoogleCloudDialogflowV2IntentMessageImage.properties.accessibilityText.description - schemas.GoogleCloudDialogflowV2IntentMessageLinkOutSuggestion.description - schemas.GoogleCloudDialogflowV2IntentMessageLinkOutSuggestion.properties.uri.description - schemas.GoogleCloudDialogflowV2IntentMessageSelectItemInfo.description - schemas.GoogleCloudDialogflowV2IntentMessageSelectItemInfo.properties.key.description - schemas.GoogleCloudDialogflowV2IntentMessageSelectItemInfo.properties.synonyms.description - schemas.GoogleCloudDialogflowV2IntentMessageSimpleResponse.properties.ssml.description - schemas.GoogleCloudDialogflowV2IntentMessageSimpleResponse.properties.textToSpeech.description - schemas.GoogleCloudDialogflowV2IntentMessageSimpleResponses.description - schemas.GoogleCloudDialogflowV2IntentMessageSuggestion.description - schemas.GoogleCloudDialogflowV2IntentParameter.properties.defaultValue.description - schemas.GoogleCloudDialogflowV2IntentParameter.properties.entityTypeDisplayName.description - schemas.GoogleCloudDialogflowV2IntentParameter.properties.mandatory.description - schemas.GoogleCloudDialogflowV2IntentParameter.properties.prompts.description - schemas.GoogleCloudDialogflowV2IntentParameter.properties.value.description - schemas.GoogleCloudDialogflowV2IntentTrainingPhrase.properties.parts.description - schemas.GoogleCloudDialogflowV2IntentTrainingPhrase.properties.timesAddedCount.description - schemas.GoogleCloudDialogflowV2IntentTrainingPhrase.properties.type.enumDescriptions - schemas.GoogleCloudDialogflowV2IntentTrainingPhrasePart.properties.alias.description - schemas.GoogleCloudDialogflowV2IntentTrainingPhrasePart.properties.entityType.description - schemas.GoogleCloudDialogflowV2IntentTrainingPhrasePart.properties.userDefined.description - schemas.GoogleCloudDialogflowV2Message.properties.languageCode.description - schemas.GoogleCloudDialogflowV2Message.properties.name.description - schemas.GoogleCloudDialogflowV2Message.properties.participantRole.enumDescriptions - schemas.GoogleCloudDialogflowV2MessageAnnotation.properties.parts.description - schemas.GoogleCloudDialogflowV2OriginalDetectIntentRequest.description - schemas.GoogleCloudDialogflowV2OriginalDetectIntentRequest.properties.payload.description - schemas.GoogleCloudDialogflowV2OriginalDetectIntentRequest.properties.source.description - schemas.GoogleCloudDialogflowV2OriginalDetectIntentRequest.properties.version.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.allRequiredParamsPresent.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.diagnosticInfo.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.fulfillmentText.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.intent.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.intentDetectionConfidence.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.languageCode.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.outputContexts.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.parameters.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.queryText.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.sentimentAnalysisResult.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.speechRecognitionConfidence.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.webhookPayload.description - schemas.GoogleCloudDialogflowV2QueryResult.properties.webhookSource.description - schemas.GoogleCloudDialogflowV2Sentiment.description - schemas.GoogleCloudDialogflowV2Sentiment.properties.magnitude.description - schemas.GoogleCloudDialogflowV2Sentiment.properties.score.description - schemas.GoogleCloudDialogflowV2SentimentAnalysisResult.description - schemas.GoogleCloudDialogflowV2SessionEntityType.description - schemas.GoogleCloudDialogflowV2SessionEntityType.properties.entities.description - schemas.GoogleCloudDialogflowV2SessionEntityType.properties.entityOverrideMode.description - schemas.GoogleCloudDialogflowV2SessionEntityType.properties.entityOverrideMode.enumDescriptions - schemas.GoogleCloudDialogflowV2SessionEntityType.properties.name.description - schemas.GoogleCloudDialogflowV2WebhookRequest.properties.originalDetectIntentRequest.description - schemas.GoogleCloudDialogflowV2WebhookRequest.properties.queryResult.description - schemas.GoogleCloudDialogflowV2WebhookRequest.properties.responseId.description - schemas.GoogleCloudDialogflowV2WebhookRequest.properties.session.description - schemas.GoogleCloudDialogflowV2WebhookResponse.description - schemas.GoogleCloudDialogflowV2WebhookResponse.properties.followupEventInput.description - schemas.GoogleCloudDialogflowV2WebhookResponse.properties.fulfillmentMessages.description - schemas.GoogleCloudDialogflowV2WebhookResponse.properties.fulfillmentText.description - schemas.GoogleCloudDialogflowV2WebhookResponse.properties.outputContexts.description - schemas.GoogleCloudDialogflowV2WebhookResponse.properties.payload.description - schemas.GoogleCloudDialogflowV2WebhookResponse.properties.sessionEntityTypes.description - schemas.GoogleCloudDialogflowV2WebhookResponse.properties.source.description - schemas.GoogleCloudDialogflowV2beta1Agent.description - schemas.GoogleCloudDialogflowV2beta1Agent.properties.apiVersion.description - schemas.GoogleCloudDialogflowV2beta1Agent.properties.avatarUri.description - schemas.GoogleCloudDialogflowV2beta1Agent.properties.classificationThreshold.description - schemas.GoogleCloudDialogflowV2beta1Agent.properties.defaultLanguageCode.description - schemas.GoogleCloudDialogflowV2beta1Agent.properties.description.description - schemas.GoogleCloudDialogflowV2beta1Agent.properties.matchMode.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1Agent.properties.parent.description - schemas.GoogleCloudDialogflowV2beta1Agent.properties.supportedLanguageCodes.description - schemas.GoogleCloudDialogflowV2beta1Agent.properties.timeZone.description - schemas.GoogleCloudDialogflowV2beta1AnnotatedConversationDataset.description - schemas.GoogleCloudDialogflowV2beta1AnnotatedConversationDataset.properties.completedExampleCount.description - schemas.GoogleCloudDialogflowV2beta1AnnotatedConversationDataset.properties.description.description - schemas.GoogleCloudDialogflowV2beta1AnnotatedConversationDataset.properties.displayName.description - schemas.GoogleCloudDialogflowV2beta1AnnotatedConversationDataset.properties.name.description - schemas.GoogleCloudDialogflowV2beta1AnnotatedConversationDataset.properties.questionTypeName.description - schemas.GoogleCloudDialogflowV2beta1BatchCreateEntitiesRequest.properties.languageCode.description - schemas.GoogleCloudDialogflowV2beta1BatchDeleteEntitiesRequest.properties.entityValues.description - schemas.GoogleCloudDialogflowV2beta1BatchDeleteEntitiesRequest.properties.languageCode.description - schemas.GoogleCloudDialogflowV2beta1BatchDeleteEntityTypesRequest.properties.entityTypeNames.description - schemas.GoogleCloudDialogflowV2beta1BatchDeleteIntentsRequest.properties.intents.description - schemas.GoogleCloudDialogflowV2beta1BatchUpdateEntitiesRequest.properties.languageCode.description - schemas.GoogleCloudDialogflowV2beta1BatchUpdateEntityTypesRequest.properties.entityTypeBatchUri.description - schemas.GoogleCloudDialogflowV2beta1BatchUpdateEntityTypesRequest.properties.languageCode.description - schemas.GoogleCloudDialogflowV2beta1BatchUpdateIntentsRequest.properties.intentBatchUri.description - schemas.GoogleCloudDialogflowV2beta1BatchUpdateIntentsRequest.properties.languageCode.description - schemas.GoogleCloudDialogflowV2beta1Context.description - schemas.GoogleCloudDialogflowV2beta1Context.properties.lifespanCount.description - schemas.GoogleCloudDialogflowV2beta1Context.properties.name.description - schemas.GoogleCloudDialogflowV2beta1Context.properties.parameters.description - schemas.GoogleCloudDialogflowV2beta1DetectIntentRequest.properties.inputAudio.description - schemas.GoogleCloudDialogflowV2beta1DetectIntentRequest.properties.outputAudioConfig.description - schemas.GoogleCloudDialogflowV2beta1DetectIntentRequest.properties.outputAudioConfigMask.description - schemas.GoogleCloudDialogflowV2beta1DetectIntentRequest.properties.queryInput.description - schemas.GoogleCloudDialogflowV2beta1DetectIntentResponse.properties.alternativeQueryResults.description - schemas.GoogleCloudDialogflowV2beta1DetectIntentResponse.properties.outputAudio.description - schemas.GoogleCloudDialogflowV2beta1DetectIntentResponse.properties.queryResult.description - schemas.GoogleCloudDialogflowV2beta1DetectIntentResponse.properties.responseId.description - schemas.GoogleCloudDialogflowV2beta1Document.description - schemas.GoogleCloudDialogflowV2beta1Document.properties.content.description - schemas.GoogleCloudDialogflowV2beta1Document.properties.contentUri.description - schemas.GoogleCloudDialogflowV2beta1Document.properties.displayName.description - schemas.GoogleCloudDialogflowV2beta1Document.properties.enableAutoReload.description - schemas.GoogleCloudDialogflowV2beta1Document.properties.knowledgeTypes.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1Document.properties.latestReloadStatus.description - schemas.GoogleCloudDialogflowV2beta1Document.properties.name.description - schemas.GoogleCloudDialogflowV2beta1Document.properties.rawContent.description - schemas.GoogleCloudDialogflowV2beta1DocumentReloadStatus.properties.time.description - schemas.GoogleCloudDialogflowV2beta1EntityType.description - schemas.GoogleCloudDialogflowV2beta1EntityType.properties.autoExpansionMode.description - schemas.GoogleCloudDialogflowV2beta1EntityType.properties.autoExpansionMode.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1EntityType.properties.kind.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1EntityType.properties.name.description - schemas.GoogleCloudDialogflowV2beta1EntityTypeEntity.properties.synonyms.description - schemas.GoogleCloudDialogflowV2beta1EntityTypeEntity.properties.value.description - schemas.GoogleCloudDialogflowV2beta1Environment.description - schemas.GoogleCloudDialogflowV2beta1Environment.properties.agentVersion.description - schemas.GoogleCloudDialogflowV2beta1Environment.properties.description.description - schemas.GoogleCloudDialogflowV2beta1Environment.properties.name.description - schemas.GoogleCloudDialogflowV2beta1Environment.properties.state.description - schemas.GoogleCloudDialogflowV2beta1Environment.properties.updateTime.description - schemas.GoogleCloudDialogflowV2beta1EventInput.description - schemas.GoogleCloudDialogflowV2beta1EventInput.properties.languageCode.description - schemas.GoogleCloudDialogflowV2beta1EventInput.properties.parameters.description - schemas.GoogleCloudDialogflowV2beta1ExportAgentRequest.properties.agentUri.description - schemas.GoogleCloudDialogflowV2beta1ExportAgentResponse.properties.agentUri.description - schemas.GoogleCloudDialogflowV2beta1Fulfillment.description - schemas.GoogleCloudDialogflowV2beta1Fulfillment.properties.name.description - schemas.GoogleCloudDialogflowV2beta1FulfillmentGenericWebService.description - schemas.GoogleCloudDialogflowV2beta1FulfillmentGenericWebService.properties.isCloudFunction.description - schemas.GoogleCloudDialogflowV2beta1FulfillmentGenericWebService.properties.uri.description - schemas.GoogleCloudDialogflowV2beta1GcsSource.properties.uri.description - schemas.GoogleCloudDialogflowV2beta1ImportAgentRequest.properties.agentUri.description - schemas.GoogleCloudDialogflowV2beta1InputAudioConfig.properties.audioEncoding.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1InputAudioConfig.properties.enableWordInfo.description - schemas.GoogleCloudDialogflowV2beta1InputAudioConfig.properties.languageCode.description - schemas.GoogleCloudDialogflowV2beta1InputAudioConfig.properties.model.description - schemas.GoogleCloudDialogflowV2beta1InputAudioConfig.properties.modelVariant.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1InputAudioConfig.properties.phraseHints.description - schemas.GoogleCloudDialogflowV2beta1InputAudioConfig.properties.sampleRateHertz.description - schemas.GoogleCloudDialogflowV2beta1InputAudioConfig.properties.singleUtterance.description - schemas.GoogleCloudDialogflowV2beta1InputAudioConfig.properties.speechContexts.description - schemas.GoogleCloudDialogflowV2beta1Intent.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.action.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.defaultResponsePlatforms.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.defaultResponsePlatforms.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1Intent.properties.endInteraction.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.events.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.followupIntentInfo.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.inputContextNames.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.messages.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.mlDisabled.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.mlEnabled.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.name.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.outputContexts.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.parentFollowupIntentName.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.priority.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.resetContexts.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.rootFollowupIntentName.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.trainingPhrases.description - schemas.GoogleCloudDialogflowV2beta1Intent.properties.webhookState.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1IntentFollowupIntentInfo.properties.followupIntentName.description - schemas.GoogleCloudDialogflowV2beta1IntentFollowupIntentInfo.properties.parentFollowupIntentName.description - schemas.GoogleCloudDialogflowV2beta1IntentMessage.properties.platform.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1IntentMessage.properties.rbmText.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCard.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCard.properties.imageDisplayOptions.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCard.properties.imageDisplayOptions.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCard.properties.items.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCardBrowseCarouselCardItem.properties.description.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCardBrowseCarouselCardItem.properties.footer.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCardBrowseCarouselCardItemOpenUrlAction.properties.urlTypeHint.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCardBrowseCarouselCardItemOpenUrlAction.properties.urlTypeHint.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1IntentMessageCardButton.properties.postback.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageImage.properties.accessibilityText.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageLinkOutSuggestion.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageLinkOutSuggestion.properties.uri.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmCardContent.properties.description.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmCardContent.properties.media.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmCardContent.properties.title.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia.properties.fileUri.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia.properties.height.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia.properties.height.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia.properties.thumbnailUri.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmCarouselCard.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmCarouselCard.properties.cardContents.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmStandaloneCard.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmStandaloneCard.properties.thumbnailImageAlignment.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedAction.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedAction.properties.postbackData.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionDial.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionDial.properties.phoneNumber.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionOpenUri.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionShareLocation.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedReply.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedReply.properties.postbackData.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestion.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageSelectItemInfo.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageSelectItemInfo.properties.key.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageSelectItemInfo.properties.synonyms.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageSimpleResponse.properties.ssml.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageSimpleResponse.properties.textToSpeech.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageSimpleResponses.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageSuggestion.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageTelephonyPlayAudio.properties.audioUri.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech.properties.ssml.description - schemas.GoogleCloudDialogflowV2beta1IntentMessageTelephonyTransferCall.properties.phoneNumber.description - schemas.GoogleCloudDialogflowV2beta1IntentParameter.properties.defaultValue.description - schemas.GoogleCloudDialogflowV2beta1IntentParameter.properties.entityTypeDisplayName.description - schemas.GoogleCloudDialogflowV2beta1IntentParameter.properties.mandatory.description - schemas.GoogleCloudDialogflowV2beta1IntentParameter.properties.prompts.description - schemas.GoogleCloudDialogflowV2beta1IntentParameter.properties.value.description - schemas.GoogleCloudDialogflowV2beta1IntentTrainingPhrase.properties.parts.description - schemas.GoogleCloudDialogflowV2beta1IntentTrainingPhrase.properties.timesAddedCount.description - schemas.GoogleCloudDialogflowV2beta1IntentTrainingPhrase.properties.type.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1IntentTrainingPhrasePart.properties.alias.description - schemas.GoogleCloudDialogflowV2beta1IntentTrainingPhrasePart.properties.entityType.description - schemas.GoogleCloudDialogflowV2beta1IntentTrainingPhrasePart.properties.userDefined.description - schemas.GoogleCloudDialogflowV2beta1KnowledgeAnswersAnswer.properties.answer.description - schemas.GoogleCloudDialogflowV2beta1KnowledgeAnswersAnswer.properties.faqQuestion.description - schemas.GoogleCloudDialogflowV2beta1KnowledgeAnswersAnswer.properties.matchConfidence.description - schemas.GoogleCloudDialogflowV2beta1KnowledgeAnswersAnswer.properties.matchConfidenceLevel.description - schemas.GoogleCloudDialogflowV2beta1KnowledgeAnswersAnswer.properties.source.description - schemas.GoogleCloudDialogflowV2beta1KnowledgeBase.description - schemas.GoogleCloudDialogflowV2beta1KnowledgeBase.properties.displayName.description - schemas.GoogleCloudDialogflowV2beta1KnowledgeBase.properties.languageCode.description - schemas.GoogleCloudDialogflowV2beta1KnowledgeBase.properties.name.description - schemas.GoogleCloudDialogflowV2beta1LabelConversationResponse.description - schemas.GoogleCloudDialogflowV2beta1ListContextsResponse.properties.contexts.description - schemas.GoogleCloudDialogflowV2beta1ListContextsResponse.properties.nextPageToken.description - schemas.GoogleCloudDialogflowV2beta1ListDocumentsResponse.properties.nextPageToken.description - schemas.GoogleCloudDialogflowV2beta1ListEntityTypesResponse.properties.entityTypes.description - schemas.GoogleCloudDialogflowV2beta1ListEntityTypesResponse.properties.nextPageToken.description - schemas.GoogleCloudDialogflowV2beta1ListEnvironmentsResponse.properties.environments.description - schemas.GoogleCloudDialogflowV2beta1ListEnvironmentsResponse.properties.nextPageToken.description - schemas.GoogleCloudDialogflowV2beta1ListIntentsResponse.properties.intents.description - schemas.GoogleCloudDialogflowV2beta1ListIntentsResponse.properties.nextPageToken.description - schemas.GoogleCloudDialogflowV2beta1ListKnowledgeBasesResponse.properties.nextPageToken.description - schemas.GoogleCloudDialogflowV2beta1ListSessionEntityTypesResponse.properties.nextPageToken.description - schemas.GoogleCloudDialogflowV2beta1ListSessionEntityTypesResponse.properties.sessionEntityTypes.description - schemas.GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest.description - schemas.GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest.properties.payload.description - schemas.GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest.properties.source.description - schemas.GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest.properties.version.description - schemas.GoogleCloudDialogflowV2beta1OutputAudioConfig.description - schemas.GoogleCloudDialogflowV2beta1OutputAudioConfig.properties.audioEncoding.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1OutputAudioConfig.properties.sampleRateHertz.description - schemas.GoogleCloudDialogflowV2beta1QueryInput.description - schemas.GoogleCloudDialogflowV2beta1QueryParameters.properties.contexts.description - schemas.GoogleCloudDialogflowV2beta1QueryParameters.properties.knowledgeBaseNames.description - schemas.GoogleCloudDialogflowV2beta1QueryParameters.properties.payload.description - schemas.GoogleCloudDialogflowV2beta1QueryParameters.properties.resetContexts.description - schemas.GoogleCloudDialogflowV2beta1QueryParameters.properties.sentimentAnalysisRequestConfig.description - schemas.GoogleCloudDialogflowV2beta1QueryParameters.properties.sessionEntityTypes.description - schemas.GoogleCloudDialogflowV2beta1QueryParameters.properties.subAgents.description - schemas.GoogleCloudDialogflowV2beta1QueryParameters.properties.timeZone.description - schemas.GoogleCloudDialogflowV2beta1QueryParameters.properties.webhookHeaders.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.allRequiredParamsPresent.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.diagnosticInfo.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.fulfillmentText.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.intent.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.intentDetectionConfidence.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.knowledgeAnswers.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.languageCode.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.outputContexts.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.parameters.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.queryText.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.sentimentAnalysisResult.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.speechRecognitionConfidence.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.webhookPayload.description - schemas.GoogleCloudDialogflowV2beta1QueryResult.properties.webhookSource.description - schemas.GoogleCloudDialogflowV2beta1ReloadDocumentRequest.properties.gcsSource.description - schemas.GoogleCloudDialogflowV2beta1RestoreAgentRequest.properties.agentUri.description - schemas.GoogleCloudDialogflowV2beta1SearchAgentsResponse.properties.agents.description - schemas.GoogleCloudDialogflowV2beta1SearchAgentsResponse.properties.nextPageToken.description - schemas.GoogleCloudDialogflowV2beta1Sentiment.description - schemas.GoogleCloudDialogflowV2beta1Sentiment.properties.magnitude.description - schemas.GoogleCloudDialogflowV2beta1Sentiment.properties.score.description - schemas.GoogleCloudDialogflowV2beta1SentimentAnalysisRequestConfig.properties.analyzeQueryTextSentiment.description - schemas.GoogleCloudDialogflowV2beta1SentimentAnalysisResult.description - schemas.GoogleCloudDialogflowV2beta1SessionEntityType.description - schemas.GoogleCloudDialogflowV2beta1SessionEntityType.properties.entities.description - schemas.GoogleCloudDialogflowV2beta1SessionEntityType.properties.entityOverrideMode.description - schemas.GoogleCloudDialogflowV2beta1SessionEntityType.properties.entityOverrideMode.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1SessionEntityType.properties.name.description - schemas.GoogleCloudDialogflowV2beta1SpeechContext.description - schemas.GoogleCloudDialogflowV2beta1SpeechContext.properties.boost.description - schemas.GoogleCloudDialogflowV2beta1SpeechContext.properties.phrases.description - schemas.GoogleCloudDialogflowV2beta1SubAgent.properties.environment.description - schemas.GoogleCloudDialogflowV2beta1SubAgent.properties.project.description - schemas.GoogleCloudDialogflowV2beta1SynthesizeSpeechConfig.properties.effectsProfileId.description - schemas.GoogleCloudDialogflowV2beta1SynthesizeSpeechConfig.properties.pitch.description - schemas.GoogleCloudDialogflowV2beta1SynthesizeSpeechConfig.properties.speakingRate.description - schemas.GoogleCloudDialogflowV2beta1SynthesizeSpeechConfig.properties.volumeGainDb.description - schemas.GoogleCloudDialogflowV2beta1TextInput.properties.languageCode.description - schemas.GoogleCloudDialogflowV2beta1TextInput.properties.text.description - schemas.GoogleCloudDialogflowV2beta1ValidationError.properties.entries.description - schemas.GoogleCloudDialogflowV2beta1VoiceSelectionParams.properties.name.description - schemas.GoogleCloudDialogflowV2beta1VoiceSelectionParams.properties.ssmlGender.description - schemas.GoogleCloudDialogflowV2beta1VoiceSelectionParams.properties.ssmlGender.enumDescriptions - schemas.GoogleCloudDialogflowV2beta1WebhookRequest.properties.originalDetectIntentRequest.description - schemas.GoogleCloudDialogflowV2beta1WebhookRequest.properties.queryResult.description - schemas.GoogleCloudDialogflowV2beta1WebhookRequest.properties.responseId.description - schemas.GoogleCloudDialogflowV2beta1WebhookRequest.properties.session.description - schemas.GoogleCloudDialogflowV2beta1WebhookResponse.description - schemas.GoogleCloudDialogflowV2beta1WebhookResponse.properties.endInteraction.description - schemas.GoogleCloudDialogflowV2beta1WebhookResponse.properties.followupEventInput.description - schemas.GoogleCloudDialogflowV2beta1WebhookResponse.properties.fulfillmentMessages.description - schemas.GoogleCloudDialogflowV2beta1WebhookResponse.properties.fulfillmentText.description - schemas.GoogleCloudDialogflowV2beta1WebhookResponse.properties.outputContexts.description - schemas.GoogleCloudDialogflowV2beta1WebhookResponse.properties.payload.description - schemas.GoogleCloudDialogflowV2beta1WebhookResponse.properties.sessionEntityTypes.description - schemas.GoogleCloudDialogflowV2beta1WebhookResponse.properties.source.description - schemas.GoogleCloudDialogflowV3alpha1ExportAgentResponse.properties.agentUri.description - schemas.GoogleLongrunningOperation.description - schemas.GoogleLongrunningOperation.properties.done.description - schemas.GoogleLongrunningOperation.properties.metadata.description - schemas.GoogleLongrunningOperation.properties.name.description - schemas.GoogleLongrunningOperation.properties.response.description - schemas.GoogleProtobufEmpty.description - schemas.GoogleRpcStatus.description - schemas.GoogleRpcStatus.properties.details.description - schemas.GoogleRpcStatus.properties.message.description - schemas.GoogleTypeLatLng.description --- discovery/dialogflow-v2.json | 1130 +++++++++--------- discovery/dialogflow-v2beta1.json | 1500 ++++++++++++------------ src/apis/dialogflow/v2.ts | 881 ++++++-------- src/apis/dialogflow/v2beta1.ts | 1769 ++++++++++------------------- 4 files changed, 2322 insertions(+), 2958 deletions(-) diff --git a/discovery/dialogflow-v2.json b/discovery/dialogflow-v2.json index ea57661b92..b5157e2267 100644 --- a/discovery/dialogflow-v2.json +++ b/discovery/dialogflow-v2.json @@ -120,7 +120,7 @@ ], "parameters": { "parent": { - "description": "Required. The project that the agent to delete is associated with.\nFormat: `projects/`.", + "description": "Required. The project that the agent to delete is associated with. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -146,7 +146,7 @@ ], "parameters": { "parent": { - "description": "Required. The project that the agent to fetch is associated with.\nFormat: `projects/`.", + "description": "Required. The project that the agent to fetch is associated with. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -172,7 +172,7 @@ ], "parameters": { "parent": { - "description": "Required. The project of this agent.\nFormat: `projects/`.", + "description": "Required. The project of this agent. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -202,7 +202,7 @@ "agent": { "methods": { "export": { - "description": "Exports the specified agent to a ZIP file.\n\nOperation ", + "description": "Exports the specified agent to a ZIP file. Operation ", "flatPath": "v2/projects/{projectsId}/agent:export", "httpMethod": "POST", "id": "dialogflow.projects.agent.export", @@ -211,7 +211,7 @@ ], "parameters": { "parent": { - "description": "Required. The project that the agent to export is associated with.\nFormat: `projects/`.", + "description": "Required. The project that the agent to export is associated with. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -240,7 +240,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the fulfillment.\nFormat: `projects//agent/fulfillment`.", + "description": "Required. The name of the fulfillment. Format: `projects//agent/fulfillment`.", "location": "path", "pattern": "^projects/[^/]+/agent/fulfillment$", "required": true, @@ -257,7 +257,7 @@ ] }, "getValidationResult": { - "description": "Gets agent validation result. Agent validation is performed during\ntraining time and is updated automatically when training is completed.", + "description": "Gets agent validation result. Agent validation is performed during training time and is updated automatically when training is completed.", "flatPath": "v2/projects/{projectsId}/agent/validationResult", "httpMethod": "GET", "id": "dialogflow.projects.agent.getValidationResult", @@ -266,12 +266,12 @@ ], "parameters": { "languageCode": { - "description": "Optional. The language for which you want a validation result. If not\nspecified, the agent's default language is used. [Many\nlanguages](https://cloud.google.com/dialogflow/docs/reference/language)\nare supported. Note: languages must be enabled in the agent before they can\nbe used.", + "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" }, "parent": { - "description": "Required. The project that the agent is associated with.\nFormat: `projects/`.", + "description": "Required. The project that the agent is associated with. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -288,7 +288,7 @@ ] }, "import": { - "description": "Imports the specified agent from a ZIP file.\n\nUploads new intents and entity types without deleting the existing ones.\nIntents and entity types with the same name are replaced with the new\nversions from ImportAgentRequest. After the import, the imported draft\nagent will be trained automatically (unless disabled in agent settings).\nHowever, once the import is done, training may not be completed yet. Please\ncall TrainAgent and wait for the operation it returns in order to train\nexplicitly.\n\nOperation \nAn operation which tracks when importing is complete. It only tracks\nwhen the draft agent is updated not when it is done training.", + "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.", "flatPath": "v2/projects/{projectsId}/agent:import", "httpMethod": "POST", "id": "dialogflow.projects.agent.import", @@ -297,7 +297,7 @@ ], "parameters": { "parent": { - "description": "Required. The project that the agent to import is associated with.\nFormat: `projects/`.", + "description": "Required. The project that the agent to import is associated with. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -317,7 +317,7 @@ ] }, "restore": { - "description": "Restores the specified agent from a ZIP file.\n\nReplaces the current agent version with a new one. All the intents and\nentity types in the older version are deleted. After the restore, the\nrestored draft agent will be trained automatically (unless disabled in\nagent settings). However, once the restore is done, training may not be\ncompleted yet. Please call TrainAgent and wait for the operation it\nreturns in order to train explicitly.\n\nOperation \nAn operation which tracks when restoring is complete. It only tracks\nwhen the draft agent is updated not when it is done training.", + "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.", "flatPath": "v2/projects/{projectsId}/agent:restore", "httpMethod": "POST", "id": "dialogflow.projects.agent.restore", @@ -326,7 +326,7 @@ ], "parameters": { "parent": { - "description": "Required. The project that the agent to restore is associated with.\nFormat: `projects/`.", + "description": "Required. The project that the agent to restore is associated with. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -346,7 +346,7 @@ ] }, "search": { - "description": "Returns the list of agents.\n\nSince there is at most one conversational agent per project, this method is\nuseful primarily for listing all agents across projects the caller has\naccess to. One can achieve that with a wildcard project collection id \"-\".\nRefer to [List\nSub-Collections](https://cloud.google.com/apis/design/design_patterns#list_sub-collections).", + "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).", "flatPath": "v2/projects/{projectsId}/agent:search", "httpMethod": "GET", "id": "dialogflow.projects.agent.search", @@ -355,7 +355,7 @@ ], "parameters": { "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 100 and at most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -366,7 +366,7 @@ "type": "string" }, "parent": { - "description": "Required. The project to list agents from.\nFormat: `projects/`.", + "description": "Required. The project to list agents from. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -383,7 +383,7 @@ ] }, "train": { - "description": "Trains the specified agent.\n\nOperation ", + "description": "Trains the specified agent. Operation ", "flatPath": "v2/projects/{projectsId}/agent:train", "httpMethod": "POST", "id": "dialogflow.projects.agent.train", @@ -392,7 +392,7 @@ ], "parameters": { "parent": { - "description": "Required. The project that the agent to train is associated with.\nFormat: `projects/`.", + "description": "Required. The project that the agent to train is associated with. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -421,14 +421,14 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of the fulfillment.\nFormat: `projects//agent/fulfillment`.", + "description": "Required. The unique identifier of the fulfillment. Format: `projects//agent/fulfillment`.", "location": "path", "pattern": "^projects/[^/]+/agent/fulfillment$", "required": true, "type": "string" }, "updateMask": { - "description": "Required. The mask to control which fields get updated. If the mask is not\npresent, all fields will be updated.", + "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" @@ -451,7 +451,7 @@ "entityTypes": { "methods": { "batchDelete": { - "description": "Deletes entity types in the specified agent.\n\nOperation ", + "description": "Deletes entity types in the specified agent. Operation ", "flatPath": "v2/projects/{projectsId}/agent/entityTypes:batchDelete", "httpMethod": "POST", "id": "dialogflow.projects.agent.entityTypes.batchDelete", @@ -460,7 +460,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the agent to delete all entities types for. Format:\n`projects//agent`.", + "description": "Required. The name of the agent to delete all entities types for. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/agent$", "required": true, @@ -480,7 +480,7 @@ ] }, "batchUpdate": { - "description": "Updates/Creates multiple entity types in the specified agent.\n\nOperation ", + "description": "Updates/Creates multiple entity types in the specified agent. Operation ", "flatPath": "v2/projects/{projectsId}/agent/entityTypes:batchUpdate", "httpMethod": "POST", "id": "dialogflow.projects.agent.entityTypes.batchUpdate", @@ -489,7 +489,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the agent to update or create entity types in.\nFormat: `projects//agent`.", + "description": "Required. The name of the agent to update or create entity types in. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/agent$", "required": true, @@ -518,12 +518,12 @@ ], "parameters": { "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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.\nFormat: `projects//agent`.", + "description": "Required. The agent to create a entity type for. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/agent$", "required": true, @@ -552,7 +552,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the entity type to delete.\nFormat: `projects//agent/entityTypes/`.", + "description": "Required. The name of the entity type to delete. Format: `projects//agent/entityTypes/`.", "location": "path", "pattern": "^projects/[^/]+/agent/entityTypes/[^/]+$", "required": true, @@ -578,12 +578,12 @@ ], "parameters": { "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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.\nFormat: `projects//agent/entityTypes/`.", + "description": "Required. The name of the entity type. Format: `projects//agent/entityTypes/`.", "location": "path", "pattern": "^projects/[^/]+/agent/entityTypes/[^/]+$", "required": true, @@ -609,12 +609,12 @@ ], "parameters": { "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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" }, "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 100 and at most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -625,7 +625,7 @@ "type": "string" }, "parent": { - "description": "Required. The agent to list all entity types from.\nFormat: `projects//agent`.", + "description": "Required. The agent to list all entity types from. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/agent$", "required": true, @@ -651,12 +651,12 @@ ], "parameters": { "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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": "The unique identifier of the entity type.\nRequired for EntityTypes.UpdateEntityType and\nEntityTypes.BatchUpdateEntityTypes methods.\nFormat: `projects//agent/entityTypes/`.", + "description": "The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`.", "location": "path", "pattern": "^projects/[^/]+/agent/entityTypes/[^/]+$", "required": true, @@ -686,7 +686,7 @@ "entities": { "methods": { "batchCreate": { - "description": "Creates multiple new entities in the specified entity type.\n\nOperation ", + "description": "Creates multiple new entities in the specified entity type. Operation ", "flatPath": "v2/projects/{projectsId}/agent/entityTypes/{entityTypesId}/entities:batchCreate", "httpMethod": "POST", "id": "dialogflow.projects.agent.entityTypes.entities.batchCreate", @@ -695,7 +695,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the entity type to create entities in. Format:\n`projects//agent/entityTypes/`.", + "description": "Required. The name of the entity type to create entities in. Format: `projects//agent/entityTypes/`.", "location": "path", "pattern": "^projects/[^/]+/agent/entityTypes/[^/]+$", "required": true, @@ -715,7 +715,7 @@ ] }, "batchDelete": { - "description": "Deletes entities in the specified entity type.\n\n\nOperation ", + "description": "Deletes entities in the specified entity type. Operation ", "flatPath": "v2/projects/{projectsId}/agent/entityTypes/{entityTypesId}/entities:batchDelete", "httpMethod": "POST", "id": "dialogflow.projects.agent.entityTypes.entities.batchDelete", @@ -724,7 +724,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the entity type to delete entries for. Format:\n`projects//agent/entityTypes/`.", + "description": "Required. The name of the entity type to delete entries for. Format: `projects//agent/entityTypes/`.", "location": "path", "pattern": "^projects/[^/]+/agent/entityTypes/[^/]+$", "required": true, @@ -744,7 +744,7 @@ ] }, "batchUpdate": { - "description": "Updates or creates multiple entities in the specified entity type. This\nmethod does not affect entities in the entity type that aren't explicitly\nspecified in the request.\n\n\nOperation ", + "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 ", "flatPath": "v2/projects/{projectsId}/agent/entityTypes/{entityTypesId}/entities:batchUpdate", "httpMethod": "POST", "id": "dialogflow.projects.agent.entityTypes.entities.batchUpdate", @@ -753,7 +753,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the entity type to update or create entities in.\nFormat: `projects//agent/entityTypes/`.", + "description": "Required. The name of the entity type to update or create entities in. Format: `projects//agent/entityTypes/`.", "location": "path", "pattern": "^projects/[^/]+/agent/entityTypes/[^/]+$", "required": true, @@ -788,7 +788,7 @@ ], "parameters": { "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By default 100 and\nat most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -799,7 +799,7 @@ "type": "string" }, "parent": { - "description": "Required. The agent to list all environments from.\nFormat: `projects//agent`.", + "description": "Required. The agent to list all environments from. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/agent$", "required": true, @@ -831,7 +831,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the session to delete all contexts from. Format:\n`projects//agent/sessions/` or `projects//agent/environments//users//sessions/`.\nIf `Environment ID` is not specified we assume default 'draft' environment.\nIf `User ID` is not specified, we assume default '-' user.", + "description": "Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. 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/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$", "required": true, @@ -848,7 +848,7 @@ ] }, "detectIntent": { - "description": "Processes a natural language query and returns structured, actionable data\nas a result. This method is not idempotent, because it may cause contexts\nand session entity types to be updated, which in turn might affect\nresults of future queries.", + "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.", "flatPath": "v2/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}:detectIntent", "httpMethod": "POST", "id": "dialogflow.projects.agent.environments.users.sessions.detectIntent", @@ -857,7 +857,7 @@ ], "parameters": { "session": { - "description": "Required. The name of the session this query is sent to. Format:\n`projects//agent/sessions/`, or\n`projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume\ndefault 'draft' environment. If `User ID` is not specified, we are using\n\"-\". It's up to the API caller to choose an appropriate `Session ID` and\n`User Id`. They can be a random number or some type of user and session\nidentifiers (preferably hashed). The length of the `Session ID` and\n`User ID` must not exceed 36 characters.\n\nFor more information, see the [API interactions\nguide](https://cloud.google.com/dialogflow/docs/api-overview).", + "description": "Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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).", "location": "path", "pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$", "required": true, @@ -881,7 +881,7 @@ "contexts": { "methods": { "create": { - "description": "Creates a context.\n\nIf the specified context already exists, overrides the context.", + "description": "Creates a context. If the specified context already exists, overrides the context.", "flatPath": "v2/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/contexts", "httpMethod": "POST", "id": "dialogflow.projects.agent.environments.users.sessions.contexts.create", @@ -890,7 +890,7 @@ ], "parameters": { "parent": { - "description": "Required. The session to create a context for.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//sessions/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. 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/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$", "required": true, @@ -919,7 +919,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the context to delete. Format:\n`projects//agent/sessions//contexts/`\nor `projects//agent/environments//users//sessions//contexts/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. 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/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -945,7 +945,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the context. Format:\n`projects//agent/sessions//contexts/`\nor `projects//agent/environments//users//sessions//contexts/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. 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/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -971,7 +971,7 @@ ], "parameters": { "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 100 and at most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -982,7 +982,7 @@ "type": "string" }, "parent": { - "description": "Required. The session to list all contexts from.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//sessions/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. 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/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$", "required": true, @@ -1008,7 +1008,7 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of the context. Format:\n`projects//agent/sessions//contexts/`,\nor `projects//agent/environments//users//sessions//contexts/`.\n\nThe `Context ID` is always converted to lowercase, may only contain\ncharacters in a-zA-Z0-9_-% and may be at most 250 bytes long.\n\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.\n\nThe following context names are reserved for internal use by Dialogflow.\nYou should not use these contexts or create contexts with these names:\n\n* `__system_counters__`\n* `*_id_dialog_context`\n* `*_dialog_params_size`", + "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`", "location": "path", "pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -1038,7 +1038,7 @@ "entityTypes": { "methods": { "create": { - "description": "Creates a session entity type.\n\nIf the specified session entity type already exists, overrides the session\nentity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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": "v2/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes", "httpMethod": "POST", "id": "dialogflow.projects.agent.environments.users.sessions.entityTypes.create", @@ -1047,7 +1047,7 @@ ], "parameters": { "parent": { - "description": "Required. The session to create a session entity type for.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//\nsessions/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. 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/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$", "required": true, @@ -1067,7 +1067,7 @@ ] }, "delete": { - "description": "Deletes the specified session entity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes/{entityTypesId}", "httpMethod": "DELETE", "id": "dialogflow.projects.agent.environments.users.sessions.entityTypes.delete", @@ -1076,7 +1076,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the entity type to delete. Format:\n`projects//agent/sessions//entityTypes/` or `projects//agent/environments//users//sessions//entityTypes/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The name of the entity type to delete. 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.", "location": "path", "pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/entityTypes/[^/]+$", "required": true, @@ -1093,7 +1093,7 @@ ] }, "get": { - "description": "Retrieves the specified session entity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes/{entityTypesId}", "httpMethod": "GET", "id": "dialogflow.projects.agent.environments.users.sessions.entityTypes.get", @@ -1102,7 +1102,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the session entity type. Format:\n`projects//agent/sessions//entityTypes/` or `projects//agent/environments//users//sessions//entityTypes/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The name of the 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.", "location": "path", "pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/entityTypes/[^/]+$", "required": true, @@ -1119,7 +1119,7 @@ ] }, "list": { - "description": "Returns the list of all session entity types in the specified session.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes", "httpMethod": "GET", "id": "dialogflow.projects.agent.environments.users.sessions.entityTypes.list", @@ -1128,7 +1128,7 @@ ], "parameters": { "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 100 and at most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -1139,7 +1139,7 @@ "type": "string" }, "parent": { - "description": "Required. The session to list all session entity types from.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//\nsessions/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. 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/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$", "required": true, @@ -1156,7 +1156,7 @@ ] }, "patch": { - "description": "Updates the specified session entity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes/{entityTypesId}", "httpMethod": "PATCH", "id": "dialogflow.projects.agent.environments.users.sessions.entityTypes.patch", @@ -1165,7 +1165,7 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of this session entity type. Format:\n`projects//agent/sessions//entityTypes/`, or `projects//agent/environments//users//sessions//entityTypes/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.\n\n`` must be the display name of an existing entity\ntype in the same agent that will be overridden or supplemented.", + "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.", "location": "path", "pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/entityTypes/[^/]+$", "required": true, @@ -1201,7 +1201,7 @@ "intents": { "methods": { "batchDelete": { - "description": "Deletes intents in the specified agent.\n\nOperation ", + "description": "Deletes intents in the specified agent. Operation ", "flatPath": "v2/projects/{projectsId}/agent/intents:batchDelete", "httpMethod": "POST", "id": "dialogflow.projects.agent.intents.batchDelete", @@ -1210,7 +1210,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the agent to delete all entities types for. Format:\n`projects//agent`.", + "description": "Required. The name of the agent to delete all entities types for. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/agent$", "required": true, @@ -1230,7 +1230,7 @@ ] }, "batchUpdate": { - "description": "Updates/Creates multiple intents in the specified agent.\n\nOperation ", + "description": "Updates/Creates multiple intents in the specified agent. Operation ", "flatPath": "v2/projects/{projectsId}/agent/intents:batchUpdate", "httpMethod": "POST", "id": "dialogflow.projects.agent.intents.batchUpdate", @@ -1239,7 +1239,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the agent to update or create intents in.\nFormat: `projects//agent`.", + "description": "Required. The name of the agent to update or create intents in. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/agent$", "required": true, @@ -1273,16 +1273,20 @@ "INTENT_VIEW_UNSPECIFIED", "INTENT_VIEW_FULL" ], + "enumDescriptions": [ + "Training phrases field is not populated in the response.", + "All fields are populated." + ], "location": "query", "type": "string" }, "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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 intent for.\nFormat: `projects//agent`.", + "description": "Required. The agent to create a intent for. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/agent$", "required": true, @@ -1311,7 +1315,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the intent to delete. If this intent has direct or\nindirect followup intents, we also delete them.\nFormat: `projects//agent/intents/`.", + "description": "Required. The name of the intent to delete. If this intent has direct or indirect followup intents, we also delete them. Format: `projects//agent/intents/`.", "location": "path", "pattern": "^projects/[^/]+/agent/intents/[^/]+$", "required": true, @@ -1342,16 +1346,20 @@ "INTENT_VIEW_UNSPECIFIED", "INTENT_VIEW_FULL" ], + "enumDescriptions": [ + "Training phrases field is not populated in the response.", + "All fields are populated." + ], "location": "query", "type": "string" }, "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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 intent.\nFormat: `projects//agent/intents/`.", + "description": "Required. The name of the intent. Format: `projects//agent/intents/`.", "location": "path", "pattern": "^projects/[^/]+/agent/intents/[^/]+$", "required": true, @@ -1382,16 +1390,20 @@ "INTENT_VIEW_UNSPECIFIED", "INTENT_VIEW_FULL" ], + "enumDescriptions": [ + "Training phrases field is not populated in the response.", + "All fields are populated." + ], "location": "query", "type": "string" }, "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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" }, "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 100 and at most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -1402,7 +1414,7 @@ "type": "string" }, "parent": { - "description": "Required. The agent to list all intents from.\nFormat: `projects//agent`.", + "description": "Required. The agent to list all intents from. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/agent$", "required": true, @@ -1433,16 +1445,20 @@ "INTENT_VIEW_UNSPECIFIED", "INTENT_VIEW_FULL" ], + "enumDescriptions": [ + "Training phrases field is not populated in the response.", + "All fields are populated." + ], "location": "query", "type": "string" }, "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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": "Optional. The unique identifier of this intent.\nRequired for Intents.UpdateIntent and Intents.BatchUpdateIntents\nmethods.\nFormat: `projects//agent/intents/`.", + "description": "Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`.", "location": "path", "pattern": "^projects/[^/]+/agent/intents/[^/]+$", "required": true, @@ -1481,7 +1497,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the session to delete all contexts from. Format:\n`projects//agent/sessions/` or `projects//agent/environments//users//sessions/`.\nIf `Environment ID` is not specified we assume default 'draft' environment.\nIf `User ID` is not specified, we assume default '-' user.", + "description": "Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. 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/[^/]+/agent/sessions/[^/]+$", "required": true, @@ -1498,7 +1514,7 @@ ] }, "detectIntent": { - "description": "Processes a natural language query and returns structured, actionable data\nas a result. This method is not idempotent, because it may cause contexts\nand session entity types to be updated, which in turn might affect\nresults of future queries.", + "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.", "flatPath": "v2/projects/{projectsId}/agent/sessions/{sessionsId}:detectIntent", "httpMethod": "POST", "id": "dialogflow.projects.agent.sessions.detectIntent", @@ -1507,7 +1523,7 @@ ], "parameters": { "session": { - "description": "Required. The name of the session this query is sent to. Format:\n`projects//agent/sessions/`, or\n`projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume\ndefault 'draft' environment. If `User ID` is not specified, we are using\n\"-\". It's up to the API caller to choose an appropriate `Session ID` and\n`User Id`. They can be a random number or some type of user and session\nidentifiers (preferably hashed). The length of the `Session ID` and\n`User ID` must not exceed 36 characters.\n\nFor more information, see the [API interactions\nguide](https://cloud.google.com/dialogflow/docs/api-overview).", + "description": "Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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).", "location": "path", "pattern": "^projects/[^/]+/agent/sessions/[^/]+$", "required": true, @@ -1531,7 +1547,7 @@ "contexts": { "methods": { "create": { - "description": "Creates a context.\n\nIf the specified context already exists, overrides the context.", + "description": "Creates a context. If the specified context already exists, overrides the context.", "flatPath": "v2/projects/{projectsId}/agent/sessions/{sessionsId}/contexts", "httpMethod": "POST", "id": "dialogflow.projects.agent.sessions.contexts.create", @@ -1540,7 +1556,7 @@ ], "parameters": { "parent": { - "description": "Required. The session to create a context for.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//sessions/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. 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/[^/]+/agent/sessions/[^/]+$", "required": true, @@ -1569,7 +1585,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the context to delete. Format:\n`projects//agent/sessions//contexts/`\nor `projects//agent/environments//users//sessions//contexts/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. 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/[^/]+/agent/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -1595,7 +1611,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the context. Format:\n`projects//agent/sessions//contexts/`\nor `projects//agent/environments//users//sessions//contexts/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. 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/[^/]+/agent/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -1621,7 +1637,7 @@ ], "parameters": { "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 100 and at most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -1632,7 +1648,7 @@ "type": "string" }, "parent": { - "description": "Required. The session to list all contexts from.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//sessions/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. 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/[^/]+/agent/sessions/[^/]+$", "required": true, @@ -1658,7 +1674,7 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of the context. Format:\n`projects//agent/sessions//contexts/`,\nor `projects//agent/environments//users//sessions//contexts/`.\n\nThe `Context ID` is always converted to lowercase, may only contain\ncharacters in a-zA-Z0-9_-% and may be at most 250 bytes long.\n\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.\n\nThe following context names are reserved for internal use by Dialogflow.\nYou should not use these contexts or create contexts with these names:\n\n* `__system_counters__`\n* `*_id_dialog_context`\n* `*_dialog_params_size`", + "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`", "location": "path", "pattern": "^projects/[^/]+/agent/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -1688,7 +1704,7 @@ "entityTypes": { "methods": { "create": { - "description": "Creates a session entity type.\n\nIf the specified session entity type already exists, overrides the session\nentity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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": "v2/projects/{projectsId}/agent/sessions/{sessionsId}/entityTypes", "httpMethod": "POST", "id": "dialogflow.projects.agent.sessions.entityTypes.create", @@ -1697,7 +1713,7 @@ ], "parameters": { "parent": { - "description": "Required. The session to create a session entity type for.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//\nsessions/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. 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/[^/]+/agent/sessions/[^/]+$", "required": true, @@ -1717,7 +1733,7 @@ ] }, "delete": { - "description": "Deletes the specified session entity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2/projects/{projectsId}/agent/sessions/{sessionsId}/entityTypes/{entityTypesId}", "httpMethod": "DELETE", "id": "dialogflow.projects.agent.sessions.entityTypes.delete", @@ -1726,7 +1742,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the entity type to delete. Format:\n`projects//agent/sessions//entityTypes/` or `projects//agent/environments//users//sessions//entityTypes/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The name of the entity type to delete. 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.", "location": "path", "pattern": "^projects/[^/]+/agent/sessions/[^/]+/entityTypes/[^/]+$", "required": true, @@ -1743,7 +1759,7 @@ ] }, "get": { - "description": "Retrieves the specified session entity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2/projects/{projectsId}/agent/sessions/{sessionsId}/entityTypes/{entityTypesId}", "httpMethod": "GET", "id": "dialogflow.projects.agent.sessions.entityTypes.get", @@ -1752,7 +1768,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the session entity type. Format:\n`projects//agent/sessions//entityTypes/` or `projects//agent/environments//users//sessions//entityTypes/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The name of the 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.", "location": "path", "pattern": "^projects/[^/]+/agent/sessions/[^/]+/entityTypes/[^/]+$", "required": true, @@ -1769,7 +1785,7 @@ ] }, "list": { - "description": "Returns the list of all session entity types in the specified session.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2/projects/{projectsId}/agent/sessions/{sessionsId}/entityTypes", "httpMethod": "GET", "id": "dialogflow.projects.agent.sessions.entityTypes.list", @@ -1778,7 +1794,7 @@ ], "parameters": { "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 100 and at most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -1789,7 +1805,7 @@ "type": "string" }, "parent": { - "description": "Required. The session to list all session entity types from.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//\nsessions/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. 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/[^/]+/agent/sessions/[^/]+$", "required": true, @@ -1806,7 +1822,7 @@ ] }, "patch": { - "description": "Updates the specified session entity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2/projects/{projectsId}/agent/sessions/{sessionsId}/entityTypes/{entityTypesId}", "httpMethod": "PATCH", "id": "dialogflow.projects.agent.sessions.entityTypes.patch", @@ -1815,7 +1831,7 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of this session entity type. Format:\n`projects//agent/sessions//entityTypes/`, or `projects//agent/environments//users//sessions//entityTypes/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.\n\n`` must be the display name of an existing entity\ntype in the same agent that will be overridden or supplemented.", + "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.", "location": "path", "pattern": "^projects/[^/]+/agent/sessions/[^/]+/entityTypes/[^/]+$", "required": true, @@ -1851,7 +1867,7 @@ "operations": { "methods": { "cancel": { - "description": "Starts asynchronous cancellation on a long-running operation. The server\nmakes a best effort to cancel the operation, but success is not\nguaranteed. If the server doesn't support this method, it returns\n`google.rpc.Code.UNIMPLEMENTED`. Clients can use\nOperations.GetOperation or\nother methods to check whether the cancellation succeeded or whether the\noperation completed despite cancellation. On successful cancellation,\nthe operation is not deleted; instead, it becomes an operation with\nan Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.", + "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`.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", "httpMethod": "POST", "id": "dialogflow.projects.locations.operations.cancel", @@ -1877,7 +1893,7 @@ ] }, "get": { - "description": "Gets the latest state of a long-running operation. Clients can use this\nmethod to poll the operation result at intervals as recommended by the API\nservice.", + "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.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", "httpMethod": "GET", "id": "dialogflow.projects.locations.operations.get", @@ -1903,7 +1919,7 @@ ] }, "list": { - "description": "Lists operations that match the specified filter in the request. If the\nserver doesn't support this method, it returns `UNIMPLEMENTED`.\n\nNOTE: the `name` binding allows API services to override the binding\nto use different resource name schemes, such as `users/*/operations`. To\noverride the binding, API services can add a binding such as\n`\"/v1/{name=users/*}/operations\"` to their service configuration.\nFor backwards compatibility, the default name includes the operations\ncollection id, however overriding users must ensure the name binding\nis the parent resource, without the operations collection id.", + "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.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/operations", "httpMethod": "GET", "id": "dialogflow.projects.locations.operations.list", @@ -1951,7 +1967,7 @@ "operations": { "methods": { "cancel": { - "description": "Starts asynchronous cancellation on a long-running operation. The server\nmakes a best effort to cancel the operation, but success is not\nguaranteed. If the server doesn't support this method, it returns\n`google.rpc.Code.UNIMPLEMENTED`. Clients can use\nOperations.GetOperation or\nother methods to check whether the cancellation succeeded or whether the\noperation completed despite cancellation. On successful cancellation,\nthe operation is not deleted; instead, it becomes an operation with\nan Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.", + "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`.", "flatPath": "v2/projects/{projectsId}/operations/{operationsId}:cancel", "httpMethod": "POST", "id": "dialogflow.projects.operations.cancel", @@ -1977,7 +1993,7 @@ ] }, "get": { - "description": "Gets the latest state of a long-running operation. Clients can use this\nmethod to poll the operation result at intervals as recommended by the API\nservice.", + "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.", "flatPath": "v2/projects/{projectsId}/operations/{operationsId}", "httpMethod": "GET", "id": "dialogflow.projects.operations.get", @@ -2003,7 +2019,7 @@ ] }, "list": { - "description": "Lists operations that match the specified filter in the request. If the\nserver doesn't support this method, it returns `UNIMPLEMENTED`.\n\nNOTE: the `name` binding allows API services to override the binding\nto use different resource name schemes, such as `users/*/operations`. To\noverride the binding, API services can add a binding such as\n`\"/v1/{name=users/*}/operations\"` to their service configuration.\nFor backwards compatibility, the default name includes the operations\ncollection id, however overriding users must ensure the name binding\nis the parent resource, without the operations collection id.", + "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.", "flatPath": "v2/projects/{projectsId}/operations", "httpMethod": "GET", "id": "dialogflow.projects.operations.list", @@ -2049,7 +2065,7 @@ } } }, - "revision": "20200719", + "revision": "20200801", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3beta1ExportAgentResponse": { @@ -2062,7 +2078,7 @@ "type": "string" }, "agentUri": { - "description": "The URI to a file containing the exported agent. This field is populated\nonly if `agent_uri` is specified in ExportAgentRequest.", + "description": "The URI to a file containing the exported agent. This field is populated only if `agent_uri` is specified in ExportAgentRequest.", "type": "string" } }, @@ -2073,12 +2089,12 @@ "id": "GoogleCloudDialogflowCxV3beta1PageInfo", "properties": { "currentPage": { - "description": "Always present for WebhookRequest. Ignored for WebhookResponse.\nThe unique identifier of the current page.\nFormat: `projects//locations//agents//flows//pages/`.", + "description": "Always present for WebhookRequest. Ignored for WebhookResponse. The unique identifier of the current page. Format: `projects//locations//agents//flows//pages/`.", "type": "string" }, "formInfo": { "$ref": "GoogleCloudDialogflowCxV3beta1PageInfoFormInfo", - "description": "Optional for both WebhookRequest and WebhookResponse.\nInformation about the form." + "description": "Optional for both WebhookRequest and WebhookResponse. Information about the form." } }, "type": "object" @@ -2088,7 +2104,7 @@ "id": "GoogleCloudDialogflowCxV3beta1PageInfoFormInfo", "properties": { "parameterInfo": { - "description": "Optional for both WebhookRequest and WebhookResponse.\nThe parameters contained in the form. Note that the webhook cannot add\nor remove any form parameter.", + "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": "GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo" }, @@ -2102,19 +2118,19 @@ "id": "GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo", "properties": { "displayName": { - "description": "Always present for WebhookRequest. Required for\nWebhookResponse.\nThe human-readable name of the parameter, unique within the form. This\nfield cannot be modified by the webhook.", + "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.\nIndicates if the parameter value was just collected on the last\nconversation turn.", + "description": "Optional for WebhookRequest. Ignored for WebhookResponse. Indicates if the parameter value was just collected on the last conversation turn.", "type": "boolean" }, "required": { - "description": "Optional for both WebhookRequest and WebhookResponse.\nIndicates whether the parameter is required. Optional parameters will\nnot trigger prompts; however, they are filled if the user specifies\nthem. Required parameters must be filled before form filling concludes.", + "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\nWebhookResponse. The state of the parameter. This field can be set\nto INVALID by\nthe webhook to invalidate the parameter; other values set by the\nwebhook will be ignored.", + "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", @@ -2124,20 +2140,20 @@ "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\nby the webhook to invalidate the parameter and ask the server to\ncollect it from the user again.", + "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" }, "value": { - "description": "Optional for both WebhookRequest and WebhookResponse.\nThe value of the parameter. This field can be set by the webhook to\nchange the parameter 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" } }, "type": "object" }, "GoogleCloudDialogflowCxV3beta1ResponseMessage": { - "description": "Represents a response message that can be returned by a conversational agent.\n\nResponse messages are also used for output audio synthesis. The approach is\nas follows:\n\n* If at least one OutputAudioText response is present, then all\n OutputAudioText responses are linearly concatenated, and the result is used\n for output audio synthesis.\n* If the OutputAudioText responses are a mixture of text and SSML, then the\n concatenated result is treated as SSML; otherwise, the result is treated as\n either text or SSML as appropriate. The agent designer should ideally use\n either text or SSML consistently throughout the bot design.\n* Otherwise, all Text responses are linearly concatenated, and the result is\n used for output audio synthesis.\n\nThis approach allows for more sophisticated user experience scenarios, where\nthe text displayed to the user may differ from what is heard.", + "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", "properties": { "conversationSuccess": { @@ -2146,7 +2162,8 @@ }, "endInteraction": { "$ref": "GoogleCloudDialogflowCxV3beta1ResponseMessageEndInteraction", - "description": "Output only. A signal that indicates the interaction with the Dialogflow agent has\nended.\nThis message is generated by Dialogflow only when the conversation\nreaches `END_SESSION` or `END_PAGE` page. It is not supposed to be\ndefined by the user.\nIt's guaranteed that there is at most one such message in each response." + "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.", + "readOnly": true }, "humanAgentHandoff": { "$ref": "GoogleCloudDialogflowCxV3beta1ResponseMessageHumanAgentHandoff", @@ -2158,11 +2175,12 @@ }, "mixedAudio": { "$ref": "GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudio", - "description": "Output only. An audio response message composed of both the synthesized Dialogflow\nagent responses and responses defined via\nplay_audio.\nThis message is generated by Dialogflow only and not supposed to be\ndefined by the user." + "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.", + "readOnly": true }, "outputAudioText": { "$ref": "GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText", - "description": "A text or ssml response that is preferentially used for TTS output audio\nsynthesis, as described in the comment on the ResponseMessage message." + "description": "A text or ssml response that is preferentially used for TTS output audio synthesis, as described in the comment on the ResponseMessage message." }, "payload": { "additionalProperties": { @@ -2174,7 +2192,7 @@ }, "playAudio": { "$ref": "GoogleCloudDialogflowCxV3beta1ResponseMessagePlayAudio", - "description": "Signal that the client should play an audio clip hosted at a\nclient-specific URI. Dialogflow uses this to construct\nmixed_audio. However, Dialogflow itself\ndoes not try to read or process the URI in any way." + "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." }, "text": { "$ref": "GoogleCloudDialogflowCxV3beta1ResponseMessageText", @@ -2184,7 +2202,7 @@ "type": "object" }, "GoogleCloudDialogflowCxV3beta1ResponseMessageConversationSuccess": { - "description": "Indicates that the conversation succeeded, i.e., the bot handled the issue\nthat the customer talked to it about.\n\nDialogflow only uses this to determine which conversations should be\ncounted as successful and doesn't process the metadata in this message in\nany way. Note that Dialogflow also considers conversations that get to the\nconversation end page as successful even if they don't return\nConversationSuccess.\n\nYou may set this, for example:\n* In the entry_fulfillment of a Page if\n entering the page indicates that the conversation succeeded.\n* In a webhook response when you determine that you handled the customer\n issue.", + "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", "properties": { "metadata": { @@ -2199,13 +2217,13 @@ "type": "object" }, "GoogleCloudDialogflowCxV3beta1ResponseMessageEndInteraction": { - "description": "Indicates that interaction with the Dialogflow agent has ended.\nThis message is generated by Dialogflow only and not supposed to be\ndefined by the user.", + "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", "properties": {}, "type": "object" }, "GoogleCloudDialogflowCxV3beta1ResponseMessageHumanAgentHandoff": { - "description": "Indicates that the conversation should be handed off to a human agent.\n\nDialogflow only uses this to determine which conversations were handed off\nto a human agent for measurement purposes. What else to do with this signal\nis up to you and your handoff procedures.\n\nYou may set this, for example:\n* In the entry_fulfillment of a Page if\n entering the page indicates something went extremely wrong in the\n conversation.\n* In a webhook response when you determine that the customer issue can only\n be handled by a human.", + "description": "Indicates that the conversation should be handed off to a human 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": "GoogleCloudDialogflowCxV3beta1ResponseMessageHumanAgentHandoff", "properties": { "metadata": { @@ -2213,14 +2231,14 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Custom metadata for your handoff procedure. Dialogflow doesn't impose\nany structure on this.", + "description": "Custom metadata for your handoff procedure. Dialogflow doesn't impose any structure on this.", "type": "object" } }, "type": "object" }, "GoogleCloudDialogflowCxV3beta1ResponseMessageLiveAgentHandoff": { - "description": "Indicates that the conversation should be handed off to a live agent.\n\nDialogflow only uses this to determine which conversations were handed off\nto a human agent for measurement purposes. What else to do with this signal\nis up to you and your handoff procedures.\n\nYou may set this, for example:\n* In the entry_fulfillment of a Page if\n entering the page indicates something went extremely wrong in the\n conversation.\n* In a webhook response when you determine that the customer issue can only\n be handled by a human.", + "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": { @@ -2228,14 +2246,14 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Custom metadata for your handoff procedure. Dialogflow doesn't impose\nany structure on this.", + "description": "Custom metadata for your handoff procedure. Dialogflow doesn't impose any structure on this.", "type": "object" } }, "type": "object" }, "GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudio": { - "description": "Represents an audio message that is composed of both segments\nsynthesized from the Dialogflow agent prompts and ones hosted externally\nat the specified URIs.\nThe external URIs are specified via\nplay_audio.\nThis message is generated by Dialogflow only and not supposed to be\ndefined by the user.", + "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.", "id": "GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudio", "properties": { "segments": { @@ -2253,27 +2271,27 @@ "id": "GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudioSegment", "properties": { "allowPlaybackInterruption": { - "description": "Whether the playback of this segment can be interrupted by the end\nuser's speech and the client should then start the next Dialogflow\nrequest.", + "description": "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.", "type": "boolean" }, "audio": { - "description": "Raw audio synthesized from the Dialogflow agent's response using\nthe output config specified in the request.", + "description": "Raw audio synthesized from the Dialogflow agent's response using the output config specified in the request.", "format": "byte", "type": "string" }, "uri": { - "description": "Client-specific URI that points to an audio clip accessible to the\nclient. Dialogflow does not impose any validation on it.", + "description": "Client-specific URI that points to an audio clip accessible to the client. Dialogflow does not impose any validation on it.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText": { - "description": "A text or ssml response that is preferentially used for TTS output audio\nsynthesis, as described in the comment on the ResponseMessage message.", + "description": "A text or ssml response that is preferentially used for TTS output audio synthesis, as described in the comment on the ResponseMessage message.", "id": "GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText", "properties": { "ssml": { - "description": "The SSML text to be synthesized. For more information, see\n[SSML](/speech/text-to-speech/docs/ssml).", + "description": "The SSML text to be synthesized. For more information, see [SSML](/speech/text-to-speech/docs/ssml).", "type": "string" }, "text": { @@ -2288,11 +2306,11 @@ "id": "GoogleCloudDialogflowCxV3beta1ResponseMessagePlayAudio", "properties": { "allowPlaybackInterruption": { - "description": "Whether the playback of this message can be interrupted by the end\nuser's speech and the client can then starts the next Dialogflow\nrequest.", + "description": "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\nvalue. It is specific to the client that reads it.", + "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" } }, @@ -2303,7 +2321,7 @@ "id": "GoogleCloudDialogflowCxV3beta1ResponseMessageText", "properties": { "allowPlaybackInterruption": { - "description": "Whether the playback of this message can be interrupted by the end\nuser's speech and the client can then starts the next Dialogflow\nrequest.", + "description": "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" }, "text": { @@ -2324,11 +2342,11 @@ "additionalProperties": { "type": "any" }, - "description": "Optional for WebhookRequest. Optional for WebhookResponse.\nAll parameters collected from forms and intents during the session.\nParameters can be created, updated, or removed by the webhook. To remove a\nparameter from the session, the webhook should explicitly set the parameter\nvalue to null in WebhookResponse. The map is keyed by parameters'\ndisplay names.", + "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" }, "session": { - "description": "Always present for WebhookRequest. Ignored for WebhookResponse.\nThe unique identifier of the session. This\nfield can be used by the webhook to identify a user.\nFormat: `projects//locations//agents//sessions/`.", + "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" } }, @@ -2339,19 +2357,19 @@ "id": "GoogleCloudDialogflowCxV3beta1WebhookRequest", "properties": { "detectIntentResponseId": { - "description": "Always present. The unique identifier of the DetectIntentResponse that\nwill be returned to the API caller.", + "description": "Always present. The unique identifier of the DetectIntentResponse that will be returned to the API caller.", "type": "string" }, "fulfillmentInfo": { "$ref": "GoogleCloudDialogflowCxV3beta1WebhookRequestFulfillmentInfo", - "description": "Always present. Information about the fulfillment that triggered this\nwebhook call." + "description": "Always present. Information about the fulfillment that triggered this webhook call." }, "intentInfo": { "$ref": "GoogleCloudDialogflowCxV3beta1WebhookRequestIntentInfo", "description": "Information about the last matched intent." }, "messages": { - "description": "The list of rich message responses to present to the user. Webhook can\nchoose to append or replace this list in\nWebhookResponse.fulfillment_response;", + "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" }, @@ -2381,7 +2399,7 @@ "id": "GoogleCloudDialogflowCxV3beta1WebhookRequestFulfillmentInfo", "properties": { "tag": { - "description": "Always present. The tag used to identify which fulfillment is being\ncalled.", + "description": "Always present. The tag used to identify which fulfillment is being called.", "type": "string" } }, @@ -2392,14 +2410,14 @@ "id": "GoogleCloudDialogflowCxV3beta1WebhookRequestIntentInfo", "properties": { "lastMatchedIntent": { - "description": "Always present. The unique identifier of the last matched\nintent. Format: `projects//locations//agents//intents/`.", + "description": "Always present. The unique identifier of the last matched intent. Format: `projects//locations//agents//intents/`.", "type": "string" }, "parameters": { "additionalProperties": { "$ref": "GoogleCloudDialogflowCxV3beta1WebhookRequestIntentInfoIntentParameterValue" }, - "description": "Parameters identified as a result of intent matching. This is a map of\nthe name of the identified parameter to the value of the parameter\nidentified from the user's utterance. All parameters defined in the\nmatched intent that are identified will be surfaced here.", + "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" } }, @@ -2414,7 +2432,7 @@ "type": "string" }, "resolvedValue": { - "description": "Always present. Structured value for the parameter extracted from user\nutterance.", + "description": "Always present. Structured value for the parameter extracted from user utterance.", "type": "any" } }, @@ -2426,11 +2444,11 @@ "properties": { "fulfillmentResponse": { "$ref": "GoogleCloudDialogflowCxV3beta1WebhookResponseFulfillmentResponse", - "description": "The fulfillment response to send to the user. This field can be omitted by\nthe webhook if it does not intend to send any response to the user." + "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." }, "pageInfo": { "$ref": "GoogleCloudDialogflowCxV3beta1PageInfo", - "description": "Information about page status. This field can be omitted by the webhook if\nit does not intend to modify page status." + "description": "Information about page status. This field can be omitted by the webhook if it does not intend to modify page status." }, "payload": { "additionalProperties": { @@ -2442,14 +2460,14 @@ }, "sessionInfo": { "$ref": "GoogleCloudDialogflowCxV3beta1SessionInfo", - "description": "Information about session status. This field can be omitted by the webhook\nif it does not intend to modify session status." + "description": "Information about session status. This field can be omitted by the webhook if it does not intend to modify session status." }, "targetFlow": { - "description": "The target flow to transition to.\nFormat: `projects//locations//agents//flows/`.", + "description": "The target flow to transition to. Format: `projects//locations//agents//flows/`.", "type": "string" }, "targetPage": { - "description": "The target page to transition to.\nFormat: `projects//locations//agents//flows//pages/`.", + "description": "The target page to transition to. Format: `projects//locations//agents//flows//pages/`.", "type": "string" } }, @@ -2468,8 +2486,8 @@ ], "enumDescriptions": [ "Not specified. `APPEND` will be used.", - "`messages` will be appended to the list of messages waiting to be sent\nto the user.", - "`messages` will replace the list of messages waiting to be sent to the\nuser." + "`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": "string" }, @@ -2484,11 +2502,11 @@ "type": "object" }, "GoogleCloudDialogflowV2Agent": { - "description": "A Dialogflow agent is a virtual agent that handles conversations with your\nend-users. It is a natural language understanding module that understands the\nnuances of human language. Dialogflow translates end-user text or audio\nduring a conversation to structured data that your apps and services can\nunderstand. You design and build a Dialogflow agent to handle the types of\nconversations required for your system.\n\nFor more information about agents, see the\n[Agent guide](https://cloud.google.com/dialogflow/docs/agents-overview).", + "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).", "id": "GoogleCloudDialogflowV2Agent", "properties": { "apiVersion": { - "description": "Optional. API version displayed in Dialogflow console. If not specified,\nV2 API is assumed. Clients are free to query different service endpoints\nfor different API versions. However, bots connectors and webhook calls will\nfollow the specified API version.", + "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.", "enum": [ "API_VERSION_UNSPECIFIED", "API_VERSION_V1", @@ -2504,20 +2522,20 @@ "type": "string" }, "avatarUri": { - "description": "Optional. The URI of the agent's avatar.\nAvatars are used throughout the Dialogflow console and in the self-hosted\n[Web\nDemo](https://cloud.google.com/dialogflow/docs/integrations/web-demo)\nintegration.", + "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" }, "classificationThreshold": { - "description": "Optional. To filter out false positive results and still get variety in\nmatched natural language inputs for your agent, you can tune the machine\nlearning classification threshold. If the returned score value is less than\nthe threshold value, then a fallback intent will be triggered or, if there\nare no fallback intents defined, no intent will be triggered. The score\nvalues range from 0.0 (completely uncertain) to 1.0 (completely certain).\nIf set to 0.0, the default of 0.3 is used.", + "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.", "format": "float", "type": "number" }, "defaultLanguageCode": { - "description": "Required. The default language of the agent as a language tag. See\n[Language\nSupport](https://cloud.google.com/dialogflow/docs/reference/language)\nfor a list of the currently supported language codes. This field cannot be\nset by the `Update` method.", + "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" }, "description": { - "description": "Optional. The description of this agent.\nThe maximum length is 500 characters. If exceeded, the request is rejected.", + "description": "Optional. The description of this agent. The maximum length is 500 characters. If exceeded, the request is rejected.", "type": "string" }, "displayName": { @@ -2537,17 +2555,17 @@ ], "enumDescriptions": [ "Not specified.", - "Best for agents with a small number of examples in intents and/or wide\nuse of templates syntax and composite entities.", - "Can be used for agents with a large number of examples in intents,\nespecially the ones using @sys.any or very large custom entities." + "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." ], "type": "string" }, "parent": { - "description": "Required. The project of this agent.\nFormat: `projects/`.", + "description": "Required. The project of this agent. Format: `projects/`.", "type": "string" }, "supportedLanguageCodes": { - "description": "Optional. The list of all languages supported by this agent (except for the\n`default_language_code`).", + "description": "Optional. The list of all languages supported by this agent (except for the `default_language_code`).", "items": { "type": "string" }, @@ -2570,22 +2588,22 @@ "type": "string" }, "timeZone": { - "description": "Required. The time zone of this agent from the\n[time zone database](https://www.iana.org/time-zones), e.g.,\nAmerica/New_York, Europe/Paris.", + "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.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2AnnotatedMessagePart": { - "description": "Represents a part of a message possibly annotated with an entity. The part\ncan be an entity or purely a part of the message between two entities or\nmessage start/end.", + "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", "properties": { "entityType": { - "description": "The [Dialogflow system entity\ntype](https://cloud.google.com/dialogflow/docs/reference/system-entities)\nof this message part. If this is empty, Dialogflow could not annotate the\nphrase part with a system entity.", + "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\n](https://cloud.google.com/dialogflow/docs/reference/system-entities) of\nthis message part. For example for a system entity of type\n`@sys.unit-currency`, this may contain:\n
\n{\n  \"amount\": 5,\n  \"currency\": \"USD\"\n}\n
", + "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": { @@ -2607,7 +2625,7 @@ "type": "array" }, "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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" } }, @@ -2618,14 +2636,14 @@ "id": "GoogleCloudDialogflowV2BatchDeleteEntitiesRequest", "properties": { "entityValues": { - "description": "Required. The reference `values` of the entities to delete. Note that\nthese are not fully-qualified names, i.e. they don't start with\n`projects/`.", + "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" }, "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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" } }, @@ -2636,7 +2654,7 @@ "id": "GoogleCloudDialogflowV2BatchDeleteEntityTypesRequest", "properties": { "entityTypeNames": { - "description": "Required. The names entity types to delete. All names must point to the\nsame agent as `parent`.", + "description": "Required. The names entity types to delete. All names must point to the same agent as `parent`.", "items": { "type": "string" }, @@ -2650,7 +2668,7 @@ "id": "GoogleCloudDialogflowV2BatchDeleteIntentsRequest", "properties": { "intents": { - "description": "Required. The collection of intents to delete. Only intent `name` must be\nfilled in.", + "description": "Required. The collection of intents to delete. Only intent `name` must be filled in.", "items": { "$ref": "GoogleCloudDialogflowV2Intent" }, @@ -2671,7 +2689,7 @@ "type": "array" }, "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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": { @@ -2691,11 +2709,11 @@ "description": "The collection of entity types to update or create." }, "entityTypeBatchUri": { - "description": "The URI to a Google Cloud Storage file containing entity types to update\nor create. The file format can either be a serialized proto (of\nEntityBatch type) or a JSON object. Note: The URI must start with\n\"gs://\".", + "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" }, "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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": { @@ -2728,7 +2746,7 @@ "description": "The collection of intents to update or create." }, "intentBatchUri": { - "description": "The URI to a Google Cloud Storage file containing intents to update or\ncreate. The file format can either be a serialized proto (of IntentBatch\ntype) or JSON object. Note: The URI must start with \"gs://\".", + "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://\".", "type": "string" }, "intentView": { @@ -2744,7 +2762,7 @@ "type": "string" }, "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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": { @@ -2770,16 +2788,16 @@ "type": "object" }, "GoogleCloudDialogflowV2Context": { - "description": "Dialogflow contexts are similar to natural language context. If a person says\nto you \"they are orange\", you need context in order to understand what \"they\"\nis referring to. Similarly, for Dialogflow to handle an end-user expression\nlike that, it needs to be provided with context in order to correctly match\nan intent.\n\nUsing contexts, you can control the flow of a conversation. You can configure\ncontexts for an intent by setting input and output contexts, which are\nidentified by string names. When an intent is matched, any configured output\ncontexts for that intent become active. While any contexts are active,\nDialogflow is more likely to match intents that are configured with input\ncontexts that correspond to the currently active contexts.\n\nFor more information about context, see the\n[Contexts guide](https://cloud.google.com/dialogflow/docs/contexts-overview).", + "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).", "id": "GoogleCloudDialogflowV2Context", "properties": { "lifespanCount": { - "description": "Optional. The number of conversational query requests after which the\ncontext expires. The default is `0`. If set to `0`, the context expires\nimmediately. Contexts expire automatically after 20 minutes if there\nare no matching queries.", + "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", "type": "integer" }, "name": { - "description": "Required. The unique identifier of the context. Format:\n`projects//agent/sessions//contexts/`,\nor `projects//agent/environments//users//sessions//contexts/`.\n\nThe `Context ID` is always converted to lowercase, may only contain\ncharacters in a-zA-Z0-9_-% and may be at most 250 bytes long.\n\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.\n\nThe following context names are reserved for internal use by Dialogflow.\nYou should not use these contexts or create contexts with these names:\n\n* `__system_counters__`\n* `*_id_dialog_context`\n* `*_dialog_params_size`", + "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`", "type": "string" }, "parameters": { @@ -2787,23 +2805,23 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. The collection of parameters associated with this context.\n\nDepending on your protocol or client library language, this is a\nmap, associative array, symbol table, dictionary, or JSON object\ncomposed of a collection of (MapKey, MapValue) pairs:\n\n- MapKey type: string\n- MapKey value: parameter name\n- MapValue type:\n - If parameter's entity type is a composite entity: map\n - Else: string or number, depending on parameter value type\n- MapValue value:\n - If parameter's entity type is a composite entity:\n map from composite entity property names to property values\n - Else: parameter value", + "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", "type": "object" } }, "type": "object" }, "GoogleCloudDialogflowV2ConversationEvent": { - "description": "Represents a notification sent to Pub/Sub subscribers for conversation\nlifecycle events.", + "description": "Represents a notification sent to Pub/Sub subscribers for conversation lifecycle events.", "id": "GoogleCloudDialogflowV2ConversationEvent", "properties": { "conversation": { - "description": "The unique identifier of the conversation this notification\nrefers to.\nFormat: `projects//conversations/`.", + "description": "The unique identifier of the conversation this notification refers to. Format: `projects//conversations/`.", "type": "string" }, "errorStatus": { "$ref": "GoogleRpcStatus", - "description": "More detailed information about an error. Only set for type\nUNRECOVERABLE_ERROR_IN_PHONE_CALL." + "description": "More detailed information about an error. Only set for type UNRECOVERABLE_ERROR_IN_PHONE_CALL." }, "newMessagePayload": { "$ref": "GoogleCloudDialogflowV2Message", @@ -2821,11 +2839,11 @@ ], "enumDescriptions": [ "Type not set.", - "A new conversation has been opened. This is fired when a telephone call\nis answered, or a conversation is created via the API.", - "An existing conversation has closed. This is fired when a telephone call\nis terminated, or a conversation is closed via the API.", - "An existing conversation has received notification from Dialogflow that\nhuman intervention is required.", - "An existing conversation has received a new message, either from API or\ntelephony. It is configured in\nConversationProfile.new_message_event_notification_config", - "Unrecoverable error during a telephone call.\n\nIn general non-recoverable errors only occur if something was\nmisconfigured in the ConversationProfile corresponding to the call. After\na non-recoverable error, Dialogflow may stop responding.\n\nWe don't fire this event:\n\n* in an API call because we can directly return the error, or,\n* when we can recover from an error." + "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." ], "type": "string" } @@ -2837,22 +2855,22 @@ "id": "GoogleCloudDialogflowV2DetectIntentRequest", "properties": { "inputAudio": { - "description": "The natural language speech audio to be processed. This field\nshould be populated iff `query_input` is set to an input audio config.\nA single request can contain up to 1 minute of speech audio data.", + "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.", "format": "byte", "type": "string" }, "outputAudioConfig": { "$ref": "GoogleCloudDialogflowV2OutputAudioConfig", - "description": "Instructs the speech synthesizer how to generate the output\naudio. If this field is not set and agent-level speech synthesizer is not\nconfigured, no output audio is generated." + "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." }, "outputAudioConfigMask": { - "description": "Mask for output_audio_config indicating which settings in this\nrequest-level config should override speech synthesizer settings defined at\nagent-level.\n\nIf unspecified or empty, output_audio_config replaces the agent-level\nconfig in its entirety.", + "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.", "format": "google-fieldmask", "type": "string" }, "queryInput": { "$ref": "GoogleCloudDialogflowV2QueryInput", - "description": "Required. The input specification. It can be set to:\n\n1. an audio config\n which instructs the speech recognizer how to process the speech audio,\n\n2. a conversational query in the form of text, or\n\n3. an event that specifies which intent to trigger." + "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." }, "queryParams": { "$ref": "GoogleCloudDialogflowV2QueryParameters", @@ -2866,7 +2884,7 @@ "id": "GoogleCloudDialogflowV2DetectIntentResponse", "properties": { "outputAudio": { - "description": "The audio data bytes encoded as specified in the request.\nNote: The output audio is generated based on the values of default platform\ntext responses found in the `query_result.fulfillment_messages` field. If\nmultiple default text responses exist, they will be concatenated when\ngenerating audio. If no default platform text responses exist, the\ngenerated audio content will be empty.\n\nIn some scenarios, multiple output audio fields may be present in the\nresponse structure. In these cases, only the top-most-level audio output\nhas content.", + "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", "type": "string" }, @@ -2876,10 +2894,10 @@ }, "queryResult": { "$ref": "GoogleCloudDialogflowV2QueryResult", - "description": "The selected results of the conversational query or event processing.\nSee `alternative_query_results` for additional potential results." + "description": "The selected results of the conversational query or event processing. See `alternative_query_results` for additional potential results." }, "responseId": { - "description": "The unique identifier of the response. It can be used to\nlocate a response in the training example set or for reporting issues.", + "description": "The unique identifier of the response. It can be used to locate a response in the training example set or for reporting issues.", "type": "string" }, "webhookStatus": { @@ -2890,18 +2908,18 @@ "type": "object" }, "GoogleCloudDialogflowV2EntityType": { - "description": "Each intent parameter has a type, called the entity type, which dictates\nexactly how data from an end-user expression is extracted.\n\nDialogflow provides predefined system entities that can match many common\ntypes of data. For example, there are system entities for matching dates,\ntimes, colors, email addresses, and so on. You can also create your own\ncustom entities for matching custom data. For example, you could define a\nvegetable entity that can match the types of vegetables available for\npurchase with a grocery store agent.\n\nFor more information, see the\n[Entity guide](https://cloud.google.com/dialogflow/docs/entities-overview).", + "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).", "id": "GoogleCloudDialogflowV2EntityType", "properties": { "autoExpansionMode": { - "description": "Optional. Indicates whether the entity type can be automatically\nexpanded.", + "description": "Optional. Indicates whether the entity type can be automatically expanded.", "enum": [ "AUTO_EXPANSION_MODE_UNSPECIFIED", "AUTO_EXPANSION_MODE_DEFAULT" ], "enumDescriptions": [ "Auto expansion disabled for the entity.", - "Allows an agent to recognize values that have not been explicitly\nlisted in the entity." + "Allows an agent to recognize values that have not been explicitly listed in the entity." ], "type": "string" }, @@ -2930,14 +2948,14 @@ ], "enumDescriptions": [ "Not specified. This value should be never used.", - "Map entity types allow mapping of a group of synonyms to a reference\nvalue.", - "List entity types contain a set of entries that do not map to reference\nvalues. However, list entity types can contain references to other entity\ntypes (with or without aliases).", - "Regexp entity types allow to specify regular expressions in entries\nvalues." + "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" }, "name": { - "description": "The unique identifier of the entity type.\nRequired for EntityTypes.UpdateEntityType and\nEntityTypes.BatchUpdateEntityTypes methods.\nFormat: `projects//agent/entityTypes/`.", + "description": "The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`.", "type": "string" } }, @@ -2962,37 +2980,38 @@ "id": "GoogleCloudDialogflowV2EntityTypeEntity", "properties": { "synonyms": { - "description": "Required. A collection of value synonyms. For example, if the entity type\nis *vegetable*, and `value` is *scallions*, a synonym could be *green\nonions*.\n\nFor `KIND_LIST` entity types:\n\n* This collection must contain exactly one synonym equal to `value`.", + "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" }, "value": { - "description": "Required. The primary value associated with this entity entry.\nFor example, if the entity type is *vegetable*, the value could be\n*scallions*.\n\nFor `KIND_MAP` entity types:\n\n* A reference value to be used in place of synonyms.\n\nFor `KIND_LIST` entity types:\n\n* A string that can contain references to other entity types (with or\n without aliases).", + "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" } }, "type": "object" }, "GoogleCloudDialogflowV2Environment": { - "description": "You can create multiple versions of your agent and publish them to separate\nenvironments.\n\nWhen you edit an agent, you are editing the draft agent. At any point, you\ncan save the draft agent as an agent version, which is an immutable snapshot\nof your agent.\n\nWhen you save the draft agent, it is published to the default environment.\nWhen you create agent versions, you can publish them to custom environments.\nYou can create a variety of custom environments for:\n\n- testing\n- development\n- production\n- etc.\n\nFor more information, see the [versions and environments\nguide](https://cloud.google.com/dialogflow/docs/agents-versions).", + "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).", "id": "GoogleCloudDialogflowV2Environment", "properties": { "agentVersion": { - "description": "Optional. The agent version loaded into this environment.\nFormat: `projects//agent/versions/`.", + "description": "Optional. The agent version loaded into this environment. Format: `projects//agent/versions/`.", "type": "string" }, "description": { - "description": "Optional. The developer-provided description for this environment.\nThe maximum length is 500 characters. If exceeded, the request is rejected.", + "description": "Optional. The developer-provided description for this environment. The maximum length is 500 characters. If exceeded, the request is rejected.", "type": "string" }, "name": { - "description": "Output only. The unique identifier of this agent environment.\nFormat: `projects//agent/environments/`.\nFor Environment ID, \"-\" is reserved for 'draft' environment.", + "description": "Output only. The unique identifier of this agent environment. Format: `projects//agent/environments/`. For Environment ID, \"-\" is reserved for 'draft' environment.", + "readOnly": true, "type": "string" }, "state": { - "description": "Output only. The state of this environment. This field is read-only, i.e., it cannot be\nset by create and update methods.", + "description": "Output only. The state of this environment. This field is read-only, i.e., it cannot be set by create and update methods.", "enum": [ "STATE_UNSPECIFIED", "STOPPED", @@ -3005,22 +3024,24 @@ "Loading.", "Running." ], + "readOnly": true, "type": "string" }, "updateTime": { - "description": "Output only. The last update time of this environment. This field is read-only, i.e., it\ncannot be set by create and update methods.", + "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.", "format": "google-datetime", + "readOnly": true, "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2EventInput": { - "description": "Events allow for matching intents by event name instead of the natural\nlanguage input. For instance, input `` can trigger a personalized welcome response.\nThe parameter `name` may be used by the agent in the response:\n`\"Hello #welcome_event.name! What can I do for you today?\"`.", + "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?\"`.", "id": "GoogleCloudDialogflowV2EventInput", "properties": { "languageCode": { - "description": "Required. The language of this query. See [Language\nSupport](https://cloud.google.com/dialogflow/docs/reference/language)\nfor a list of the currently supported language codes. Note that queries in\nthe same session do not necessarily need to specify the same language.", + "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": { @@ -3032,7 +3053,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of parameters associated with the event.\n\nDepending on your protocol or client library language, this is a\nmap, associative array, symbol table, dictionary, or JSON object\ncomposed of a collection of (MapKey, MapValue) pairs:\n\n- MapKey type: string\n- MapKey value: parameter name\n- MapValue type:\n - If parameter's entity type is a composite entity: map\n - Else: string or number, depending on parameter value type\n- MapValue value:\n - If parameter's entity type is a composite entity:\n map from composite entity property names to property values\n - Else: parameter value", + "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" } }, @@ -3043,7 +3064,7 @@ "id": "GoogleCloudDialogflowV2ExportAgentRequest", "properties": { "agentUri": { - "description": "Required. The [Google Cloud Storage](https://cloud.google.com/storage/docs/)\nURI to export the agent to.\nThe format of this URI must be `gs:///`.\nIf left unspecified, the serialized agent is returned inline.", + "description": "Required. 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.", "type": "string" } }, @@ -3059,14 +3080,14 @@ "type": "string" }, "agentUri": { - "description": "The URI to a file containing the exported agent. This field is populated\nonly if `agent_uri` is specified in `ExportAgentRequest`.", + "description": "The URI to a file containing the exported agent. This field is populated only if `agent_uri` is specified in `ExportAgentRequest`.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2Fulfillment": { - "description": "By default, your agent responds to a matched intent with a static response.\nAs an alternative, you can provide a more dynamic response by using\nfulfillment. When you enable fulfillment for an intent, Dialogflow responds\nto that intent by calling a service that you define. For example, if an\nend-user wants to schedule a haircut on Friday, your service can check your\ndatabase and respond to the end-user with availability information for\nFriday.\n\nFor more information, see the [fulfillment\nguide](https://cloud.google.com/dialogflow/docs/fulfillment-overview).", + "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).", "id": "GoogleCloudDialogflowV2Fulfillment", "properties": { "displayName": { @@ -3089,7 +3110,7 @@ "description": "Configuration for a generic web service." }, "name": { - "description": "Required. The unique identifier of the fulfillment.\nFormat: `projects//agent/fulfillment`.", + "description": "Required. The unique identifier of the fulfillment. Format: `projects//agent/fulfillment`.", "type": "string" } }, @@ -3115,11 +3136,11 @@ "type": "object" }, "GoogleCloudDialogflowV2FulfillmentGenericWebService": { - "description": "Represents configuration for a generic web service.\nDialogflow supports two mechanisms for authentications:\n- Basic authentication with username and password.\n- Authentication with additional authentication headers.\nMore information could be found at:\nhttps://cloud.google.com/dialogflow/docs/fulfillment-configure.", + "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": "GoogleCloudDialogflowV2FulfillmentGenericWebService", "properties": { "isCloudFunction": { - "description": "Optional. Indicates if generic web service is created through Cloud Functions\nintegration. Defaults to false.", + "description": "Optional. Indicates if generic web service is created through Cloud Functions integration. Defaults to false.", "type": "boolean" }, "password": { @@ -3134,7 +3155,7 @@ "type": "object" }, "uri": { - "description": "Required. The fulfillment URI for receiving POST requests.\nIt must use https protocol.", + "description": "Required. The fulfillment URI for receiving POST requests. It must use https protocol.", "type": "string" }, "username": { @@ -3154,7 +3175,7 @@ "type": "string" }, "agentUri": { - "description": "The URI to a Google Cloud Storage file containing the agent to import.\nNote: The URI must start with \"gs://\".", + "description": "The URI to a Google Cloud Storage file containing the agent to import. Note: The URI must start with \"gs://\".", "type": "string" } }, @@ -3179,25 +3200,25 @@ "enumDescriptions": [ "Not specified.", "Uncompressed 16-bit signed little-endian samples (Linear PCM).", - "[`FLAC`](https://xiph.org/flac/documentation.html) (Free Lossless Audio\nCodec) is the recommended encoding because it is lossless (therefore\nrecognition is not compromised) and requires only about half the\nbandwidth of `LINEAR16`. `FLAC` stream encoding supports 16-bit and\n24-bit samples, however, not all fields in `STREAMINFO` are supported.", + "[`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\n([OggOpus](https://wiki.xiph.org/OggOpus)).\n`sample_rate_hertz` must be 16000.", - "Although the use of lossy encodings is not recommended, if a very low\nbitrate encoding is required, `OGG_OPUS` is highly preferred over\nSpeex encoding. The [Speex](https://speex.org/) encoding supported by\nDialogflow API has a header byte in each block, as in MIME type\n`audio/x-speex-with-header-byte`.\nIt is a variant of the RTP Speex encoding defined in\n[RFC 5574](https://tools.ietf.org/html/rfc5574).\nThe stream is a sequence of blocks, one block per RTP packet. Each block\nstarts with a byte containing the length of the block, in bytes, followed\nby one or more frames of Speex data, padded to an integral number of\nbytes (octets) as specified in RFC 5574. In other words, each RTP header\nis replaced with a single byte containing the block length. Only Speex\nwideband is supported. `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." ], "type": "string" }, "enableWordInfo": { - "description": "If `true`, Dialogflow returns SpeechWordInfo in\nStreamingRecognitionResult with information about the recognized speech\nwords, e.g. start and end time offsets. If false or unspecified, Speech\ndoesn't return any word-level information.", + "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" }, "languageCode": { - "description": "Required. The language of the supplied audio. Dialogflow does not do\ntranslations. See [Language\nSupport](https://cloud.google.com/dialogflow/docs/reference/language)\nfor a list of the currently supported language codes. Note that queries in\nthe same session do not necessarily need to specify the same language.", + "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.", "type": "string" }, "model": { - "description": "Which Speech model to select for the given request. Select the\nmodel best suited to your domain to get best results. If a model is not\nexplicitly specified, then we auto-select a model based on the parameters\nin the InputAudioConfig.\nIf enhanced speech model is enabled for the agent and an enhanced\nversion of the specified model for the language does not exist, then the\nspeech is recognized using the standard version of the specified model.\nRefer to\n[Cloud Speech API\ndocumentation](https://cloud.google.com/speech-to-text/docs/basics#select-model)\nfor more details.", + "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" }, "modelVariant": { @@ -3209,31 +3230,31 @@ "USE_ENHANCED" ], "enumDescriptions": [ - "No model variant specified. In this case Dialogflow defaults to\nUSE_BEST_AVAILABLE.", - "Use the best available variant of the Speech\nmodel that the caller is eligible for.\n\nPlease see the [Dialogflow\ndocs](https://cloud.google.com/dialogflow/docs/data-logging) for\nhow to make your project eligible for enhanced models.", - "Use standard model variant even if an enhanced model is available. See the\n[Cloud Speech\ndocumentation](https://cloud.google.com/speech-to-text/docs/enhanced-models)\nfor details about enhanced models.", - "Use an enhanced model variant:\n\n* If an enhanced variant does not exist for the given\n model and request language, Dialogflow falls\n back to the standard variant.\n\n The [Cloud Speech\n documentation](https://cloud.google.com/speech-to-text/docs/enhanced-models)\n describes which models have enhanced variants.\n\n* If the API caller isn't eligible for enhanced models, Dialogflow returns\n an error. Please see the [Dialogflow\n docs](https://cloud.google.com/dialogflow/docs/data-logging)\n for how to make your project eligible." + "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" }, "phraseHints": { - "description": "A list of strings containing words and phrases that the speech\nrecognizer should recognize with higher likelihood.\n\nSee [the Cloud Speech\ndocumentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-hints)\nfor more details.\n\nThis field is deprecated. Please use [speech_contexts]() instead. If you\nspecify both [phrase_hints]() and [speech_contexts](), Dialogflow will\ntreat the [phrase_hints]() as a single additional [SpeechContext]().", + "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]().", "items": { "type": "string" }, "type": "array" }, "sampleRateHertz": { - "description": "Required. Sample rate (in Hertz) of the audio content sent in the query.\nRefer to\n[Cloud Speech API\ndocumentation](https://cloud.google.com/speech-to-text/docs/basics) for\nmore details.", + "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.", "format": "int32", "type": "integer" }, "singleUtterance": { - "description": "If `false` (default), recognition does not cease until the\nclient closes the stream.\nIf `true`, the recognizer will detect a single spoken utterance in input\naudio. Recognition ceases when it detects the audio's voice has\nstopped or paused. In this case, once a detected intent is received, the\nclient should close the stream and start a new request with a new stream as\nneeded.\nNote: This setting is relevant only for streaming methods.\nNote: When specified, InputAudioConfig.single_utterance takes precedence\nover StreamingDetectIntentRequest.single_utterance.", + "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" }, "speechContexts": { - "description": "Context information to assist speech recognition.\n\nSee [the Cloud Speech\ndocumentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-hints)\nfor more details.", + "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.", "items": { "$ref": "GoogleCloudDialogflowV2SpeechContext" }, @@ -3243,15 +3264,15 @@ "type": "object" }, "GoogleCloudDialogflowV2Intent": { - "description": "An intent categorizes an end-user's intention for one conversation turn. For\neach agent, you define many intents, where your combined intents can handle a\ncomplete conversation. When an end-user writes or says something, referred to\nas an end-user expression or end-user input, Dialogflow matches the end-user\ninput to the best intent in your agent. Matching an intent is also known as\nintent classification.\n\nFor more information, see the [intent\nguide](https://cloud.google.com/dialogflow/docs/intents-overview).", + "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", "properties": { "action": { - "description": "Optional. The name of the action associated with the intent.\nNote: The action name must not contain whitespaces.", + "description": "Optional. The name of the action associated with the intent. Note: The action name must not contain whitespaces.", "type": "string" }, "defaultResponsePlatforms": { - "description": "Optional. The list of platforms for which the first responses will be\ncopied from the messages in PLATFORM_UNSPECIFIED (i.e. default platform).", + "description": "Optional. The list of platforms for which the first responses will be copied from the messages in PLATFORM_UNSPECIFIED (i.e. default platform).", "enumDescriptions": [ "Default platform.", "Facebook.", @@ -3261,7 +3282,7 @@ "Skype.", "Line.", "Viber.", - "Google Assistant\nSee [Dialogflow webhook\nformat](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)", + "Google Assistant See [Dialogflow webhook format](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)", "Google Hangouts." ], "items": { @@ -3277,6 +3298,18 @@ "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." + ], "type": "string" }, "type": "array" @@ -3286,21 +3319,21 @@ "type": "string" }, "events": { - "description": "Optional. The collection of event names that trigger the intent.\nIf the collection of input contexts is not empty, all of the contexts must\nbe present in the active user session for an event to trigger this intent.\nEvent names are limited to 150 characters.", + "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.", "items": { "type": "string" }, "type": "array" }, "followupIntentInfo": { - "description": "Read-only. Information about all followup intents that have this intent as\na direct or indirect parent. We populate this field only in the output.", + "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.", "items": { "$ref": "GoogleCloudDialogflowV2IntentFollowupIntentInfo" }, "type": "array" }, "inputContextNames": { - "description": "Optional. The list of context names required for this intent to be\ntriggered.\nFormat: `projects//agent/sessions/-/contexts/`.", + "description": "Optional. The list of context names required for this intent to be triggered. Format: `projects//agent/sessions/-/contexts/`.", "items": { "type": "string" }, @@ -3311,22 +3344,22 @@ "type": "boolean" }, "messages": { - "description": "Optional. The collection of rich messages corresponding to the\n`Response` field in the Dialogflow console.", + "description": "Optional. The collection of rich messages corresponding to the `Response` field in the Dialogflow console.", "items": { "$ref": "GoogleCloudDialogflowV2IntentMessage" }, "type": "array" }, "mlDisabled": { - "description": "Optional. Indicates whether Machine Learning is disabled for the intent.\nNote: If `ml_disabled` setting is set to true, then this intent is not\ntaken into account during inference in `ML ONLY` match mode. Also,\nauto-markup in the UI is turned off.", + "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" }, "name": { - "description": "Optional. The unique identifier of this intent.\nRequired for Intents.UpdateIntent and Intents.BatchUpdateIntents\nmethods.\nFormat: `projects//agent/intents/`.", + "description": "Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`.", "type": "string" }, "outputContexts": { - "description": "Optional. The collection of contexts that are activated when the intent\nis matched. Context messages in this collection should not set the\nparameters field. Setting the `lifespan_count` to 0 will reset the context\nwhen the intent is matched.\nFormat: `projects//agent/sessions/-/contexts/`.", + "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" }, @@ -3340,24 +3373,24 @@ "type": "array" }, "parentFollowupIntentName": { - "description": "Read-only after creation. The unique identifier of the parent intent in the\nchain of followup intents. You can set this field when creating an intent,\nfor example with CreateIntent or\nBatchUpdateIntents, in order to make this\nintent a followup intent.\n\nIt identifies the parent followup intent.\nFormat: `projects//agent/intents/`.", + "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/`.", "type": "string" }, "priority": { - "description": "Optional. The priority of this intent. Higher numbers represent higher\npriorities.\n\n- If the supplied value is unspecified or 0, the service\n translates the value to 500,000, which corresponds to the\n `Normal` priority in the console.\n- If the supplied value is negative, the intent is ignored\n in runtime detect intent requests.", + "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", "type": "integer" }, "resetContexts": { - "description": "Optional. Indicates whether to delete all contexts in the current\nsession when this intent is matched.", + "description": "Optional. Indicates whether to delete all contexts in the current session when this intent is matched.", "type": "boolean" }, "rootFollowupIntentName": { - "description": "Read-only. The unique identifier of the root intent in the chain of\nfollowup intents. It identifies the correct followup intents chain for\nthis intent. We populate this field only in the output.\n\nFormat: `projects//agent/intents/`.", + "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" }, "trainingPhrases": { - "description": "Optional. The collection of examples that the agent is\ntrained on.", + "description": "Optional. The collection of examples that the agent is trained on.", "items": { "$ref": "GoogleCloudDialogflowV2IntentTrainingPhrase" }, @@ -3373,7 +3406,7 @@ "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\nfilling prompt is forwarded to the webhook." + "Webhook is enabled in the agent and in the intent. Also, each slot filling prompt is forwarded to the webhook." ], "type": "string" } @@ -3399,18 +3432,18 @@ "id": "GoogleCloudDialogflowV2IntentFollowupIntentInfo", "properties": { "followupIntentName": { - "description": "The unique identifier of the followup intent.\nFormat: `projects//agent/intents/`.", + "description": "The unique identifier of the followup intent. Format: `projects//agent/intents/`.", "type": "string" }, "parentFollowupIntentName": { - "description": "The unique identifier of the followup intent's parent.\nFormat: `projects//agent/intents/`.", + "description": "The unique identifier of the followup intent's parent. Format: `projects//agent/intents/`.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2IntentMessage": { - "description": "A rich response message.\nCorresponds to the intent `Response` field in the Dialogflow console.\nFor more information, see\n[Rich response\nmessages](https://cloud.google.com/dialogflow/docs/intents-rich-messages).", + "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).", "id": "GoogleCloudDialogflowV2IntentMessage", "properties": { "basicCard": { @@ -3476,7 +3509,7 @@ "Skype.", "Line.", "Viber.", - "Google Assistant\nSee [Dialogflow webhook\nformat](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)", + "Google Assistant See [Dialogflow webhook format](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)", "Google Hangouts." ], "type": "string" @@ -3561,11 +3594,11 @@ "type": "object" }, "GoogleCloudDialogflowV2IntentMessageBrowseCarouselCard": { - "description": "Browse Carousel Card for Actions on Google.\nhttps://developers.google.com/actions/assistant/responses#browsing_carousel", + "description": "Browse Carousel Card for Actions on Google. https://developers.google.com/actions/assistant/responses#browsing_carousel", "id": "GoogleCloudDialogflowV2IntentMessageBrowseCarouselCard", "properties": { "imageDisplayOptions": { - "description": "Optional. Settings for displaying the image. Applies to every image in\nitems.", + "description": "Optional. Settings for displaying the image. Applies to every image in items.", "enum": [ "IMAGE_DISPLAY_OPTIONS_UNSPECIFIED", "GRAY", @@ -3574,16 +3607,16 @@ "BLURRED_BACKGROUND" ], "enumDescriptions": [ - "Fill the gaps between the image and the image container with gray\nbars.", - "Fill the gaps between the image and the image container with gray\nbars.", - "Fill the gaps between the image and the image container with white\nbars.", - "Image is scaled such that the image width and height match or exceed\nthe container dimensions. This may crop the top and bottom of the\nimage if the scaled image height is greater than the container\nheight, or crop the left and right of the image if the scaled image\nwidth is greater than the container width. This is similar to \"Zoom\nMode\" on a widescreen TV when playing a 4:3 video.", - "Pad the gaps between image and image frame with a blurred copy of the\nsame image." + "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." ], "type": "string" }, "items": { - "description": "Required. List of items in the Browse Carousel Card. Minimum of two\nitems, maximum of ten.", + "description": "Required. List of items in the Browse Carousel Card. Minimum of two items, maximum of ten.", "items": { "$ref": "GoogleCloudDialogflowV2IntentMessageBrowseCarouselCardBrowseCarouselCardItem" }, @@ -3597,11 +3630,11 @@ "id": "GoogleCloudDialogflowV2IntentMessageBrowseCarouselCardBrowseCarouselCardItem", "properties": { "description": { - "description": "Optional. Description of the carousel item. Maximum of four lines of\ntext.", + "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\nCard. Maximum of one line of text.", + "description": "Optional. Text that appears at the bottom of the Browse Carousel Card. Maximum of one line of text.", "type": "string" }, "image": { @@ -3628,7 +3661,7 @@ "type": "string" }, "urlTypeHint": { - "description": "Optional. Specifies the type of viewer that is used when opening\nthe URL. Defaults to opening via web browser.", + "description": "Optional. Specifies the type of viewer that is used when opening the URL. Defaults to opening via web browser.", "enum": [ "URL_TYPE_HINT_UNSPECIFIED", "AMP_ACTION", @@ -3637,7 +3670,7 @@ "enumDescriptions": [ "Unspecified", "Url would be an amp action", - "URL that points directly to AMP content, or to a canonical URL\nwhich refers to AMP content via ." + "URL that points directly to AMP content, or to a canonical URL which refers to AMP content via ." ], "type": "string" } @@ -3675,7 +3708,7 @@ "id": "GoogleCloudDialogflowV2IntentMessageCardButton", "properties": { "postback": { - "description": "Optional. The text to send back to the Dialogflow API or a URI to\nopen.", + "description": "Optional. The text to send back to the Dialogflow API or a URI to open.", "type": "string" }, "text": { @@ -3754,7 +3787,7 @@ "id": "GoogleCloudDialogflowV2IntentMessageImage", "properties": { "accessibilityText": { - "description": "Optional. A text description of the image to be used for accessibility,\ne.g., screen readers.", + "description": "Optional. A text description of the image to be used for accessibility, e.g., screen readers.", "type": "string" }, "imageUri": { @@ -3765,7 +3798,7 @@ "type": "object" }, "GoogleCloudDialogflowV2IntentMessageLinkOutSuggestion": { - "description": "The suggestion chip message that allows the user to jump out to the app\nor website associated with this agent.", + "description": "The suggestion chip message that allows the user to jump out to the app or website associated with this agent.", "id": "GoogleCloudDialogflowV2IntentMessageLinkOutSuggestion", "properties": { "destinationName": { @@ -3773,7 +3806,7 @@ "type": "string" }, "uri": { - "description": "Required. The URI of the app or site to open when the user taps the\nsuggestion chip.", + "description": "Required. The URI of the app or site to open when the user taps the suggestion chip.", "type": "string" } }, @@ -3896,15 +3929,15 @@ "type": "object" }, "GoogleCloudDialogflowV2IntentMessageSelectItemInfo": { - "description": "Additional info about the select item for when it is triggered in a\ndialog.", + "description": "Additional info about the select item for when it is triggered in a dialog.", "id": "GoogleCloudDialogflowV2IntentMessageSelectItemInfo", "properties": { "key": { - "description": "Required. A unique key that will be sent back to the agent if this\nresponse is given.", + "description": "Required. A unique key that will be sent back to the agent if this response is given.", "type": "string" }, "synonyms": { - "description": "Optional. A list of synonyms that can also be used to trigger this\nitem in dialog.", + "description": "Optional. A list of synonyms that can also be used to trigger this item in dialog.", "items": { "type": "string" }, @@ -3922,18 +3955,18 @@ "type": "string" }, "ssml": { - "description": "One of text_to_speech or ssml must be provided. Structured spoken\nresponse to the user in the SSML format. Mutually exclusive with\ntext_to_speech.", + "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\nspeech output. Mutually exclusive with ssml.", + "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" }, "GoogleCloudDialogflowV2IntentMessageSimpleResponses": { - "description": "The collection of simple response candidates.\nThis message in `QueryResult.fulfillment_messages` and\n`WebhookResponse.fulfillment_messages` should contain only one\n`SimpleResponse`.", + "description": "The collection of simple response candidates. This message in `QueryResult.fulfillment_messages` and `WebhookResponse.fulfillment_messages` should contain only one `SimpleResponse`.", "id": "GoogleCloudDialogflowV2IntentMessageSimpleResponses", "properties": { "simpleResponses": { @@ -3947,7 +3980,7 @@ "type": "object" }, "GoogleCloudDialogflowV2IntentMessageSuggestion": { - "description": "The suggestion chip message that the user can tap to quickly post a reply\nto the conversation.", + "description": "The suggestion chip message that the user can tap to quickly post a reply to the conversation.", "id": "GoogleCloudDialogflowV2IntentMessageSuggestion", "properties": { "title": { @@ -4059,7 +4092,7 @@ "id": "GoogleCloudDialogflowV2IntentParameter", "properties": { "defaultValue": { - "description": "Optional. The default value to use when the `value` yields an empty\nresult.\nDefault values can be extracted from contexts by using the following\nsyntax: `#context_name.parameter_name`.", + "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": { @@ -4067,7 +4100,7 @@ "type": "string" }, "entityTypeDisplayName": { - "description": "Optional. The name of the entity type, prefixed with `@`, that\ndescribes values of the parameter. If the parameter is\nrequired, this must be provided.", + "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" }, "isList": { @@ -4075,7 +4108,7 @@ "type": "boolean" }, "mandatory": { - "description": "Optional. Indicates whether the parameter is required. That is,\nwhether the intent cannot be completed without collecting the parameter\nvalue.", + "description": "Optional. Indicates whether the parameter is required. That is, whether the intent cannot be completed without collecting the parameter value.", "type": "boolean" }, "name": { @@ -4083,14 +4116,14 @@ "type": "string" }, "prompts": { - "description": "Optional. The collection of prompts that the agent can present to the\nuser in order to collect a value for the parameter.", + "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" }, "value": { - "description": "Optional. The definition of the parameter value. It can be:\n\n- a constant string,\n- a parameter value defined as `$parameter_name`,\n- an original parameter value defined as `$parameter_name.original`,\n- a parameter value from some context defined as\n `#context_name.parameter_name`.", + "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" } }, @@ -4105,14 +4138,14 @@ "type": "string" }, "parts": { - "description": "Required. The ordered list of training phrase parts.\nThe parts are concatenated in order to form the training phrase.\n\nNote: The API does not automatically annotate training phrases like the\nDialogflow Console does.\n\nNote: Do not forget to include whitespace at part boundaries,\nso the training phrase is well formatted when the parts are concatenated.\n\nIf the training phrase does not need to be annotated with parameters,\nyou just need a single part with only the Part.text field set.\n\nIf you want to annotate the training phrase, you must create multiple\nparts, where the fields of each part are populated in one of two ways:\n\n- `Part.text` is set to a part of the phrase that has no parameters.\n- `Part.text` is set to a part of the phrase that you want to annotate,\n and the `entity_type`, `alias`, and `user_defined` fields are all\n set.", + "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.", "items": { "$ref": "GoogleCloudDialogflowV2IntentTrainingPhrasePart" }, "type": "array" }, "timesAddedCount": { - "description": "Optional. Indicates how many times this example was added to\nthe intent. Each time a developer adds an existing sample by editing an\nintent or training, this counter is increased.", + "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" }, @@ -4125,8 +4158,8 @@ ], "enumDescriptions": [ "Not specified. This value should never be used.", - "Examples do not contain @-prefixed entity type names, but example parts\ncan be annotated with entity types.", - "Templates are not annotated with entity types, but they can contain\n@-prefixed entity type names as substrings.\nTemplate mode has been deprecated. Example mode is the only supported\nway to create new training phrases. If you have existing training\nphrases that you've created in template mode, those will continue to\nwork." + "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" } @@ -4138,11 +4171,11 @@ "id": "GoogleCloudDialogflowV2IntentTrainingPhrasePart", "properties": { "alias": { - "description": "Optional. The parameter name for the value extracted from the\nannotated part of the example.\nThis field is required for annotated parts of the training phrase.", + "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" }, "entityType": { - "description": "Optional. The entity type name prefixed with `@`.\nThis field is required for annotated parts of the training phrase.", + "description": "Optional. The entity type name prefixed with `@`. This field is required for annotated parts of the training phrase.", "type": "string" }, "text": { @@ -4150,7 +4183,7 @@ "type": "string" }, "userDefined": { - "description": "Optional. Indicates whether the text was manually annotated.\nThis field is set to true when the Dialogflow Console is used to\nmanually annotate the part. When creating an annotated part with the\nAPI, you must set this to true.", + "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.", "type": "boolean" } }, @@ -4161,14 +4194,14 @@ "id": "GoogleCloudDialogflowV2ListContextsResponse", "properties": { "contexts": { - "description": "The list of contexts. There will be a maximum number of items\nreturned based on the page_size field in the request.", + "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": "GoogleCloudDialogflowV2Context" }, "type": "array" }, "nextPageToken": { - "description": "Token to retrieve the next page of results, or empty if there are no\nmore results in the list.", + "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" } }, @@ -4179,14 +4212,14 @@ "id": "GoogleCloudDialogflowV2ListEntityTypesResponse", "properties": { "entityTypes": { - "description": "The list of agent entity types. There will be a maximum number of items\nreturned based on the page_size field in the request.", + "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": "GoogleCloudDialogflowV2EntityType" }, "type": "array" }, "nextPageToken": { - "description": "Token to retrieve the next page of results, or empty if there are no\nmore results in the list.", + "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" } }, @@ -4197,14 +4230,14 @@ "id": "GoogleCloudDialogflowV2ListEnvironmentsResponse", "properties": { "environments": { - "description": "The list of agent environments. There will be a maximum number of items\nreturned based on the page_size field in the request.", + "description": "The list of agent environments. There will be a maximum number of items returned based on the page_size field in the request.", "items": { "$ref": "GoogleCloudDialogflowV2Environment" }, "type": "array" }, "nextPageToken": { - "description": "Token to retrieve the next page of results, or empty if there are no\nmore results in the list.", + "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" } }, @@ -4215,14 +4248,14 @@ "id": "GoogleCloudDialogflowV2ListIntentsResponse", "properties": { "intents": { - "description": "The list of agent intents. There will be a maximum number of items\nreturned based on the page_size field in the request.", + "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": "GoogleCloudDialogflowV2Intent" }, "type": "array" }, "nextPageToken": { - "description": "Token to retrieve the next page of results, or empty if there are no\nmore results in the list.", + "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" } }, @@ -4233,11 +4266,11 @@ "id": "GoogleCloudDialogflowV2ListSessionEntityTypesResponse", "properties": { "nextPageToken": { - "description": "Token to retrieve the next page of results, or empty if there are no\nmore results in the list.", + "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" }, "sessionEntityTypes": { - "description": "The list of session entity types. There will be a maximum number of items\nreturned based on the page_size field in the request.", + "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.", "items": { "$ref": "GoogleCloudDialogflowV2SessionEntityType" }, @@ -4257,22 +4290,25 @@ "createTime": { "description": "Output only. The time when the message was created.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "languageCode": { - "description": "Optional. The message language.\nThis should be a [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt)\nlanguage tag. Example: \"en-US\".", + "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\".", "type": "string" }, "messageAnnotation": { "$ref": "GoogleCloudDialogflowV2MessageAnnotation", - "description": "Output only. The annotation for the message." + "description": "Output only. The annotation for the message.", + "readOnly": true }, "name": { - "description": "The unique identifier of the message.\nFormat: `projects//conversations//messages/`.", + "description": "The unique identifier of the message. Format: `projects//conversations//messages/`.", "type": "string" }, "participant": { "description": "Output only. The participant that sends this message.", + "readOnly": true, "type": "string" }, "participantRole": { @@ -4287,8 +4323,9 @@ "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\nDialogflow services." + "Participant is an end user that has called or chatted with Dialogflow services." ], + "readOnly": true, "type": "string" } }, @@ -4303,7 +4340,7 @@ "type": "boolean" }, "parts": { - "description": "The collection of annotated message parts ordered by their\nposition in the message. You can recover the annotated message by\nconcatenating [AnnotatedMessagePart.text].", + "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" }, @@ -4313,7 +4350,7 @@ "type": "object" }, "GoogleCloudDialogflowV2OriginalDetectIntentRequest": { - "description": "Represents the contents of the original request that was passed to\nthe `[Streaming]DetectIntent` call.", + "description": "Represents the contents of the original request that was passed to the `[Streaming]DetectIntent` call.", "id": "GoogleCloudDialogflowV2OriginalDetectIntentRequest", "properties": { "payload": { @@ -4321,22 +4358,22 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. This field is set to the value of the `QueryParameters.payload`\nfield passed in the request. Some integrations that query a Dialogflow\nagent may provide additional information in the payload.\n\nIn particular, for the Dialogflow Phone Gateway integration, this field has\nthe form:\n
{\n \"telephony\": {\n   \"caller_id\": \"+18558363987\"\n }\n}
\nNote: The caller ID field (`caller_id`) will be redacted for Standard\nEdition agents and populated with the caller ID in [E.164\nformat](https://en.wikipedia.org/wiki/E.164) for Enterprise Edition agents.", + "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 Standard Edition agents and populated with the caller ID in [E.164 format](https://en.wikipedia.org/wiki/E.164) for Enterprise Edition agents.", "type": "object" }, "source": { - "description": "The source of this request, e.g., `google`, `facebook`, `slack`. It is set\nby Dialogflow-owned servers.", + "description": "The source of this request, e.g., `google`, `facebook`, `slack`. It is set by Dialogflow-owned servers.", "type": "string" }, "version": { - "description": "Optional. The version of the protocol used for this request.\nThis field is AoG-specific.", + "description": "Optional. The version of the protocol used for this request. This field is AoG-specific.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2OutputAudioConfig": { - "description": "Instructs the speech synthesizer on how to generate the output audio content.\nIf this audio config is supplied in a request, it overrides all existing\ntext-to-speech settings applied to the agent.", + "description": "Instructs the speech synthesizer on 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": "GoogleCloudDialogflowV2OutputAudioConfig", "properties": { "audioEncoding": { @@ -4349,14 +4386,14 @@ ], "enumDescriptions": [ "Not specified.", - "Uncompressed 16-bit signed little-endian samples (Linear PCM).\nAudio content returned as LINEAR16 also contains a WAV header.", + "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\nfile which can be played natively on Android, and in browsers (at least\nChrome and Firefox). The quality of the encoding is considerably higher\nthan MP3 while using approximately the same bitrate." + "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" }, "sampleRateHertz": { - "description": "The synthesis sample rate (in hertz) for this audio. If not\nprovided, then the synthesizer will use the default sample rate based on\nthe audio encoding. If this is different from the voice's natural sample\nrate, then the synthesizer will honor this request by converting to the\ndesired sample rate (which might result in worse audio quality).", + "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).", "format": "int32", "type": "integer" }, @@ -4368,7 +4405,7 @@ "type": "object" }, "GoogleCloudDialogflowV2QueryInput": { - "description": "Represents the query input. It can contain either:\n\n1. An audio config which\n instructs the speech recognizer how to process the speech audio.\n\n2. A conversational query in the form of text,.\n\n3. An event that specifies which intent to trigger.", + "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.", "id": "GoogleCloudDialogflowV2QueryInput", "properties": { "audioConfig": { @@ -4391,7 +4428,7 @@ "id": "GoogleCloudDialogflowV2QueryParameters", "properties": { "contexts": { - "description": "The collection of contexts to be activated before this query is\nexecuted.", + "description": "The collection of contexts to be activated before this query is executed.", "items": { "$ref": "GoogleCloudDialogflowV2Context" }, @@ -4406,26 +4443,26 @@ "description": "Properties of the object.", "type": "any" }, - "description": "This field can be used to pass custom data to your webhook.\nArbitrary JSON objects are supported.\nIf supplied, the value is used to populate the\n`WebhookRequest.original_detect_intent_request.payload`\nfield sent to your webhook.", + "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.", "type": "object" }, "resetContexts": { - "description": "Specifies whether to delete all contexts in the current session\nbefore the new ones are activated.", + "description": "Specifies whether to delete all contexts in the current session before the new ones are activated.", "type": "boolean" }, "sentimentAnalysisRequestConfig": { "$ref": "GoogleCloudDialogflowV2SentimentAnalysisRequestConfig", - "description": "Configures the type of sentiment analysis to perform. If not\nprovided, sentiment analysis is not performed." + "description": "Configures the type of sentiment analysis to perform. If not provided, sentiment analysis is not performed." }, "sessionEntityTypes": { - "description": "Additional session entity types to replace or extend developer\nentity types with. The entity synonyms apply to all languages and persist\nfor the session of this query.", + "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.", "items": { "$ref": "GoogleCloudDialogflowV2SessionEntityType" }, "type": "array" }, "timeZone": { - "description": "The time zone of this conversational query from the\n[time zone database](https://www.iana.org/time-zones), e.g.,\nAmerica/New_York, Europe/Paris. If not provided, the time zone specified in\nagent settings is used.", + "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.", "type": "string" } }, @@ -4440,7 +4477,7 @@ "type": "string" }, "allRequiredParamsPresent": { - "description": "This field is set to:\n\n- `false` if the matched intent has required parameters and not all of\n the required parameter values have been collected.\n- `true` if all required parameter values have been collected, or if the\n matched intent doesn't contain any required parameters.", + "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" }, "diagnosticInfo": { @@ -4448,7 +4485,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Free-form diagnostic information for the associated detect intent request.\nThe fields of this data can change without notice, so you should not write\ncode that depends on its structure.\nThe data may contain:\n\n- webhook call latency\n- webhook errors", + "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", "type": "object" }, "fulfillmentMessages": { @@ -4459,24 +4496,24 @@ "type": "array" }, "fulfillmentText": { - "description": "The text to be pronounced to the user or shown on the screen.\nNote: This is a legacy field, `fulfillment_messages` should be preferred.", + "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" }, "intent": { "$ref": "GoogleCloudDialogflowV2Intent", - "description": "The intent that matched the conversational query. Some, not\nall fields are filled in this message, including but not limited to:\n`name`, `display_name`, `end_interaction` and `is_fallback`." + "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`." }, "intentDetectionConfidence": { - "description": "The intent detection confidence. Values range from 0.0\n(completely uncertain) to 1.0 (completely certain).\nThis value is for informational purpose only and is only used to\nhelp match the best intent within the classification threshold.\nThis value may change for the same end-user expression at any time due to a\nmodel retraining or change in implementation.\nIf there are `multiple knowledge_answers` messages, this value is set to\nthe greatest `knowledgeAnswers.match_confidence` value in the list.", + "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" }, "languageCode": { - "description": "The language that was triggered during intent detection.\nSee [Language\nSupport](https://cloud.google.com/dialogflow/docs/reference/language)\nfor a list of the currently supported language codes.", + "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.", "type": "string" }, "outputContexts": { - "description": "The collection of output contexts. If applicable,\n`output_contexts.parameters` contains entries with name\n`.original` containing the original parameter values\nbefore the query.", + "description": "The collection of output contexts. If applicable, `output_contexts.parameters` contains entries with name `.original` containing the original parameter values before the query.", "items": { "$ref": "GoogleCloudDialogflowV2Context" }, @@ -4487,19 +4524,19 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of extracted parameters.\n\nDepending on your protocol or client library language, this is a\nmap, associative array, symbol table, dictionary, or JSON object\ncomposed of a collection of (MapKey, MapValue) pairs:\n\n- MapKey type: string\n- MapKey value: parameter name\n- MapValue type:\n - If parameter's entity type is a composite entity: map\n - Else: string or number, depending on parameter value type\n- MapValue value:\n - If parameter's entity type is a composite entity:\n map from composite entity property names to property values\n - Else: parameter value", + "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", "type": "object" }, "queryText": { - "description": "The original conversational query text:\n\n- If natural language text was provided as input, `query_text` contains\n a copy of the input.\n- If natural language speech audio was provided as input, `query_text`\n contains the speech recognition result. If speech recognizer produced\n multiple alternatives, a particular one is picked.\n- If automatic spell correction is enabled, `query_text` will contain the\n corrected user input.", + "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" }, "sentimentAnalysisResult": { "$ref": "GoogleCloudDialogflowV2SentimentAnalysisResult", - "description": "The sentiment analysis result, which depends on the\n`sentiment_analysis_request_config` specified in the request." + "description": "The sentiment analysis result, which depends on the `sentiment_analysis_request_config` specified in the request." }, "speechRecognitionConfidence": { - "description": "The Speech recognition confidence between 0.0 and 1.0. A higher number\nindicates an estimated greater likelihood that the recognized words are\ncorrect. The default of 0.0 is a sentinel value indicating that confidence\nwas not set.\n\nThis field is not guaranteed to be accurate or set. In particular this\nfield isn't set for StreamingDetectIntent since the streaming endpoint has\nseparate confidence estimates per portion of the audio in\nStreamingRecognitionResult.", + "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.", "format": "float", "type": "number" }, @@ -4508,11 +4545,11 @@ "description": "Properties of the object.", "type": "any" }, - "description": "If the query was fulfilled by a webhook call, this field is set to the\nvalue of the `payload` field returned in the webhook response.", + "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" }, "webhookSource": { - "description": "If the query was fulfilled by a webhook call, this field is set to the\nvalue of the `source` field returned in the webhook response.", + "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.", "type": "string" } }, @@ -4528,7 +4565,7 @@ "type": "string" }, "agentUri": { - "description": "The URI to a Google Cloud Storage file containing the agent to restore.\nNote: The URI must start with \"gs://\".", + "description": "The URI to a Google Cloud Storage file containing the agent to restore. Note: The URI must start with \"gs://\".", "type": "string" } }, @@ -4539,30 +4576,30 @@ "id": "GoogleCloudDialogflowV2SearchAgentsResponse", "properties": { "agents": { - "description": "The list of agents. There will be a maximum number of items returned based\non the page_size field in the request.", + "description": "The list of agents. There will be a maximum number of items returned based on the page_size field in the request.", "items": { "$ref": "GoogleCloudDialogflowV2Agent" }, "type": "array" }, "nextPageToken": { - "description": "Token to retrieve the next page of results, or empty if there are no\nmore results in the list.", + "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2Sentiment": { - "description": "The sentiment, such as positive/negative feeling or association, for a unit\nof analysis, such as the query text.", + "description": "The sentiment, such as positive/negative feeling or association, for a unit of analysis, such as the query text.", "id": "GoogleCloudDialogflowV2Sentiment", "properties": { "magnitude": { - "description": "A non-negative number in the [0, +inf) range, which represents the absolute\nmagnitude of sentiment, regardless of score (positive or negative).", + "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", "type": "number" }, "score": { - "description": "Sentiment score between -1.0 (negative sentiment) and 1.0 (positive\nsentiment).", + "description": "Sentiment score between -1.0 (negative sentiment) and 1.0 (positive sentiment).", "format": "float", "type": "number" } @@ -4574,14 +4611,14 @@ "id": "GoogleCloudDialogflowV2SentimentAnalysisRequestConfig", "properties": { "analyzeQueryTextSentiment": { - "description": "Instructs the service to perform sentiment analysis on\n`query_text`. If not provided, sentiment analysis is not performed on\n`query_text`.", + "description": "Instructs the service to perform sentiment analysis on `query_text`. If not provided, sentiment analysis is not performed on `query_text`.", "type": "boolean" } }, "type": "object" }, "GoogleCloudDialogflowV2SentimentAnalysisResult": { - "description": "The result of sentiment analysis. Sentiment analysis inspects user input\nand identifies the prevailing subjective opinion, especially to determine a\nuser's attitude as positive, negative, or neutral.\nFor Participants.AnalyzeContent, it needs to be configured in\nDetectIntentRequest.query_params. For\nParticipants.StreamingAnalyzeContent, it needs to be configured in\nStreamingDetectIntentRequest.query_params.\nAnd for Participants.AnalyzeContent and\nParticipants.StreamingAnalyzeContent, it needs to be configured in\nConversationProfile.human_agent_assistant_config", + "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.AnalyzeContent, it needs to be configured in DetectIntentRequest.query_params. For Participants.StreamingAnalyzeContent, 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": "GoogleCloudDialogflowV2SentimentAnalysisResult", "properties": { "queryTextSentiment": { @@ -4592,18 +4629,18 @@ "type": "object" }, "GoogleCloudDialogflowV2SessionEntityType": { - "description": "A session represents a conversation between a Dialogflow agent and an\nend-user. You can create special entities, called session entities, during a\nsession. Session entities can extend or replace custom entity types and only\nexist during the session that they were created for. All session data,\nincluding session entities, is stored by Dialogflow for 20 minutes.\n\nFor more information, see the [session entity\nguide](https://cloud.google.com/dialogflow/docs/entities-session).", + "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": "GoogleCloudDialogflowV2SessionEntityType", "properties": { "entities": { - "description": "Required. The collection of entities associated with this session entity\ntype.", + "description": "Required. The collection of entities associated with this session entity type.", "items": { "$ref": "GoogleCloudDialogflowV2EntityTypeEntity" }, "type": "array" }, "entityOverrideMode": { - "description": "Required. Indicates whether the additional data should override or\nsupplement the custom entity type definition.", + "description": "Required. Indicates whether the additional data should override or supplement the custom entity type definition.", "enum": [ "ENTITY_OVERRIDE_MODE_UNSPECIFIED", "ENTITY_OVERRIDE_MODE_OVERRIDE", @@ -4611,29 +4648,29 @@ ], "enumDescriptions": [ "Not specified. This value should be never used.", - "The collection of session entities overrides the collection of entities\nin the corresponding custom entity type.", - "The collection of session entities extends the collection of entities in\nthe corresponding custom entity type.\n\nNote: Even in this override mode calls to `ListSessionEntityTypes`,\n`GetSessionEntityType`, `CreateSessionEntityType` and\n`UpdateSessionEntityType` only return the additional entities added in\nthis session entity type. If you want to get the supplemented list,\nplease call EntityTypes.GetEntityType on the custom entity type\nand merge." + "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" }, "name": { - "description": "Required. The unique identifier of this session entity type. Format:\n`projects//agent/sessions//entityTypes/`, or `projects//agent/environments//users//sessions//entityTypes/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.\n\n`` must be the display name of an existing entity\ntype in the same agent that will be overridden or supplemented.", + "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.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2SpeechContext": { - "description": "Hints for the speech recognizer to help with recognition in a specific\nconversation state.", + "description": "Hints for the speech recognizer to help with recognition in a specific conversation state.", "id": "GoogleCloudDialogflowV2SpeechContext", "properties": { "boost": { - "description": "Optional. Boost for this context compared to other contexts:\n\n* If the boost is positive, Dialogflow will increase the probability that\n the phrases in this context are recognized over similar sounding phrases.\n* If the boost is unspecified or non-positive, Dialogflow will not apply\n any boost.\n\nDialogflow recommends that you use boosts in the range (0, 20] and that you\nfind a value that fits your use case with binary search.", + "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.", "format": "float", "type": "number" }, "phrases": { - "description": "Optional. A list of strings containing words and phrases that the speech\nrecognizer should recognize with higher likelihood.\n\nThis list can be used to:\n\n* improve accuracy for words and phrases you expect the user to say,\n e.g. typical commands for your Dialogflow agent\n* add additional words to the speech recognizer vocabulary\n* ...\n\nSee the [Cloud Speech\ndocumentation](https://cloud.google.com/speech-to-text/quotas) for usage\nlimits.", + "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" }, @@ -4647,19 +4684,19 @@ "id": "GoogleCloudDialogflowV2SynthesizeSpeechConfig", "properties": { "effectsProfileId": { - "description": "Optional. An identifier which selects 'audio effects' profiles that are\napplied on (post synthesized) text to speech. Effects are applied on top of\neach other in the order they are given.", + "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.", "items": { "type": "string" }, "type": "array" }, "pitch": { - "description": "Optional. Speaking pitch, in the range [-20.0, 20.0]. 20 means increase 20\nsemitones from the original pitch. -20 means decrease 20 semitones from the\noriginal pitch.", + "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.", "format": "double", "type": "number" }, "speakingRate": { - "description": "Optional. Speaking rate/speed, in the range [0.25, 4.0]. 1.0 is the normal\nnative speed supported by the specific voice. 2.0 is twice as fast, and\n0.5 is half as fast. If unset(0.0), defaults to the native 1.0 speed. Any\nother values < 0.25 or > 4.0 will return an error.", + "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 < 0.25 or > 4.0 will return an error.", "format": "double", "type": "number" }, @@ -4668,7 +4705,7 @@ "description": "Optional. The desired voice of the synthesized audio." }, "volumeGainDb": { - "description": "Optional. Volume gain (in dB) of the normal native volume supported by the\nspecific voice, in the range [-96.0, 16.0]. If unset, or set to a value of\n0.0 (dB), will play at normal native signal amplitude. A value of -6.0 (dB)\nwill play at approximately half the amplitude of the normal native signal\namplitude. A value of +6.0 (dB) will play at approximately twice the\namplitude of the normal native signal amplitude. We strongly recommend not\nto exceed +10 (dB) as there's usually no effective increase in loudness for\nany value greater than that.", + "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.", "format": "double", "type": "number" } @@ -4680,11 +4717,11 @@ "id": "GoogleCloudDialogflowV2TextInput", "properties": { "languageCode": { - "description": "Required. The language of this conversational query. See [Language\nSupport](https://cloud.google.com/dialogflow/docs/reference/language)\nfor a list of the currently supported language codes. Note that queries in\nthe same session do not necessarily need to specify the same language.", + "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": { - "description": "Required. The UTF-8 encoded natural language text to be processed.\nText length must not exceed 256 characters.", + "description": "Required. The UTF-8 encoded natural language text to be processed. Text length must not exceed 256 characters.", "type": "string" } }, @@ -4701,7 +4738,7 @@ "id": "GoogleCloudDialogflowV2ValidationError", "properties": { "entries": { - "description": "The names of the entries that the error is associated with.\nFormat:\n\n- \"projects//agent\", if the error is associated with the entire\nagent.\n- \"projects//agent/intents/\", if the error is\nassociated with certain intents.\n- \"projects//agent/intents//trainingPhrases/\", if the\nerror is associated with certain intent training phrases.\n- \"projects//agent/intents//parameters/\", if the error is associated with certain intent parameters.\n- \"projects//agent/entities/\", if the error is\nassociated with certain entities.", + "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.", "items": { "type": "string" }, @@ -4751,11 +4788,11 @@ "id": "GoogleCloudDialogflowV2VoiceSelectionParams", "properties": { "name": { - "description": "Optional. The name of the voice. If not set, the service will choose a\nvoice based on the other parameters such as language_code and\nssml_gender.", + "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" }, "ssmlGender": { - "description": "Optional. The preferred gender of the voice. If not set, the service will\nchoose a voice based on the other parameters such as language_code and\nname. Note that this is only a preference, not requirement. If a\nvoice of the appropriate gender is not available, the synthesizer should\nsubstitute a voice with a different gender rather than failing the request.", + "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.", "enum": [ "SSML_VOICE_GENDER_UNSPECIFIED", "SSML_VOICE_GENDER_MALE", @@ -4763,7 +4800,7 @@ "SSML_VOICE_GENDER_NEUTRAL" ], "enumDescriptions": [ - "An unspecified gender, which means that the client doesn't care which\ngender the selected voice will have.", + "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." @@ -4779,44 +4816,44 @@ "properties": { "originalDetectIntentRequest": { "$ref": "GoogleCloudDialogflowV2OriginalDetectIntentRequest", - "description": "Optional. The contents of the original request that was passed to\n`[Streaming]DetectIntent` call." + "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\nsame value as `[Streaming]DetectIntentResponse.query_result`." + "description": "The result of the conversational query or event processing. Contains the same value as `[Streaming]DetectIntentResponse.query_result`." }, "responseId": { - "description": "The unique identifier of the response. Contains the same value as\n`[Streaming]DetectIntentResponse.response_id`.", + "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.\nCan be used to identify end-user inside webhook implementation.\nFormat: `projects//agent/sessions/`, or\n`projects//agent/environments//users//sessions/`.", + "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" } }, "type": "object" }, "GoogleCloudDialogflowV2WebhookResponse": { - "description": "The response message for a webhook call.\n\nThis response is validated by the Dialogflow server. If validation fails,\nan error will be returned in the QueryResult.diagnostic_info field.\nSetting JSON fields to an empty value with the wrong type is a common error.\nTo avoid this error:\n\n- Use `\"\"` for empty strings\n- Use `{}` or `null` for empty objects\n- Use `[]` or `null` for empty arrays\n\nFor more information, see the\n[Protocol Buffers Language\nGuide](https://developers.google.com/protocol-buffers/docs/proto3#json).", + "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", "properties": { "followupEventInput": { "$ref": "GoogleCloudDialogflowV2EventInput", - "description": "Optional. Invokes the supplied events.\nWhen this field is set, Dialogflow ignores the `fulfillment_text`,\n`fulfillment_messages`, and `payload` fields." + "description": "Optional. Invokes the supplied events. When this field is set, Dialogflow ignores the `fulfillment_text`, `fulfillment_messages`, and `payload` fields." }, "fulfillmentMessages": { - "description": "Optional. The rich response messages intended for the end-user.\nWhen provided, Dialogflow uses this field to populate\nQueryResult.fulfillment_messages sent to the integration or API caller.", + "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.", "items": { "$ref": "GoogleCloudDialogflowV2IntentMessage" }, "type": "array" }, "fulfillmentText": { - "description": "Optional. The text response message intended for the end-user.\nIt is recommended to use `fulfillment_messages.text.text[0]` instead.\nWhen provided, Dialogflow uses this field to populate\nQueryResult.fulfillment_text sent to the integration or API caller.", + "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.", "type": "string" }, "outputContexts": { - "description": "Optional. The collection of output contexts that will overwrite currently\nactive contexts for the session and reset their lifespans.\nWhen provided, Dialogflow uses this field to populate\nQueryResult.output_contexts sent to the integration or API caller.", + "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" }, @@ -4827,56 +4864,61 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. This field can be used to pass custom data from your webhook to the\nintegration or API caller. Arbitrary JSON objects are supported.\nWhen provided, Dialogflow uses this field to populate\nQueryResult.webhook_payload sent to the integration or API caller.\nThis field is also used by the\n[Google Assistant\nintegration](https://cloud.google.com/dialogflow/docs/integrations/aog)\nfor rich response messages.\nSee the format definition at [Google Assistant Dialogflow webhook\nformat](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)", + "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" }, "sessionEntityTypes": { - "description": "Optional. Additional session entity types to replace or extend developer\nentity types with. The entity synonyms apply to all languages and persist\nfor the session. Setting this data from a webhook overwrites\nthe session entity types that have been set using `detectIntent`,\n`streamingDetectIntent` or SessionEntityType management methods.", + "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": "GoogleCloudDialogflowV2SessionEntityType" }, "type": "array" }, "source": { - "description": "Optional. A custom field used to identify the webhook source.\nArbitrary strings are supported.\nWhen provided, Dialogflow uses this field to populate\nQueryResult.webhook_source sent to the integration or API caller.", + "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" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1AnnotatedConversationDataset": { - "description": "Represents an annotated conversation dataset.\nConversationDataset can have multiple AnnotatedConversationDataset, each of\nthem represents one result from one annotation task.\nAnnotatedConversationDataset can only be generated from annotation task,\nwhich will be triggered by LabelConversation.", + "description": "Represents an annotated conversation dataset. ConversationDataset can have multiple AnnotatedConversationDataset, each of them represents one result from one annotation task. AnnotatedConversationDataset can only be generated from annotation task, which will be triggered by LabelConversation.", "id": "GoogleCloudDialogflowV2beta1AnnotatedConversationDataset", "properties": { "completedExampleCount": { - "description": "Output only. Number of examples that have annotations in the annotated\nconversation dataset.", + "description": "Output only. Number of examples that have annotations in the annotated conversation dataset.", "format": "int64", + "readOnly": true, "type": "string" }, "createTime": { "description": "Output only. Creation time of this annotated conversation dataset.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "description": { - "description": "Optional. The description of the annotated conversation dataset.\nMaximum of 10000 bytes.", + "description": "Optional. The description of the annotated conversation dataset. Maximum of 10000 bytes.", "type": "string" }, "displayName": { - "description": "Required. The display name of the annotated conversation dataset.\nIt's specified when user starts an annotation task. Maximum of 64 bytes.", + "description": "Required. The display name of the annotated conversation dataset. It's specified when user starts an annotation task. Maximum of 64 bytes.", "type": "string" }, "exampleCount": { "description": "Output only. Number of examples in the annotated conversation dataset.", "format": "int64", + "readOnly": true, "type": "string" }, "name": { - "description": "Output only. AnnotatedConversationDataset resource name. Format:\n`projects//conversationDatasets//annotatedConversationDatasets/`", + "description": "Output only. AnnotatedConversationDataset resource name. Format: `projects//conversationDatasets//annotatedConversationDatasets/`", + "readOnly": true, "type": "string" }, "questionTypeName": { - "description": "Output only. Question type name that identifies a labeling task.\nA question is a single task that a worker answers. A question type is set\nof related questions. Each question belongs to a particular question type.\nIt can be used in CrowdCompute UI to filter and manage labeling tasks.", + "description": "Output only. Question type name that identifies a labeling task. A question is a single task that a worker answers. A question type is set of related questions. Each question belongs to a particular question type. It can be used in CrowdCompute UI to filter and manage labeling tasks.", + "readOnly": true, "type": "string" } }, @@ -4933,16 +4975,16 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1Context": { - "description": "Dialogflow contexts are similar to natural language context. If a person says\nto you \"they are orange\", you need context in order to understand what \"they\"\nis referring to. Similarly, for Dialogflow to handle an end-user expression\nlike that, it needs to be provided with context in order to correctly match\nan intent.\n\nUsing contexts, you can control the flow of a conversation. You can configure\ncontexts for an intent by setting input and output contexts, which are\nidentified by string names. When an intent is matched, any configured output\ncontexts for that intent become active. While any contexts are active,\nDialogflow is more likely to match intents that are configured with input\ncontexts that correspond to the currently active contexts.\n\nFor more information about context, see the\n[Contexts guide](https://cloud.google.com/dialogflow/docs/contexts-overview).", + "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).", "id": "GoogleCloudDialogflowV2beta1Context", "properties": { "lifespanCount": { - "description": "Optional. The number of conversational query requests after which the\ncontext expires. The default is `0`. If set to `0`, the context expires\nimmediately. Contexts expire automatically after 20 minutes if there\nare no matching queries.", + "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", "type": "integer" }, "name": { - "description": "Required. The unique identifier of the context. Format:\n`projects//agent/sessions//contexts/`,\nor `projects//agent/environments//users//sessions//contexts/`.\n\nThe `Context ID` is always converted to lowercase, may only contain\ncharacters in a-zA-Z0-9_-% and may be at most 250 bytes long.\n\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.\n\nThe following context names are reserved for internal use by Dialogflow.\nYou should not use these contexts or create contexts with these names:\n\n* `__system_counters__`\n* `*_id_dialog_context`\n* `*_dialog_params_size`", + "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`", "type": "string" }, "parameters": { @@ -4950,25 +4992,25 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. The collection of parameters associated with this context.\n\nDepending on your protocol or client library language, this is a\nmap, associative array, symbol table, dictionary, or JSON object\ncomposed of a collection of (MapKey, MapValue) pairs:\n\n- MapKey type: string\n- MapKey value: parameter name\n- MapValue type:\n - If parameter's entity type is a composite entity: map\n - Else: string or number, depending on parameter value type\n- MapValue value:\n - If parameter's entity type is a composite entity:\n map from composite entity property names to property values\n - Else: parameter value", + "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", "type": "object" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1EntityType": { - "description": "Each intent parameter has a type, called the entity type, which dictates\nexactly how data from an end-user expression is extracted.\n\nDialogflow provides predefined system entities that can match many common\ntypes of data. For example, there are system entities for matching dates,\ntimes, colors, email addresses, and so on. You can also create your own\ncustom entities for matching custom data. For example, you could define a\nvegetable entity that can match the types of vegetables available for\npurchase with a grocery store agent.\n\nFor more information, see the\n[Entity guide](https://cloud.google.com/dialogflow/docs/entities-overview).", + "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).", "id": "GoogleCloudDialogflowV2beta1EntityType", "properties": { "autoExpansionMode": { - "description": "Optional. Indicates whether the entity type can be automatically\nexpanded.", + "description": "Optional. Indicates whether the entity type can be automatically expanded.", "enum": [ "AUTO_EXPANSION_MODE_UNSPECIFIED", "AUTO_EXPANSION_MODE_DEFAULT" ], "enumDescriptions": [ "Auto expansion disabled for the entity.", - "Allows an agent to recognize values that have not been explicitly\nlisted in the entity." + "Allows an agent to recognize values that have not been explicitly listed in the entity." ], "type": "string" }, @@ -4997,14 +5039,14 @@ ], "enumDescriptions": [ "Not specified. This value should be never used.", - "Map entity types allow mapping of a group of synonyms to a reference\nvalue.", - "List entity types contain a set of entries that do not map to reference\nvalues. However, list entity types can contain references to other entity\ntypes (with or without aliases).", - "Regexp entity types allow to specify regular expressions in entries\nvalues." + "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" }, "name": { - "description": "The unique identifier of the entity type.\nRequired for EntityTypes.UpdateEntityType and\nEntityTypes.BatchUpdateEntityTypes methods.\nFormat: `projects//agent/entityTypes/`.", + "description": "The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`.", "type": "string" } }, @@ -5015,25 +5057,25 @@ "id": "GoogleCloudDialogflowV2beta1EntityTypeEntity", "properties": { "synonyms": { - "description": "Required. A collection of value synonyms. For example, if the entity type\nis *vegetable*, and `value` is *scallions*, a synonym could be *green\nonions*.\n\nFor `KIND_LIST` entity types:\n\n* This collection must contain exactly one synonym equal to `value`.", + "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" }, "value": { - "description": "Required. The primary value associated with this entity entry.\nFor example, if the entity type is *vegetable*, the value could be\n*scallions*.\n\nFor `KIND_MAP` entity types:\n\n* A reference value to be used in place of synonyms.\n\nFor `KIND_LIST` entity types:\n\n* A string that can contain references to other entity types (with or\n without aliases).", + "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" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1EventInput": { - "description": "Events allow for matching intents by event name instead of the natural\nlanguage input. For instance, input `` can trigger a personalized welcome response.\nThe parameter `name` may be used by the agent in the response:\n`\"Hello #welcome_event.name! What can I do for you today?\"`.", + "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?\"`.", "id": "GoogleCloudDialogflowV2beta1EventInput", "properties": { "languageCode": { - "description": "Required. The language of this query. See [Language\nSupport](https://cloud.google.com/dialogflow/docs/reference/language)\nfor a list of the currently supported language codes. Note that queries in\nthe same session do not necessarily need to specify the same language.", + "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": { @@ -5045,7 +5087,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of parameters associated with the event.\n\nDepending on your protocol or client library language, this is a\nmap, associative array, symbol table, dictionary, or JSON object\ncomposed of a collection of (MapKey, MapValue) pairs:\n\n- MapKey type: string\n- MapKey value: parameter name\n- MapValue type:\n - If parameter's entity type is a composite entity: map\n - Else: string or number, depending on parameter value type\n- MapValue value:\n - If parameter's entity type is a composite entity:\n map from composite entity property names to property values\n - Else: parameter value", + "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" } }, @@ -5061,22 +5103,22 @@ "type": "string" }, "agentUri": { - "description": "The URI to a file containing the exported agent. This field is populated\nonly if `agent_uri` is specified in `ExportAgentRequest`.", + "description": "The URI to a file containing the exported agent. This field is populated only if `agent_uri` is specified in `ExportAgentRequest`.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1Intent": { - "description": "An intent categorizes an end-user's intention for one conversation turn. For\neach agent, you define many intents, where your combined intents can handle a\ncomplete conversation. When an end-user writes or says something, referred to\nas an end-user expression or end-user input, Dialogflow matches the end-user\ninput to the best intent in your agent. Matching an intent is also known as\nintent classification.\n\nFor more information, see the [intent\nguide](https://cloud.google.com/dialogflow/docs/intents-overview).", + "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": "GoogleCloudDialogflowV2beta1Intent", "properties": { "action": { - "description": "Optional. The name of the action associated with the intent.\nNote: The action name must not contain whitespaces.", + "description": "Optional. The name of the action associated with the intent. Note: The action name must not contain whitespaces.", "type": "string" }, "defaultResponsePlatforms": { - "description": "Optional. The list of platforms for which the first responses will be\ncopied from the messages in PLATFORM_UNSPECIFIED (i.e. default platform).", + "description": "Optional. The list of platforms for which the first responses will be copied from the messages in PLATFORM_UNSPECIFIED (i.e. default platform).", "enumDescriptions": [ "Not specified.", "Facebook.", @@ -5086,7 +5128,7 @@ "Skype.", "Line.", "Viber.", - "Google Assistant\nSee [Dialogflow webhook\nformat](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)", + "Google Assistant See [Dialogflow webhook format](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)", "Telephony Gateway.", "Google Hangouts." ], @@ -5104,6 +5146,19 @@ "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." + ], "type": "string" }, "type": "array" @@ -5113,25 +5168,26 @@ "type": "string" }, "endInteraction": { - "description": "Optional. Indicates that this intent ends an interaction. Some integrations\n(e.g., Actions on Google or Dialogflow phone gateway) use this information\nto close interaction with an end user. Default is false.", + "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" }, "events": { - "description": "Optional. The collection of event names that trigger the intent.\nIf the collection of input contexts is not empty, all of the contexts must\nbe present in the active user session for an event to trigger this intent.\nEvent names are limited to 150 characters.", + "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.", "items": { "type": "string" }, "type": "array" }, "followupIntentInfo": { - "description": "Output only. Information about all followup intents that have this intent as\na direct or indirect parent. We populate this field only in the output.", + "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" }, + "readOnly": true, "type": "array" }, "inputContextNames": { - "description": "Optional. The list of context names required for this intent to be\ntriggered.\nFormat: `projects//agent/sessions/-/contexts/`.", + "description": "Optional. The list of context names required for this intent to be triggered. Format: `projects//agent/sessions/-/contexts/`.", "items": { "type": "string" }, @@ -5142,26 +5198,26 @@ "type": "boolean" }, "messages": { - "description": "Optional. The collection of rich messages corresponding to the\n`Response` field in the Dialogflow console.", + "description": "Optional. The collection of rich messages corresponding to the `Response` field in the Dialogflow console.", "items": { "$ref": "GoogleCloudDialogflowV2beta1IntentMessage" }, "type": "array" }, "mlDisabled": { - "description": "Optional. Indicates whether Machine Learning is disabled for the intent.\nNote: If `ml_disabled` setting is set to true, then this intent is not\ntaken into account during inference in `ML ONLY` match mode. Also,\nauto-markup in the UI is turned off.", + "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" }, "mlEnabled": { - "description": "Optional. Indicates whether Machine Learning is enabled for the intent.\nNote: If `ml_enabled` setting is set to false, then this intent is not\ntaken into account during inference in `ML ONLY` match mode. Also,\nauto-markup in the UI is turned off.\nDEPRECATED! Please use `ml_disabled` field instead.\nNOTE: If both `ml_enabled` and `ml_disabled` are either not set or false,\nthen the default value is determined as follows:\n- Before April 15th, 2018 the default is:\n ml_enabled = false / ml_disabled = true.\n- After April 15th, 2018 the default is:\n ml_enabled = true / ml_disabled = false.", + "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" }, "name": { - "description": "Optional. The unique identifier of this intent.\nRequired for Intents.UpdateIntent and Intents.BatchUpdateIntents\nmethods.\nFormat: `projects//agent/intents/`.", + "description": "Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`.", "type": "string" }, "outputContexts": { - "description": "Optional. The collection of contexts that are activated when the intent\nis matched. Context messages in this collection should not set the\nparameters field. Setting the `lifespan_count` to 0 will reset the context\nwhen the intent is matched.\nFormat: `projects//agent/sessions/-/contexts/`.", + "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": "GoogleCloudDialogflowV2beta1Context" }, @@ -5175,24 +5231,25 @@ "type": "array" }, "parentFollowupIntentName": { - "description": "Optional. The unique identifier of the parent intent in the\nchain of followup intents. You can set this field when creating an intent,\nfor example with CreateIntent or\nBatchUpdateIntents, in order to make this\nintent a followup intent.\n\nIt identifies the parent followup intent.\nFormat: `projects//agent/intents/`.", + "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/`.", "type": "string" }, "priority": { - "description": "Optional. The priority of this intent. Higher numbers represent higher\npriorities.\n\n- If the supplied value is unspecified or 0, the service\n translates the value to 500,000, which corresponds to the\n `Normal` priority in the console.\n- If the supplied value is negative, the intent is ignored\n in runtime detect intent requests.", + "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", "type": "integer" }, "resetContexts": { - "description": "Optional. Indicates whether to delete all contexts in the current\nsession when this intent is matched.", + "description": "Optional. Indicates whether to delete all contexts in the current session when this intent is matched.", "type": "boolean" }, "rootFollowupIntentName": { - "description": "Output only. The unique identifier of the root intent in the chain of\nfollowup intents. It identifies the correct followup intents chain for\nthis intent.\n\nFormat: `projects//agent/intents/`.", + "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/`.", + "readOnly": true, "type": "string" }, "trainingPhrases": { - "description": "Optional. The collection of examples that the agent is\ntrained on.", + "description": "Optional. The collection of examples that the agent is trained on.", "items": { "$ref": "GoogleCloudDialogflowV2beta1IntentTrainingPhrase" }, @@ -5208,7 +5265,7 @@ "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\nfilling prompt is forwarded to the webhook." + "Webhook is enabled in the agent and in the intent. Also, each slot filling prompt is forwarded to the webhook." ], "type": "string" } @@ -5220,11 +5277,11 @@ "id": "GoogleCloudDialogflowV2beta1IntentFollowupIntentInfo", "properties": { "followupIntentName": { - "description": "The unique identifier of the followup intent.\nFormat: `projects//agent/intents/`.", + "description": "The unique identifier of the followup intent. Format: `projects//agent/intents/`.", "type": "string" }, "parentFollowupIntentName": { - "description": "The unique identifier of the followup intent's parent.\nFormat: `projects//agent/intents/`.", + "description": "The unique identifier of the followup intent's parent. Format: `projects//agent/intents/`.", "type": "string" } }, @@ -5298,7 +5355,7 @@ "Skype.", "Line.", "Viber.", - "Google Assistant\nSee [Dialogflow webhook\nformat](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)", + "Google Assistant See [Dialogflow webhook format](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)", "Telephony Gateway.", "Google Hangouts." ], @@ -5318,7 +5375,7 @@ }, "rbmText": { "$ref": "GoogleCloudDialogflowV2beta1IntentMessageRbmText", - "description": "Rich Business Messaging (RBM) text response.\n\nRBM allows businesses to send enriched and branded versions of SMS. See\nhttps://jibe.google.com/business-messaging." + "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." }, "simpleResponses": { "$ref": "GoogleCloudDialogflowV2beta1IntentMessageSimpleResponses", @@ -5408,11 +5465,11 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCard": { - "description": "Browse Carousel Card for Actions on Google.\nhttps://developers.google.com/actions/assistant/responses#browsing_carousel", + "description": "Browse Carousel Card for Actions on Google. https://developers.google.com/actions/assistant/responses#browsing_carousel", "id": "GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCard", "properties": { "imageDisplayOptions": { - "description": "Optional. Settings for displaying the image. Applies to every image in\nitems.", + "description": "Optional. Settings for displaying the image. Applies to every image in items.", "enum": [ "IMAGE_DISPLAY_OPTIONS_UNSPECIFIED", "GRAY", @@ -5421,16 +5478,16 @@ "BLURRED_BACKGROUND" ], "enumDescriptions": [ - "Fill the gaps between the image and the image container with gray\nbars.", - "Fill the gaps between the image and the image container with gray\nbars.", - "Fill the gaps between the image and the image container with white\nbars.", - "Image is scaled such that the image width and height match or exceed\nthe container dimensions. This may crop the top and bottom of the\nimage if the scaled image height is greater than the container\nheight, or crop the left and right of the image if the scaled image\nwidth is greater than the container width. This is similar to \"Zoom\nMode\" on a widescreen TV when playing a 4:3 video.", - "Pad the gaps between image and image frame with a blurred copy of the\nsame image." + "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." ], "type": "string" }, "items": { - "description": "Required. List of items in the Browse Carousel Card. Minimum of two\nitems, maximum of ten.", + "description": "Required. List of items in the Browse Carousel Card. Minimum of two items, maximum of ten.", "items": { "$ref": "GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCardBrowseCarouselCardItem" }, @@ -5444,11 +5501,11 @@ "id": "GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCardBrowseCarouselCardItem", "properties": { "description": { - "description": "Optional. Description of the carousel item. Maximum of four lines of\ntext.", + "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\nCard. Maximum of one line of text.", + "description": "Optional. Text that appears at the bottom of the Browse Carousel Card. Maximum of one line of text.", "type": "string" }, "image": { @@ -5475,7 +5532,7 @@ "type": "string" }, "urlTypeHint": { - "description": "Optional. Specifies the type of viewer that is used when opening\nthe URL. Defaults to opening via web browser.", + "description": "Optional. Specifies the type of viewer that is used when opening the URL. Defaults to opening via web browser.", "enum": [ "URL_TYPE_HINT_UNSPECIFIED", "AMP_ACTION", @@ -5484,7 +5541,7 @@ "enumDescriptions": [ "Unspecified", "Url would be an amp action", - "URL that points directly to AMP content, or to a canonical URL\nwhich refers to AMP content via ." + "URL that points directly to AMP content, or to a canonical URL which refers to AMP content via ." ], "type": "string" } @@ -5522,7 +5579,7 @@ "id": "GoogleCloudDialogflowV2beta1IntentMessageCardButton", "properties": { "postback": { - "description": "Optional. The text to send back to the Dialogflow API or a URI to\nopen.", + "description": "Optional. The text to send back to the Dialogflow API or a URI to open.", "type": "string" }, "text": { @@ -5601,7 +5658,7 @@ "id": "GoogleCloudDialogflowV2beta1IntentMessageImage", "properties": { "accessibilityText": { - "description": "A text description of the image to be used for accessibility,\ne.g., screen readers. Required if image_uri is set for CarouselSelect.", + "description": "A text description of the image to be used for accessibility, e.g., screen readers. Required if image_uri is set for CarouselSelect.", "type": "string" }, "imageUri": { @@ -5612,7 +5669,7 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageLinkOutSuggestion": { - "description": "The suggestion chip message that allows the user to jump out to the app\nor website associated with this agent.", + "description": "The suggestion chip message that allows the user to jump out to the app or website associated with this agent.", "id": "GoogleCloudDialogflowV2beta1IntentMessageLinkOutSuggestion", "properties": { "destinationName": { @@ -5620,7 +5677,7 @@ "type": "string" }, "uri": { - "description": "Required. The URI of the app or site to open when the user taps the\nsuggestion chip.", + "description": "Required. The URI of the app or site to open when the user taps the suggestion chip.", "type": "string" } }, @@ -5747,12 +5804,12 @@ "id": "GoogleCloudDialogflowV2beta1IntentMessageRbmCardContent", "properties": { "description": { - "description": "Optional. Description of the card (at most 2000 bytes).\n\nAt least one of the title, description or media must be set.", + "description": "Optional. Description of the card (at most 2000 bytes). At least one of the title, description or media must be set.", "type": "string" }, "media": { "$ref": "GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia", - "description": "Optional. However at least one of the title, description or media must\nbe set. Media (image, GIF or a video) to include in the card." + "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." }, "suggestions": { "description": "Optional. List of suggestions to include in the card.", @@ -5762,22 +5819,22 @@ "type": "array" }, "title": { - "description": "Optional. Title of the card (at most 200 bytes).\n\nAt least one of the title, description or media must be set.", + "description": "Optional. Title of the card (at most 200 bytes). At least one of the title, description or media must be set.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia": { - "description": "Rich Business Messaging (RBM) Media displayed in Cards\nThe following media-types are currently supported:\n\nImage Types\n\n* image/jpeg\n* image/jpg'\n* image/gif\n* image/png\n\nVideo Types\n\n* video/h263\n* video/m4v\n* video/mp4\n* video/mpeg\n* video/mpeg4\n* video/webm", + "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", "id": "GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia", "properties": { "fileUri": { - "description": "Required. Publicly reachable URI of the file. The RBM platform\ndetermines the MIME type of the file from the content-type field in\nthe HTTP headers when the platform fetches the file. The content-type\nfield must be present and accurate in the HTTP response from the URL.", + "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\nwithin a rich card with a vertical layout.\nFor a standalone card with horizontal layout, height is not\ncustomizable, and this field is ignored.", + "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.", "enum": [ "HEIGHT_UNSPECIFIED", "SHORT", @@ -5788,23 +5845,23 @@ "Not specified.", "112 DP.", "168 DP.", - "264 DP. Not available for rich card carousels when the card width\nis set to small." + "264 DP. Not available for rich card carousels when the card width is set to small." ], "type": "string" }, "thumbnailUri": { - "description": "Optional. Publicly reachable URI of the thumbnail.If you don't\nprovide a thumbnail URI, the RBM platform displays a blank\nplaceholder thumbnail until the user's device downloads the file.\nDepending on the user's setting, the file may not download\nautomatically and may require the user to tap a download button.", + "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.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageRbmCarouselCard": { - "description": "Carousel Rich Business Messaging (RBM) rich card.\n\nRich cards allow you to respond to users with more vivid content, e.g.\nwith media and suggestions.\n\nIf you want to show a single card with more control over the layout,\nplease use RbmStandaloneCard instead.", + "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", "properties": { "cardContents": { - "description": "Required. The cards in the carousel. A carousel must have at least\n2 cards and at most 10.", + "description": "Required. The cards in the carousel. A carousel must have at least 2 cards and at most 10.", "items": { "$ref": "GoogleCloudDialogflowV2beta1IntentMessageRbmCardContent" }, @@ -5828,7 +5885,7 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageRbmStandaloneCard": { - "description": "Standalone Rich Business Messaging (RBM) rich card.\n\nRich cards allow you to respond to users with more vivid content, e.g.\nwith media and suggestions.\n\nYou can group multiple rich cards into one using RbmCarouselCard but\ncarousel cards will give you less control over the card layout.", + "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", "properties": { "cardContent": { @@ -5850,7 +5907,7 @@ "type": "string" }, "thumbnailImageAlignment": { - "description": "Required if orientation is horizontal.\nImage preview alignment for standalone cards with horizontal layout.", + "description": "Required if orientation is horizontal. Image preview alignment for standalone cards with horizontal layout.", "enum": [ "THUMBNAIL_IMAGE_ALIGNMENT_UNSPECIFIED", "LEFT", @@ -5867,7 +5924,7 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedAction": { - "description": "Rich Business Messaging (RBM) suggested client-side action that the user\ncan choose from the card.", + "description": "Rich Business Messaging (RBM) suggested client-side action that the user can choose from the card.", "id": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedAction", "properties": { "dial": { @@ -5879,7 +5936,7 @@ "description": "Suggested client side action: Open a URI on device" }, "postbackData": { - "description": "Opaque payload that the Dialogflow receives in a user event\nwhen the user taps the suggested action. This data will be also\nforwarded to webhook to allow performing custom business logic.", + "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.", "type": "string" }, "shareLocation": { @@ -5894,18 +5951,18 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionDial": { - "description": "Opens the user's default dialer app with the specified phone number\nbut does not dial automatically.", + "description": "Opens the user's default dialer app with the specified phone number but does not dial automatically.", "id": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionDial", "properties": { "phoneNumber": { - "description": "Required. The phone number to fill in the default dialer app.\nThis field should be in [E.164](https://en.wikipedia.org/wiki/E.164)\nformat. An example of a correctly formatted phone number:\n+15556767888.", + "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" }, "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionOpenUri": { - "description": "Opens the user's default web browser app to the specified uri\nIf the user has an app installed that is\nregistered as the default handler for the URL, then this app will be\nopened instead, and its icon will be used in the suggested action UI.", + "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.", "id": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionOpenUri", "properties": { "uri": { @@ -5916,17 +5973,17 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionShareLocation": { - "description": "Opens the device's location chooser so the user can pick a location\nto send back to the agent.", + "description": "Opens the device's location chooser so the user can pick a location to send back to the agent.", "id": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionShareLocation", "properties": {}, "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedReply": { - "description": "Rich Business Messaging (RBM) suggested reply that the user can click\ninstead of typing in their own response.", + "description": "Rich Business Messaging (RBM) suggested reply that the user can click instead of typing in their own response.", "id": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedReply", "properties": { "postbackData": { - "description": "Opaque payload that the Dialogflow receives in a user event\nwhen the user taps the suggested reply. This data will be also\nforwarded to webhook to allow performing custom business logic.", + "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": { @@ -5937,7 +5994,7 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestion": { - "description": "Rich Business Messaging (RBM) suggestion. Suggestions allow user to\neasily select/click a predefined response or perform an action (like\nopening a web uri).", + "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).", "id": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestion", "properties": { "action": { @@ -5970,15 +6027,15 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageSelectItemInfo": { - "description": "Additional info about the select item for when it is triggered in a\ndialog.", + "description": "Additional info about the select item for when it is triggered in a dialog.", "id": "GoogleCloudDialogflowV2beta1IntentMessageSelectItemInfo", "properties": { "key": { - "description": "Required. A unique key that will be sent back to the agent if this\nresponse is given.", + "description": "Required. A unique key that will be sent back to the agent if this response is given.", "type": "string" }, "synonyms": { - "description": "Optional. A list of synonyms that can also be used to trigger this\nitem in dialog.", + "description": "Optional. A list of synonyms that can also be used to trigger this item in dialog.", "items": { "type": "string" }, @@ -5996,18 +6053,18 @@ "type": "string" }, "ssml": { - "description": "One of text_to_speech or ssml must be provided. Structured spoken\nresponse to the user in the SSML format. Mutually exclusive with\ntext_to_speech.", + "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\nspeech output. Mutually exclusive with ssml.", + "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" }, "GoogleCloudDialogflowV2beta1IntentMessageSimpleResponses": { - "description": "The collection of simple response candidates.\nThis message in `QueryResult.fulfillment_messages` and\n`WebhookResponse.fulfillment_messages` should contain only one\n`SimpleResponse`.", + "description": "The collection of simple response candidates. This message in `QueryResult.fulfillment_messages` and `WebhookResponse.fulfillment_messages` should contain only one `SimpleResponse`.", "id": "GoogleCloudDialogflowV2beta1IntentMessageSimpleResponses", "properties": { "simpleResponses": { @@ -6021,7 +6078,7 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageSuggestion": { - "description": "The suggestion chip message that the user can tap to quickly post a reply\nto the conversation.", + "description": "The suggestion chip message that the user can tap to quickly post a reply to the conversation.", "id": "GoogleCloudDialogflowV2beta1IntentMessageSuggestion", "properties": { "title": { @@ -6119,18 +6176,18 @@ "id": "GoogleCloudDialogflowV2beta1IntentMessageTelephonyPlayAudio", "properties": { "audioUri": { - "description": "Required. URI to a Google Cloud Storage object containing the audio to\nplay, e.g., \"gs://bucket/object\". The object must contain a single\nchannel (mono) of linear PCM audio (2 bytes / sample) at 8kHz.\n\nThis object must be readable by the `service-@gcp-sa-dialogflow.iam.gserviceaccount.com` service account\nwhere is the number of the Telephony Gateway project\n(usually the same as the Dialogflow agent project). If the Google Cloud\nStorage bucket is in the Telephony Gateway project, this permission is\nadded by default when enabling the Dialogflow V2 API.\n\nFor audio from other sources, consider using the\n`TelephonySynthesizeSpeech` message with SSML.", + "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 `service-@gcp-sa-dialogflow.iam.gserviceaccount.com` 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.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech": { - "description": "Synthesizes speech and plays back the synthesized audio to the caller in\nTelephony Gateway.\n\nTelephony Gateway takes the synthesizer settings from\n`DetectIntentResponse.output_audio_config` which can either be set\nat request-level or can come from the agent-level synthesizer config.", + "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.", "id": "GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech", "properties": { "ssml": { - "description": "The SSML to be synthesized. For more information, see\n[SSML](https://developers.google.com/actions/reference/ssml).", + "description": "The SSML to be synthesized. For more information, see [SSML](https://developers.google.com/actions/reference/ssml).", "type": "string" }, "text": { @@ -6145,7 +6202,7 @@ "id": "GoogleCloudDialogflowV2beta1IntentMessageTelephonyTransferCall", "properties": { "phoneNumber": { - "description": "Required. The phone number to transfer the call to\nin [E.164 format](https://en.wikipedia.org/wiki/E.164).\n\nWe currently only allow transferring to US numbers (+1xxxyyyzzzz).", + "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).", "type": "string" } }, @@ -6170,7 +6227,7 @@ "id": "GoogleCloudDialogflowV2beta1IntentParameter", "properties": { "defaultValue": { - "description": "Optional. The default value to use when the `value` yields an empty\nresult.\nDefault values can be extracted from contexts by using the following\nsyntax: `#context_name.parameter_name`.", + "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": { @@ -6178,7 +6235,7 @@ "type": "string" }, "entityTypeDisplayName": { - "description": "Optional. The name of the entity type, prefixed with `@`, that\ndescribes values of the parameter. If the parameter is\nrequired, this must be provided.", + "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" }, "isList": { @@ -6186,7 +6243,7 @@ "type": "boolean" }, "mandatory": { - "description": "Optional. Indicates whether the parameter is required. That is,\nwhether the intent cannot be completed without collecting the parameter\nvalue.", + "description": "Optional. Indicates whether the parameter is required. That is, whether the intent cannot be completed without collecting the parameter value.", "type": "boolean" }, "name": { @@ -6194,14 +6251,14 @@ "type": "string" }, "prompts": { - "description": "Optional. The collection of prompts that the agent can present to the\nuser in order to collect a value for the parameter.", + "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" }, "value": { - "description": "Optional. The definition of the parameter value. It can be:\n\n- a constant string,\n- a parameter value defined as `$parameter_name`,\n- an original parameter value defined as `$parameter_name.original`,\n- a parameter value from some context defined as\n `#context_name.parameter_name`.", + "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" } }, @@ -6216,14 +6273,14 @@ "type": "string" }, "parts": { - "description": "Required. The ordered list of training phrase parts.\nThe parts are concatenated in order to form the training phrase.\n\nNote: The API does not automatically annotate training phrases like the\nDialogflow Console does.\n\nNote: Do not forget to include whitespace at part boundaries,\nso the training phrase is well formatted when the parts are concatenated.\n\nIf the training phrase does not need to be annotated with parameters,\nyou just need a single part with only the Part.text field set.\n\nIf you want to annotate the training phrase, you must create multiple\nparts, where the fields of each part are populated in one of two ways:\n\n- `Part.text` is set to a part of the phrase that has no parameters.\n- `Part.text` is set to a part of the phrase that you want to annotate,\n and the `entity_type`, `alias`, and `user_defined` fields are all\n set.", + "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.", "items": { "$ref": "GoogleCloudDialogflowV2beta1IntentTrainingPhrasePart" }, "type": "array" }, "timesAddedCount": { - "description": "Optional. Indicates how many times this example was added to\nthe intent. Each time a developer adds an existing sample by editing an\nintent or training, this counter is increased.", + "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" }, @@ -6236,8 +6293,8 @@ ], "enumDescriptions": [ "Not specified. This value should never be used.", - "Examples do not contain @-prefixed entity type names, but example parts\ncan be annotated with entity types.", - "Templates are not annotated with entity types, but they can contain\n@-prefixed entity type names as substrings.\nTemplate mode has been deprecated. Example mode is the only supported\nway to create new training phrases. If you have existing training\nphrases that you've created in template mode, those will continue to\nwork." + "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" } @@ -6249,11 +6306,11 @@ "id": "GoogleCloudDialogflowV2beta1IntentTrainingPhrasePart", "properties": { "alias": { - "description": "Optional. The parameter name for the value extracted from the\nannotated part of the example.\nThis field is required for annotated parts of the training phrase.", + "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" }, "entityType": { - "description": "Optional. The entity type name prefixed with `@`.\nThis field is required for annotated parts of the training phrase.", + "description": "Optional. The entity type name prefixed with `@`. This field is required for annotated parts of the training phrase.", "type": "string" }, "text": { @@ -6261,7 +6318,7 @@ "type": "string" }, "userDefined": { - "description": "Optional. Indicates whether the text was manually annotated.\nThis field is set to true when the Dialogflow Console is used to\nmanually annotate the part. When creating an annotated part with the\nAPI, you must set this to true.", + "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.", "type": "boolean" } }, @@ -6286,20 +6343,20 @@ "id": "GoogleCloudDialogflowV2beta1KnowledgeAnswersAnswer", "properties": { "answer": { - "description": "The piece of text from the `source` knowledge base document that answers\nthis conversational query.", + "description": "The piece of text from the `source` knowledge base document that answers this conversational query.", "type": "string" }, "faqQuestion": { - "description": "The corresponding FAQ question if the answer was extracted from a FAQ\nDocument, empty otherwise.", + "description": "The corresponding FAQ question if the answer was extracted from a FAQ Document, empty otherwise.", "type": "string" }, "matchConfidence": { - "description": "The system's confidence score that this Knowledge answer is a good match\nfor this conversational query.\nThe range is from 0.0 (completely uncertain) to 1.0 (completely certain).\nNote: The confidence score is likely to vary somewhat (possibly even for\nidentical requests), as the underlying model is under constant\nimprovement. It may be deprecated in the future. We recommend using\n`match_confidence_level` which should be generally more stable.", + "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.", "format": "float", "type": "number" }, "matchConfidenceLevel": { - "description": "The system's confidence level that this knowledge answer is a good match\nfor this conversational query.\nNOTE: The confidence level for a given `` pair may change\nwithout notice, as it depends on models that are constantly being\nimproved. However, it will change less frequently than the confidence\nscore below, and should be preferred for referencing the quality of an\nanswer.", + "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.", "enum": [ "MATCH_CONFIDENCE_LEVEL_UNSPECIFIED", "LOW", @@ -6315,7 +6372,7 @@ "type": "string" }, "source": { - "description": "Indicates which Knowledge Document this answer was extracted from.\nFormat: `projects//knowledgeBases//documents/`.", + "description": "Indicates which Knowledge Document this answer was extracted from. Format: `projects//knowledgeBases//documents/`.", "type": "string" } }, @@ -6339,13 +6396,14 @@ "The operation is currently running.", "The operation is done, either cancelled or completed." ], + "readOnly": true, "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1LabelConversationResponse": { - "description": "The response for\nConversationDatasets.LabelConversation.", + "description": "The response for ConversationDatasets.LabelConversation.", "id": "GoogleCloudDialogflowV2beta1LabelConversationResponse", "properties": { "annotatedConversationDataset": { @@ -6356,7 +6414,7 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest": { - "description": "Represents the contents of the original request that was passed to\nthe `[Streaming]DetectIntent` call.", + "description": "Represents the contents of the original request that was passed to the `[Streaming]DetectIntent` call.", "id": "GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest", "properties": { "payload": { @@ -6364,15 +6422,15 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. This field is set to the value of the `QueryParameters.payload`\nfield passed in the request. Some integrations that query a Dialogflow\nagent may provide additional information in the payload.\n\nIn particular, for the Dialogflow Phone Gateway integration, this field has\nthe form:\n
{\n \"telephony\": {\n   \"caller_id\": \"+18558363987\"\n }\n}
\nNote: The caller ID field (`caller_id`) will be redacted for Standard\nEdition agents and populated with the caller ID in [E.164\nformat](https://en.wikipedia.org/wiki/E.164) for Enterprise Edition agents.", + "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 Standard Edition agents and populated with the caller ID in [E.164 format](https://en.wikipedia.org/wiki/E.164) for Enterprise Edition agents.", "type": "object" }, "source": { - "description": "The source of this request, e.g., `google`, `facebook`, `slack`. It is set\nby Dialogflow-owned servers.", + "description": "The source of this request, e.g., `google`, `facebook`, `slack`. It is set by Dialogflow-owned servers.", "type": "string" }, "version": { - "description": "Optional. The version of the protocol used for this request.\nThis field is AoG-specific.", + "description": "Optional. The version of the protocol used for this request. This field is AoG-specific.", "type": "string" } }, @@ -6387,7 +6445,7 @@ "type": "string" }, "allRequiredParamsPresent": { - "description": "This field is set to:\n\n- `false` if the matched intent has required parameters and not all of\n the required parameter values have been collected.\n- `true` if all required parameter values have been collected, or if the\n matched intent doesn't contain any required parameters.", + "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" }, "diagnosticInfo": { @@ -6395,7 +6453,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Free-form diagnostic information for the associated detect intent request.\nThe fields of this data can change without notice, so you should not write\ncode that depends on its structure.\nThe data may contain:\n\n- webhook call latency\n- webhook errors", + "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", "type": "object" }, "fulfillmentMessages": { @@ -6406,28 +6464,28 @@ "type": "array" }, "fulfillmentText": { - "description": "The text to be pronounced to the user or shown on the screen.\nNote: This is a legacy field, `fulfillment_messages` should be preferred.", + "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" }, "intent": { "$ref": "GoogleCloudDialogflowV2beta1Intent", - "description": "The intent that matched the conversational query. Some, not\nall fields are filled in this message, including but not limited to:\n`name`, `display_name`, `end_interaction` and `is_fallback`." + "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`." }, "intentDetectionConfidence": { - "description": "The intent detection confidence. Values range from 0.0\n(completely uncertain) to 1.0 (completely certain).\nThis value is for informational purpose only and is only used to\nhelp match the best intent within the classification threshold.\nThis value may change for the same end-user expression at any time due to a\nmodel retraining or change in implementation.\nIf there are `multiple knowledge_answers` messages, this value is set to\nthe greatest `knowledgeAnswers.match_confidence` value in the list.", + "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\n`KnowledgeAnswers.match_confidence`." + "description": "The result from Knowledge Connector (if any), ordered by decreasing `KnowledgeAnswers.match_confidence`." }, "languageCode": { - "description": "The language that was triggered during intent detection.\nSee [Language\nSupport](https://cloud.google.com/dialogflow/docs/reference/language)\nfor a list of the currently supported language codes.", + "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.", "type": "string" }, "outputContexts": { - "description": "The collection of output contexts. If applicable,\n`output_contexts.parameters` contains entries with name\n`.original` containing the original parameter values\nbefore the query.", + "description": "The collection of output contexts. If applicable, `output_contexts.parameters` contains entries with name `.original` containing the original parameter values before the query.", "items": { "$ref": "GoogleCloudDialogflowV2beta1Context" }, @@ -6438,19 +6496,19 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of extracted parameters.\n\nDepending on your protocol or client library language, this is a\nmap, associative array, symbol table, dictionary, or JSON object\ncomposed of a collection of (MapKey, MapValue) pairs:\n\n- MapKey type: string\n- MapKey value: parameter name\n- MapValue type:\n - If parameter's entity type is a composite entity: map\n - Else: string or number, depending on parameter value type\n- MapValue value:\n - If parameter's entity type is a composite entity:\n map from composite entity property names to property values\n - Else: parameter value", + "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", "type": "object" }, "queryText": { - "description": "The original conversational query text:\n\n- If natural language text was provided as input, `query_text` contains\n a copy of the input.\n- If natural language speech audio was provided as input, `query_text`\n contains the speech recognition result. If speech recognizer produced\n multiple alternatives, a particular one is picked.\n- If automatic spell correction is enabled, `query_text` will contain the\n corrected user input.", + "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" }, "sentimentAnalysisResult": { "$ref": "GoogleCloudDialogflowV2beta1SentimentAnalysisResult", - "description": "The sentiment analysis result, which depends on the\n`sentiment_analysis_request_config` specified in the request." + "description": "The sentiment analysis result, which depends on the `sentiment_analysis_request_config` specified in the request." }, "speechRecognitionConfidence": { - "description": "The Speech recognition confidence between 0.0 and 1.0. A higher number\nindicates an estimated greater likelihood that the recognized words are\ncorrect. The default of 0.0 is a sentinel value indicating that confidence\nwas not set.\n\nThis field is not guaranteed to be accurate or set. In particular this\nfield isn't set for StreamingDetectIntent since the streaming endpoint has\nseparate confidence estimates per portion of the audio in\nStreamingRecognitionResult.", + "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.", "format": "float", "type": "number" }, @@ -6459,27 +6517,27 @@ "description": "Properties of the object.", "type": "any" }, - "description": "If the query was fulfilled by a webhook call, this field is set to the\nvalue of the `payload` field returned in the webhook response.", + "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" }, "webhookSource": { - "description": "If the query was fulfilled by a webhook call, this field is set to the\nvalue of the `source` field returned in the webhook response.", + "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.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1Sentiment": { - "description": "The sentiment, such as positive/negative feeling or association, for a unit\nof analysis, such as the query text.", + "description": "The sentiment, such as positive/negative feeling or association, for a unit of analysis, such as the query text.", "id": "GoogleCloudDialogflowV2beta1Sentiment", "properties": { "magnitude": { - "description": "A non-negative number in the [0, +inf) range, which represents the absolute\nmagnitude of sentiment, regardless of score (positive or negative).", + "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", "type": "number" }, "score": { - "description": "Sentiment score between -1.0 (negative sentiment) and 1.0 (positive\nsentiment).", + "description": "Sentiment score between -1.0 (negative sentiment) and 1.0 (positive sentiment).", "format": "float", "type": "number" } @@ -6487,7 +6545,7 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1SentimentAnalysisResult": { - "description": "The result of sentiment analysis. Sentiment analysis inspects user input\nand identifies the prevailing subjective opinion, especially to determine a\nuser's attitude as positive, negative, or neutral.\nFor Participants.AnalyzeContent, it needs to be configured in\nDetectIntentRequest.query_params. For\nParticipants.StreamingAnalyzeContent, it needs to be configured in\nStreamingDetectIntentRequest.query_params.\nAnd for Participants.AnalyzeContent and\nParticipants.StreamingAnalyzeContent, it needs to be configured in\nConversationProfile.human_agent_assistant_config", + "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.AnalyzeContent, it needs to be configured in DetectIntentRequest.query_params. For Participants.StreamingAnalyzeContent, 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", "properties": { "queryTextSentiment": { @@ -6498,18 +6556,18 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1SessionEntityType": { - "description": "A session represents a conversation between a Dialogflow agent and an\nend-user. You can create special entities, called session entities, during a\nsession. Session entities can extend or replace custom entity types and only\nexist during the session that they were created for. All session data,\nincluding session entities, is stored by Dialogflow for 20 minutes.\n\nFor more information, see the [session entity\nguide](https://cloud.google.com/dialogflow/docs/entities-session).", + "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\ntype.", + "description": "Required. The collection of entities associated with this session entity type.", "items": { "$ref": "GoogleCloudDialogflowV2beta1EntityTypeEntity" }, "type": "array" }, "entityOverrideMode": { - "description": "Required. Indicates whether the additional data should override or\nsupplement the custom entity type definition.", + "description": "Required. Indicates whether the additional data should override or supplement the custom entity type definition.", "enum": [ "ENTITY_OVERRIDE_MODE_UNSPECIFIED", "ENTITY_OVERRIDE_MODE_OVERRIDE", @@ -6517,13 +6575,13 @@ ], "enumDescriptions": [ "Not specified. This value should be never used.", - "The collection of session entities overrides the collection of entities\nin the corresponding custom entity type.", - "The collection of session entities extends the collection of entities in\nthe corresponding custom entity type.\n\nNote: Even in this override mode calls to `ListSessionEntityTypes`,\n`GetSessionEntityType`, `CreateSessionEntityType` and\n`UpdateSessionEntityType` only return the additional entities added in\nthis session entity type. If you want to get the supplemented list,\nplease call EntityTypes.GetEntityType on the custom entity type\nand merge." + "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" }, "name": { - "description": "Required. The unique identifier of this session entity type. Format:\n`projects//agent/sessions//entityTypes/`, or\n`projects//agent/environments//users//sessions//entityTypes/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.\n\n`` must be the display name of an existing entity\ntype in the same agent that will be overridden or supplemented.", + "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.", "type": "string" } }, @@ -6542,48 +6600,48 @@ }, "originalDetectIntentRequest": { "$ref": "GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest", - "description": "Optional. The contents of the original request that was passed to\n`[Streaming]DetectIntent` call." + "description": "Optional. The contents of the original request that was passed to `[Streaming]DetectIntent` call." }, "queryResult": { "$ref": "GoogleCloudDialogflowV2beta1QueryResult", - "description": "The result of the conversational query or event processing. Contains the\nsame value as `[Streaming]DetectIntentResponse.query_result`." + "description": "The result of the conversational query or event processing. Contains the same value as `[Streaming]DetectIntentResponse.query_result`." }, "responseId": { - "description": "The unique identifier of the response. Contains the same value as\n`[Streaming]DetectIntentResponse.response_id`.", + "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.\nCan be used to identify end-user inside webhook implementation.\nFormat: `projects//agent/sessions/`, or\n`projects//agent/environments//users//sessions/`.", + "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" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1WebhookResponse": { - "description": "The response message for a webhook call.\n\nThis response is validated by the Dialogflow server. If validation fails,\nan error will be returned in the QueryResult.diagnostic_info field.\nSetting JSON fields to an empty value with the wrong type is a common error.\nTo avoid this error:\n\n- Use `\"\"` for empty strings\n- Use `{}` or `null` for empty objects\n- Use `[]` or `null` for empty arrays\n\nFor more information, see the\n[Protocol Buffers Language\nGuide](https://developers.google.com/protocol-buffers/docs/proto3#json).", + "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": "GoogleCloudDialogflowV2beta1WebhookResponse", "properties": { "endInteraction": { - "description": "Optional. Indicates that this intent ends an interaction. Some integrations\n(e.g., Actions on Google or Dialogflow phone gateway) use this information\nto close interaction with an end user. Default is false.", + "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" }, "followupEventInput": { "$ref": "GoogleCloudDialogflowV2beta1EventInput", - "description": "Optional. Invokes the supplied events.\nWhen this field is set, Dialogflow ignores the `fulfillment_text`,\n`fulfillment_messages`, and `payload` fields." + "description": "Optional. Invokes the supplied events. When this field is set, Dialogflow ignores the `fulfillment_text`, `fulfillment_messages`, and `payload` fields." }, "fulfillmentMessages": { - "description": "Optional. The rich response messages intended for the end-user.\nWhen provided, Dialogflow uses this field to populate\nQueryResult.fulfillment_messages sent to the integration or API caller.", + "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.", "items": { "$ref": "GoogleCloudDialogflowV2beta1IntentMessage" }, "type": "array" }, "fulfillmentText": { - "description": "Optional. The text response message intended for the end-user.\nIt is recommended to use `fulfillment_messages.text.text[0]` instead.\nWhen provided, Dialogflow uses this field to populate\nQueryResult.fulfillment_text sent to the integration or API caller.", + "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.", "type": "string" }, "outputContexts": { - "description": "Optional. The collection of output contexts that will overwrite currently\nactive contexts for the session and reset their lifespans.\nWhen provided, Dialogflow uses this field to populate\nQueryResult.output_contexts sent to the integration or API caller.", + "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": "GoogleCloudDialogflowV2beta1Context" }, @@ -6594,18 +6652,18 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. This field can be used to pass custom data from your webhook to the\nintegration or API caller. Arbitrary JSON objects are supported.\nWhen provided, Dialogflow uses this field to populate\nQueryResult.webhook_payload sent to the integration or API caller.\nThis field is also used by the\n[Google Assistant\nintegration](https://cloud.google.com/dialogflow/docs/integrations/aog)\nfor rich response messages.\nSee the format definition at [Google Assistant Dialogflow webhook\nformat](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)", + "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" }, "sessionEntityTypes": { - "description": "Optional. Additional session entity types to replace or extend developer\nentity types with. The entity synonyms apply to all languages and persist\nfor the session. Setting this data from a webhook overwrites\nthe session entity types that have been set using `detectIntent`,\n`streamingDetectIntent` or SessionEntityType management methods.", + "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": { - "description": "Optional. A custom field used to identify the webhook source.\nArbitrary strings are supported.\nWhen provided, Dialogflow uses this field to populate\nQueryResult.webhook_source sent to the integration or API caller.", + "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" } }, @@ -6621,7 +6679,7 @@ "type": "string" }, "agentUri": { - "description": "The URI to a file containing the exported agent. This field is populated\nonly if `agent_uri` is specified in ExportAgentRequest.", + "description": "The URI to a file containing the exported agent. This field is populated only if `agent_uri` is specified in ExportAgentRequest.", "type": "string" } }, @@ -6646,11 +6704,11 @@ "type": "object" }, "GoogleLongrunningOperation": { - "description": "This resource represents a long-running operation that is the result of a\nnetwork API call.", + "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "GoogleLongrunningOperation", "properties": { "done": { - "description": "If the value is `false`, it means the operation is still in progress.\nIf `true`, the operation is completed, and either `error` or `response` is\navailable.", + "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.", "type": "boolean" }, "error": { @@ -6662,11 +6720,11 @@ "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, - "description": "Service-specific metadata associated with the operation. It typically\ncontains progress information and common metadata such as create time.\nSome services might not provide such metadata. Any method that returns a\nlong-running operation should document the metadata type, if any.", + "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" }, "name": { - "description": "The server-assigned name, which is only unique within the same service that\noriginally returns it. If you use the default HTTP mapping, the\n`name` should be a resource name ending with `operations/{unique_id}`.", + "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" }, "response": { @@ -6674,20 +6732,20 @@ "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, - "description": "The normal response of the operation in case of success. If the original\nmethod returns no data on success, such as `Delete`, the response is\n`google.protobuf.Empty`. If the original method is standard\n`Get`/`Create`/`Update`, the response should be the resource. For other\nmethods, the response should have the type `XxxResponse`, where `Xxx`\nis the original method name. For example, if the original method name\nis `TakeSnapshot()`, the inferred response type is\n`TakeSnapshotResponse`.", + "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`.", "type": "object" } }, "type": "object" }, "GoogleProtobufEmpty": { - "description": "A generic empty message that you can re-use to avoid defining duplicated\nempty messages in your APIs. A typical example is to use it as the request\nor the response type of an API method. For instance:\n\n service Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.", + "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 `{}`.", "id": "GoogleProtobufEmpty", "properties": {}, "type": "object" }, "GoogleRpcStatus": { - "description": "The `Status` type defines a logical error model that is suitable for\ndifferent programming environments, including REST APIs and RPC APIs. It is\nused by [gRPC](https://github.com/grpc). Each `Status` message contains\nthree pieces of data: error code, error message, and error details.\n\nYou can find out more about this error model and how to work with it in the\n[API Design Guide](https://cloud.google.com/apis/design/errors).", + "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).", "id": "GoogleRpcStatus", "properties": { "code": { @@ -6696,7 +6754,7 @@ "type": "integer" }, "details": { - "description": "A list of messages that carry the error details. There is a common set of\nmessage types for APIs to use.", + "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", "items": { "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", @@ -6707,14 +6765,14 @@ "type": "array" }, "message": { - "description": "A developer-facing error message, which should be in English. Any\nuser-facing error message should be localized and sent in the\ngoogle.rpc.Status.details field, or localized by the client.", + "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" } }, "type": "object" }, "GoogleTypeLatLng": { - "description": "An object representing a latitude/longitude pair. This is expressed as a pair\nof doubles representing degrees latitude and degrees longitude. Unless\nspecified otherwise, this must conform to the\nWGS84\nstandard. Values must be within normalized ranges.", + "description": "An object representing a latitude/longitude pair. This is expressed as a pair of doubles representing degrees latitude and degrees longitude. Unless specified otherwise, this must conform to the WGS84 standard. Values must be within normalized ranges.", "id": "GoogleTypeLatLng", "properties": { "latitude": { diff --git a/discovery/dialogflow-v2beta1.json b/discovery/dialogflow-v2beta1.json index 1dd3934520..38a1b3244f 100644 --- a/discovery/dialogflow-v2beta1.json +++ b/discovery/dialogflow-v2beta1.json @@ -120,7 +120,7 @@ ], "parameters": { "parent": { - "description": "Required. The project that the agent to delete is associated with.\nFormat: `projects/`.", + "description": "Required. The project that the agent to delete is associated with. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -146,7 +146,7 @@ ], "parameters": { "parent": { - "description": "Required. The project that the agent to fetch is associated with.\nFormat: `projects/`.", + "description": "Required. The project that the agent to fetch is associated with. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -172,7 +172,7 @@ ], "parameters": { "parent": { - "description": "Required. The project of this agent.\nFormat: `projects/`.", + "description": "Required. The project of this agent. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -202,7 +202,7 @@ "agent": { "methods": { "export": { - "description": "Exports the specified agent to a ZIP file.\n\n\nOperation ", + "description": "Exports the specified agent to a ZIP file. Operation ", "flatPath": "v2beta1/projects/{projectsId}/agent:export", "httpMethod": "POST", "id": "dialogflow.projects.agent.export", @@ -211,7 +211,7 @@ ], "parameters": { "parent": { - "description": "Required. The project that the agent to export is associated with.\nFormat: `projects/`.", + "description": "Required. The project that the agent to export is associated with. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -240,7 +240,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the fulfillment.\nFormat: `projects//agent/fulfillment`.", + "description": "Required. The name of the fulfillment. Format: `projects//agent/fulfillment`.", "location": "path", "pattern": "^projects/[^/]+/agent/fulfillment$", "required": true, @@ -257,7 +257,7 @@ ] }, "getValidationResult": { - "description": "Gets agent validation result. Agent validation is performed during\ntraining time and is updated automatically when training is completed.", + "description": "Gets agent validation result. Agent validation is performed during training time and is updated automatically when training is completed.", "flatPath": "v2beta1/projects/{projectsId}/agent/validationResult", "httpMethod": "GET", "id": "dialogflow.projects.agent.getValidationResult", @@ -266,12 +266,12 @@ ], "parameters": { "languageCode": { - "description": "Optional. The language for which you want a validation result. If not\nspecified, the agent's default language is used. [Many\nlanguages](https://cloud.google.com/dialogflow/docs/reference/language)\nare supported. Note: languages must be enabled in the agent before they can\nbe used.", + "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" }, "parent": { - "description": "Required. The project that the agent is associated with.\nFormat: `projects/`.", + "description": "Required. The project that the agent is associated with. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -288,7 +288,7 @@ ] }, "import": { - "description": "Imports the specified agent from a ZIP file.\n\nUploads new intents and entity types without deleting the existing ones.\nIntents and entity types with the same name are replaced with the new\nversions from ImportAgentRequest. After the import, the imported draft\nagent will be trained automatically (unless disabled in agent settings).\nHowever, once the import is done, training may not be completed yet. Please\ncall TrainAgent and wait for the operation it returns in order to train\nexplicitly.\n\n\nOperation \nAn operation which tracks when importing is complete. It only tracks\nwhen the draft agent is updated not when it is done training.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/agent:import", "httpMethod": "POST", "id": "dialogflow.projects.agent.import", @@ -297,7 +297,7 @@ ], "parameters": { "parent": { - "description": "Required. The project that the agent to import is associated with.\nFormat: `projects/`.", + "description": "Required. The project that the agent to import is associated with. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -317,7 +317,7 @@ ] }, "restore": { - "description": "Restores the specified agent from a ZIP file.\n\nReplaces the current agent version with a new one. All the intents and\nentity types in the older version are deleted. After the restore, the\nrestored draft agent will be trained automatically (unless disabled in\nagent settings). However, once the restore is done, training may not be\ncompleted yet. Please call TrainAgent and wait for the operation it\nreturns in order to train explicitly.\n\n\nOperation \nAn operation which tracks when restoring is complete. It only tracks\nwhen the draft agent is updated not when it is done training.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/agent:restore", "httpMethod": "POST", "id": "dialogflow.projects.agent.restore", @@ -326,7 +326,7 @@ ], "parameters": { "parent": { - "description": "Required. The project that the agent to restore is associated with.\nFormat: `projects/`.", + "description": "Required. The project that the agent to restore is associated with. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -346,7 +346,7 @@ ] }, "search": { - "description": "Returns the list of agents.\nSince there is at most one conversational agent per project, this method is\nuseful primarily for listing all agents across projects the caller has\naccess to. One can achieve that with a wildcard project collection id \"-\".\nRefer to [List\nSub-Collections](https://cloud.google.com/apis/design/design_patterns#list_sub-collections).", + "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).", "flatPath": "v2beta1/projects/{projectsId}/agent:search", "httpMethod": "GET", "id": "dialogflow.projects.agent.search", @@ -355,7 +355,7 @@ ], "parameters": { "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 100 and at most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -366,7 +366,7 @@ "type": "string" }, "parent": { - "description": "Required. The project to list agents from.\nFormat: `projects/`.", + "description": "Required. The project to list agents from. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -383,7 +383,7 @@ ] }, "train": { - "description": "Trains the specified agent.\n\n\nOperation ", + "description": "Trains the specified agent. Operation ", "flatPath": "v2beta1/projects/{projectsId}/agent:train", "httpMethod": "POST", "id": "dialogflow.projects.agent.train", @@ -392,7 +392,7 @@ ], "parameters": { "parent": { - "description": "Required. The project that the agent to train is associated with.\nFormat: `projects/`.", + "description": "Required. The project that the agent to train is associated with. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -421,14 +421,14 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of the fulfillment.\nFormat: `projects//agent/fulfillment`.", + "description": "Required. The unique identifier of the fulfillment. Format: `projects//agent/fulfillment`.", "location": "path", "pattern": "^projects/[^/]+/agent/fulfillment$", "required": true, "type": "string" }, "updateMask": { - "description": "Required. The mask to control which fields get updated. If the mask is not\npresent, all fields will be updated.", + "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" @@ -451,7 +451,7 @@ "entityTypes": { "methods": { "batchDelete": { - "description": "Deletes entity types in the specified agent.\nOperation ", + "description": "Deletes entity types in the specified agent. Operation ", "flatPath": "v2beta1/projects/{projectsId}/agent/entityTypes:batchDelete", "httpMethod": "POST", "id": "dialogflow.projects.agent.entityTypes.batchDelete", @@ -460,7 +460,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the agent to delete all entities types for. Format:\n`projects//agent`.", + "description": "Required. The name of the agent to delete all entities types for. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/agent$", "required": true, @@ -480,7 +480,7 @@ ] }, "batchUpdate": { - "description": "Updates/Creates multiple entity types in the specified agent.\nOperation ", + "description": "Updates/Creates multiple entity types in the specified agent. Operation ", "flatPath": "v2beta1/projects/{projectsId}/agent/entityTypes:batchUpdate", "httpMethod": "POST", "id": "dialogflow.projects.agent.entityTypes.batchUpdate", @@ -489,7 +489,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the agent to update or create entity types in.\nFormat: `projects//agent`.", + "description": "Required. The name of the agent to update or create entity types in. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/agent$", "required": true, @@ -518,12 +518,12 @@ ], "parameters": { "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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.\nFormat: `projects//agent`.", + "description": "Required. The agent to create a entity type for. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/agent$", "required": true, @@ -552,7 +552,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the entity type to delete.\nFormat: `projects//agent/entityTypes/`.", + "description": "Required. The name of the entity type to delete. Format: `projects//agent/entityTypes/`.", "location": "path", "pattern": "^projects/[^/]+/agent/entityTypes/[^/]+$", "required": true, @@ -578,12 +578,12 @@ ], "parameters": { "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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.\nFormat: `projects//agent/entityTypes/`.", + "description": "Required. The name of the entity type. Format: `projects//agent/entityTypes/`.", "location": "path", "pattern": "^projects/[^/]+/agent/entityTypes/[^/]+$", "required": true, @@ -609,12 +609,12 @@ ], "parameters": { "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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" }, "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 100 and at most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -625,7 +625,7 @@ "type": "string" }, "parent": { - "description": "Required. The agent to list all entity types from.\nFormat: `projects//agent`.", + "description": "Required. The agent to list all entity types from. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/agent$", "required": true, @@ -651,12 +651,12 @@ ], "parameters": { "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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": "The unique identifier of the entity type.\nRequired for EntityTypes.UpdateEntityType and\nEntityTypes.BatchUpdateEntityTypes methods.\nFormat: `projects//agent/entityTypes/`.", + "description": "The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`.", "location": "path", "pattern": "^projects/[^/]+/agent/entityTypes/[^/]+$", "required": true, @@ -686,7 +686,7 @@ "entities": { "methods": { "batchCreate": { - "description": "Creates multiple new entities in the specified entity type.\n\nOperation ", + "description": "Creates multiple new entities in the specified entity type. Operation ", "flatPath": "v2beta1/projects/{projectsId}/agent/entityTypes/{entityTypesId}/entities:batchCreate", "httpMethod": "POST", "id": "dialogflow.projects.agent.entityTypes.entities.batchCreate", @@ -695,7 +695,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the entity type to create entities in. Format:\n`projects//agent/entityTypes/`.", + "description": "Required. The name of the entity type to create entities in. Format: `projects//agent/entityTypes/`.", "location": "path", "pattern": "^projects/[^/]+/agent/entityTypes/[^/]+$", "required": true, @@ -715,7 +715,7 @@ ] }, "batchDelete": { - "description": "Deletes entities in the specified entity type.\n\nOperation ", + "description": "Deletes entities in the specified entity type. Operation ", "flatPath": "v2beta1/projects/{projectsId}/agent/entityTypes/{entityTypesId}/entities:batchDelete", "httpMethod": "POST", "id": "dialogflow.projects.agent.entityTypes.entities.batchDelete", @@ -724,7 +724,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the entity type to delete entries for. Format:\n`projects//agent/entityTypes/`.", + "description": "Required. The name of the entity type to delete entries for. Format: `projects//agent/entityTypes/`.", "location": "path", "pattern": "^projects/[^/]+/agent/entityTypes/[^/]+$", "required": true, @@ -744,7 +744,7 @@ ] }, "batchUpdate": { - "description": "Updates or creates multiple entities in the specified entity type. This\nmethod does not affect entities in the entity type that aren't explicitly\nspecified in the request.\n\nOperation ", + "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 ", "flatPath": "v2beta1/projects/{projectsId}/agent/entityTypes/{entityTypesId}/entities:batchUpdate", "httpMethod": "POST", "id": "dialogflow.projects.agent.entityTypes.entities.batchUpdate", @@ -753,7 +753,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the entity type to update or create entities in.\nFormat: `projects//agent/entityTypes/`.", + "description": "Required. The name of the entity type to update or create entities in. Format: `projects//agent/entityTypes/`.", "location": "path", "pattern": "^projects/[^/]+/agent/entityTypes/[^/]+$", "required": true, @@ -788,7 +788,7 @@ ], "parameters": { "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By default 100 and\nat most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -799,7 +799,7 @@ "type": "string" }, "parent": { - "description": "Required. The agent to list all environments from.\nFormat:\n- `projects//agent`\n- `projects//locations//agent", + "description": "Required. The agent to list all environments from. Format: - `projects//agent` - `projects//locations//agent", "location": "path", "pattern": "^projects/[^/]+/agent$", "required": true, @@ -831,7 +831,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the session to delete all contexts from. Format:\n`projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. 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/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$", "required": true, @@ -848,7 +848,7 @@ ] }, "detectIntent": { - "description": "Processes a natural language query and returns structured, actionable data\nas a result. This method is not idempotent, because it may cause contexts\nand session entity types to be updated, which in turn might affect\nresults of future queries.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}:detectIntent", "httpMethod": "POST", "id": "dialogflow.projects.agent.environments.users.sessions.detectIntent", @@ -857,7 +857,7 @@ ], "parameters": { "session": { - "description": "Required. The name of the session this query is sent to. Format:\n`projects//agent/sessions/`, or\n`projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume\ndefault 'draft' environment. If `User ID` is not specified, we are using\n\"-\". It's up to the API caller to choose an appropriate `Session ID` and\n`User Id`. They can be a random number or some type of user and session\nidentifiers (preferably hashed). The length of the `Session ID` and\n`User ID` must not exceed 36 characters.\n\nFor more information, see the [API interactions\nguide](https://cloud.google.com/dialogflow/docs/api-overview).", + "description": "Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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).", "location": "path", "pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$", "required": true, @@ -881,7 +881,7 @@ "contexts": { "methods": { "create": { - "description": "Creates a context.\n\nIf the specified context already exists, overrides the context.", + "description": "Creates a context. If the specified context already exists, overrides the context.", "flatPath": "v2beta1/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/contexts", "httpMethod": "POST", "id": "dialogflow.projects.agent.environments.users.sessions.contexts.create", @@ -890,7 +890,7 @@ ], "parameters": { "parent": { - "description": "Required. The session to create a context for.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume\ndefault 'draft' environment. If `User ID` is not specified, we assume\ndefault '-' user.", + "description": "Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. 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/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$", "required": true, @@ -919,7 +919,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the context to delete. Format:\n`projects//agent/sessions//contexts/`\nor `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is\nnot specified, we assume default 'draft' environment. If `User ID` is not\nspecified, we assume default '-' user.", + "description": "Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. 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/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -945,7 +945,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the context. Format:\n`projects//agent/sessions//contexts/`\nor `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is\nnot specified, we assume default 'draft' environment. If `User ID` is not\nspecified, we assume default '-' user.", + "description": "Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. 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/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -971,7 +971,7 @@ ], "parameters": { "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 100 and at most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -982,7 +982,7 @@ "type": "string" }, "parent": { - "description": "Required. The session to list all contexts from.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume\ndefault 'draft' environment. If `User ID` is not specified, we assume\ndefault '-' user.", + "description": "Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. 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/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$", "required": true, @@ -1008,7 +1008,7 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of the context. Format:\n`projects//agent/sessions//contexts/`,\nor `projects//agent/environments//users//sessions//contexts/`.\n\nThe `Context ID` is always converted to lowercase, may only contain\ncharacters in a-zA-Z0-9_-% and may be at most 250 bytes long.\n\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.\n\nThe following context names are reserved for internal use by Dialogflow.\nYou should not use these contexts or create contexts with these names:\n\n* `__system_counters__`\n* `*_id_dialog_context`\n* `*_dialog_params_size`", + "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`", "location": "path", "pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -1038,7 +1038,7 @@ "entityTypes": { "methods": { "create": { - "description": "Creates a session entity type.\n\nIf the specified session entity type already exists, overrides the\nsession entity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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", "httpMethod": "POST", "id": "dialogflow.projects.agent.environments.users.sessions.entityTypes.create", @@ -1047,7 +1047,7 @@ ], "parameters": { "parent": { - "description": "Required. The session to create a session entity type for.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//\nsessions/`. If `Environment ID` is not specified, we assume\ndefault 'draft' environment. If `User ID` is not specified, we assume\ndefault '-' user.", + "description": "Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. 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/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$", "required": true, @@ -1067,7 +1067,7 @@ ] }, "delete": { - "description": "Deletes the specified session entity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes/{entityTypesId}", "httpMethod": "DELETE", "id": "dialogflow.projects.agent.environments.users.sessions.entityTypes.delete", @@ -1076,7 +1076,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the entity type to delete. Format:\n`projects//agent/sessions//entityTypes/` or `projects//agent/environments//users//sessions//entityTypes/`. If `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The name of the entity type to delete. 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.", "location": "path", "pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/entityTypes/[^/]+$", "required": true, @@ -1093,7 +1093,7 @@ ] }, "get": { - "description": "Retrieves the specified session entity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes/{entityTypesId}", "httpMethod": "GET", "id": "dialogflow.projects.agent.environments.users.sessions.entityTypes.get", @@ -1102,7 +1102,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the session entity type. Format:\n`projects//agent/sessions//entityTypes/` or `projects//agent/environments//users//sessions//entityTypes/`. If `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The name of the 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.", "location": "path", "pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/entityTypes/[^/]+$", "required": true, @@ -1119,7 +1119,7 @@ ] }, "list": { - "description": "Returns the list of all session entity types in the specified session.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes", "httpMethod": "GET", "id": "dialogflow.projects.agent.environments.users.sessions.entityTypes.list", @@ -1128,7 +1128,7 @@ ], "parameters": { "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 100 and at most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -1139,7 +1139,7 @@ "type": "string" }, "parent": { - "description": "Required. The session to list all session entity types from.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//\nsessions/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. 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/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$", "required": true, @@ -1156,7 +1156,7 @@ ] }, "patch": { - "description": "Updates the specified session entity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes/{entityTypesId}", "httpMethod": "PATCH", "id": "dialogflow.projects.agent.environments.users.sessions.entityTypes.patch", @@ -1165,7 +1165,7 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of this session entity type. Format:\n`projects//agent/sessions//entityTypes/`, or\n`projects//agent/environments//users//sessions//entityTypes/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.\n\n`` must be the display name of an existing entity\ntype in the same agent that will be overridden or supplemented.", + "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.", "location": "path", "pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/entityTypes/[^/]+$", "required": true, @@ -1201,7 +1201,7 @@ "intents": { "methods": { "batchDelete": { - "description": "Deletes intents in the specified agent.\n\nOperation ", + "description": "Deletes intents in the specified agent. Operation ", "flatPath": "v2beta1/projects/{projectsId}/agent/intents:batchDelete", "httpMethod": "POST", "id": "dialogflow.projects.agent.intents.batchDelete", @@ -1210,7 +1210,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the agent to delete all entities types for. Format:\n`projects//agent`.", + "description": "Required. The name of the agent to delete all entities types for. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/agent$", "required": true, @@ -1230,7 +1230,7 @@ ] }, "batchUpdate": { - "description": "Updates/Creates multiple intents in the specified agent.\n\nOperation ", + "description": "Updates/Creates multiple intents in the specified agent. Operation ", "flatPath": "v2beta1/projects/{projectsId}/agent/intents:batchUpdate", "httpMethod": "POST", "id": "dialogflow.projects.agent.intents.batchUpdate", @@ -1239,7 +1239,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the agent to update or create intents in.\nFormat: `projects//agent`.", + "description": "Required. The name of the agent to update or create intents in. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/agent$", "required": true, @@ -1273,16 +1273,20 @@ "INTENT_VIEW_UNSPECIFIED", "INTENT_VIEW_FULL" ], + "enumDescriptions": [ + "Training phrases field is not populated in the response.", + "All fields are populated." + ], "location": "query", "type": "string" }, "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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 intent for.\nFormat: `projects//agent`.", + "description": "Required. The agent to create a intent for. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/agent$", "required": true, @@ -1311,7 +1315,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the intent to delete. If this intent has direct or\nindirect followup intents, we also delete them.\n\nFormat: `projects//agent/intents/`.", + "description": "Required. The name of the intent to delete. If this intent has direct or indirect followup intents, we also delete them. Format: `projects//agent/intents/`.", "location": "path", "pattern": "^projects/[^/]+/agent/intents/[^/]+$", "required": true, @@ -1342,16 +1346,20 @@ "INTENT_VIEW_UNSPECIFIED", "INTENT_VIEW_FULL" ], + "enumDescriptions": [ + "Training phrases field is not populated in the response.", + "All fields are populated." + ], "location": "query", "type": "string" }, "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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 intent.\nFormat: `projects//agent/intents/`.", + "description": "Required. The name of the intent. Format: `projects//agent/intents/`.", "location": "path", "pattern": "^projects/[^/]+/agent/intents/[^/]+$", "required": true, @@ -1382,16 +1390,20 @@ "INTENT_VIEW_UNSPECIFIED", "INTENT_VIEW_FULL" ], + "enumDescriptions": [ + "Training phrases field is not populated in the response.", + "All fields are populated." + ], "location": "query", "type": "string" }, "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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" }, "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 100 and at most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -1402,7 +1414,7 @@ "type": "string" }, "parent": { - "description": "Required. The agent to list all intents from.\nFormat: `projects//agent`.", + "description": "Required. The agent to list all intents from. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/agent$", "required": true, @@ -1433,16 +1445,20 @@ "INTENT_VIEW_UNSPECIFIED", "INTENT_VIEW_FULL" ], + "enumDescriptions": [ + "Training phrases field is not populated in the response.", + "All fields are populated." + ], "location": "query", "type": "string" }, "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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": "Optional. The unique identifier of this intent.\nRequired for Intents.UpdateIntent and Intents.BatchUpdateIntents\nmethods.\nFormat: `projects//agent/intents/`.", + "description": "Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`.", "location": "path", "pattern": "^projects/[^/]+/agent/intents/[^/]+$", "required": true, @@ -1472,7 +1488,7 @@ "knowledgeBases": { "methods": { "create": { - "description": "Creates a knowledge base.\n\nNote: The `projects.agent.knowledgeBases` resource is deprecated;\nonly use `projects.knowledgeBases`.", + "description": "Creates a knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.", "flatPath": "v2beta1/projects/{projectsId}/agent/knowledgeBases", "httpMethod": "POST", "id": "dialogflow.projects.agent.knowledgeBases.create", @@ -1481,7 +1497,7 @@ ], "parameters": { "parent": { - "description": "Required. The project to create a knowledge base for.\nFormat: `projects/`.", + "description": "Required. The project to create a knowledge base for. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+/agent$", "required": true, @@ -1501,7 +1517,7 @@ ] }, "delete": { - "description": "Deletes the specified knowledge base.\n\nNote: The `projects.agent.knowledgeBases` resource is deprecated;\nonly use `projects.knowledgeBases`.", + "description": "Deletes the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.", "flatPath": "v2beta1/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId}", "httpMethod": "DELETE", "id": "dialogflow.projects.agent.knowledgeBases.delete", @@ -1510,12 +1526,12 @@ ], "parameters": { "force": { - "description": "Optional. Force deletes the knowledge base. When set to true, any documents\nin the knowledge base are also deleted.", + "description": "Optional. Force deletes the knowledge base. When set to true, any documents in the knowledge base are also deleted.", "location": "query", "type": "boolean" }, "name": { - "description": "Required. The name of the knowledge base to delete.\nFormat: `projects//knowledgeBases/`.", + "description": "Required. The name of the knowledge base to delete. Format: `projects//knowledgeBases/`.", "location": "path", "pattern": "^projects/[^/]+/agent/knowledgeBases/[^/]+$", "required": true, @@ -1532,7 +1548,7 @@ ] }, "get": { - "description": "Retrieves the specified knowledge base.\n\nNote: The `projects.agent.knowledgeBases` resource is deprecated;\nonly use `projects.knowledgeBases`.", + "description": "Retrieves the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.", "flatPath": "v2beta1/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId}", "httpMethod": "GET", "id": "dialogflow.projects.agent.knowledgeBases.get", @@ -1541,7 +1557,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the knowledge base to retrieve.\nFormat `projects//knowledgeBases/`.", + "description": "Required. The name of the knowledge base to retrieve. Format `projects//knowledgeBases/`.", "location": "path", "pattern": "^projects/[^/]+/agent/knowledgeBases/[^/]+$", "required": true, @@ -1558,7 +1574,7 @@ ] }, "list": { - "description": "Returns the list of all knowledge bases of the specified agent.\n\nNote: The `projects.agent.knowledgeBases` resource is deprecated;\nonly use `projects.knowledgeBases`.", + "description": "Returns the list of all knowledge bases of the specified agent. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.", "flatPath": "v2beta1/projects/{projectsId}/agent/knowledgeBases", "httpMethod": "GET", "id": "dialogflow.projects.agent.knowledgeBases.list", @@ -1567,7 +1583,7 @@ ], "parameters": { "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 10 and at most 100.", + "description": "Optional. The maximum number of items to return in a single page. By default 10 and at most 100.", "format": "int32", "location": "query", "type": "integer" @@ -1578,7 +1594,7 @@ "type": "string" }, "parent": { - "description": "Required. The project to list of knowledge bases for.\nFormat: `projects/`.", + "description": "Required. The project to list of knowledge bases for. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+/agent$", "required": true, @@ -1595,7 +1611,7 @@ ] }, "patch": { - "description": "Updates the specified knowledge base.\n\nNote: The `projects.agent.knowledgeBases` resource is deprecated;\nonly use `projects.knowledgeBases`.", + "description": "Updates the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.", "flatPath": "v2beta1/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId}", "httpMethod": "PATCH", "id": "dialogflow.projects.agent.knowledgeBases.patch", @@ -1604,14 +1620,14 @@ ], "parameters": { "name": { - "description": "The knowledge base resource name.\nThe name must be empty when creating a knowledge base.\nFormat: `projects//knowledgeBases/`.", + "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/[^/]+$", "required": true, "type": "string" }, "updateMask": { - "description": "Optional. Not specified means `update all`.\nCurrently, only `display_name` can be updated, an InvalidArgument will be\nreturned for attempting to update other fields.", + "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", "type": "string" @@ -1634,7 +1650,7 @@ "documents": { "methods": { "create": { - "description": "Creates a new document.\n\nNote: The `projects.agent.knowledgeBases.documents` resource is deprecated;\nonly use `projects.knowledgeBases.documents`.", + "description": "Creates a new document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`.", "flatPath": "v2beta1/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId}/documents", "httpMethod": "POST", "id": "dialogflow.projects.agent.knowledgeBases.documents.create", @@ -1643,7 +1659,7 @@ ], "parameters": { "parent": { - "description": "Required. The knoweldge base to create a document for.\nFormat: `projects//knowledgeBases/`.", + "description": "Required. The knoweldge base to create a document for. Format: `projects//knowledgeBases/`.", "location": "path", "pattern": "^projects/[^/]+/agent/knowledgeBases/[^/]+$", "required": true, @@ -1663,7 +1679,7 @@ ] }, "delete": { - "description": "Deletes the specified document.\n\nNote: The `projects.agent.knowledgeBases.documents` resource is deprecated;\nonly use `projects.knowledgeBases.documents`.", + "description": "Deletes 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}", "httpMethod": "DELETE", "id": "dialogflow.projects.agent.knowledgeBases.documents.delete", @@ -1672,7 +1688,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the document to delete.\nFormat: `projects//knowledgeBases//documents/`.", + "description": "Required. The name of the document to delete. Format: `projects//knowledgeBases//documents/`.", "location": "path", "pattern": "^projects/[^/]+/agent/knowledgeBases/[^/]+/documents/[^/]+$", "required": true, @@ -1689,7 +1705,7 @@ ] }, "get": { - "description": "Retrieves the specified document.\n\nNote: The `projects.agent.knowledgeBases.documents` resource is deprecated;\nonly use `projects.knowledgeBases.documents`.", + "description": "Retrieves 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}", "httpMethod": "GET", "id": "dialogflow.projects.agent.knowledgeBases.documents.get", @@ -1698,7 +1714,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the document to retrieve.\nFormat `projects//knowledgeBases//documents/`.", + "description": "Required. The name of the document to retrieve. Format `projects//knowledgeBases//documents/`.", "location": "path", "pattern": "^projects/[^/]+/agent/knowledgeBases/[^/]+/documents/[^/]+$", "required": true, @@ -1715,7 +1731,7 @@ ] }, "list": { - "description": "Returns the list of all documents of the knowledge base.\n\nNote: The `projects.agent.knowledgeBases.documents` resource is deprecated;\nonly use `projects.knowledgeBases.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`.", "flatPath": "v2beta1/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId}/documents", "httpMethod": "GET", "id": "dialogflow.projects.agent.knowledgeBases.documents.list", @@ -1724,7 +1740,7 @@ ], "parameters": { "pageSize": { - "description": "The maximum number of items to return in a single page. By\ndefault 10 and at most 100.", + "description": "The maximum number of items to return in a single page. By default 10 and at most 100.", "format": "int32", "location": "query", "type": "integer" @@ -1735,7 +1751,7 @@ "type": "string" }, "parent": { - "description": "Required. The knowledge base to list all documents for.\nFormat: `projects//knowledgeBases/`.", + "description": "Required. The knowledge base to list all documents for. Format: `projects//knowledgeBases/`.", "location": "path", "pattern": "^projects/[^/]+/agent/knowledgeBases/[^/]+$", "required": true, @@ -1752,7 +1768,7 @@ ] }, "patch": { - "description": "Updates the specified document.\n\nNote: The `projects.agent.knowledgeBases.documents` resource is deprecated;\nonly use `projects.knowledgeBases.documents`.", + "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}", "httpMethod": "PATCH", "id": "dialogflow.projects.agent.knowledgeBases.documents.patch", @@ -1761,14 +1777,14 @@ ], "parameters": { "name": { - "description": "Optional. The document resource name.\nThe name must be empty when creating a document.\nFormat: `projects//knowledgeBases//documents/`.", + "description": "Optional. The document resource name. The name must be empty when creating a document. Format: `projects//knowledgeBases//documents/`.", "location": "path", "pattern": "^projects/[^/]+/agent/knowledgeBases/[^/]+/documents/[^/]+$", "required": true, "type": "string" }, "updateMask": { - "description": "Optional. Not specified means `update all`.\nCurrently, only `display_name` can be updated, an InvalidArgument will be\nreturned for attempting to update other fields.", + "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", "type": "string" @@ -1787,7 +1803,7 @@ ] }, "reload": { - "description": "Reloads the specified document from its specified source, content_uri or\ncontent. The previously loaded content of the document will be deleted.\nNote: Even when the content of the document has not changed, there still\nmay be side effects because of internal implementation changes.\n\nNote: The `projects.agent.knowledgeBases.documents` resource is deprecated;\nonly use `projects.knowledgeBases.documents`.", + "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: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`.", "flatPath": "v2beta1/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId}/documents/{documentsId}:reload", "httpMethod": "POST", "id": "dialogflow.projects.agent.knowledgeBases.documents.reload", @@ -1796,7 +1812,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the document to reload.\nFormat: `projects//knowledgeBases//documents/`", + "description": "Required. The name of the document to reload. Format: `projects//knowledgeBases//documents/`", "location": "path", "pattern": "^projects/[^/]+/agent/knowledgeBases/[^/]+/documents/[^/]+$", "required": true, @@ -1831,7 +1847,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the session to delete all contexts from. Format:\n`projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. 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/[^/]+/agent/sessions/[^/]+$", "required": true, @@ -1848,7 +1864,7 @@ ] }, "detectIntent": { - "description": "Processes a natural language query and returns structured, actionable data\nas a result. This method is not idempotent, because it may cause contexts\nand session entity types to be updated, which in turn might affect\nresults of future queries.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/agent/sessions/{sessionsId}:detectIntent", "httpMethod": "POST", "id": "dialogflow.projects.agent.sessions.detectIntent", @@ -1857,7 +1873,7 @@ ], "parameters": { "session": { - "description": "Required. The name of the session this query is sent to. Format:\n`projects//agent/sessions/`, or\n`projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume\ndefault 'draft' environment. If `User ID` is not specified, we are using\n\"-\". It's up to the API caller to choose an appropriate `Session ID` and\n`User Id`. They can be a random number or some type of user and session\nidentifiers (preferably hashed). The length of the `Session ID` and\n`User ID` must not exceed 36 characters.\n\nFor more information, see the [API interactions\nguide](https://cloud.google.com/dialogflow/docs/api-overview).", + "description": "Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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).", "location": "path", "pattern": "^projects/[^/]+/agent/sessions/[^/]+$", "required": true, @@ -1881,7 +1897,7 @@ "contexts": { "methods": { "create": { - "description": "Creates a context.\n\nIf the specified context already exists, overrides the context.", + "description": "Creates a context. If the specified context already exists, overrides the context.", "flatPath": "v2beta1/projects/{projectsId}/agent/sessions/{sessionsId}/contexts", "httpMethod": "POST", "id": "dialogflow.projects.agent.sessions.contexts.create", @@ -1890,7 +1906,7 @@ ], "parameters": { "parent": { - "description": "Required. The session to create a context for.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume\ndefault 'draft' environment. If `User ID` is not specified, we assume\ndefault '-' user.", + "description": "Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. 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/[^/]+/agent/sessions/[^/]+$", "required": true, @@ -1919,7 +1935,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the context to delete. Format:\n`projects//agent/sessions//contexts/`\nor `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is\nnot specified, we assume default 'draft' environment. If `User ID` is not\nspecified, we assume default '-' user.", + "description": "Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. 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/[^/]+/agent/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -1945,7 +1961,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the context. Format:\n`projects//agent/sessions//contexts/`\nor `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is\nnot specified, we assume default 'draft' environment. If `User ID` is not\nspecified, we assume default '-' user.", + "description": "Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. 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/[^/]+/agent/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -1971,7 +1987,7 @@ ], "parameters": { "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 100 and at most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -1982,7 +1998,7 @@ "type": "string" }, "parent": { - "description": "Required. The session to list all contexts from.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume\ndefault 'draft' environment. If `User ID` is not specified, we assume\ndefault '-' user.", + "description": "Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. 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/[^/]+/agent/sessions/[^/]+$", "required": true, @@ -2008,7 +2024,7 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of the context. Format:\n`projects//agent/sessions//contexts/`,\nor `projects//agent/environments//users//sessions//contexts/`.\n\nThe `Context ID` is always converted to lowercase, may only contain\ncharacters in a-zA-Z0-9_-% and may be at most 250 bytes long.\n\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.\n\nThe following context names are reserved for internal use by Dialogflow.\nYou should not use these contexts or create contexts with these names:\n\n* `__system_counters__`\n* `*_id_dialog_context`\n* `*_dialog_params_size`", + "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`", "location": "path", "pattern": "^projects/[^/]+/agent/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -2038,7 +2054,7 @@ "entityTypes": { "methods": { "create": { - "description": "Creates a session entity type.\n\nIf the specified session entity type already exists, overrides the\nsession entity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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", "httpMethod": "POST", "id": "dialogflow.projects.agent.sessions.entityTypes.create", @@ -2047,7 +2063,7 @@ ], "parameters": { "parent": { - "description": "Required. The session to create a session entity type for.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//\nsessions/`. If `Environment ID` is not specified, we assume\ndefault 'draft' environment. If `User ID` is not specified, we assume\ndefault '-' user.", + "description": "Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. 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/[^/]+/agent/sessions/[^/]+$", "required": true, @@ -2067,7 +2083,7 @@ ] }, "delete": { - "description": "Deletes the specified session entity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/agent/sessions/{sessionsId}/entityTypes/{entityTypesId}", "httpMethod": "DELETE", "id": "dialogflow.projects.agent.sessions.entityTypes.delete", @@ -2076,7 +2092,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the entity type to delete. Format:\n`projects//agent/sessions//entityTypes/` or `projects//agent/environments//users//sessions//entityTypes/`. If `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The name of the entity type to delete. 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.", "location": "path", "pattern": "^projects/[^/]+/agent/sessions/[^/]+/entityTypes/[^/]+$", "required": true, @@ -2093,7 +2109,7 @@ ] }, "get": { - "description": "Retrieves the specified session entity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/agent/sessions/{sessionsId}/entityTypes/{entityTypesId}", "httpMethod": "GET", "id": "dialogflow.projects.agent.sessions.entityTypes.get", @@ -2102,7 +2118,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the session entity type. Format:\n`projects//agent/sessions//entityTypes/` or `projects//agent/environments//users//sessions//entityTypes/`. If `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The name of the 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.", "location": "path", "pattern": "^projects/[^/]+/agent/sessions/[^/]+/entityTypes/[^/]+$", "required": true, @@ -2119,7 +2135,7 @@ ] }, "list": { - "description": "Returns the list of all session entity types in the specified session.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/agent/sessions/{sessionsId}/entityTypes", "httpMethod": "GET", "id": "dialogflow.projects.agent.sessions.entityTypes.list", @@ -2128,7 +2144,7 @@ ], "parameters": { "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 100 and at most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -2139,7 +2155,7 @@ "type": "string" }, "parent": { - "description": "Required. The session to list all session entity types from.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//\nsessions/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. 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/[^/]+/agent/sessions/[^/]+$", "required": true, @@ -2156,7 +2172,7 @@ ] }, "patch": { - "description": "Updates the specified session entity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/agent/sessions/{sessionsId}/entityTypes/{entityTypesId}", "httpMethod": "PATCH", "id": "dialogflow.projects.agent.sessions.entityTypes.patch", @@ -2165,7 +2181,7 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of this session entity type. Format:\n`projects//agent/sessions//entityTypes/`, or\n`projects//agent/environments//users//sessions//entityTypes/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.\n\n`` must be the display name of an existing entity\ntype in the same agent that will be overridden or supplemented.", + "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.", "location": "path", "pattern": "^projects/[^/]+/agent/sessions/[^/]+/entityTypes/[^/]+$", "required": true, @@ -2199,7 +2215,7 @@ "knowledgeBases": { "methods": { "create": { - "description": "Creates a knowledge base.\n\nNote: The `projects.agent.knowledgeBases` resource is deprecated;\nonly use `projects.knowledgeBases`.", + "description": "Creates a knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.", "flatPath": "v2beta1/projects/{projectsId}/knowledgeBases", "httpMethod": "POST", "id": "dialogflow.projects.knowledgeBases.create", @@ -2208,7 +2224,7 @@ ], "parameters": { "parent": { - "description": "Required. The project to create a knowledge base for.\nFormat: `projects/`.", + "description": "Required. The project to create a knowledge base for. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -2228,7 +2244,7 @@ ] }, "delete": { - "description": "Deletes the specified knowledge base.\n\nNote: The `projects.agent.knowledgeBases` resource is deprecated;\nonly use `projects.knowledgeBases`.", + "description": "Deletes the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.", "flatPath": "v2beta1/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}", "httpMethod": "DELETE", "id": "dialogflow.projects.knowledgeBases.delete", @@ -2237,12 +2253,12 @@ ], "parameters": { "force": { - "description": "Optional. Force deletes the knowledge base. When set to true, any documents\nin the knowledge base are also deleted.", + "description": "Optional. Force deletes the knowledge base. When set to true, any documents in the knowledge base are also deleted.", "location": "query", "type": "boolean" }, "name": { - "description": "Required. The name of the knowledge base to delete.\nFormat: `projects//knowledgeBases/`.", + "description": "Required. The name of the knowledge base to delete. Format: `projects//knowledgeBases/`.", "location": "path", "pattern": "^projects/[^/]+/knowledgeBases/[^/]+$", "required": true, @@ -2259,7 +2275,7 @@ ] }, "get": { - "description": "Retrieves the specified knowledge base.\n\nNote: The `projects.agent.knowledgeBases` resource is deprecated;\nonly use `projects.knowledgeBases`.", + "description": "Retrieves the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.", "flatPath": "v2beta1/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}", "httpMethod": "GET", "id": "dialogflow.projects.knowledgeBases.get", @@ -2268,7 +2284,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the knowledge base to retrieve.\nFormat `projects//knowledgeBases/`.", + "description": "Required. The name of the knowledge base to retrieve. Format `projects//knowledgeBases/`.", "location": "path", "pattern": "^projects/[^/]+/knowledgeBases/[^/]+$", "required": true, @@ -2285,7 +2301,7 @@ ] }, "list": { - "description": "Returns the list of all knowledge bases of the specified agent.\n\nNote: The `projects.agent.knowledgeBases` resource is deprecated;\nonly use `projects.knowledgeBases`.", + "description": "Returns the list of all knowledge bases of the specified agent. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.", "flatPath": "v2beta1/projects/{projectsId}/knowledgeBases", "httpMethod": "GET", "id": "dialogflow.projects.knowledgeBases.list", @@ -2294,7 +2310,7 @@ ], "parameters": { "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 10 and at most 100.", + "description": "Optional. The maximum number of items to return in a single page. By default 10 and at most 100.", "format": "int32", "location": "query", "type": "integer" @@ -2305,7 +2321,7 @@ "type": "string" }, "parent": { - "description": "Required. The project to list of knowledge bases for.\nFormat: `projects/`.", + "description": "Required. The project to list of knowledge bases for. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -2322,7 +2338,7 @@ ] }, "patch": { - "description": "Updates the specified knowledge base.\n\nNote: The `projects.agent.knowledgeBases` resource is deprecated;\nonly use `projects.knowledgeBases`.", + "description": "Updates the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.", "flatPath": "v2beta1/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}", "httpMethod": "PATCH", "id": "dialogflow.projects.knowledgeBases.patch", @@ -2331,14 +2347,14 @@ ], "parameters": { "name": { - "description": "The knowledge base resource name.\nThe name must be empty when creating a knowledge base.\nFormat: `projects//knowledgeBases/`.", + "description": "The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`.", "location": "path", "pattern": "^projects/[^/]+/knowledgeBases/[^/]+$", "required": true, "type": "string" }, "updateMask": { - "description": "Optional. Not specified means `update all`.\nCurrently, only `display_name` can be updated, an InvalidArgument will be\nreturned for attempting to update other fields.", + "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", "type": "string" @@ -2361,7 +2377,7 @@ "documents": { "methods": { "create": { - "description": "Creates a new document.\n\nNote: The `projects.agent.knowledgeBases.documents` resource is deprecated;\nonly use `projects.knowledgeBases.documents`.", + "description": "Creates a new document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`.", "flatPath": "v2beta1/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}/documents", "httpMethod": "POST", "id": "dialogflow.projects.knowledgeBases.documents.create", @@ -2370,7 +2386,7 @@ ], "parameters": { "parent": { - "description": "Required. The knoweldge base to create a document for.\nFormat: `projects//knowledgeBases/`.", + "description": "Required. The knoweldge base to create a document for. Format: `projects//knowledgeBases/`.", "location": "path", "pattern": "^projects/[^/]+/knowledgeBases/[^/]+$", "required": true, @@ -2390,7 +2406,7 @@ ] }, "delete": { - "description": "Deletes the specified document.\n\nNote: The `projects.agent.knowledgeBases.documents` resource is deprecated;\nonly use `projects.knowledgeBases.documents`.", + "description": "Deletes the specified document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`.", "flatPath": "v2beta1/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}/documents/{documentsId}", "httpMethod": "DELETE", "id": "dialogflow.projects.knowledgeBases.documents.delete", @@ -2399,7 +2415,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the document to delete.\nFormat: `projects//knowledgeBases//documents/`.", + "description": "Required. The name of the document to delete. Format: `projects//knowledgeBases//documents/`.", "location": "path", "pattern": "^projects/[^/]+/knowledgeBases/[^/]+/documents/[^/]+$", "required": true, @@ -2416,7 +2432,7 @@ ] }, "get": { - "description": "Retrieves the specified document.\n\nNote: The `projects.agent.knowledgeBases.documents` resource is deprecated;\nonly use `projects.knowledgeBases.documents`.", + "description": "Retrieves the specified document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`.", "flatPath": "v2beta1/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}/documents/{documentsId}", "httpMethod": "GET", "id": "dialogflow.projects.knowledgeBases.documents.get", @@ -2425,7 +2441,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the document to retrieve.\nFormat `projects//knowledgeBases//documents/`.", + "description": "Required. The name of the document to retrieve. Format `projects//knowledgeBases//documents/`.", "location": "path", "pattern": "^projects/[^/]+/knowledgeBases/[^/]+/documents/[^/]+$", "required": true, @@ -2442,7 +2458,7 @@ ] }, "list": { - "description": "Returns the list of all documents of the knowledge base.\n\nNote: The `projects.agent.knowledgeBases.documents` resource is deprecated;\nonly use `projects.knowledgeBases.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`.", "flatPath": "v2beta1/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}/documents", "httpMethod": "GET", "id": "dialogflow.projects.knowledgeBases.documents.list", @@ -2451,7 +2467,7 @@ ], "parameters": { "pageSize": { - "description": "The maximum number of items to return in a single page. By\ndefault 10 and at most 100.", + "description": "The maximum number of items to return in a single page. By default 10 and at most 100.", "format": "int32", "location": "query", "type": "integer" @@ -2462,7 +2478,7 @@ "type": "string" }, "parent": { - "description": "Required. The knowledge base to list all documents for.\nFormat: `projects//knowledgeBases/`.", + "description": "Required. The knowledge base to list all documents for. Format: `projects//knowledgeBases/`.", "location": "path", "pattern": "^projects/[^/]+/knowledgeBases/[^/]+$", "required": true, @@ -2479,7 +2495,7 @@ ] }, "patch": { - "description": "Updates the specified document.\n\nNote: The `projects.agent.knowledgeBases.documents` resource is deprecated;\nonly use `projects.knowledgeBases.documents`.", + "description": "Updates the specified document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`.", "flatPath": "v2beta1/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}/documents/{documentsId}", "httpMethod": "PATCH", "id": "dialogflow.projects.knowledgeBases.documents.patch", @@ -2488,14 +2504,14 @@ ], "parameters": { "name": { - "description": "Optional. The document resource name.\nThe name must be empty when creating a document.\nFormat: `projects//knowledgeBases//documents/`.", + "description": "Optional. The document resource name. The name must be empty when creating a document. Format: `projects//knowledgeBases//documents/`.", "location": "path", "pattern": "^projects/[^/]+/knowledgeBases/[^/]+/documents/[^/]+$", "required": true, "type": "string" }, "updateMask": { - "description": "Optional. Not specified means `update all`.\nCurrently, only `display_name` can be updated, an InvalidArgument will be\nreturned for attempting to update other fields.", + "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", "type": "string" @@ -2514,7 +2530,7 @@ ] }, "reload": { - "description": "Reloads the specified document from its specified source, content_uri or\ncontent. The previously loaded content of the document will be deleted.\nNote: Even when the content of the document has not changed, there still\nmay be side effects because of internal implementation changes.\n\nNote: The `projects.agent.knowledgeBases.documents` resource is deprecated;\nonly use `projects.knowledgeBases.documents`.", + "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: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`.", "flatPath": "v2beta1/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}/documents/{documentsId}:reload", "httpMethod": "POST", "id": "dialogflow.projects.knowledgeBases.documents.reload", @@ -2523,7 +2539,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the document to reload.\nFormat: `projects//knowledgeBases//documents/`", + "description": "Required. The name of the document to reload. Format: `projects//knowledgeBases//documents/`", "location": "path", "pattern": "^projects/[^/]+/knowledgeBases/[^/]+/documents/[^/]+$", "required": true, @@ -2558,7 +2574,7 @@ ], "parameters": { "parent": { - "description": "Required. The project that the agent to delete is associated with.\nFormat: `projects/`.", + "description": "Required. The project that the agent to delete is associated with. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -2584,7 +2600,7 @@ ], "parameters": { "parent": { - "description": "Required. The project that the agent to fetch is associated with.\nFormat: `projects/`.", + "description": "Required. The project that the agent to fetch is associated with. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -2610,7 +2626,7 @@ ], "parameters": { "parent": { - "description": "Required. The project of this agent.\nFormat: `projects/`.", + "description": "Required. The project of this agent. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -2640,7 +2656,7 @@ "agent": { "methods": { "export": { - "description": "Exports the specified agent to a ZIP file.\n\n\nOperation ", + "description": "Exports the specified agent to a ZIP file. Operation ", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent:export", "httpMethod": "POST", "id": "dialogflow.projects.locations.agent.export", @@ -2649,7 +2665,7 @@ ], "parameters": { "parent": { - "description": "Required. The project that the agent to export is associated with.\nFormat: `projects/`.", + "description": "Required. The project that the agent to export is associated with. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -2678,7 +2694,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the fulfillment.\nFormat: `projects//agent/fulfillment`.", + "description": "Required. The name of the fulfillment. Format: `projects//agent/fulfillment`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/fulfillment$", "required": true, @@ -2695,7 +2711,7 @@ ] }, "import": { - "description": "Imports the specified agent from a ZIP file.\n\nUploads new intents and entity types without deleting the existing ones.\nIntents and entity types with the same name are replaced with the new\nversions from ImportAgentRequest. After the import, the imported draft\nagent will be trained automatically (unless disabled in agent settings).\nHowever, once the import is done, training may not be completed yet. Please\ncall TrainAgent and wait for the operation it returns in order to train\nexplicitly.\n\n\nOperation \nAn operation which tracks when importing is complete. It only tracks\nwhen the draft agent is updated not when it is done training.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent:import", "httpMethod": "POST", "id": "dialogflow.projects.locations.agent.import", @@ -2704,7 +2720,7 @@ ], "parameters": { "parent": { - "description": "Required. The project that the agent to import is associated with.\nFormat: `projects/`.", + "description": "Required. The project that the agent to import is associated with. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -2724,7 +2740,7 @@ ] }, "restore": { - "description": "Restores the specified agent from a ZIP file.\n\nReplaces the current agent version with a new one. All the intents and\nentity types in the older version are deleted. After the restore, the\nrestored draft agent will be trained automatically (unless disabled in\nagent settings). However, once the restore is done, training may not be\ncompleted yet. Please call TrainAgent and wait for the operation it\nreturns in order to train explicitly.\n\n\nOperation \nAn operation which tracks when restoring is complete. It only tracks\nwhen the draft agent is updated not when it is done training.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent:restore", "httpMethod": "POST", "id": "dialogflow.projects.locations.agent.restore", @@ -2733,7 +2749,7 @@ ], "parameters": { "parent": { - "description": "Required. The project that the agent to restore is associated with.\nFormat: `projects/`.", + "description": "Required. The project that the agent to restore is associated with. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -2753,7 +2769,7 @@ ] }, "search": { - "description": "Returns the list of agents.\nSince there is at most one conversational agent per project, this method is\nuseful primarily for listing all agents across projects the caller has\naccess to. One can achieve that with a wildcard project collection id \"-\".\nRefer to [List\nSub-Collections](https://cloud.google.com/apis/design/design_patterns#list_sub-collections).", + "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).", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent:search", "httpMethod": "GET", "id": "dialogflow.projects.locations.agent.search", @@ -2762,7 +2778,7 @@ ], "parameters": { "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 100 and at most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -2773,7 +2789,7 @@ "type": "string" }, "parent": { - "description": "Required. The project to list agents from.\nFormat: `projects/`.", + "description": "Required. The project to list agents from. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -2790,7 +2806,7 @@ ] }, "train": { - "description": "Trains the specified agent.\n\n\nOperation ", + "description": "Trains the specified agent. Operation ", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent:train", "httpMethod": "POST", "id": "dialogflow.projects.locations.agent.train", @@ -2799,7 +2815,7 @@ ], "parameters": { "parent": { - "description": "Required. The project that the agent to train is associated with.\nFormat: `projects/`.", + "description": "Required. The project that the agent to train is associated with. Format: `projects/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -2828,14 +2844,14 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of the fulfillment.\nFormat: `projects//agent/fulfillment`.", + "description": "Required. The unique identifier of the fulfillment. Format: `projects//agent/fulfillment`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/fulfillment$", "required": true, "type": "string" }, "updateMask": { - "description": "Required. The mask to control which fields get updated. If the mask is not\npresent, all fields will be updated.", + "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" @@ -2858,7 +2874,7 @@ "entityTypes": { "methods": { "batchDelete": { - "description": "Deletes entity types in the specified agent.\nOperation ", + "description": "Deletes entity types in the specified agent. Operation ", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/entityTypes:batchDelete", "httpMethod": "POST", "id": "dialogflow.projects.locations.agent.entityTypes.batchDelete", @@ -2867,7 +2883,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the agent to delete all entities types for. Format:\n`projects//agent`.", + "description": "Required. The name of the agent to delete all entities types for. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent$", "required": true, @@ -2887,7 +2903,7 @@ ] }, "batchUpdate": { - "description": "Updates/Creates multiple entity types in the specified agent.\nOperation ", + "description": "Updates/Creates multiple entity types in the specified agent. Operation ", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/entityTypes:batchUpdate", "httpMethod": "POST", "id": "dialogflow.projects.locations.agent.entityTypes.batchUpdate", @@ -2896,7 +2912,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the agent to update or create entity types in.\nFormat: `projects//agent`.", + "description": "Required. The name of the agent to update or create entity types in. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent$", "required": true, @@ -2925,12 +2941,12 @@ ], "parameters": { "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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.\nFormat: `projects//agent`.", + "description": "Required. The agent to create a entity type for. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent$", "required": true, @@ -2959,7 +2975,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the entity type to delete.\nFormat: `projects//agent/entityTypes/`.", + "description": "Required. The name of the entity type to delete. Format: `projects//agent/entityTypes/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/entityTypes/[^/]+$", "required": true, @@ -2985,12 +3001,12 @@ ], "parameters": { "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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.\nFormat: `projects//agent/entityTypes/`.", + "description": "Required. The name of the entity type. Format: `projects//agent/entityTypes/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/entityTypes/[^/]+$", "required": true, @@ -3016,12 +3032,12 @@ ], "parameters": { "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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" }, "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 100 and at most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -3032,7 +3048,7 @@ "type": "string" }, "parent": { - "description": "Required. The agent to list all entity types from.\nFormat: `projects//agent`.", + "description": "Required. The agent to list all entity types from. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent$", "required": true, @@ -3058,12 +3074,12 @@ ], "parameters": { "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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": "The unique identifier of the entity type.\nRequired for EntityTypes.UpdateEntityType and\nEntityTypes.BatchUpdateEntityTypes methods.\nFormat: `projects//agent/entityTypes/`.", + "description": "The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/entityTypes/[^/]+$", "required": true, @@ -3093,7 +3109,7 @@ "entities": { "methods": { "batchCreate": { - "description": "Creates multiple new entities in the specified entity type.\n\nOperation ", + "description": "Creates multiple new entities in the specified entity type. Operation ", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/entityTypes/{entityTypesId}/entities:batchCreate", "httpMethod": "POST", "id": "dialogflow.projects.locations.agent.entityTypes.entities.batchCreate", @@ -3102,7 +3118,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the entity type to create entities in. Format:\n`projects//agent/entityTypes/`.", + "description": "Required. The name of the entity type to create entities in. Format: `projects//agent/entityTypes/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/entityTypes/[^/]+$", "required": true, @@ -3122,7 +3138,7 @@ ] }, "batchDelete": { - "description": "Deletes entities in the specified entity type.\n\nOperation ", + "description": "Deletes entities in the specified entity type. Operation ", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/entityTypes/{entityTypesId}/entities:batchDelete", "httpMethod": "POST", "id": "dialogflow.projects.locations.agent.entityTypes.entities.batchDelete", @@ -3131,7 +3147,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the entity type to delete entries for. Format:\n`projects//agent/entityTypes/`.", + "description": "Required. The name of the entity type to delete entries for. Format: `projects//agent/entityTypes/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/entityTypes/[^/]+$", "required": true, @@ -3151,7 +3167,7 @@ ] }, "batchUpdate": { - "description": "Updates or creates multiple entities in the specified entity type. This\nmethod does not affect entities in the entity type that aren't explicitly\nspecified in the request.\n\nOperation ", + "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 ", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/entityTypes/{entityTypesId}/entities:batchUpdate", "httpMethod": "POST", "id": "dialogflow.projects.locations.agent.entityTypes.entities.batchUpdate", @@ -3160,7 +3176,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the entity type to update or create entities in.\nFormat: `projects//agent/entityTypes/`.", + "description": "Required. The name of the entity type to update or create entities in. Format: `projects//agent/entityTypes/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/entityTypes/[^/]+$", "required": true, @@ -3195,7 +3211,7 @@ ], "parameters": { "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By default 100 and\nat most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -3206,7 +3222,7 @@ "type": "string" }, "parent": { - "description": "Required. The agent to list all environments from.\nFormat:\n- `projects//agent`\n- `projects//locations//agent", + "description": "Required. The agent to list all environments from. Format: - `projects//agent` - `projects//locations//agent", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent$", "required": true, @@ -3238,7 +3254,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the session to delete all contexts from. Format:\n`projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. 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/[^/]+$", "required": true, @@ -3255,7 +3271,7 @@ ] }, "detectIntent": { - "description": "Processes a natural language query and returns structured, actionable data\nas a result. This method is not idempotent, because it may cause contexts\nand session entity types to be updated, which in turn might affect\nresults of future queries.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}:detectIntent", "httpMethod": "POST", "id": "dialogflow.projects.locations.agent.environments.users.sessions.detectIntent", @@ -3264,7 +3280,7 @@ ], "parameters": { "session": { - "description": "Required. The name of the session this query is sent to. Format:\n`projects//agent/sessions/`, or\n`projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume\ndefault 'draft' environment. If `User ID` is not specified, we are using\n\"-\". It's up to the API caller to choose an appropriate `Session ID` and\n`User Id`. They can be a random number or some type of user and session\nidentifiers (preferably hashed). The length of the `Session ID` and\n`User ID` must not exceed 36 characters.\n\nFor more information, see the [API interactions\nguide](https://cloud.google.com/dialogflow/docs/api-overview).", + "description": "Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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).", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+$", "required": true, @@ -3288,7 +3304,7 @@ "contexts": { "methods": { "create": { - "description": "Creates a context.\n\nIf the specified context already exists, overrides the context.", + "description": "Creates a context. If the specified context already exists, overrides the context.", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/contexts", "httpMethod": "POST", "id": "dialogflow.projects.locations.agent.environments.users.sessions.contexts.create", @@ -3297,7 +3313,7 @@ ], "parameters": { "parent": { - "description": "Required. The session to create a context for.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume\ndefault 'draft' environment. If `User ID` is not specified, we assume\ndefault '-' user.", + "description": "Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. 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/[^/]+$", "required": true, @@ -3326,7 +3342,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the context to delete. Format:\n`projects//agent/sessions//contexts/`\nor `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is\nnot specified, we assume default 'draft' environment. If `User ID` is not\nspecified, we assume default '-' user.", + "description": "Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. 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/[^/]+/contexts/[^/]+$", "required": true, @@ -3352,7 +3368,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the context. Format:\n`projects//agent/sessions//contexts/`\nor `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is\nnot specified, we assume default 'draft' environment. If `User ID` is not\nspecified, we assume default '-' user.", + "description": "Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. 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/[^/]+/contexts/[^/]+$", "required": true, @@ -3378,7 +3394,7 @@ ], "parameters": { "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 100 and at most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -3389,7 +3405,7 @@ "type": "string" }, "parent": { - "description": "Required. The session to list all contexts from.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume\ndefault 'draft' environment. If `User ID` is not specified, we assume\ndefault '-' user.", + "description": "Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. 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/[^/]+$", "required": true, @@ -3415,7 +3431,7 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of the context. Format:\n`projects//agent/sessions//contexts/`,\nor `projects//agent/environments//users//sessions//contexts/`.\n\nThe `Context ID` is always converted to lowercase, may only contain\ncharacters in a-zA-Z0-9_-% and may be at most 250 bytes long.\n\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.\n\nThe following context names are reserved for internal use by Dialogflow.\nYou should not use these contexts or create contexts with these names:\n\n* `__system_counters__`\n* `*_id_dialog_context`\n* `*_dialog_params_size`", + "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`", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -3445,7 +3461,7 @@ "entityTypes": { "methods": { "create": { - "description": "Creates a session entity type.\n\nIf the specified session entity type already exists, overrides the\nsession entity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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}/locations/{locationsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes", "httpMethod": "POST", "id": "dialogflow.projects.locations.agent.environments.users.sessions.entityTypes.create", @@ -3454,7 +3470,7 @@ ], "parameters": { "parent": { - "description": "Required. The session to create a session entity type for.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//\nsessions/`. If `Environment ID` is not specified, we assume\ndefault 'draft' environment. If `User ID` is not specified, we assume\ndefault '-' user.", + "description": "Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. 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/[^/]+$", "required": true, @@ -3474,7 +3490,7 @@ ] }, "delete": { - "description": "Deletes the specified session entity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes/{entityTypesId}", "httpMethod": "DELETE", "id": "dialogflow.projects.locations.agent.environments.users.sessions.entityTypes.delete", @@ -3483,7 +3499,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the entity type to delete. Format:\n`projects//agent/sessions//entityTypes/` or `projects//agent/environments//users//sessions//entityTypes/`. If `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The name of the entity type to delete. 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.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/entityTypes/[^/]+$", "required": true, @@ -3500,7 +3516,7 @@ ] }, "get": { - "description": "Retrieves the specified session entity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes/{entityTypesId}", "httpMethod": "GET", "id": "dialogflow.projects.locations.agent.environments.users.sessions.entityTypes.get", @@ -3509,7 +3525,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the session entity type. Format:\n`projects//agent/sessions//entityTypes/` or `projects//agent/environments//users//sessions//entityTypes/`. If `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The name of the 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.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/entityTypes/[^/]+$", "required": true, @@ -3526,7 +3542,7 @@ ] }, "list": { - "description": "Returns the list of all session entity types in the specified session.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes", "httpMethod": "GET", "id": "dialogflow.projects.locations.agent.environments.users.sessions.entityTypes.list", @@ -3535,7 +3551,7 @@ ], "parameters": { "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 100 and at most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -3546,7 +3562,7 @@ "type": "string" }, "parent": { - "description": "Required. The session to list all session entity types from.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//\nsessions/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. 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/[^/]+$", "required": true, @@ -3563,7 +3579,7 @@ ] }, "patch": { - "description": "Updates the specified session entity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/environments/{environmentsId}/users/{usersId}/sessions/{sessionsId}/entityTypes/{entityTypesId}", "httpMethod": "PATCH", "id": "dialogflow.projects.locations.agent.environments.users.sessions.entityTypes.patch", @@ -3572,7 +3588,7 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of this session entity type. Format:\n`projects//agent/sessions//entityTypes/`, or\n`projects//agent/environments//users//sessions//entityTypes/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.\n\n`` must be the display name of an existing entity\ntype in the same agent that will be overridden or supplemented.", + "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.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/entityTypes/[^/]+$", "required": true, @@ -3608,7 +3624,7 @@ "intents": { "methods": { "batchDelete": { - "description": "Deletes intents in the specified agent.\n\nOperation ", + "description": "Deletes intents in the specified agent. Operation ", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/intents:batchDelete", "httpMethod": "POST", "id": "dialogflow.projects.locations.agent.intents.batchDelete", @@ -3617,7 +3633,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the agent to delete all entities types for. Format:\n`projects//agent`.", + "description": "Required. The name of the agent to delete all entities types for. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent$", "required": true, @@ -3637,7 +3653,7 @@ ] }, "batchUpdate": { - "description": "Updates/Creates multiple intents in the specified agent.\n\nOperation ", + "description": "Updates/Creates multiple intents in the specified agent. Operation ", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/intents:batchUpdate", "httpMethod": "POST", "id": "dialogflow.projects.locations.agent.intents.batchUpdate", @@ -3646,7 +3662,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the agent to update or create intents in.\nFormat: `projects//agent`.", + "description": "Required. The name of the agent to update or create intents in. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent$", "required": true, @@ -3680,16 +3696,20 @@ "INTENT_VIEW_UNSPECIFIED", "INTENT_VIEW_FULL" ], + "enumDescriptions": [ + "Training phrases field is not populated in the response.", + "All fields are populated." + ], "location": "query", "type": "string" }, "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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 intent for.\nFormat: `projects//agent`.", + "description": "Required. The agent to create a intent for. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent$", "required": true, @@ -3718,7 +3738,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the intent to delete. If this intent has direct or\nindirect followup intents, we also delete them.\n\nFormat: `projects//agent/intents/`.", + "description": "Required. The name of the intent to delete. If this intent has direct or indirect followup intents, we also delete them. Format: `projects//agent/intents/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/intents/[^/]+$", "required": true, @@ -3749,16 +3769,20 @@ "INTENT_VIEW_UNSPECIFIED", "INTENT_VIEW_FULL" ], + "enumDescriptions": [ + "Training phrases field is not populated in the response.", + "All fields are populated." + ], "location": "query", "type": "string" }, "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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 intent.\nFormat: `projects//agent/intents/`.", + "description": "Required. The name of the intent. Format: `projects//agent/intents/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/intents/[^/]+$", "required": true, @@ -3789,16 +3813,20 @@ "INTENT_VIEW_UNSPECIFIED", "INTENT_VIEW_FULL" ], + "enumDescriptions": [ + "Training phrases field is not populated in the response.", + "All fields are populated." + ], "location": "query", "type": "string" }, "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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" }, "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 100 and at most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -3809,7 +3837,7 @@ "type": "string" }, "parent": { - "description": "Required. The agent to list all intents from.\nFormat: `projects//agent`.", + "description": "Required. The agent to list all intents from. Format: `projects//agent`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent$", "required": true, @@ -3840,16 +3868,20 @@ "INTENT_VIEW_UNSPECIFIED", "INTENT_VIEW_FULL" ], + "enumDescriptions": [ + "Training phrases field is not populated in the response.", + "All fields are populated." + ], "location": "query", "type": "string" }, "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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": "Optional. The unique identifier of this intent.\nRequired for Intents.UpdateIntent and Intents.BatchUpdateIntents\nmethods.\nFormat: `projects//agent/intents/`.", + "description": "Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/intents/[^/]+$", "required": true, @@ -3888,7 +3920,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the session to delete all contexts from. Format:\n`projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. 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/sessions/[^/]+$", "required": true, @@ -3905,7 +3937,7 @@ ] }, "detectIntent": { - "description": "Processes a natural language query and returns structured, actionable data\nas a result. This method is not idempotent, because it may cause contexts\nand session entity types to be updated, which in turn might affect\nresults of future queries.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/sessions/{sessionsId}:detectIntent", "httpMethod": "POST", "id": "dialogflow.projects.locations.agent.sessions.detectIntent", @@ -3914,7 +3946,7 @@ ], "parameters": { "session": { - "description": "Required. The name of the session this query is sent to. Format:\n`projects//agent/sessions/`, or\n`projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume\ndefault 'draft' environment. If `User ID` is not specified, we are using\n\"-\". It's up to the API caller to choose an appropriate `Session ID` and\n`User Id`. They can be a random number or some type of user and session\nidentifiers (preferably hashed). The length of the `Session ID` and\n`User ID` must not exceed 36 characters.\n\nFor more information, see the [API interactions\nguide](https://cloud.google.com/dialogflow/docs/api-overview).", + "description": "Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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).", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/sessions/[^/]+$", "required": true, @@ -3938,7 +3970,7 @@ "contexts": { "methods": { "create": { - "description": "Creates a context.\n\nIf the specified context already exists, overrides the context.", + "description": "Creates a context. If the specified context already exists, overrides the context.", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/sessions/{sessionsId}/contexts", "httpMethod": "POST", "id": "dialogflow.projects.locations.agent.sessions.contexts.create", @@ -3947,7 +3979,7 @@ ], "parameters": { "parent": { - "description": "Required. The session to create a context for.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume\ndefault 'draft' environment. If `User ID` is not specified, we assume\ndefault '-' user.", + "description": "Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. 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/sessions/[^/]+$", "required": true, @@ -3976,7 +4008,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the context to delete. Format:\n`projects//agent/sessions//contexts/`\nor `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is\nnot specified, we assume default 'draft' environment. If `User ID` is not\nspecified, we assume default '-' user.", + "description": "Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. 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/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -4002,7 +4034,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the context. Format:\n`projects//agent/sessions//contexts/`\nor `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is\nnot specified, we assume default 'draft' environment. If `User ID` is not\nspecified, we assume default '-' user.", + "description": "Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. 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/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -4028,7 +4060,7 @@ ], "parameters": { "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 100 and at most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -4039,7 +4071,7 @@ "type": "string" }, "parent": { - "description": "Required. The session to list all contexts from.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume\ndefault 'draft' environment. If `User ID` is not specified, we assume\ndefault '-' user.", + "description": "Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. 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/sessions/[^/]+$", "required": true, @@ -4065,7 +4097,7 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of the context. Format:\n`projects//agent/sessions//contexts/`,\nor `projects//agent/environments//users//sessions//contexts/`.\n\nThe `Context ID` is always converted to lowercase, may only contain\ncharacters in a-zA-Z0-9_-% and may be at most 250 bytes long.\n\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.\n\nThe following context names are reserved for internal use by Dialogflow.\nYou should not use these contexts or create contexts with these names:\n\n* `__system_counters__`\n* `*_id_dialog_context`\n* `*_dialog_params_size`", + "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`", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -4095,7 +4127,7 @@ "entityTypes": { "methods": { "create": { - "description": "Creates a session entity type.\n\nIf the specified session entity type already exists, overrides the\nsession entity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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}/locations/{locationsId}/agent/sessions/{sessionsId}/entityTypes", "httpMethod": "POST", "id": "dialogflow.projects.locations.agent.sessions.entityTypes.create", @@ -4104,7 +4136,7 @@ ], "parameters": { "parent": { - "description": "Required. The session to create a session entity type for.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//\nsessions/`. If `Environment ID` is not specified, we assume\ndefault 'draft' environment. If `User ID` is not specified, we assume\ndefault '-' user.", + "description": "Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. 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/sessions/[^/]+$", "required": true, @@ -4124,7 +4156,7 @@ ] }, "delete": { - "description": "Deletes the specified session entity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/sessions/{sessionsId}/entityTypes/{entityTypesId}", "httpMethod": "DELETE", "id": "dialogflow.projects.locations.agent.sessions.entityTypes.delete", @@ -4133,7 +4165,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the entity type to delete. Format:\n`projects//agent/sessions//entityTypes/` or `projects//agent/environments//users//sessions//entityTypes/`. If `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The name of the entity type to delete. 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.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/sessions/[^/]+/entityTypes/[^/]+$", "required": true, @@ -4150,7 +4182,7 @@ ] }, "get": { - "description": "Retrieves the specified session entity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/sessions/{sessionsId}/entityTypes/{entityTypesId}", "httpMethod": "GET", "id": "dialogflow.projects.locations.agent.sessions.entityTypes.get", @@ -4159,7 +4191,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the session entity type. Format:\n`projects//agent/sessions//entityTypes/` or `projects//agent/environments//users//sessions//entityTypes/`. If `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The name of the 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.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/sessions/[^/]+/entityTypes/[^/]+$", "required": true, @@ -4176,7 +4208,7 @@ ] }, "list": { - "description": "Returns the list of all session entity types in the specified session.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/sessions/{sessionsId}/entityTypes", "httpMethod": "GET", "id": "dialogflow.projects.locations.agent.sessions.entityTypes.list", @@ -4185,7 +4217,7 @@ ], "parameters": { "pageSize": { - "description": "Optional. The maximum number of items to return in a single page. By\ndefault 100 and at most 1000.", + "description": "Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.", "format": "int32", "location": "query", "type": "integer" @@ -4196,7 +4228,7 @@ "type": "string" }, "parent": { - "description": "Required. The session to list all session entity types from.\nFormat: `projects//agent/sessions/` or\n`projects//agent/environments//users//\nsessions/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.", + "description": "Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. 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/sessions/[^/]+$", "required": true, @@ -4213,7 +4245,7 @@ ] }, "patch": { - "description": "Updates the specified session entity type.\n\nThis method doesn't work with Google Assistant integration.\nContact Dialogflow support if you need to use session entities\nwith Google Assistant integration.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/agent/sessions/{sessionsId}/entityTypes/{entityTypesId}", "httpMethod": "PATCH", "id": "dialogflow.projects.locations.agent.sessions.entityTypes.patch", @@ -4222,7 +4254,7 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of this session entity type. Format:\n`projects//agent/sessions//entityTypes/`, or\n`projects//agent/environments//users//sessions//entityTypes/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.\n\n`` must be the display name of an existing entity\ntype in the same agent that will be overridden or supplemented.", + "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.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/sessions/[^/]+/entityTypes/[^/]+$", "required": true, @@ -4256,7 +4288,7 @@ "operations": { "methods": { "cancel": { - "description": "Starts asynchronous cancellation on a long-running operation. The server\nmakes a best effort to cancel the operation, but success is not\nguaranteed. If the server doesn't support this method, it returns\n`google.rpc.Code.UNIMPLEMENTED`. Clients can use\nOperations.GetOperation or\nother methods to check whether the cancellation succeeded or whether the\noperation completed despite cancellation. On successful cancellation,\nthe operation is not deleted; instead, it becomes an operation with\nan Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.", + "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`.", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", "httpMethod": "POST", "id": "dialogflow.projects.locations.operations.cancel", @@ -4282,7 +4314,7 @@ ] }, "get": { - "description": "Gets the latest state of a long-running operation. Clients can use this\nmethod to poll the operation result at intervals as recommended by the API\nservice.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", "httpMethod": "GET", "id": "dialogflow.projects.locations.operations.get", @@ -4308,7 +4340,7 @@ ] }, "list": { - "description": "Lists operations that match the specified filter in the request. If the\nserver doesn't support this method, it returns `UNIMPLEMENTED`.\n\nNOTE: the `name` binding allows API services to override the binding\nto use different resource name schemes, such as `users/*/operations`. To\noverride the binding, API services can add a binding such as\n`\"/v1/{name=users/*}/operations\"` to their service configuration.\nFor backwards compatibility, the default name includes the operations\ncollection id, however overriding users must ensure the name binding\nis the parent resource, without the operations collection id.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/operations", "httpMethod": "GET", "id": "dialogflow.projects.locations.operations.list", @@ -4356,7 +4388,7 @@ "operations": { "methods": { "cancel": { - "description": "Starts asynchronous cancellation on a long-running operation. The server\nmakes a best effort to cancel the operation, but success is not\nguaranteed. If the server doesn't support this method, it returns\n`google.rpc.Code.UNIMPLEMENTED`. Clients can use\nOperations.GetOperation or\nother methods to check whether the cancellation succeeded or whether the\noperation completed despite cancellation. On successful cancellation,\nthe operation is not deleted; instead, it becomes an operation with\nan Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.", + "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`.", "flatPath": "v2beta1/projects/{projectsId}/operations/{operationsId}:cancel", "httpMethod": "POST", "id": "dialogflow.projects.operations.cancel", @@ -4382,7 +4414,7 @@ ] }, "get": { - "description": "Gets the latest state of a long-running operation. Clients can use this\nmethod to poll the operation result at intervals as recommended by the API\nservice.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/operations/{operationsId}", "httpMethod": "GET", "id": "dialogflow.projects.operations.get", @@ -4408,7 +4440,7 @@ ] }, "list": { - "description": "Lists operations that match the specified filter in the request. If the\nserver doesn't support this method, it returns `UNIMPLEMENTED`.\n\nNOTE: the `name` binding allows API services to override the binding\nto use different resource name schemes, such as `users/*/operations`. To\noverride the binding, API services can add a binding such as\n`\"/v1/{name=users/*}/operations\"` to their service configuration.\nFor backwards compatibility, the default name includes the operations\ncollection id, however overriding users must ensure the name binding\nis the parent resource, without the operations collection id.", + "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.", "flatPath": "v2beta1/projects/{projectsId}/operations", "httpMethod": "GET", "id": "dialogflow.projects.operations.list", @@ -4454,7 +4486,7 @@ } } }, - "revision": "20200719", + "revision": "20200801", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3beta1ExportAgentResponse": { @@ -4467,7 +4499,7 @@ "type": "string" }, "agentUri": { - "description": "The URI to a file containing the exported agent. This field is populated\nonly if `agent_uri` is specified in ExportAgentRequest.", + "description": "The URI to a file containing the exported agent. This field is populated only if `agent_uri` is specified in ExportAgentRequest.", "type": "string" } }, @@ -4478,12 +4510,12 @@ "id": "GoogleCloudDialogflowCxV3beta1PageInfo", "properties": { "currentPage": { - "description": "Always present for WebhookRequest. Ignored for WebhookResponse.\nThe unique identifier of the current page.\nFormat: `projects//locations//agents//flows//pages/`.", + "description": "Always present for WebhookRequest. Ignored for WebhookResponse. The unique identifier of the current page. Format: `projects//locations//agents//flows//pages/`.", "type": "string" }, "formInfo": { "$ref": "GoogleCloudDialogflowCxV3beta1PageInfoFormInfo", - "description": "Optional for both WebhookRequest and WebhookResponse.\nInformation about the form." + "description": "Optional for both WebhookRequest and WebhookResponse. Information about the form." } }, "type": "object" @@ -4493,7 +4525,7 @@ "id": "GoogleCloudDialogflowCxV3beta1PageInfoFormInfo", "properties": { "parameterInfo": { - "description": "Optional for both WebhookRequest and WebhookResponse.\nThe parameters contained in the form. Note that the webhook cannot add\nor remove any form parameter.", + "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": "GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo" }, @@ -4507,19 +4539,19 @@ "id": "GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo", "properties": { "displayName": { - "description": "Always present for WebhookRequest. Required for\nWebhookResponse.\nThe human-readable name of the parameter, unique within the form. This\nfield cannot be modified by the webhook.", + "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.\nIndicates if the parameter value was just collected on the last\nconversation turn.", + "description": "Optional for WebhookRequest. Ignored for WebhookResponse. Indicates if the parameter value was just collected on the last conversation turn.", "type": "boolean" }, "required": { - "description": "Optional for both WebhookRequest and WebhookResponse.\nIndicates whether the parameter is required. Optional parameters will\nnot trigger prompts; however, they are filled if the user specifies\nthem. Required parameters must be filled before form filling concludes.", + "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\nWebhookResponse. The state of the parameter. This field can be set\nto INVALID by\nthe webhook to invalidate the parameter; other values set by the\nwebhook will be ignored.", + "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", @@ -4529,20 +4561,20 @@ "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\nby the webhook to invalidate the parameter and ask the server to\ncollect it from the user again.", + "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" }, "value": { - "description": "Optional for both WebhookRequest and WebhookResponse.\nThe value of the parameter. This field can be set by the webhook to\nchange the parameter 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" } }, "type": "object" }, "GoogleCloudDialogflowCxV3beta1ResponseMessage": { - "description": "Represents a response message that can be returned by a conversational agent.\n\nResponse messages are also used for output audio synthesis. The approach is\nas follows:\n\n* If at least one OutputAudioText response is present, then all\n OutputAudioText responses are linearly concatenated, and the result is used\n for output audio synthesis.\n* If the OutputAudioText responses are a mixture of text and SSML, then the\n concatenated result is treated as SSML; otherwise, the result is treated as\n either text or SSML as appropriate. The agent designer should ideally use\n either text or SSML consistently throughout the bot design.\n* Otherwise, all Text responses are linearly concatenated, and the result is\n used for output audio synthesis.\n\nThis approach allows for more sophisticated user experience scenarios, where\nthe text displayed to the user may differ from what is heard.", + "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", "properties": { "conversationSuccess": { @@ -4551,7 +4583,8 @@ }, "endInteraction": { "$ref": "GoogleCloudDialogflowCxV3beta1ResponseMessageEndInteraction", - "description": "Output only. A signal that indicates the interaction with the Dialogflow agent has\nended.\nThis message is generated by Dialogflow only when the conversation\nreaches `END_SESSION` or `END_PAGE` page. It is not supposed to be\ndefined by the user.\nIt's guaranteed that there is at most one such message in each response." + "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.", + "readOnly": true }, "humanAgentHandoff": { "$ref": "GoogleCloudDialogflowCxV3beta1ResponseMessageHumanAgentHandoff", @@ -4563,11 +4596,12 @@ }, "mixedAudio": { "$ref": "GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudio", - "description": "Output only. An audio response message composed of both the synthesized Dialogflow\nagent responses and responses defined via\nplay_audio.\nThis message is generated by Dialogflow only and not supposed to be\ndefined by the user." + "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.", + "readOnly": true }, "outputAudioText": { "$ref": "GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText", - "description": "A text or ssml response that is preferentially used for TTS output audio\nsynthesis, as described in the comment on the ResponseMessage message." + "description": "A text or ssml response that is preferentially used for TTS output audio synthesis, as described in the comment on the ResponseMessage message." }, "payload": { "additionalProperties": { @@ -4579,7 +4613,7 @@ }, "playAudio": { "$ref": "GoogleCloudDialogflowCxV3beta1ResponseMessagePlayAudio", - "description": "Signal that the client should play an audio clip hosted at a\nclient-specific URI. Dialogflow uses this to construct\nmixed_audio. However, Dialogflow itself\ndoes not try to read or process the URI in any way." + "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." }, "text": { "$ref": "GoogleCloudDialogflowCxV3beta1ResponseMessageText", @@ -4589,7 +4623,7 @@ "type": "object" }, "GoogleCloudDialogflowCxV3beta1ResponseMessageConversationSuccess": { - "description": "Indicates that the conversation succeeded, i.e., the bot handled the issue\nthat the customer talked to it about.\n\nDialogflow only uses this to determine which conversations should be\ncounted as successful and doesn't process the metadata in this message in\nany way. Note that Dialogflow also considers conversations that get to the\nconversation end page as successful even if they don't return\nConversationSuccess.\n\nYou may set this, for example:\n* In the entry_fulfillment of a Page if\n entering the page indicates that the conversation succeeded.\n* In a webhook response when you determine that you handled the customer\n issue.", + "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", "properties": { "metadata": { @@ -4604,13 +4638,13 @@ "type": "object" }, "GoogleCloudDialogflowCxV3beta1ResponseMessageEndInteraction": { - "description": "Indicates that interaction with the Dialogflow agent has ended.\nThis message is generated by Dialogflow only and not supposed to be\ndefined by the user.", + "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", "properties": {}, "type": "object" }, "GoogleCloudDialogflowCxV3beta1ResponseMessageHumanAgentHandoff": { - "description": "Indicates that the conversation should be handed off to a human agent.\n\nDialogflow only uses this to determine which conversations were handed off\nto a human agent for measurement purposes. What else to do with this signal\nis up to you and your handoff procedures.\n\nYou may set this, for example:\n* In the entry_fulfillment of a Page if\n entering the page indicates something went extremely wrong in the\n conversation.\n* In a webhook response when you determine that the customer issue can only\n be handled by a human.", + "description": "Indicates that the conversation should be handed off to a human 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": "GoogleCloudDialogflowCxV3beta1ResponseMessageHumanAgentHandoff", "properties": { "metadata": { @@ -4618,14 +4652,14 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Custom metadata for your handoff procedure. Dialogflow doesn't impose\nany structure on this.", + "description": "Custom metadata for your handoff procedure. Dialogflow doesn't impose any structure on this.", "type": "object" } }, "type": "object" }, "GoogleCloudDialogflowCxV3beta1ResponseMessageLiveAgentHandoff": { - "description": "Indicates that the conversation should be handed off to a live agent.\n\nDialogflow only uses this to determine which conversations were handed off\nto a human agent for measurement purposes. What else to do with this signal\nis up to you and your handoff procedures.\n\nYou may set this, for example:\n* In the entry_fulfillment of a Page if\n entering the page indicates something went extremely wrong in the\n conversation.\n* In a webhook response when you determine that the customer issue can only\n be handled by a human.", + "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": { @@ -4633,14 +4667,14 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Custom metadata for your handoff procedure. Dialogflow doesn't impose\nany structure on this.", + "description": "Custom metadata for your handoff procedure. Dialogflow doesn't impose any structure on this.", "type": "object" } }, "type": "object" }, "GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudio": { - "description": "Represents an audio message that is composed of both segments\nsynthesized from the Dialogflow agent prompts and ones hosted externally\nat the specified URIs.\nThe external URIs are specified via\nplay_audio.\nThis message is generated by Dialogflow only and not supposed to be\ndefined by the user.", + "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.", "id": "GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudio", "properties": { "segments": { @@ -4658,27 +4692,27 @@ "id": "GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudioSegment", "properties": { "allowPlaybackInterruption": { - "description": "Whether the playback of this segment can be interrupted by the end\nuser's speech and the client should then start the next Dialogflow\nrequest.", + "description": "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.", "type": "boolean" }, "audio": { - "description": "Raw audio synthesized from the Dialogflow agent's response using\nthe output config specified in the request.", + "description": "Raw audio synthesized from the Dialogflow agent's response using the output config specified in the request.", "format": "byte", "type": "string" }, "uri": { - "description": "Client-specific URI that points to an audio clip accessible to the\nclient. Dialogflow does not impose any validation on it.", + "description": "Client-specific URI that points to an audio clip accessible to the client. Dialogflow does not impose any validation on it.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText": { - "description": "A text or ssml response that is preferentially used for TTS output audio\nsynthesis, as described in the comment on the ResponseMessage message.", + "description": "A text or ssml response that is preferentially used for TTS output audio synthesis, as described in the comment on the ResponseMessage message.", "id": "GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText", "properties": { "ssml": { - "description": "The SSML text to be synthesized. For more information, see\n[SSML](/speech/text-to-speech/docs/ssml).", + "description": "The SSML text to be synthesized. For more information, see [SSML](/speech/text-to-speech/docs/ssml).", "type": "string" }, "text": { @@ -4693,11 +4727,11 @@ "id": "GoogleCloudDialogflowCxV3beta1ResponseMessagePlayAudio", "properties": { "allowPlaybackInterruption": { - "description": "Whether the playback of this message can be interrupted by the end\nuser's speech and the client can then starts the next Dialogflow\nrequest.", + "description": "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\nvalue. It is specific to the client that reads it.", + "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" } }, @@ -4708,7 +4742,7 @@ "id": "GoogleCloudDialogflowCxV3beta1ResponseMessageText", "properties": { "allowPlaybackInterruption": { - "description": "Whether the playback of this message can be interrupted by the end\nuser's speech and the client can then starts the next Dialogflow\nrequest.", + "description": "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" }, "text": { @@ -4729,11 +4763,11 @@ "additionalProperties": { "type": "any" }, - "description": "Optional for WebhookRequest. Optional for WebhookResponse.\nAll parameters collected from forms and intents during the session.\nParameters can be created, updated, or removed by the webhook. To remove a\nparameter from the session, the webhook should explicitly set the parameter\nvalue to null in WebhookResponse. The map is keyed by parameters'\ndisplay names.", + "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" }, "session": { - "description": "Always present for WebhookRequest. Ignored for WebhookResponse.\nThe unique identifier of the session. This\nfield can be used by the webhook to identify a user.\nFormat: `projects//locations//agents//sessions/`.", + "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" } }, @@ -4744,19 +4778,19 @@ "id": "GoogleCloudDialogflowCxV3beta1WebhookRequest", "properties": { "detectIntentResponseId": { - "description": "Always present. The unique identifier of the DetectIntentResponse that\nwill be returned to the API caller.", + "description": "Always present. The unique identifier of the DetectIntentResponse that will be returned to the API caller.", "type": "string" }, "fulfillmentInfo": { "$ref": "GoogleCloudDialogflowCxV3beta1WebhookRequestFulfillmentInfo", - "description": "Always present. Information about the fulfillment that triggered this\nwebhook call." + "description": "Always present. Information about the fulfillment that triggered this webhook call." }, "intentInfo": { "$ref": "GoogleCloudDialogflowCxV3beta1WebhookRequestIntentInfo", "description": "Information about the last matched intent." }, "messages": { - "description": "The list of rich message responses to present to the user. Webhook can\nchoose to append or replace this list in\nWebhookResponse.fulfillment_response;", + "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" }, @@ -4786,7 +4820,7 @@ "id": "GoogleCloudDialogflowCxV3beta1WebhookRequestFulfillmentInfo", "properties": { "tag": { - "description": "Always present. The tag used to identify which fulfillment is being\ncalled.", + "description": "Always present. The tag used to identify which fulfillment is being called.", "type": "string" } }, @@ -4797,14 +4831,14 @@ "id": "GoogleCloudDialogflowCxV3beta1WebhookRequestIntentInfo", "properties": { "lastMatchedIntent": { - "description": "Always present. The unique identifier of the last matched\nintent. Format: `projects//locations//agents//intents/`.", + "description": "Always present. The unique identifier of the last matched intent. Format: `projects//locations//agents//intents/`.", "type": "string" }, "parameters": { "additionalProperties": { "$ref": "GoogleCloudDialogflowCxV3beta1WebhookRequestIntentInfoIntentParameterValue" }, - "description": "Parameters identified as a result of intent matching. This is a map of\nthe name of the identified parameter to the value of the parameter\nidentified from the user's utterance. All parameters defined in the\nmatched intent that are identified will be surfaced here.", + "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" } }, @@ -4819,7 +4853,7 @@ "type": "string" }, "resolvedValue": { - "description": "Always present. Structured value for the parameter extracted from user\nutterance.", + "description": "Always present. Structured value for the parameter extracted from user utterance.", "type": "any" } }, @@ -4831,11 +4865,11 @@ "properties": { "fulfillmentResponse": { "$ref": "GoogleCloudDialogflowCxV3beta1WebhookResponseFulfillmentResponse", - "description": "The fulfillment response to send to the user. This field can be omitted by\nthe webhook if it does not intend to send any response to the user." + "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." }, "pageInfo": { "$ref": "GoogleCloudDialogflowCxV3beta1PageInfo", - "description": "Information about page status. This field can be omitted by the webhook if\nit does not intend to modify page status." + "description": "Information about page status. This field can be omitted by the webhook if it does not intend to modify page status." }, "payload": { "additionalProperties": { @@ -4847,14 +4881,14 @@ }, "sessionInfo": { "$ref": "GoogleCloudDialogflowCxV3beta1SessionInfo", - "description": "Information about session status. This field can be omitted by the webhook\nif it does not intend to modify session status." + "description": "Information about session status. This field can be omitted by the webhook if it does not intend to modify session status." }, "targetFlow": { - "description": "The target flow to transition to.\nFormat: `projects//locations//agents//flows/`.", + "description": "The target flow to transition to. Format: `projects//locations//agents//flows/`.", "type": "string" }, "targetPage": { - "description": "The target page to transition to.\nFormat: `projects//locations//agents//flows//pages/`.", + "description": "The target page to transition to. Format: `projects//locations//agents//flows//pages/`.", "type": "string" } }, @@ -4873,8 +4907,8 @@ ], "enumDescriptions": [ "Not specified. `APPEND` will be used.", - "`messages` will be appended to the list of messages waiting to be sent\nto the user.", - "`messages` will replace the list of messages waiting to be sent to the\nuser." + "`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": "string" }, @@ -4889,15 +4923,15 @@ "type": "object" }, "GoogleCloudDialogflowV2AnnotatedMessagePart": { - "description": "Represents a part of a message possibly annotated with an entity. The part\ncan be an entity or purely a part of the message between two entities or\nmessage start/end.", + "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", "properties": { "entityType": { - "description": "The [Dialogflow system entity\ntype](https://cloud.google.com/dialogflow/docs/reference/system-entities)\nof this message part. If this is empty, Dialogflow could not annotate the\nphrase part with a system entity.", + "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\n](https://cloud.google.com/dialogflow/docs/reference/system-entities) of\nthis message part. For example for a system entity of type\n`@sys.unit-currency`, this may contain:\n
\n{\n  \"amount\": 5,\n  \"currency\": \"USD\"\n}\n
", + "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": { @@ -4936,16 +4970,16 @@ "type": "object" }, "GoogleCloudDialogflowV2Context": { - "description": "Dialogflow contexts are similar to natural language context. If a person says\nto you \"they are orange\", you need context in order to understand what \"they\"\nis referring to. Similarly, for Dialogflow to handle an end-user expression\nlike that, it needs to be provided with context in order to correctly match\nan intent.\n\nUsing contexts, you can control the flow of a conversation. You can configure\ncontexts for an intent by setting input and output contexts, which are\nidentified by string names. When an intent is matched, any configured output\ncontexts for that intent become active. While any contexts are active,\nDialogflow is more likely to match intents that are configured with input\ncontexts that correspond to the currently active contexts.\n\nFor more information about context, see the\n[Contexts guide](https://cloud.google.com/dialogflow/docs/contexts-overview).", + "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).", "id": "GoogleCloudDialogflowV2Context", "properties": { "lifespanCount": { - "description": "Optional. The number of conversational query requests after which the\ncontext expires. The default is `0`. If set to `0`, the context expires\nimmediately. Contexts expire automatically after 20 minutes if there\nare no matching queries.", + "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", "type": "integer" }, "name": { - "description": "Required. The unique identifier of the context. Format:\n`projects//agent/sessions//contexts/`,\nor `projects//agent/environments//users//sessions//contexts/`.\n\nThe `Context ID` is always converted to lowercase, may only contain\ncharacters in a-zA-Z0-9_-% and may be at most 250 bytes long.\n\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.\n\nThe following context names are reserved for internal use by Dialogflow.\nYou should not use these contexts or create contexts with these names:\n\n* `__system_counters__`\n* `*_id_dialog_context`\n* `*_dialog_params_size`", + "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`", "type": "string" }, "parameters": { @@ -4953,23 +4987,23 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. The collection of parameters associated with this context.\n\nDepending on your protocol or client library language, this is a\nmap, associative array, symbol table, dictionary, or JSON object\ncomposed of a collection of (MapKey, MapValue) pairs:\n\n- MapKey type: string\n- MapKey value: parameter name\n- MapValue type:\n - If parameter's entity type is a composite entity: map\n - Else: string or number, depending on parameter value type\n- MapValue value:\n - If parameter's entity type is a composite entity:\n map from composite entity property names to property values\n - Else: parameter value", + "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", "type": "object" } }, "type": "object" }, "GoogleCloudDialogflowV2ConversationEvent": { - "description": "Represents a notification sent to Pub/Sub subscribers for conversation\nlifecycle events.", + "description": "Represents a notification sent to Pub/Sub subscribers for conversation lifecycle events.", "id": "GoogleCloudDialogflowV2ConversationEvent", "properties": { "conversation": { - "description": "The unique identifier of the conversation this notification\nrefers to.\nFormat: `projects//conversations/`.", + "description": "The unique identifier of the conversation this notification refers to. Format: `projects//conversations/`.", "type": "string" }, "errorStatus": { "$ref": "GoogleRpcStatus", - "description": "More detailed information about an error. Only set for type\nUNRECOVERABLE_ERROR_IN_PHONE_CALL." + "description": "More detailed information about an error. Only set for type UNRECOVERABLE_ERROR_IN_PHONE_CALL." }, "newMessagePayload": { "$ref": "GoogleCloudDialogflowV2Message", @@ -4987,11 +5021,11 @@ ], "enumDescriptions": [ "Type not set.", - "A new conversation has been opened. This is fired when a telephone call\nis answered, or a conversation is created via the API.", - "An existing conversation has closed. This is fired when a telephone call\nis terminated, or a conversation is closed via the API.", - "An existing conversation has received notification from Dialogflow that\nhuman intervention is required.", - "An existing conversation has received a new message, either from API or\ntelephony. It is configured in\nConversationProfile.new_message_event_notification_config", - "Unrecoverable error during a telephone call.\n\nIn general non-recoverable errors only occur if something was\nmisconfigured in the ConversationProfile corresponding to the call. After\na non-recoverable error, Dialogflow may stop responding.\n\nWe don't fire this event:\n\n* in an API call because we can directly return the error, or,\n* when we can recover from an error." + "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." ], "type": "string" } @@ -4999,18 +5033,18 @@ "type": "object" }, "GoogleCloudDialogflowV2EntityType": { - "description": "Each intent parameter has a type, called the entity type, which dictates\nexactly how data from an end-user expression is extracted.\n\nDialogflow provides predefined system entities that can match many common\ntypes of data. For example, there are system entities for matching dates,\ntimes, colors, email addresses, and so on. You can also create your own\ncustom entities for matching custom data. For example, you could define a\nvegetable entity that can match the types of vegetables available for\npurchase with a grocery store agent.\n\nFor more information, see the\n[Entity guide](https://cloud.google.com/dialogflow/docs/entities-overview).", + "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).", "id": "GoogleCloudDialogflowV2EntityType", "properties": { "autoExpansionMode": { - "description": "Optional. Indicates whether the entity type can be automatically\nexpanded.", + "description": "Optional. Indicates whether the entity type can be automatically expanded.", "enum": [ "AUTO_EXPANSION_MODE_UNSPECIFIED", "AUTO_EXPANSION_MODE_DEFAULT" ], "enumDescriptions": [ "Auto expansion disabled for the entity.", - "Allows an agent to recognize values that have not been explicitly\nlisted in the entity." + "Allows an agent to recognize values that have not been explicitly listed in the entity." ], "type": "string" }, @@ -5039,14 +5073,14 @@ ], "enumDescriptions": [ "Not specified. This value should be never used.", - "Map entity types allow mapping of a group of synonyms to a reference\nvalue.", - "List entity types contain a set of entries that do not map to reference\nvalues. However, list entity types can contain references to other entity\ntypes (with or without aliases).", - "Regexp entity types allow to specify regular expressions in entries\nvalues." + "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" }, "name": { - "description": "The unique identifier of the entity type.\nRequired for EntityTypes.UpdateEntityType and\nEntityTypes.BatchUpdateEntityTypes methods.\nFormat: `projects//agent/entityTypes/`.", + "description": "The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`.", "type": "string" } }, @@ -5057,25 +5091,25 @@ "id": "GoogleCloudDialogflowV2EntityTypeEntity", "properties": { "synonyms": { - "description": "Required. A collection of value synonyms. For example, if the entity type\nis *vegetable*, and `value` is *scallions*, a synonym could be *green\nonions*.\n\nFor `KIND_LIST` entity types:\n\n* This collection must contain exactly one synonym equal to `value`.", + "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" }, "value": { - "description": "Required. The primary value associated with this entity entry.\nFor example, if the entity type is *vegetable*, the value could be\n*scallions*.\n\nFor `KIND_MAP` entity types:\n\n* A reference value to be used in place of synonyms.\n\nFor `KIND_LIST` entity types:\n\n* A string that can contain references to other entity types (with or\n without aliases).", + "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" } }, "type": "object" }, "GoogleCloudDialogflowV2EventInput": { - "description": "Events allow for matching intents by event name instead of the natural\nlanguage input. For instance, input `` can trigger a personalized welcome response.\nThe parameter `name` may be used by the agent in the response:\n`\"Hello #welcome_event.name! What can I do for you today?\"`.", + "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?\"`.", "id": "GoogleCloudDialogflowV2EventInput", "properties": { "languageCode": { - "description": "Required. The language of this query. See [Language\nSupport](https://cloud.google.com/dialogflow/docs/reference/language)\nfor a list of the currently supported language codes. Note that queries in\nthe same session do not necessarily need to specify the same language.", + "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": { @@ -5087,7 +5121,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of parameters associated with the event.\n\nDepending on your protocol or client library language, this is a\nmap, associative array, symbol table, dictionary, or JSON object\ncomposed of a collection of (MapKey, MapValue) pairs:\n\n- MapKey type: string\n- MapKey value: parameter name\n- MapValue type:\n - If parameter's entity type is a composite entity: map\n - Else: string or number, depending on parameter value type\n- MapValue value:\n - If parameter's entity type is a composite entity:\n map from composite entity property names to property values\n - Else: parameter value", + "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" } }, @@ -5103,22 +5137,22 @@ "type": "string" }, "agentUri": { - "description": "The URI to a file containing the exported agent. This field is populated\nonly if `agent_uri` is specified in `ExportAgentRequest`.", + "description": "The URI to a file containing the exported agent. This field is populated only if `agent_uri` is specified in `ExportAgentRequest`.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2Intent": { - "description": "An intent categorizes an end-user's intention for one conversation turn. For\neach agent, you define many intents, where your combined intents can handle a\ncomplete conversation. When an end-user writes or says something, referred to\nas an end-user expression or end-user input, Dialogflow matches the end-user\ninput to the best intent in your agent. Matching an intent is also known as\nintent classification.\n\nFor more information, see the [intent\nguide](https://cloud.google.com/dialogflow/docs/intents-overview).", + "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", "properties": { "action": { - "description": "Optional. The name of the action associated with the intent.\nNote: The action name must not contain whitespaces.", + "description": "Optional. The name of the action associated with the intent. Note: The action name must not contain whitespaces.", "type": "string" }, "defaultResponsePlatforms": { - "description": "Optional. The list of platforms for which the first responses will be\ncopied from the messages in PLATFORM_UNSPECIFIED (i.e. default platform).", + "description": "Optional. The list of platforms for which the first responses will be copied from the messages in PLATFORM_UNSPECIFIED (i.e. default platform).", "enumDescriptions": [ "Default platform.", "Facebook.", @@ -5128,7 +5162,7 @@ "Skype.", "Line.", "Viber.", - "Google Assistant\nSee [Dialogflow webhook\nformat](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)", + "Google Assistant See [Dialogflow webhook format](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)", "Google Hangouts." ], "items": { @@ -5144,6 +5178,18 @@ "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." + ], "type": "string" }, "type": "array" @@ -5153,21 +5199,21 @@ "type": "string" }, "events": { - "description": "Optional. The collection of event names that trigger the intent.\nIf the collection of input contexts is not empty, all of the contexts must\nbe present in the active user session for an event to trigger this intent.\nEvent names are limited to 150 characters.", + "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.", "items": { "type": "string" }, "type": "array" }, "followupIntentInfo": { - "description": "Read-only. Information about all followup intents that have this intent as\na direct or indirect parent. We populate this field only in the output.", + "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.", "items": { "$ref": "GoogleCloudDialogflowV2IntentFollowupIntentInfo" }, "type": "array" }, "inputContextNames": { - "description": "Optional. The list of context names required for this intent to be\ntriggered.\nFormat: `projects//agent/sessions/-/contexts/`.", + "description": "Optional. The list of context names required for this intent to be triggered. Format: `projects//agent/sessions/-/contexts/`.", "items": { "type": "string" }, @@ -5178,22 +5224,22 @@ "type": "boolean" }, "messages": { - "description": "Optional. The collection of rich messages corresponding to the\n`Response` field in the Dialogflow console.", + "description": "Optional. The collection of rich messages corresponding to the `Response` field in the Dialogflow console.", "items": { "$ref": "GoogleCloudDialogflowV2IntentMessage" }, "type": "array" }, "mlDisabled": { - "description": "Optional. Indicates whether Machine Learning is disabled for the intent.\nNote: If `ml_disabled` setting is set to true, then this intent is not\ntaken into account during inference in `ML ONLY` match mode. Also,\nauto-markup in the UI is turned off.", + "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" }, "name": { - "description": "Optional. The unique identifier of this intent.\nRequired for Intents.UpdateIntent and Intents.BatchUpdateIntents\nmethods.\nFormat: `projects//agent/intents/`.", + "description": "Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`.", "type": "string" }, "outputContexts": { - "description": "Optional. The collection of contexts that are activated when the intent\nis matched. Context messages in this collection should not set the\nparameters field. Setting the `lifespan_count` to 0 will reset the context\nwhen the intent is matched.\nFormat: `projects//agent/sessions/-/contexts/`.", + "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" }, @@ -5207,24 +5253,24 @@ "type": "array" }, "parentFollowupIntentName": { - "description": "Read-only after creation. The unique identifier of the parent intent in the\nchain of followup intents. You can set this field when creating an intent,\nfor example with CreateIntent or\nBatchUpdateIntents, in order to make this\nintent a followup intent.\n\nIt identifies the parent followup intent.\nFormat: `projects//agent/intents/`.", + "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/`.", "type": "string" }, "priority": { - "description": "Optional. The priority of this intent. Higher numbers represent higher\npriorities.\n\n- If the supplied value is unspecified or 0, the service\n translates the value to 500,000, which corresponds to the\n `Normal` priority in the console.\n- If the supplied value is negative, the intent is ignored\n in runtime detect intent requests.", + "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", "type": "integer" }, "resetContexts": { - "description": "Optional. Indicates whether to delete all contexts in the current\nsession when this intent is matched.", + "description": "Optional. Indicates whether to delete all contexts in the current session when this intent is matched.", "type": "boolean" }, "rootFollowupIntentName": { - "description": "Read-only. The unique identifier of the root intent in the chain of\nfollowup intents. It identifies the correct followup intents chain for\nthis intent. We populate this field only in the output.\n\nFormat: `projects//agent/intents/`.", + "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" }, "trainingPhrases": { - "description": "Optional. The collection of examples that the agent is\ntrained on.", + "description": "Optional. The collection of examples that the agent is trained on.", "items": { "$ref": "GoogleCloudDialogflowV2IntentTrainingPhrase" }, @@ -5240,7 +5286,7 @@ "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\nfilling prompt is forwarded to the webhook." + "Webhook is enabled in the agent and in the intent. Also, each slot filling prompt is forwarded to the webhook." ], "type": "string" } @@ -5252,18 +5298,18 @@ "id": "GoogleCloudDialogflowV2IntentFollowupIntentInfo", "properties": { "followupIntentName": { - "description": "The unique identifier of the followup intent.\nFormat: `projects//agent/intents/`.", + "description": "The unique identifier of the followup intent. Format: `projects//agent/intents/`.", "type": "string" }, "parentFollowupIntentName": { - "description": "The unique identifier of the followup intent's parent.\nFormat: `projects//agent/intents/`.", + "description": "The unique identifier of the followup intent's parent. Format: `projects//agent/intents/`.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2IntentMessage": { - "description": "A rich response message.\nCorresponds to the intent `Response` field in the Dialogflow console.\nFor more information, see\n[Rich response\nmessages](https://cloud.google.com/dialogflow/docs/intents-rich-messages).", + "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).", "id": "GoogleCloudDialogflowV2IntentMessage", "properties": { "basicCard": { @@ -5329,7 +5375,7 @@ "Skype.", "Line.", "Viber.", - "Google Assistant\nSee [Dialogflow webhook\nformat](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)", + "Google Assistant See [Dialogflow webhook format](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)", "Google Hangouts." ], "type": "string" @@ -5414,11 +5460,11 @@ "type": "object" }, "GoogleCloudDialogflowV2IntentMessageBrowseCarouselCard": { - "description": "Browse Carousel Card for Actions on Google.\nhttps://developers.google.com/actions/assistant/responses#browsing_carousel", + "description": "Browse Carousel Card for Actions on Google. https://developers.google.com/actions/assistant/responses#browsing_carousel", "id": "GoogleCloudDialogflowV2IntentMessageBrowseCarouselCard", "properties": { "imageDisplayOptions": { - "description": "Optional. Settings for displaying the image. Applies to every image in\nitems.", + "description": "Optional. Settings for displaying the image. Applies to every image in items.", "enum": [ "IMAGE_DISPLAY_OPTIONS_UNSPECIFIED", "GRAY", @@ -5427,16 +5473,16 @@ "BLURRED_BACKGROUND" ], "enumDescriptions": [ - "Fill the gaps between the image and the image container with gray\nbars.", - "Fill the gaps between the image and the image container with gray\nbars.", - "Fill the gaps between the image and the image container with white\nbars.", - "Image is scaled such that the image width and height match or exceed\nthe container dimensions. This may crop the top and bottom of the\nimage if the scaled image height is greater than the container\nheight, or crop the left and right of the image if the scaled image\nwidth is greater than the container width. This is similar to \"Zoom\nMode\" on a widescreen TV when playing a 4:3 video.", - "Pad the gaps between image and image frame with a blurred copy of the\nsame image." + "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." ], "type": "string" }, "items": { - "description": "Required. List of items in the Browse Carousel Card. Minimum of two\nitems, maximum of ten.", + "description": "Required. List of items in the Browse Carousel Card. Minimum of two items, maximum of ten.", "items": { "$ref": "GoogleCloudDialogflowV2IntentMessageBrowseCarouselCardBrowseCarouselCardItem" }, @@ -5450,11 +5496,11 @@ "id": "GoogleCloudDialogflowV2IntentMessageBrowseCarouselCardBrowseCarouselCardItem", "properties": { "description": { - "description": "Optional. Description of the carousel item. Maximum of four lines of\ntext.", + "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\nCard. Maximum of one line of text.", + "description": "Optional. Text that appears at the bottom of the Browse Carousel Card. Maximum of one line of text.", "type": "string" }, "image": { @@ -5481,7 +5527,7 @@ "type": "string" }, "urlTypeHint": { - "description": "Optional. Specifies the type of viewer that is used when opening\nthe URL. Defaults to opening via web browser.", + "description": "Optional. Specifies the type of viewer that is used when opening the URL. Defaults to opening via web browser.", "enum": [ "URL_TYPE_HINT_UNSPECIFIED", "AMP_ACTION", @@ -5490,7 +5536,7 @@ "enumDescriptions": [ "Unspecified", "Url would be an amp action", - "URL that points directly to AMP content, or to a canonical URL\nwhich refers to AMP content via ." + "URL that points directly to AMP content, or to a canonical URL which refers to AMP content via ." ], "type": "string" } @@ -5528,7 +5574,7 @@ "id": "GoogleCloudDialogflowV2IntentMessageCardButton", "properties": { "postback": { - "description": "Optional. The text to send back to the Dialogflow API or a URI to\nopen.", + "description": "Optional. The text to send back to the Dialogflow API or a URI to open.", "type": "string" }, "text": { @@ -5607,7 +5653,7 @@ "id": "GoogleCloudDialogflowV2IntentMessageImage", "properties": { "accessibilityText": { - "description": "Optional. A text description of the image to be used for accessibility,\ne.g., screen readers.", + "description": "Optional. A text description of the image to be used for accessibility, e.g., screen readers.", "type": "string" }, "imageUri": { @@ -5618,7 +5664,7 @@ "type": "object" }, "GoogleCloudDialogflowV2IntentMessageLinkOutSuggestion": { - "description": "The suggestion chip message that allows the user to jump out to the app\nor website associated with this agent.", + "description": "The suggestion chip message that allows the user to jump out to the app or website associated with this agent.", "id": "GoogleCloudDialogflowV2IntentMessageLinkOutSuggestion", "properties": { "destinationName": { @@ -5626,7 +5672,7 @@ "type": "string" }, "uri": { - "description": "Required. The URI of the app or site to open when the user taps the\nsuggestion chip.", + "description": "Required. The URI of the app or site to open when the user taps the suggestion chip.", "type": "string" } }, @@ -5749,15 +5795,15 @@ "type": "object" }, "GoogleCloudDialogflowV2IntentMessageSelectItemInfo": { - "description": "Additional info about the select item for when it is triggered in a\ndialog.", + "description": "Additional info about the select item for when it is triggered in a dialog.", "id": "GoogleCloudDialogflowV2IntentMessageSelectItemInfo", "properties": { "key": { - "description": "Required. A unique key that will be sent back to the agent if this\nresponse is given.", + "description": "Required. A unique key that will be sent back to the agent if this response is given.", "type": "string" }, "synonyms": { - "description": "Optional. A list of synonyms that can also be used to trigger this\nitem in dialog.", + "description": "Optional. A list of synonyms that can also be used to trigger this item in dialog.", "items": { "type": "string" }, @@ -5775,18 +5821,18 @@ "type": "string" }, "ssml": { - "description": "One of text_to_speech or ssml must be provided. Structured spoken\nresponse to the user in the SSML format. Mutually exclusive with\ntext_to_speech.", + "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\nspeech output. Mutually exclusive with ssml.", + "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" }, "GoogleCloudDialogflowV2IntentMessageSimpleResponses": { - "description": "The collection of simple response candidates.\nThis message in `QueryResult.fulfillment_messages` and\n`WebhookResponse.fulfillment_messages` should contain only one\n`SimpleResponse`.", + "description": "The collection of simple response candidates. This message in `QueryResult.fulfillment_messages` and `WebhookResponse.fulfillment_messages` should contain only one `SimpleResponse`.", "id": "GoogleCloudDialogflowV2IntentMessageSimpleResponses", "properties": { "simpleResponses": { @@ -5800,7 +5846,7 @@ "type": "object" }, "GoogleCloudDialogflowV2IntentMessageSuggestion": { - "description": "The suggestion chip message that the user can tap to quickly post a reply\nto the conversation.", + "description": "The suggestion chip message that the user can tap to quickly post a reply to the conversation.", "id": "GoogleCloudDialogflowV2IntentMessageSuggestion", "properties": { "title": { @@ -5912,7 +5958,7 @@ "id": "GoogleCloudDialogflowV2IntentParameter", "properties": { "defaultValue": { - "description": "Optional. The default value to use when the `value` yields an empty\nresult.\nDefault values can be extracted from contexts by using the following\nsyntax: `#context_name.parameter_name`.", + "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": { @@ -5920,7 +5966,7 @@ "type": "string" }, "entityTypeDisplayName": { - "description": "Optional. The name of the entity type, prefixed with `@`, that\ndescribes values of the parameter. If the parameter is\nrequired, this must be provided.", + "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" }, "isList": { @@ -5928,7 +5974,7 @@ "type": "boolean" }, "mandatory": { - "description": "Optional. Indicates whether the parameter is required. That is,\nwhether the intent cannot be completed without collecting the parameter\nvalue.", + "description": "Optional. Indicates whether the parameter is required. That is, whether the intent cannot be completed without collecting the parameter value.", "type": "boolean" }, "name": { @@ -5936,14 +5982,14 @@ "type": "string" }, "prompts": { - "description": "Optional. The collection of prompts that the agent can present to the\nuser in order to collect a value for the parameter.", + "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" }, "value": { - "description": "Optional. The definition of the parameter value. It can be:\n\n- a constant string,\n- a parameter value defined as `$parameter_name`,\n- an original parameter value defined as `$parameter_name.original`,\n- a parameter value from some context defined as\n `#context_name.parameter_name`.", + "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" } }, @@ -5958,14 +6004,14 @@ "type": "string" }, "parts": { - "description": "Required. The ordered list of training phrase parts.\nThe parts are concatenated in order to form the training phrase.\n\nNote: The API does not automatically annotate training phrases like the\nDialogflow Console does.\n\nNote: Do not forget to include whitespace at part boundaries,\nso the training phrase is well formatted when the parts are concatenated.\n\nIf the training phrase does not need to be annotated with parameters,\nyou just need a single part with only the Part.text field set.\n\nIf you want to annotate the training phrase, you must create multiple\nparts, where the fields of each part are populated in one of two ways:\n\n- `Part.text` is set to a part of the phrase that has no parameters.\n- `Part.text` is set to a part of the phrase that you want to annotate,\n and the `entity_type`, `alias`, and `user_defined` fields are all\n set.", + "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.", "items": { "$ref": "GoogleCloudDialogflowV2IntentTrainingPhrasePart" }, "type": "array" }, "timesAddedCount": { - "description": "Optional. Indicates how many times this example was added to\nthe intent. Each time a developer adds an existing sample by editing an\nintent or training, this counter is increased.", + "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" }, @@ -5978,8 +6024,8 @@ ], "enumDescriptions": [ "Not specified. This value should never be used.", - "Examples do not contain @-prefixed entity type names, but example parts\ncan be annotated with entity types.", - "Templates are not annotated with entity types, but they can contain\n@-prefixed entity type names as substrings.\nTemplate mode has been deprecated. Example mode is the only supported\nway to create new training phrases. If you have existing training\nphrases that you've created in template mode, those will continue to\nwork." + "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" } @@ -5991,11 +6037,11 @@ "id": "GoogleCloudDialogflowV2IntentTrainingPhrasePart", "properties": { "alias": { - "description": "Optional. The parameter name for the value extracted from the\nannotated part of the example.\nThis field is required for annotated parts of the training phrase.", + "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" }, "entityType": { - "description": "Optional. The entity type name prefixed with `@`.\nThis field is required for annotated parts of the training phrase.", + "description": "Optional. The entity type name prefixed with `@`. This field is required for annotated parts of the training phrase.", "type": "string" }, "text": { @@ -6003,7 +6049,7 @@ "type": "string" }, "userDefined": { - "description": "Optional. Indicates whether the text was manually annotated.\nThis field is set to true when the Dialogflow Console is used to\nmanually annotate the part. When creating an annotated part with the\nAPI, you must set this to true.", + "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.", "type": "boolean" } }, @@ -6020,22 +6066,25 @@ "createTime": { "description": "Output only. The time when the message was created.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "languageCode": { - "description": "Optional. The message language.\nThis should be a [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt)\nlanguage tag. Example: \"en-US\".", + "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\".", "type": "string" }, "messageAnnotation": { "$ref": "GoogleCloudDialogflowV2MessageAnnotation", - "description": "Output only. The annotation for the message." + "description": "Output only. The annotation for the message.", + "readOnly": true }, "name": { - "description": "The unique identifier of the message.\nFormat: `projects//conversations//messages/`.", + "description": "The unique identifier of the message. Format: `projects//conversations//messages/`.", "type": "string" }, "participant": { "description": "Output only. The participant that sends this message.", + "readOnly": true, "type": "string" }, "participantRole": { @@ -6050,8 +6099,9 @@ "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\nDialogflow services." + "Participant is an end user that has called or chatted with Dialogflow services." ], + "readOnly": true, "type": "string" } }, @@ -6066,7 +6116,7 @@ "type": "boolean" }, "parts": { - "description": "The collection of annotated message parts ordered by their\nposition in the message. You can recover the annotated message by\nconcatenating [AnnotatedMessagePart.text].", + "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" }, @@ -6076,7 +6126,7 @@ "type": "object" }, "GoogleCloudDialogflowV2OriginalDetectIntentRequest": { - "description": "Represents the contents of the original request that was passed to\nthe `[Streaming]DetectIntent` call.", + "description": "Represents the contents of the original request that was passed to the `[Streaming]DetectIntent` call.", "id": "GoogleCloudDialogflowV2OriginalDetectIntentRequest", "properties": { "payload": { @@ -6084,15 +6134,15 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. This field is set to the value of the `QueryParameters.payload`\nfield passed in the request. Some integrations that query a Dialogflow\nagent may provide additional information in the payload.\n\nIn particular, for the Dialogflow Phone Gateway integration, this field has\nthe form:\n
{\n \"telephony\": {\n   \"caller_id\": \"+18558363987\"\n }\n}
\nNote: The caller ID field (`caller_id`) will be redacted for Standard\nEdition agents and populated with the caller ID in [E.164\nformat](https://en.wikipedia.org/wiki/E.164) for Enterprise Edition agents.", + "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 Standard Edition agents and populated with the caller ID in [E.164 format](https://en.wikipedia.org/wiki/E.164) for Enterprise Edition agents.", "type": "object" }, "source": { - "description": "The source of this request, e.g., `google`, `facebook`, `slack`. It is set\nby Dialogflow-owned servers.", + "description": "The source of this request, e.g., `google`, `facebook`, `slack`. It is set by Dialogflow-owned servers.", "type": "string" }, "version": { - "description": "Optional. The version of the protocol used for this request.\nThis field is AoG-specific.", + "description": "Optional. The version of the protocol used for this request. This field is AoG-specific.", "type": "string" } }, @@ -6107,7 +6157,7 @@ "type": "string" }, "allRequiredParamsPresent": { - "description": "This field is set to:\n\n- `false` if the matched intent has required parameters and not all of\n the required parameter values have been collected.\n- `true` if all required parameter values have been collected, or if the\n matched intent doesn't contain any required parameters.", + "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" }, "diagnosticInfo": { @@ -6115,7 +6165,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Free-form diagnostic information for the associated detect intent request.\nThe fields of this data can change without notice, so you should not write\ncode that depends on its structure.\nThe data may contain:\n\n- webhook call latency\n- webhook errors", + "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", "type": "object" }, "fulfillmentMessages": { @@ -6126,24 +6176,24 @@ "type": "array" }, "fulfillmentText": { - "description": "The text to be pronounced to the user or shown on the screen.\nNote: This is a legacy field, `fulfillment_messages` should be preferred.", + "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" }, "intent": { "$ref": "GoogleCloudDialogflowV2Intent", - "description": "The intent that matched the conversational query. Some, not\nall fields are filled in this message, including but not limited to:\n`name`, `display_name`, `end_interaction` and `is_fallback`." + "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`." }, "intentDetectionConfidence": { - "description": "The intent detection confidence. Values range from 0.0\n(completely uncertain) to 1.0 (completely certain).\nThis value is for informational purpose only and is only used to\nhelp match the best intent within the classification threshold.\nThis value may change for the same end-user expression at any time due to a\nmodel retraining or change in implementation.\nIf there are `multiple knowledge_answers` messages, this value is set to\nthe greatest `knowledgeAnswers.match_confidence` value in the list.", + "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" }, "languageCode": { - "description": "The language that was triggered during intent detection.\nSee [Language\nSupport](https://cloud.google.com/dialogflow/docs/reference/language)\nfor a list of the currently supported language codes.", + "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.", "type": "string" }, "outputContexts": { - "description": "The collection of output contexts. If applicable,\n`output_contexts.parameters` contains entries with name\n`.original` containing the original parameter values\nbefore the query.", + "description": "The collection of output contexts. If applicable, `output_contexts.parameters` contains entries with name `.original` containing the original parameter values before the query.", "items": { "$ref": "GoogleCloudDialogflowV2Context" }, @@ -6154,19 +6204,19 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of extracted parameters.\n\nDepending on your protocol or client library language, this is a\nmap, associative array, symbol table, dictionary, or JSON object\ncomposed of a collection of (MapKey, MapValue) pairs:\n\n- MapKey type: string\n- MapKey value: parameter name\n- MapValue type:\n - If parameter's entity type is a composite entity: map\n - Else: string or number, depending on parameter value type\n- MapValue value:\n - If parameter's entity type is a composite entity:\n map from composite entity property names to property values\n - Else: parameter value", + "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", "type": "object" }, "queryText": { - "description": "The original conversational query text:\n\n- If natural language text was provided as input, `query_text` contains\n a copy of the input.\n- If natural language speech audio was provided as input, `query_text`\n contains the speech recognition result. If speech recognizer produced\n multiple alternatives, a particular one is picked.\n- If automatic spell correction is enabled, `query_text` will contain the\n corrected user input.", + "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" }, "sentimentAnalysisResult": { "$ref": "GoogleCloudDialogflowV2SentimentAnalysisResult", - "description": "The sentiment analysis result, which depends on the\n`sentiment_analysis_request_config` specified in the request." + "description": "The sentiment analysis result, which depends on the `sentiment_analysis_request_config` specified in the request." }, "speechRecognitionConfidence": { - "description": "The Speech recognition confidence between 0.0 and 1.0. A higher number\nindicates an estimated greater likelihood that the recognized words are\ncorrect. The default of 0.0 is a sentinel value indicating that confidence\nwas not set.\n\nThis field is not guaranteed to be accurate or set. In particular this\nfield isn't set for StreamingDetectIntent since the streaming endpoint has\nseparate confidence estimates per portion of the audio in\nStreamingRecognitionResult.", + "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.", "format": "float", "type": "number" }, @@ -6175,27 +6225,27 @@ "description": "Properties of the object.", "type": "any" }, - "description": "If the query was fulfilled by a webhook call, this field is set to the\nvalue of the `payload` field returned in the webhook response.", + "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" }, "webhookSource": { - "description": "If the query was fulfilled by a webhook call, this field is set to the\nvalue of the `source` field returned in the webhook response.", + "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.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2Sentiment": { - "description": "The sentiment, such as positive/negative feeling or association, for a unit\nof analysis, such as the query text.", + "description": "The sentiment, such as positive/negative feeling or association, for a unit of analysis, such as the query text.", "id": "GoogleCloudDialogflowV2Sentiment", "properties": { "magnitude": { - "description": "A non-negative number in the [0, +inf) range, which represents the absolute\nmagnitude of sentiment, regardless of score (positive or negative).", + "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", "type": "number" }, "score": { - "description": "Sentiment score between -1.0 (negative sentiment) and 1.0 (positive\nsentiment).", + "description": "Sentiment score between -1.0 (negative sentiment) and 1.0 (positive sentiment).", "format": "float", "type": "number" } @@ -6203,7 +6253,7 @@ "type": "object" }, "GoogleCloudDialogflowV2SentimentAnalysisResult": { - "description": "The result of sentiment analysis. Sentiment analysis inspects user input\nand identifies the prevailing subjective opinion, especially to determine a\nuser's attitude as positive, negative, or neutral.\nFor Participants.AnalyzeContent, it needs to be configured in\nDetectIntentRequest.query_params. For\nParticipants.StreamingAnalyzeContent, it needs to be configured in\nStreamingDetectIntentRequest.query_params.\nAnd for Participants.AnalyzeContent and\nParticipants.StreamingAnalyzeContent, it needs to be configured in\nConversationProfile.human_agent_assistant_config", + "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.AnalyzeContent, it needs to be configured in DetectIntentRequest.query_params. For Participants.StreamingAnalyzeContent, 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": "GoogleCloudDialogflowV2SentimentAnalysisResult", "properties": { "queryTextSentiment": { @@ -6214,18 +6264,18 @@ "type": "object" }, "GoogleCloudDialogflowV2SessionEntityType": { - "description": "A session represents a conversation between a Dialogflow agent and an\nend-user. You can create special entities, called session entities, during a\nsession. Session entities can extend or replace custom entity types and only\nexist during the session that they were created for. All session data,\nincluding session entities, is stored by Dialogflow for 20 minutes.\n\nFor more information, see the [session entity\nguide](https://cloud.google.com/dialogflow/docs/entities-session).", + "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": "GoogleCloudDialogflowV2SessionEntityType", "properties": { "entities": { - "description": "Required. The collection of entities associated with this session entity\ntype.", + "description": "Required. The collection of entities associated with this session entity type.", "items": { "$ref": "GoogleCloudDialogflowV2EntityTypeEntity" }, "type": "array" }, "entityOverrideMode": { - "description": "Required. Indicates whether the additional data should override or\nsupplement the custom entity type definition.", + "description": "Required. Indicates whether the additional data should override or supplement the custom entity type definition.", "enum": [ "ENTITY_OVERRIDE_MODE_UNSPECIFIED", "ENTITY_OVERRIDE_MODE_OVERRIDE", @@ -6233,13 +6283,13 @@ ], "enumDescriptions": [ "Not specified. This value should be never used.", - "The collection of session entities overrides the collection of entities\nin the corresponding custom entity type.", - "The collection of session entities extends the collection of entities in\nthe corresponding custom entity type.\n\nNote: Even in this override mode calls to `ListSessionEntityTypes`,\n`GetSessionEntityType`, `CreateSessionEntityType` and\n`UpdateSessionEntityType` only return the additional entities added in\nthis session entity type. If you want to get the supplemented list,\nplease call EntityTypes.GetEntityType on the custom entity type\nand merge." + "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" }, "name": { - "description": "Required. The unique identifier of this session entity type. Format:\n`projects//agent/sessions//entityTypes/`, or `projects//agent/environments//users//sessions//entityTypes/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.\n\n`` must be the display name of an existing entity\ntype in the same agent that will be overridden or supplemented.", + "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.", "type": "string" } }, @@ -6251,44 +6301,44 @@ "properties": { "originalDetectIntentRequest": { "$ref": "GoogleCloudDialogflowV2OriginalDetectIntentRequest", - "description": "Optional. The contents of the original request that was passed to\n`[Streaming]DetectIntent` call." + "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\nsame value as `[Streaming]DetectIntentResponse.query_result`." + "description": "The result of the conversational query or event processing. Contains the same value as `[Streaming]DetectIntentResponse.query_result`." }, "responseId": { - "description": "The unique identifier of the response. Contains the same value as\n`[Streaming]DetectIntentResponse.response_id`.", + "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.\nCan be used to identify end-user inside webhook implementation.\nFormat: `projects//agent/sessions/`, or\n`projects//agent/environments//users//sessions/`.", + "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" } }, "type": "object" }, "GoogleCloudDialogflowV2WebhookResponse": { - "description": "The response message for a webhook call.\n\nThis response is validated by the Dialogflow server. If validation fails,\nan error will be returned in the QueryResult.diagnostic_info field.\nSetting JSON fields to an empty value with the wrong type is a common error.\nTo avoid this error:\n\n- Use `\"\"` for empty strings\n- Use `{}` or `null` for empty objects\n- Use `[]` or `null` for empty arrays\n\nFor more information, see the\n[Protocol Buffers Language\nGuide](https://developers.google.com/protocol-buffers/docs/proto3#json).", + "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", "properties": { "followupEventInput": { "$ref": "GoogleCloudDialogflowV2EventInput", - "description": "Optional. Invokes the supplied events.\nWhen this field is set, Dialogflow ignores the `fulfillment_text`,\n`fulfillment_messages`, and `payload` fields." + "description": "Optional. Invokes the supplied events. When this field is set, Dialogflow ignores the `fulfillment_text`, `fulfillment_messages`, and `payload` fields." }, "fulfillmentMessages": { - "description": "Optional. The rich response messages intended for the end-user.\nWhen provided, Dialogflow uses this field to populate\nQueryResult.fulfillment_messages sent to the integration or API caller.", + "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.", "items": { "$ref": "GoogleCloudDialogflowV2IntentMessage" }, "type": "array" }, "fulfillmentText": { - "description": "Optional. The text response message intended for the end-user.\nIt is recommended to use `fulfillment_messages.text.text[0]` instead.\nWhen provided, Dialogflow uses this field to populate\nQueryResult.fulfillment_text sent to the integration or API caller.", + "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.", "type": "string" }, "outputContexts": { - "description": "Optional. The collection of output contexts that will overwrite currently\nactive contexts for the session and reset their lifespans.\nWhen provided, Dialogflow uses this field to populate\nQueryResult.output_contexts sent to the integration or API caller.", + "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" }, @@ -6299,29 +6349,29 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. This field can be used to pass custom data from your webhook to the\nintegration or API caller. Arbitrary JSON objects are supported.\nWhen provided, Dialogflow uses this field to populate\nQueryResult.webhook_payload sent to the integration or API caller.\nThis field is also used by the\n[Google Assistant\nintegration](https://cloud.google.com/dialogflow/docs/integrations/aog)\nfor rich response messages.\nSee the format definition at [Google Assistant Dialogflow webhook\nformat](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)", + "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" }, "sessionEntityTypes": { - "description": "Optional. Additional session entity types to replace or extend developer\nentity types with. The entity synonyms apply to all languages and persist\nfor the session. Setting this data from a webhook overwrites\nthe session entity types that have been set using `detectIntent`,\n`streamingDetectIntent` or SessionEntityType management methods.", + "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": "GoogleCloudDialogflowV2SessionEntityType" }, "type": "array" }, "source": { - "description": "Optional. A custom field used to identify the webhook source.\nArbitrary strings are supported.\nWhen provided, Dialogflow uses this field to populate\nQueryResult.webhook_source sent to the integration or API caller.", + "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" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1Agent": { - "description": "A Dialogflow agent is a virtual agent that handles conversations with your\nend-users. It is a natural language understanding module that understands the\nnuances of human language. Dialogflow translates end-user text or audio\nduring a conversation to structured data that your apps and services can\nunderstand. You design and build a Dialogflow agent to handle the types of\nconversations required for your system.\n\nFor more information about agents, see the\n[Agent guide](https://cloud.google.com/dialogflow/docs/agents-overview).", + "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).", "id": "GoogleCloudDialogflowV2beta1Agent", "properties": { "apiVersion": { - "description": "Optional. API version displayed in Dialogflow console. If not specified,\nV2 API is assumed. Clients are free to query different service endpoints\nfor different API versions. However, bots connectors and webhook calls will\nfollow the specified API version.", + "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.", "enum": [ "API_VERSION_UNSPECIFIED", "API_VERSION_V1", @@ -6337,20 +6387,20 @@ "type": "string" }, "avatarUri": { - "description": "Optional. The URI of the agent's avatar.\nAvatars are used throughout the Dialogflow console and in the self-hosted\n[Web\nDemo](https://cloud.google.com/dialogflow/docs/integrations/web-demo)\nintegration.", + "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" }, "classificationThreshold": { - "description": "Optional. To filter out false positive results and still get variety in\nmatched natural language inputs for your agent, you can tune the machine\nlearning classification threshold. If the returned score value is less than\nthe threshold value, then a fallback intent will be triggered or, if there\nare no fallback intents defined, no intent will be triggered. The score\nvalues range from 0.0 (completely uncertain) to 1.0 (completely certain).\nIf set to 0.0, the default of 0.3 is used.", + "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.", "format": "float", "type": "number" }, "defaultLanguageCode": { - "description": "Required. The default language of the agent as a language tag. See\n[Language\nSupport](https://cloud.google.com/dialogflow/docs/reference/language)\nfor a list of the currently supported language codes. This field cannot be\nset by the `Update` method.", + "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" }, "description": { - "description": "Optional. The description of this agent.\nThe maximum length is 500 characters. If exceeded, the request is rejected.", + "description": "Optional. The description of this agent. The maximum length is 500 characters. If exceeded, the request is rejected.", "type": "string" }, "displayName": { @@ -6370,17 +6420,17 @@ ], "enumDescriptions": [ "Not specified.", - "Best for agents with a small number of examples in intents and/or wide\nuse of templates syntax and composite entities.", - "Can be used for agents with a large number of examples in intents,\nespecially the ones using @sys.any or very large custom entities." + "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." ], "type": "string" }, "parent": { - "description": "Required. The project of this agent.\nFormat: `projects/`.", + "description": "Required. The project of this agent. Format: `projects/`.", "type": "string" }, "supportedLanguageCodes": { - "description": "Optional. The list of all languages supported by this agent (except for the\n`default_language_code`).", + "description": "Optional. The list of all languages supported by this agent (except for the `default_language_code`).", "items": { "type": "string" }, @@ -6403,45 +6453,50 @@ "type": "string" }, "timeZone": { - "description": "Required. The time zone of this agent from the\n[time zone database](https://www.iana.org/time-zones), e.g.,\nAmerica/New_York, Europe/Paris.", + "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.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1AnnotatedConversationDataset": { - "description": "Represents an annotated conversation dataset.\nConversationDataset can have multiple AnnotatedConversationDataset, each of\nthem represents one result from one annotation task.\nAnnotatedConversationDataset can only be generated from annotation task,\nwhich will be triggered by LabelConversation.", + "description": "Represents an annotated conversation dataset. ConversationDataset can have multiple AnnotatedConversationDataset, each of them represents one result from one annotation task. AnnotatedConversationDataset can only be generated from annotation task, which will be triggered by LabelConversation.", "id": "GoogleCloudDialogflowV2beta1AnnotatedConversationDataset", "properties": { "completedExampleCount": { - "description": "Output only. Number of examples that have annotations in the annotated\nconversation dataset.", + "description": "Output only. Number of examples that have annotations in the annotated conversation dataset.", "format": "int64", + "readOnly": true, "type": "string" }, "createTime": { "description": "Output only. Creation time of this annotated conversation dataset.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "description": { - "description": "Optional. The description of the annotated conversation dataset.\nMaximum of 10000 bytes.", + "description": "Optional. The description of the annotated conversation dataset. Maximum of 10000 bytes.", "type": "string" }, "displayName": { - "description": "Required. The display name of the annotated conversation dataset.\nIt's specified when user starts an annotation task. Maximum of 64 bytes.", + "description": "Required. The display name of the annotated conversation dataset. It's specified when user starts an annotation task. Maximum of 64 bytes.", "type": "string" }, "exampleCount": { "description": "Output only. Number of examples in the annotated conversation dataset.", "format": "int64", + "readOnly": true, "type": "string" }, "name": { - "description": "Output only. AnnotatedConversationDataset resource name. Format:\n`projects//conversationDatasets//annotatedConversationDatasets/`", + "description": "Output only. AnnotatedConversationDataset resource name. Format: `projects//conversationDatasets//annotatedConversationDatasets/`", + "readOnly": true, "type": "string" }, "questionTypeName": { - "description": "Output only. Question type name that identifies a labeling task.\nA question is a single task that a worker answers. A question type is set\nof related questions. Each question belongs to a particular question type.\nIt can be used in CrowdCompute UI to filter and manage labeling tasks.", + "description": "Output only. Question type name that identifies a labeling task. A question is a single task that a worker answers. A question type is set of related questions. Each question belongs to a particular question type. It can be used in CrowdCompute UI to filter and manage labeling tasks.", + "readOnly": true, "type": "string" } }, @@ -6481,7 +6536,7 @@ "type": "array" }, "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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" } }, @@ -6492,14 +6547,14 @@ "id": "GoogleCloudDialogflowV2beta1BatchDeleteEntitiesRequest", "properties": { "entityValues": { - "description": "Required. The reference `values` of the entities to delete. Note that\nthese are not fully-qualified names, i.e. they don't start with\n`projects/`.", + "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" }, "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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" } }, @@ -6510,7 +6565,7 @@ "id": "GoogleCloudDialogflowV2beta1BatchDeleteEntityTypesRequest", "properties": { "entityTypeNames": { - "description": "Required. The names entity types to delete. All names must point to the\nsame agent as `parent`.", + "description": "Required. The names entity types to delete. All names must point to the same agent as `parent`.", "items": { "type": "string" }, @@ -6524,7 +6579,7 @@ "id": "GoogleCloudDialogflowV2beta1BatchDeleteIntentsRequest", "properties": { "intents": { - "description": "Required. The collection of intents to delete. Only intent `name` must be\nfilled in.", + "description": "Required. The collection of intents to delete. Only intent `name` must be filled in.", "items": { "$ref": "GoogleCloudDialogflowV2beta1Intent" }, @@ -6545,7 +6600,7 @@ "type": "array" }, "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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": { @@ -6565,11 +6620,11 @@ "description": "The collection of entity types to update or create." }, "entityTypeBatchUri": { - "description": "The URI to a Google Cloud Storage file containing entity types to update\nor create. The file format can either be a serialized proto (of\nEntityBatch type) or a JSON object. Note: The URI must start with\n\"gs://\".", + "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" }, "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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": { @@ -6603,7 +6658,7 @@ "description": "The collection of intents to update or create." }, "intentBatchUri": { - "description": "The URI to a Google Cloud Storage file containing intents to update or\ncreate. The file format can either be a serialized proto (of IntentBatch\ntype) or JSON object. Note: The URI must start with \"gs://\".", + "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://\".", "type": "string" }, "intentView": { @@ -6619,7 +6674,7 @@ "type": "string" }, "languageCode": { - "description": "Optional. The language used to access language-specific data.\nIf not specified, the agent's default language is used.\nFor more information, see\n[Multilingual intent and entity\ndata](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).", + "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": { @@ -6645,16 +6700,16 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1Context": { - "description": "Dialogflow contexts are similar to natural language context. If a person says\nto you \"they are orange\", you need context in order to understand what \"they\"\nis referring to. Similarly, for Dialogflow to handle an end-user expression\nlike that, it needs to be provided with context in order to correctly match\nan intent.\n\nUsing contexts, you can control the flow of a conversation. You can configure\ncontexts for an intent by setting input and output contexts, which are\nidentified by string names. When an intent is matched, any configured output\ncontexts for that intent become active. While any contexts are active,\nDialogflow is more likely to match intents that are configured with input\ncontexts that correspond to the currently active contexts.\n\nFor more information about context, see the\n[Contexts guide](https://cloud.google.com/dialogflow/docs/contexts-overview).", + "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).", "id": "GoogleCloudDialogflowV2beta1Context", "properties": { "lifespanCount": { - "description": "Optional. The number of conversational query requests after which the\ncontext expires. The default is `0`. If set to `0`, the context expires\nimmediately. Contexts expire automatically after 20 minutes if there\nare no matching queries.", + "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", "type": "integer" }, "name": { - "description": "Required. The unique identifier of the context. Format:\n`projects//agent/sessions//contexts/`,\nor `projects//agent/environments//users//sessions//contexts/`.\n\nThe `Context ID` is always converted to lowercase, may only contain\ncharacters in a-zA-Z0-9_-% and may be at most 250 bytes long.\n\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.\n\nThe following context names are reserved for internal use by Dialogflow.\nYou should not use these contexts or create contexts with these names:\n\n* `__system_counters__`\n* `*_id_dialog_context`\n* `*_dialog_params_size`", + "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`", "type": "string" }, "parameters": { @@ -6662,7 +6717,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. The collection of parameters associated with this context.\n\nDepending on your protocol or client library language, this is a\nmap, associative array, symbol table, dictionary, or JSON object\ncomposed of a collection of (MapKey, MapValue) pairs:\n\n- MapKey type: string\n- MapKey value: parameter name\n- MapValue type:\n - If parameter's entity type is a composite entity: map\n - Else: string or number, depending on parameter value type\n- MapValue value:\n - If parameter's entity type is a composite entity:\n map from composite entity property names to property values\n - Else: parameter value", + "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", "type": "object" } }, @@ -6673,22 +6728,22 @@ "id": "GoogleCloudDialogflowV2beta1DetectIntentRequest", "properties": { "inputAudio": { - "description": "The natural language speech audio to be processed. This field\nshould be populated iff `query_input` is set to an input audio config.\nA single request can contain up to 1 minute of speech audio data.", + "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.", "format": "byte", "type": "string" }, "outputAudioConfig": { "$ref": "GoogleCloudDialogflowV2beta1OutputAudioConfig", - "description": "Instructs the speech synthesizer how to generate the output\naudio. If this field is not set and agent-level speech synthesizer is not\nconfigured, no output audio is generated." + "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." }, "outputAudioConfigMask": { - "description": "Mask for output_audio_config indicating which settings in this\nrequest-level config should override speech synthesizer settings defined at\nagent-level.\n\nIf unspecified or empty, output_audio_config replaces the agent-level\nconfig in its entirety.", + "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.", "format": "google-fieldmask", "type": "string" }, "queryInput": { "$ref": "GoogleCloudDialogflowV2beta1QueryInput", - "description": "Required. The input specification. It can be set to:\n\n1. an audio config\n which instructs the speech recognizer how to process the speech audio,\n\n2. a conversational query in the form of text, or\n\n3. an event that specifies which intent to trigger." + "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." }, "queryParams": { "$ref": "GoogleCloudDialogflowV2beta1QueryParameters", @@ -6702,14 +6757,14 @@ "id": "GoogleCloudDialogflowV2beta1DetectIntentResponse", "properties": { "alternativeQueryResults": { - "description": "If Knowledge Connectors are enabled, there could be more than one result\nreturned for a given query or event, and this field will contain all\nresults except for the top one, which is captured in query_result. The\nalternative results are ordered by decreasing\n`QueryResult.intent_detection_confidence`. If Knowledge Connectors are\ndisabled, this field will be empty until multiple responses for regular\nintents are supported, at which point those additional results will be\nsurfaced here.", + "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.", "items": { "$ref": "GoogleCloudDialogflowV2beta1QueryResult" }, "type": "array" }, "outputAudio": { - "description": "The audio data bytes encoded as specified in the request.\nNote: The output audio is generated based on the values of default platform\ntext responses found in the `query_result.fulfillment_messages` field. If\nmultiple default text responses exist, they will be concatenated when\ngenerating audio. If no default platform text responses exist, the\ngenerated audio content will be empty.\n\nIn some scenarios, multiple output audio fields may be present in the\nresponse structure. In these cases, only the top-most-level audio output\nhas content.", + "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", "type": "string" }, @@ -6719,10 +6774,10 @@ }, "queryResult": { "$ref": "GoogleCloudDialogflowV2beta1QueryResult", - "description": "The selected results of the conversational query or event processing.\nSee `alternative_query_results` for additional potential results." + "description": "The selected results of the conversational query or event processing. See `alternative_query_results` for additional potential results." }, "responseId": { - "description": "The unique identifier of the response. It can be used to\nlocate a response in the training example set or for reporting issues.", + "description": "The unique identifier of the response. It can be used to locate a response in the training example set or for reporting issues.", "type": "string" }, "webhookStatus": { @@ -6733,31 +6788,31 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1Document": { - "description": "A knowledge document to be used by a KnowledgeBase.\n\nFor more information, see the [knowledge base\nguide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases).\n\nNote: The `projects.agent.knowledgeBases.documents` resource is deprecated;\nonly use `projects.knowledgeBases.documents`.", + "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", "properties": { "content": { - "description": "The raw content of the document. This field is only permitted for\nEXTRACTIVE_QA and FAQ knowledge types.\nNote: This field is in the process of being deprecated, please use\nraw_content instead.", + "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" }, "contentUri": { - "description": "The URI where the file content is located.\n\nFor documents stored in Google Cloud Storage, these URIs must have\nthe form `gs:///`.\n\nNOTE: External URLs must correspond to public webpages, i.e., they must\nbe indexed by Google Search. In particular, URLs for showing documents in\nGoogle Cloud Storage (i.e. the URL in your browser) are not supported.\nInstead use the `gs://` format URI described above.", + "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" }, "displayName": { - "description": "Required. The display name of the document. The name must be 1024 bytes or\nless; otherwise, the creation request fails.", + "description": "Required. The display name of the document. The name must be 1024 bytes or less; otherwise, the creation request fails.", "type": "string" }, "enableAutoReload": { - "description": "Optional. If true, we try to automatically reload the document every day\n(at a time picked by the system). If false or unspecified, we don't try\nto automatically reload the document.\n\nCurrently you can only enable automatic reload for documents sourced from\na public url, see `source` field for the source types.\n\nReload status can be tracked in `latest_reload_status`. If a reload\nfails, we will keep the document unchanged.\n\nIf a reload fails with internal errors, the system will try to reload the\ndocument on the next day.\nIf a reload fails with non-retriable errors (e.g. PERMISION_DENIED), the\nsystem will not try to reload the document anymore. You need to manually\nreload the document successfully by calling `ReloadDocument` and clear the\nerrors.", + "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.", "type": "boolean" }, "knowledgeTypes": { "description": "Required. The knowledge type of document content.", "enumDescriptions": [ "The type is unspecified or arbitrary.", - "The document content contains question and answer pairs as either HTML or\nCSV. Typical FAQ HTML formats are parsed accurately, but unusual formats\nmay fail to be parsed.\n\nCSV must have questions in the first column and answers in the second,\nwith no header. Because of this explicit format, they are always parsed\naccurately.", - "Documents for which unstructured text is extracted and used for\nquestion answering." + "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." ], "items": { "enum": [ @@ -6765,24 +6820,30 @@ "FAQ", "EXTRACTIVE_QA" ], + "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." + ], "type": "string" }, "type": "array" }, "latestReloadStatus": { "$ref": "GoogleCloudDialogflowV2beta1DocumentReloadStatus", - "description": "Output only. The time and status of the latest reload.\nThis reload may have been triggered automatically or manually\nand may not have succeeded." + "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.", + "readOnly": true }, "mimeType": { "description": "Required. The MIME type of this document.", "type": "string" }, "name": { - "description": "Optional. The document resource name.\nThe name must be empty when creating a document.\nFormat: `projects//knowledgeBases//documents/`.", + "description": "Optional. The document resource name. The name must be empty when creating a document. Format: `projects//knowledgeBases//documents/`.", "type": "string" }, "rawContent": { - "description": "The raw content of the document. This field is only permitted for\nEXTRACTIVE_QA and FAQ knowledge types.", + "description": "The raw content of the document. This field is only permitted for EXTRACTIVE_QA and FAQ knowledge types.", "format": "byte", "type": "string" } @@ -6798,7 +6859,7 @@ "description": "Output only. The status of a reload attempt or the initial load." }, "time": { - "description": "Output only. The time of a reload attempt.\nThis reload may have been triggered automatically or manually and may\nnot have succeeded.", + "description": "Output only. The time of a reload attempt. This reload may have been triggered automatically or manually and may not have succeeded.", "format": "google-datetime", "type": "string" } @@ -6806,18 +6867,18 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1EntityType": { - "description": "Each intent parameter has a type, called the entity type, which dictates\nexactly how data from an end-user expression is extracted.\n\nDialogflow provides predefined system entities that can match many common\ntypes of data. For example, there are system entities for matching dates,\ntimes, colors, email addresses, and so on. You can also create your own\ncustom entities for matching custom data. For example, you could define a\nvegetable entity that can match the types of vegetables available for\npurchase with a grocery store agent.\n\nFor more information, see the\n[Entity guide](https://cloud.google.com/dialogflow/docs/entities-overview).", + "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).", "id": "GoogleCloudDialogflowV2beta1EntityType", "properties": { "autoExpansionMode": { - "description": "Optional. Indicates whether the entity type can be automatically\nexpanded.", + "description": "Optional. Indicates whether the entity type can be automatically expanded.", "enum": [ "AUTO_EXPANSION_MODE_UNSPECIFIED", "AUTO_EXPANSION_MODE_DEFAULT" ], "enumDescriptions": [ "Auto expansion disabled for the entity.", - "Allows an agent to recognize values that have not been explicitly\nlisted in the entity." + "Allows an agent to recognize values that have not been explicitly listed in the entity." ], "type": "string" }, @@ -6846,14 +6907,14 @@ ], "enumDescriptions": [ "Not specified. This value should be never used.", - "Map entity types allow mapping of a group of synonyms to a reference\nvalue.", - "List entity types contain a set of entries that do not map to reference\nvalues. However, list entity types can contain references to other entity\ntypes (with or without aliases).", - "Regexp entity types allow to specify regular expressions in entries\nvalues." + "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" }, "name": { - "description": "The unique identifier of the entity type.\nRequired for EntityTypes.UpdateEntityType and\nEntityTypes.BatchUpdateEntityTypes methods.\nFormat: `projects//agent/entityTypes/`.", + "description": "The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`.", "type": "string" } }, @@ -6878,37 +6939,38 @@ "id": "GoogleCloudDialogflowV2beta1EntityTypeEntity", "properties": { "synonyms": { - "description": "Required. A collection of value synonyms. For example, if the entity type\nis *vegetable*, and `value` is *scallions*, a synonym could be *green\nonions*.\n\nFor `KIND_LIST` entity types:\n\n* This collection must contain exactly one synonym equal to `value`.", + "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" }, "value": { - "description": "Required. The primary value associated with this entity entry.\nFor example, if the entity type is *vegetable*, the value could be\n*scallions*.\n\nFor `KIND_MAP` entity types:\n\n* A reference value to be used in place of synonyms.\n\nFor `KIND_LIST` entity types:\n\n* A string that can contain references to other entity types (with or\n without aliases).", + "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" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1Environment": { - "description": "You can create multiple versions of your agent and publish them to separate\nenvironments.\n\nWhen you edit an agent, you are editing the draft agent. At any point, you\ncan save the draft agent as an agent version, which is an immutable snapshot\nof your agent.\n\nWhen you save the draft agent, it is published to the default environment.\nWhen you create agent versions, you can publish them to custom environments.\nYou can create a variety of custom environments for:\n\n- testing\n- development\n- production\n- etc.\n\nFor more information, see the [versions and environments\nguide](https://cloud.google.com/dialogflow/docs/agents-versions).", + "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).", "id": "GoogleCloudDialogflowV2beta1Environment", "properties": { "agentVersion": { - "description": "Optional. The agent version loaded into this environment.\nFormat: `projects//agent/versions/`.", + "description": "Optional. The agent version loaded into this environment. Format: `projects//agent/versions/`.", "type": "string" }, "description": { - "description": "Optional. The developer-provided description for this environment.\nThe maximum length is 500 characters. If exceeded, the request is rejected.", + "description": "Optional. The developer-provided description for this environment. The maximum length is 500 characters. If exceeded, the request is rejected.", "type": "string" }, "name": { - "description": "Output only. The unique identifier of this agent environment.\nFormat:\n- `projects//agent/environments/`\n- `projects//locations//agent/environments/`", + "description": "Output only. The unique identifier of this agent environment. Format: - `projects//agent/environments/` - `projects//locations//agent/environments/`", + "readOnly": true, "type": "string" }, "state": { - "description": "Output only. The state of this environment. This field is read-only, i.e., it cannot be\nset by create and update methods.", + "description": "Output only. The state of this environment. This field is read-only, i.e., it cannot be set by create and update methods.", "enum": [ "STATE_UNSPECIFIED", "STOPPED", @@ -6921,22 +6983,24 @@ "Loading.", "Running." ], + "readOnly": true, "type": "string" }, "updateTime": { - "description": "Output only. The last update time of this environment. This field is read-only, i.e., it\ncannot be set by create and update methods.", + "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.", "format": "google-datetime", + "readOnly": true, "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1EventInput": { - "description": "Events allow for matching intents by event name instead of the natural\nlanguage input. For instance, input `` can trigger a personalized welcome response.\nThe parameter `name` may be used by the agent in the response:\n`\"Hello #welcome_event.name! What can I do for you today?\"`.", + "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?\"`.", "id": "GoogleCloudDialogflowV2beta1EventInput", "properties": { "languageCode": { - "description": "Required. The language of this query. See [Language\nSupport](https://cloud.google.com/dialogflow/docs/reference/language)\nfor a list of the currently supported language codes. Note that queries in\nthe same session do not necessarily need to specify the same language.", + "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": { @@ -6948,7 +7012,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of parameters associated with the event.\n\nDepending on your protocol or client library language, this is a\nmap, associative array, symbol table, dictionary, or JSON object\ncomposed of a collection of (MapKey, MapValue) pairs:\n\n- MapKey type: string\n- MapKey value: parameter name\n- MapValue type:\n - If parameter's entity type is a composite entity: map\n - Else: string or number, depending on parameter value type\n- MapValue value:\n - If parameter's entity type is a composite entity:\n map from composite entity property names to property values\n - Else: parameter value", + "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" } }, @@ -6959,7 +7023,7 @@ "id": "GoogleCloudDialogflowV2beta1ExportAgentRequest", "properties": { "agentUri": { - "description": "Optional. The\n[Google Cloud Storage](https://cloud.google.com/storage/docs/)\nURI to export the agent to.\nThe format of this URI must be `gs:///`.\nIf left unspecified, the serialized agent is returned inline.", + "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.", "type": "string" } }, @@ -6975,14 +7039,14 @@ "type": "string" }, "agentUri": { - "description": "The URI to a file containing the exported agent. This field is populated\nonly if `agent_uri` is specified in `ExportAgentRequest`.", + "description": "The URI to a file containing the exported agent. This field is populated only if `agent_uri` is specified in `ExportAgentRequest`.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1Fulfillment": { - "description": "By default, your agent responds to a matched intent with a static response.\nAs an alternative, you can provide a more dynamic response by using\nfulfillment. When you enable fulfillment for an intent, Dialogflow responds\nto that intent by calling a service that you define. For example, if an\nend-user wants to schedule a haircut on Friday, your service can check your\ndatabase and respond to the end-user with availability information for\nFriday.\n\nFor more information, see the [fulfillment\nguide](https://cloud.google.com/dialogflow/docs/fulfillment-overview).", + "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).", "id": "GoogleCloudDialogflowV2beta1Fulfillment", "properties": { "displayName": { @@ -7005,7 +7069,7 @@ "description": "Configuration for a generic web service." }, "name": { - "description": "Required. The unique identifier of the fulfillment.\nFormat: `projects//agent/fulfillment`.", + "description": "Required. The unique identifier of the fulfillment. Format: `projects//agent/fulfillment`.", "type": "string" } }, @@ -7031,11 +7095,11 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1FulfillmentGenericWebService": { - "description": "Represents configuration for a generic web service.\nDialogflow supports two mechanisms for authentications:\n- Basic authentication with username and password.\n- Authentication with additional authentication headers.\nMore information could be found at:\nhttps://cloud.google.com/dialogflow/docs/fulfillment-configure.", + "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", "properties": { "isCloudFunction": { - "description": "Optional. Indicates if generic web service is created through Cloud Functions\nintegration. Defaults to false.", + "description": "Optional. Indicates if generic web service is created through Cloud Functions integration. Defaults to false.", "type": "boolean" }, "password": { @@ -7050,7 +7114,7 @@ "type": "object" }, "uri": { - "description": "Required. The fulfillment URI for receiving POST requests.\nIt must use https protocol.", + "description": "Required. The fulfillment URI for receiving POST requests. It must use https protocol.", "type": "string" }, "username": { @@ -7065,7 +7129,7 @@ "id": "GoogleCloudDialogflowV2beta1GcsSource", "properties": { "uri": { - "description": "Required. The Google Cloud Storage URIs for the inputs. A URI is of the\nform:\n gs://bucket/object-prefix-or-name\nWhether a prefix or name is used depends on the use case.", + "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.", "type": "string" } }, @@ -7081,7 +7145,7 @@ "type": "string" }, "agentUri": { - "description": "The URI to a Google Cloud Storage file containing the agent to import.\nNote: The URI must start with \"gs://\".", + "description": "The URI to a Google Cloud Storage file containing the agent to import. Note: The URI must start with \"gs://\".", "type": "string" } }, @@ -7106,25 +7170,25 @@ "enumDescriptions": [ "Not specified.", "Uncompressed 16-bit signed little-endian samples (Linear PCM).", - "[`FLAC`](https://xiph.org/flac/documentation.html) (Free Lossless Audio\nCodec) is the recommended encoding because it is lossless (therefore\nrecognition is not compromised) and requires only about half the\nbandwidth of `LINEAR16`. `FLAC` stream encoding supports 16-bit and\n24-bit samples, however, not all fields in `STREAMINFO` are supported.", + "[`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\n([OggOpus](https://wiki.xiph.org/OggOpus)).\n`sample_rate_hertz` must be 16000.", - "Although the use of lossy encodings is not recommended, if a very low\nbitrate encoding is required, `OGG_OPUS` is highly preferred over\nSpeex encoding. The [Speex](https://speex.org/) encoding supported by\nDialogflow API has a header byte in each block, as in MIME type\n`audio/x-speex-with-header-byte`.\nIt is a variant of the RTP Speex encoding defined in\n[RFC 5574](https://tools.ietf.org/html/rfc5574).\nThe stream is a sequence of blocks, one block per RTP packet. Each block\nstarts with a byte containing the length of the block, in bytes, followed\nby one or more frames of Speex data, padded to an integral number of\nbytes (octets) as specified in RFC 5574. In other words, each RTP header\nis replaced with a single byte containing the block length. Only Speex\nwideband is supported. `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." ], "type": "string" }, "enableWordInfo": { - "description": "If `true`, Dialogflow returns SpeechWordInfo in\nStreamingRecognitionResult with information about the recognized speech\nwords, e.g. start and end time offsets. If false or unspecified, Speech\ndoesn't return any word-level information.", + "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" }, "languageCode": { - "description": "Required. The language of the supplied audio. Dialogflow does not do\ntranslations. See [Language\nSupport](https://cloud.google.com/dialogflow/docs/reference/language)\nfor a list of the currently supported language codes. Note that queries in\nthe same session do not necessarily need to specify the same language.", + "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.", "type": "string" }, "model": { - "description": "Which Speech model to select for the given request. Select the\nmodel best suited to your domain to get best results. If a model is not\nexplicitly specified, then we auto-select a model based on the parameters\nin the InputAudioConfig.\nIf enhanced speech model is enabled for the agent and an enhanced\nversion of the specified model for the language does not exist, then the\nspeech is recognized using the standard version of the specified model.\nRefer to\n[Cloud Speech API\ndocumentation](https://cloud.google.com/speech-to-text/docs/basics#select-model)\nfor more details.", + "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" }, "modelVariant": { @@ -7136,31 +7200,31 @@ "USE_ENHANCED" ], "enumDescriptions": [ - "No model variant specified. In this case Dialogflow defaults to\nUSE_BEST_AVAILABLE.", - "Use the best available variant of the Speech\nmodel that the caller is eligible for.\n\nPlease see the [Dialogflow\ndocs](https://cloud.google.com/dialogflow/docs/data-logging) for\nhow to make your project eligible for enhanced models.", - "Use standard model variant even if an enhanced model is available. See the\n[Cloud Speech\ndocumentation](https://cloud.google.com/speech-to-text/docs/enhanced-models)\nfor details about enhanced models.", - "Use an enhanced model variant:\n\n* If an enhanced variant does not exist for the given\n model and request language, Dialogflow falls\n back to the standard variant.\n\n The [Cloud Speech\n documentation](https://cloud.google.com/speech-to-text/docs/enhanced-models)\n describes which models have enhanced variants.\n\n* If the API caller isn't eligible for enhanced models, Dialogflow returns\n an error. Please see the [Dialogflow\n docs](https://cloud.google.com/dialogflow/docs/data-logging)\n for how to make your project eligible." + "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" }, "phraseHints": { - "description": "A list of strings containing words and phrases that the speech\nrecognizer should recognize with higher likelihood.\n\nSee [the Cloud Speech\ndocumentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-hints)\nfor more details.\n\nThis field is deprecated. Please use [speech_contexts]() instead. If you\nspecify both [phrase_hints]() and [speech_contexts](), Dialogflow will\ntreat the [phrase_hints]() as a single additional [SpeechContext]().", + "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]().", "items": { "type": "string" }, "type": "array" }, "sampleRateHertz": { - "description": "Required. Sample rate (in Hertz) of the audio content sent in the query.\nRefer to\n[Cloud Speech API\ndocumentation](https://cloud.google.com/speech-to-text/docs/basics) for\nmore details.", + "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.", "format": "int32", "type": "integer" }, "singleUtterance": { - "description": "If `false` (default), recognition does not cease until the\nclient closes the stream.\nIf `true`, the recognizer will detect a single spoken utterance in input\naudio. Recognition ceases when it detects the audio's voice has\nstopped or paused. In this case, once a detected intent is received, the\nclient should close the stream and start a new request with a new stream as\nneeded.\nNote: This setting is relevant only for streaming methods.\nNote: When specified, InputAudioConfig.single_utterance takes precedence\nover StreamingDetectIntentRequest.single_utterance.", + "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" }, "speechContexts": { - "description": "Context information to assist speech recognition.\n\nSee [the Cloud Speech\ndocumentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-hints)\nfor more details.", + "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.", "items": { "$ref": "GoogleCloudDialogflowV2beta1SpeechContext" }, @@ -7170,15 +7234,15 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1Intent": { - "description": "An intent categorizes an end-user's intention for one conversation turn. For\neach agent, you define many intents, where your combined intents can handle a\ncomplete conversation. When an end-user writes or says something, referred to\nas an end-user expression or end-user input, Dialogflow matches the end-user\ninput to the best intent in your agent. Matching an intent is also known as\nintent classification.\n\nFor more information, see the [intent\nguide](https://cloud.google.com/dialogflow/docs/intents-overview).", + "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": "GoogleCloudDialogflowV2beta1Intent", "properties": { "action": { - "description": "Optional. The name of the action associated with the intent.\nNote: The action name must not contain whitespaces.", + "description": "Optional. The name of the action associated with the intent. Note: The action name must not contain whitespaces.", "type": "string" }, "defaultResponsePlatforms": { - "description": "Optional. The list of platforms for which the first responses will be\ncopied from the messages in PLATFORM_UNSPECIFIED (i.e. default platform).", + "description": "Optional. The list of platforms for which the first responses will be copied from the messages in PLATFORM_UNSPECIFIED (i.e. default platform).", "enumDescriptions": [ "Not specified.", "Facebook.", @@ -7188,7 +7252,7 @@ "Skype.", "Line.", "Viber.", - "Google Assistant\nSee [Dialogflow webhook\nformat](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)", + "Google Assistant See [Dialogflow webhook format](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)", "Telephony Gateway.", "Google Hangouts." ], @@ -7206,6 +7270,19 @@ "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." + ], "type": "string" }, "type": "array" @@ -7215,25 +7292,26 @@ "type": "string" }, "endInteraction": { - "description": "Optional. Indicates that this intent ends an interaction. Some integrations\n(e.g., Actions on Google or Dialogflow phone gateway) use this information\nto close interaction with an end user. Default is false.", + "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" }, "events": { - "description": "Optional. The collection of event names that trigger the intent.\nIf the collection of input contexts is not empty, all of the contexts must\nbe present in the active user session for an event to trigger this intent.\nEvent names are limited to 150 characters.", + "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.", "items": { "type": "string" }, "type": "array" }, "followupIntentInfo": { - "description": "Output only. Information about all followup intents that have this intent as\na direct or indirect parent. We populate this field only in the output.", + "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" }, + "readOnly": true, "type": "array" }, "inputContextNames": { - "description": "Optional. The list of context names required for this intent to be\ntriggered.\nFormat: `projects//agent/sessions/-/contexts/`.", + "description": "Optional. The list of context names required for this intent to be triggered. Format: `projects//agent/sessions/-/contexts/`.", "items": { "type": "string" }, @@ -7244,26 +7322,26 @@ "type": "boolean" }, "messages": { - "description": "Optional. The collection of rich messages corresponding to the\n`Response` field in the Dialogflow console.", + "description": "Optional. The collection of rich messages corresponding to the `Response` field in the Dialogflow console.", "items": { "$ref": "GoogleCloudDialogflowV2beta1IntentMessage" }, "type": "array" }, "mlDisabled": { - "description": "Optional. Indicates whether Machine Learning is disabled for the intent.\nNote: If `ml_disabled` setting is set to true, then this intent is not\ntaken into account during inference in `ML ONLY` match mode. Also,\nauto-markup in the UI is turned off.", + "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" }, "mlEnabled": { - "description": "Optional. Indicates whether Machine Learning is enabled for the intent.\nNote: If `ml_enabled` setting is set to false, then this intent is not\ntaken into account during inference in `ML ONLY` match mode. Also,\nauto-markup in the UI is turned off.\nDEPRECATED! Please use `ml_disabled` field instead.\nNOTE: If both `ml_enabled` and `ml_disabled` are either not set or false,\nthen the default value is determined as follows:\n- Before April 15th, 2018 the default is:\n ml_enabled = false / ml_disabled = true.\n- After April 15th, 2018 the default is:\n ml_enabled = true / ml_disabled = false.", + "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" }, "name": { - "description": "Optional. The unique identifier of this intent.\nRequired for Intents.UpdateIntent and Intents.BatchUpdateIntents\nmethods.\nFormat: `projects//agent/intents/`.", + "description": "Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`.", "type": "string" }, "outputContexts": { - "description": "Optional. The collection of contexts that are activated when the intent\nis matched. Context messages in this collection should not set the\nparameters field. Setting the `lifespan_count` to 0 will reset the context\nwhen the intent is matched.\nFormat: `projects//agent/sessions/-/contexts/`.", + "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": "GoogleCloudDialogflowV2beta1Context" }, @@ -7277,24 +7355,25 @@ "type": "array" }, "parentFollowupIntentName": { - "description": "Optional. The unique identifier of the parent intent in the\nchain of followup intents. You can set this field when creating an intent,\nfor example with CreateIntent or\nBatchUpdateIntents, in order to make this\nintent a followup intent.\n\nIt identifies the parent followup intent.\nFormat: `projects//agent/intents/`.", + "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/`.", "type": "string" }, "priority": { - "description": "Optional. The priority of this intent. Higher numbers represent higher\npriorities.\n\n- If the supplied value is unspecified or 0, the service\n translates the value to 500,000, which corresponds to the\n `Normal` priority in the console.\n- If the supplied value is negative, the intent is ignored\n in runtime detect intent requests.", + "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", "type": "integer" }, "resetContexts": { - "description": "Optional. Indicates whether to delete all contexts in the current\nsession when this intent is matched.", + "description": "Optional. Indicates whether to delete all contexts in the current session when this intent is matched.", "type": "boolean" }, "rootFollowupIntentName": { - "description": "Output only. The unique identifier of the root intent in the chain of\nfollowup intents. It identifies the correct followup intents chain for\nthis intent.\n\nFormat: `projects//agent/intents/`.", + "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/`.", + "readOnly": true, "type": "string" }, "trainingPhrases": { - "description": "Optional. The collection of examples that the agent is\ntrained on.", + "description": "Optional. The collection of examples that the agent is trained on.", "items": { "$ref": "GoogleCloudDialogflowV2beta1IntentTrainingPhrase" }, @@ -7310,7 +7389,7 @@ "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\nfilling prompt is forwarded to the webhook." + "Webhook is enabled in the agent and in the intent. Also, each slot filling prompt is forwarded to the webhook." ], "type": "string" } @@ -7336,11 +7415,11 @@ "id": "GoogleCloudDialogflowV2beta1IntentFollowupIntentInfo", "properties": { "followupIntentName": { - "description": "The unique identifier of the followup intent.\nFormat: `projects//agent/intents/`.", + "description": "The unique identifier of the followup intent. Format: `projects//agent/intents/`.", "type": "string" }, "parentFollowupIntentName": { - "description": "The unique identifier of the followup intent's parent.\nFormat: `projects//agent/intents/`.", + "description": "The unique identifier of the followup intent's parent. Format: `projects//agent/intents/`.", "type": "string" } }, @@ -7414,7 +7493,7 @@ "Skype.", "Line.", "Viber.", - "Google Assistant\nSee [Dialogflow webhook\nformat](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)", + "Google Assistant See [Dialogflow webhook format](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)", "Telephony Gateway.", "Google Hangouts." ], @@ -7434,7 +7513,7 @@ }, "rbmText": { "$ref": "GoogleCloudDialogflowV2beta1IntentMessageRbmText", - "description": "Rich Business Messaging (RBM) text response.\n\nRBM allows businesses to send enriched and branded versions of SMS. See\nhttps://jibe.google.com/business-messaging." + "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." }, "simpleResponses": { "$ref": "GoogleCloudDialogflowV2beta1IntentMessageSimpleResponses", @@ -7524,11 +7603,11 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCard": { - "description": "Browse Carousel Card for Actions on Google.\nhttps://developers.google.com/actions/assistant/responses#browsing_carousel", + "description": "Browse Carousel Card for Actions on Google. https://developers.google.com/actions/assistant/responses#browsing_carousel", "id": "GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCard", "properties": { "imageDisplayOptions": { - "description": "Optional. Settings for displaying the image. Applies to every image in\nitems.", + "description": "Optional. Settings for displaying the image. Applies to every image in items.", "enum": [ "IMAGE_DISPLAY_OPTIONS_UNSPECIFIED", "GRAY", @@ -7537,16 +7616,16 @@ "BLURRED_BACKGROUND" ], "enumDescriptions": [ - "Fill the gaps between the image and the image container with gray\nbars.", - "Fill the gaps between the image and the image container with gray\nbars.", - "Fill the gaps between the image and the image container with white\nbars.", - "Image is scaled such that the image width and height match or exceed\nthe container dimensions. This may crop the top and bottom of the\nimage if the scaled image height is greater than the container\nheight, or crop the left and right of the image if the scaled image\nwidth is greater than the container width. This is similar to \"Zoom\nMode\" on a widescreen TV when playing a 4:3 video.", - "Pad the gaps between image and image frame with a blurred copy of the\nsame image." + "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." ], "type": "string" }, "items": { - "description": "Required. List of items in the Browse Carousel Card. Minimum of two\nitems, maximum of ten.", + "description": "Required. List of items in the Browse Carousel Card. Minimum of two items, maximum of ten.", "items": { "$ref": "GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCardBrowseCarouselCardItem" }, @@ -7560,11 +7639,11 @@ "id": "GoogleCloudDialogflowV2beta1IntentMessageBrowseCarouselCardBrowseCarouselCardItem", "properties": { "description": { - "description": "Optional. Description of the carousel item. Maximum of four lines of\ntext.", + "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\nCard. Maximum of one line of text.", + "description": "Optional. Text that appears at the bottom of the Browse Carousel Card. Maximum of one line of text.", "type": "string" }, "image": { @@ -7591,7 +7670,7 @@ "type": "string" }, "urlTypeHint": { - "description": "Optional. Specifies the type of viewer that is used when opening\nthe URL. Defaults to opening via web browser.", + "description": "Optional. Specifies the type of viewer that is used when opening the URL. Defaults to opening via web browser.", "enum": [ "URL_TYPE_HINT_UNSPECIFIED", "AMP_ACTION", @@ -7600,7 +7679,7 @@ "enumDescriptions": [ "Unspecified", "Url would be an amp action", - "URL that points directly to AMP content, or to a canonical URL\nwhich refers to AMP content via ." + "URL that points directly to AMP content, or to a canonical URL which refers to AMP content via ." ], "type": "string" } @@ -7638,7 +7717,7 @@ "id": "GoogleCloudDialogflowV2beta1IntentMessageCardButton", "properties": { "postback": { - "description": "Optional. The text to send back to the Dialogflow API or a URI to\nopen.", + "description": "Optional. The text to send back to the Dialogflow API or a URI to open.", "type": "string" }, "text": { @@ -7717,7 +7796,7 @@ "id": "GoogleCloudDialogflowV2beta1IntentMessageImage", "properties": { "accessibilityText": { - "description": "A text description of the image to be used for accessibility,\ne.g., screen readers. Required if image_uri is set for CarouselSelect.", + "description": "A text description of the image to be used for accessibility, e.g., screen readers. Required if image_uri is set for CarouselSelect.", "type": "string" }, "imageUri": { @@ -7728,7 +7807,7 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageLinkOutSuggestion": { - "description": "The suggestion chip message that allows the user to jump out to the app\nor website associated with this agent.", + "description": "The suggestion chip message that allows the user to jump out to the app or website associated with this agent.", "id": "GoogleCloudDialogflowV2beta1IntentMessageLinkOutSuggestion", "properties": { "destinationName": { @@ -7736,7 +7815,7 @@ "type": "string" }, "uri": { - "description": "Required. The URI of the app or site to open when the user taps the\nsuggestion chip.", + "description": "Required. The URI of the app or site to open when the user taps the suggestion chip.", "type": "string" } }, @@ -7863,12 +7942,12 @@ "id": "GoogleCloudDialogflowV2beta1IntentMessageRbmCardContent", "properties": { "description": { - "description": "Optional. Description of the card (at most 2000 bytes).\n\nAt least one of the title, description or media must be set.", + "description": "Optional. Description of the card (at most 2000 bytes). At least one of the title, description or media must be set.", "type": "string" }, "media": { "$ref": "GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia", - "description": "Optional. However at least one of the title, description or media must\nbe set. Media (image, GIF or a video) to include in the card." + "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." }, "suggestions": { "description": "Optional. List of suggestions to include in the card.", @@ -7878,22 +7957,22 @@ "type": "array" }, "title": { - "description": "Optional. Title of the card (at most 200 bytes).\n\nAt least one of the title, description or media must be set.", + "description": "Optional. Title of the card (at most 200 bytes). At least one of the title, description or media must be set.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia": { - "description": "Rich Business Messaging (RBM) Media displayed in Cards\nThe following media-types are currently supported:\n\nImage Types\n\n* image/jpeg\n* image/jpg'\n* image/gif\n* image/png\n\nVideo Types\n\n* video/h263\n* video/m4v\n* video/mp4\n* video/mpeg\n* video/mpeg4\n* video/webm", + "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", "id": "GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia", "properties": { "fileUri": { - "description": "Required. Publicly reachable URI of the file. The RBM platform\ndetermines the MIME type of the file from the content-type field in\nthe HTTP headers when the platform fetches the file. The content-type\nfield must be present and accurate in the HTTP response from the URL.", + "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\nwithin a rich card with a vertical layout.\nFor a standalone card with horizontal layout, height is not\ncustomizable, and this field is ignored.", + "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.", "enum": [ "HEIGHT_UNSPECIFIED", "SHORT", @@ -7904,23 +7983,23 @@ "Not specified.", "112 DP.", "168 DP.", - "264 DP. Not available for rich card carousels when the card width\nis set to small." + "264 DP. Not available for rich card carousels when the card width is set to small." ], "type": "string" }, "thumbnailUri": { - "description": "Optional. Publicly reachable URI of the thumbnail.If you don't\nprovide a thumbnail URI, the RBM platform displays a blank\nplaceholder thumbnail until the user's device downloads the file.\nDepending on the user's setting, the file may not download\nautomatically and may require the user to tap a download button.", + "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.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageRbmCarouselCard": { - "description": "Carousel Rich Business Messaging (RBM) rich card.\n\nRich cards allow you to respond to users with more vivid content, e.g.\nwith media and suggestions.\n\nIf you want to show a single card with more control over the layout,\nplease use RbmStandaloneCard instead.", + "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", "properties": { "cardContents": { - "description": "Required. The cards in the carousel. A carousel must have at least\n2 cards and at most 10.", + "description": "Required. The cards in the carousel. A carousel must have at least 2 cards and at most 10.", "items": { "$ref": "GoogleCloudDialogflowV2beta1IntentMessageRbmCardContent" }, @@ -7944,7 +8023,7 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageRbmStandaloneCard": { - "description": "Standalone Rich Business Messaging (RBM) rich card.\n\nRich cards allow you to respond to users with more vivid content, e.g.\nwith media and suggestions.\n\nYou can group multiple rich cards into one using RbmCarouselCard but\ncarousel cards will give you less control over the card layout.", + "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", "properties": { "cardContent": { @@ -7966,7 +8045,7 @@ "type": "string" }, "thumbnailImageAlignment": { - "description": "Required if orientation is horizontal.\nImage preview alignment for standalone cards with horizontal layout.", + "description": "Required if orientation is horizontal. Image preview alignment for standalone cards with horizontal layout.", "enum": [ "THUMBNAIL_IMAGE_ALIGNMENT_UNSPECIFIED", "LEFT", @@ -7983,7 +8062,7 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedAction": { - "description": "Rich Business Messaging (RBM) suggested client-side action that the user\ncan choose from the card.", + "description": "Rich Business Messaging (RBM) suggested client-side action that the user can choose from the card.", "id": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedAction", "properties": { "dial": { @@ -7995,7 +8074,7 @@ "description": "Suggested client side action: Open a URI on device" }, "postbackData": { - "description": "Opaque payload that the Dialogflow receives in a user event\nwhen the user taps the suggested action. This data will be also\nforwarded to webhook to allow performing custom business logic.", + "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.", "type": "string" }, "shareLocation": { @@ -8010,18 +8089,18 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionDial": { - "description": "Opens the user's default dialer app with the specified phone number\nbut does not dial automatically.", + "description": "Opens the user's default dialer app with the specified phone number but does not dial automatically.", "id": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionDial", "properties": { "phoneNumber": { - "description": "Required. The phone number to fill in the default dialer app.\nThis field should be in [E.164](https://en.wikipedia.org/wiki/E.164)\nformat. An example of a correctly formatted phone number:\n+15556767888.", + "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" }, "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionOpenUri": { - "description": "Opens the user's default web browser app to the specified uri\nIf the user has an app installed that is\nregistered as the default handler for the URL, then this app will be\nopened instead, and its icon will be used in the suggested action UI.", + "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.", "id": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionOpenUri", "properties": { "uri": { @@ -8032,17 +8111,17 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionShareLocation": { - "description": "Opens the device's location chooser so the user can pick a location\nto send back to the agent.", + "description": "Opens the device's location chooser so the user can pick a location to send back to the agent.", "id": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionShareLocation", "properties": {}, "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedReply": { - "description": "Rich Business Messaging (RBM) suggested reply that the user can click\ninstead of typing in their own response.", + "description": "Rich Business Messaging (RBM) suggested reply that the user can click instead of typing in their own response.", "id": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedReply", "properties": { "postbackData": { - "description": "Opaque payload that the Dialogflow receives in a user event\nwhen the user taps the suggested reply. This data will be also\nforwarded to webhook to allow performing custom business logic.", + "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": { @@ -8053,7 +8132,7 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestion": { - "description": "Rich Business Messaging (RBM) suggestion. Suggestions allow user to\neasily select/click a predefined response or perform an action (like\nopening a web uri).", + "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).", "id": "GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestion", "properties": { "action": { @@ -8086,15 +8165,15 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageSelectItemInfo": { - "description": "Additional info about the select item for when it is triggered in a\ndialog.", + "description": "Additional info about the select item for when it is triggered in a dialog.", "id": "GoogleCloudDialogflowV2beta1IntentMessageSelectItemInfo", "properties": { "key": { - "description": "Required. A unique key that will be sent back to the agent if this\nresponse is given.", + "description": "Required. A unique key that will be sent back to the agent if this response is given.", "type": "string" }, "synonyms": { - "description": "Optional. A list of synonyms that can also be used to trigger this\nitem in dialog.", + "description": "Optional. A list of synonyms that can also be used to trigger this item in dialog.", "items": { "type": "string" }, @@ -8112,18 +8191,18 @@ "type": "string" }, "ssml": { - "description": "One of text_to_speech or ssml must be provided. Structured spoken\nresponse to the user in the SSML format. Mutually exclusive with\ntext_to_speech.", + "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\nspeech output. Mutually exclusive with ssml.", + "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" }, "GoogleCloudDialogflowV2beta1IntentMessageSimpleResponses": { - "description": "The collection of simple response candidates.\nThis message in `QueryResult.fulfillment_messages` and\n`WebhookResponse.fulfillment_messages` should contain only one\n`SimpleResponse`.", + "description": "The collection of simple response candidates. This message in `QueryResult.fulfillment_messages` and `WebhookResponse.fulfillment_messages` should contain only one `SimpleResponse`.", "id": "GoogleCloudDialogflowV2beta1IntentMessageSimpleResponses", "properties": { "simpleResponses": { @@ -8137,7 +8216,7 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageSuggestion": { - "description": "The suggestion chip message that the user can tap to quickly post a reply\nto the conversation.", + "description": "The suggestion chip message that the user can tap to quickly post a reply to the conversation.", "id": "GoogleCloudDialogflowV2beta1IntentMessageSuggestion", "properties": { "title": { @@ -8235,18 +8314,18 @@ "id": "GoogleCloudDialogflowV2beta1IntentMessageTelephonyPlayAudio", "properties": { "audioUri": { - "description": "Required. URI to a Google Cloud Storage object containing the audio to\nplay, e.g., \"gs://bucket/object\". The object must contain a single\nchannel (mono) of linear PCM audio (2 bytes / sample) at 8kHz.\n\nThis object must be readable by the `service-@gcp-sa-dialogflow.iam.gserviceaccount.com` service account\nwhere is the number of the Telephony Gateway project\n(usually the same as the Dialogflow agent project). If the Google Cloud\nStorage bucket is in the Telephony Gateway project, this permission is\nadded by default when enabling the Dialogflow V2 API.\n\nFor audio from other sources, consider using the\n`TelephonySynthesizeSpeech` message with SSML.", + "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 `service-@gcp-sa-dialogflow.iam.gserviceaccount.com` 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.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech": { - "description": "Synthesizes speech and plays back the synthesized audio to the caller in\nTelephony Gateway.\n\nTelephony Gateway takes the synthesizer settings from\n`DetectIntentResponse.output_audio_config` which can either be set\nat request-level or can come from the agent-level synthesizer config.", + "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.", "id": "GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech", "properties": { "ssml": { - "description": "The SSML to be synthesized. For more information, see\n[SSML](https://developers.google.com/actions/reference/ssml).", + "description": "The SSML to be synthesized. For more information, see [SSML](https://developers.google.com/actions/reference/ssml).", "type": "string" }, "text": { @@ -8261,7 +8340,7 @@ "id": "GoogleCloudDialogflowV2beta1IntentMessageTelephonyTransferCall", "properties": { "phoneNumber": { - "description": "Required. The phone number to transfer the call to\nin [E.164 format](https://en.wikipedia.org/wiki/E.164).\n\nWe currently only allow transferring to US numbers (+1xxxyyyzzzz).", + "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).", "type": "string" } }, @@ -8286,7 +8365,7 @@ "id": "GoogleCloudDialogflowV2beta1IntentParameter", "properties": { "defaultValue": { - "description": "Optional. The default value to use when the `value` yields an empty\nresult.\nDefault values can be extracted from contexts by using the following\nsyntax: `#context_name.parameter_name`.", + "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": { @@ -8294,7 +8373,7 @@ "type": "string" }, "entityTypeDisplayName": { - "description": "Optional. The name of the entity type, prefixed with `@`, that\ndescribes values of the parameter. If the parameter is\nrequired, this must be provided.", + "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" }, "isList": { @@ -8302,7 +8381,7 @@ "type": "boolean" }, "mandatory": { - "description": "Optional. Indicates whether the parameter is required. That is,\nwhether the intent cannot be completed without collecting the parameter\nvalue.", + "description": "Optional. Indicates whether the parameter is required. That is, whether the intent cannot be completed without collecting the parameter value.", "type": "boolean" }, "name": { @@ -8310,14 +8389,14 @@ "type": "string" }, "prompts": { - "description": "Optional. The collection of prompts that the agent can present to the\nuser in order to collect a value for the parameter.", + "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" }, "value": { - "description": "Optional. The definition of the parameter value. It can be:\n\n- a constant string,\n- a parameter value defined as `$parameter_name`,\n- an original parameter value defined as `$parameter_name.original`,\n- a parameter value from some context defined as\n `#context_name.parameter_name`.", + "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" } }, @@ -8332,14 +8411,14 @@ "type": "string" }, "parts": { - "description": "Required. The ordered list of training phrase parts.\nThe parts are concatenated in order to form the training phrase.\n\nNote: The API does not automatically annotate training phrases like the\nDialogflow Console does.\n\nNote: Do not forget to include whitespace at part boundaries,\nso the training phrase is well formatted when the parts are concatenated.\n\nIf the training phrase does not need to be annotated with parameters,\nyou just need a single part with only the Part.text field set.\n\nIf you want to annotate the training phrase, you must create multiple\nparts, where the fields of each part are populated in one of two ways:\n\n- `Part.text` is set to a part of the phrase that has no parameters.\n- `Part.text` is set to a part of the phrase that you want to annotate,\n and the `entity_type`, `alias`, and `user_defined` fields are all\n set.", + "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.", "items": { "$ref": "GoogleCloudDialogflowV2beta1IntentTrainingPhrasePart" }, "type": "array" }, "timesAddedCount": { - "description": "Optional. Indicates how many times this example was added to\nthe intent. Each time a developer adds an existing sample by editing an\nintent or training, this counter is increased.", + "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" }, @@ -8352,8 +8431,8 @@ ], "enumDescriptions": [ "Not specified. This value should never be used.", - "Examples do not contain @-prefixed entity type names, but example parts\ncan be annotated with entity types.", - "Templates are not annotated with entity types, but they can contain\n@-prefixed entity type names as substrings.\nTemplate mode has been deprecated. Example mode is the only supported\nway to create new training phrases. If you have existing training\nphrases that you've created in template mode, those will continue to\nwork." + "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" } @@ -8365,11 +8444,11 @@ "id": "GoogleCloudDialogflowV2beta1IntentTrainingPhrasePart", "properties": { "alias": { - "description": "Optional. The parameter name for the value extracted from the\nannotated part of the example.\nThis field is required for annotated parts of the training phrase.", + "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" }, "entityType": { - "description": "Optional. The entity type name prefixed with `@`.\nThis field is required for annotated parts of the training phrase.", + "description": "Optional. The entity type name prefixed with `@`. This field is required for annotated parts of the training phrase.", "type": "string" }, "text": { @@ -8377,7 +8456,7 @@ "type": "string" }, "userDefined": { - "description": "Optional. Indicates whether the text was manually annotated.\nThis field is set to true when the Dialogflow Console is used to\nmanually annotate the part. When creating an annotated part with the\nAPI, you must set this to true.", + "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.", "type": "boolean" } }, @@ -8402,20 +8481,20 @@ "id": "GoogleCloudDialogflowV2beta1KnowledgeAnswersAnswer", "properties": { "answer": { - "description": "The piece of text from the `source` knowledge base document that answers\nthis conversational query.", + "description": "The piece of text from the `source` knowledge base document that answers this conversational query.", "type": "string" }, "faqQuestion": { - "description": "The corresponding FAQ question if the answer was extracted from a FAQ\nDocument, empty otherwise.", + "description": "The corresponding FAQ question if the answer was extracted from a FAQ Document, empty otherwise.", "type": "string" }, "matchConfidence": { - "description": "The system's confidence score that this Knowledge answer is a good match\nfor this conversational query.\nThe range is from 0.0 (completely uncertain) to 1.0 (completely certain).\nNote: The confidence score is likely to vary somewhat (possibly even for\nidentical requests), as the underlying model is under constant\nimprovement. It may be deprecated in the future. We recommend using\n`match_confidence_level` which should be generally more stable.", + "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.", "format": "float", "type": "number" }, "matchConfidenceLevel": { - "description": "The system's confidence level that this knowledge answer is a good match\nfor this conversational query.\nNOTE: The confidence level for a given `` pair may change\nwithout notice, as it depends on models that are constantly being\nimproved. However, it will change less frequently than the confidence\nscore below, and should be preferred for referencing the quality of an\nanswer.", + "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.", "enum": [ "MATCH_CONFIDENCE_LEVEL_UNSPECIFIED", "LOW", @@ -8431,26 +8510,26 @@ "type": "string" }, "source": { - "description": "Indicates which Knowledge Document this answer was extracted from.\nFormat: `projects//knowledgeBases//documents/`.", + "description": "Indicates which Knowledge Document this answer was extracted from. Format: `projects//knowledgeBases//documents/`.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1KnowledgeBase": { - "description": "A knowledge base represents a collection of knowledge documents that you\nprovide to Dialogflow. Your knowledge documents contain information that may\nbe useful during conversations with end-users. Some Dialogflow features use\nknowledge bases when looking for a response to an end-user input.\n\nFor more information, see the [knowledge base\nguide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases).\n\nNote: The `projects.agent.knowledgeBases` resource is deprecated;\nonly use `projects.knowledgeBases`.", + "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\nbytes or less; otherwise, the creation request fails.", + "description": "Required. The display name of the knowledge base. The name must be 1024 bytes or less; otherwise, the creation request fails.", "type": "string" }, "languageCode": { - "description": "Language which represents the KnowledgeBase. When the KnowledgeBase is\ncreated/updated, this is populated for all non en-us languages. If not\npopulated, the default language en-us applies.", + "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" }, "name": { - "description": "The knowledge base resource name.\nThe name must be empty when creating a knowledge base.\nFormat: `projects//knowledgeBases/`.", + "description": "The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`.", "type": "string" } }, @@ -8474,13 +8553,14 @@ "The operation is currently running.", "The operation is done, either cancelled or completed." ], + "readOnly": true, "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1LabelConversationResponse": { - "description": "The response for\nConversationDatasets.LabelConversation.", + "description": "The response for ConversationDatasets.LabelConversation.", "id": "GoogleCloudDialogflowV2beta1LabelConversationResponse", "properties": { "annotatedConversationDataset": { @@ -8495,14 +8575,14 @@ "id": "GoogleCloudDialogflowV2beta1ListContextsResponse", "properties": { "contexts": { - "description": "The list of contexts. There will be a maximum number of items\nreturned based on the page_size field in the request.", + "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": { - "description": "Token to retrieve the next page of results, or empty if there are no\nmore results in the list.", + "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" } }, @@ -8520,7 +8600,7 @@ "type": "array" }, "nextPageToken": { - "description": "Token to retrieve the next page of results, or empty if there are no\nmore results in the list.", + "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" } }, @@ -8531,14 +8611,14 @@ "id": "GoogleCloudDialogflowV2beta1ListEntityTypesResponse", "properties": { "entityTypes": { - "description": "The list of agent entity types. There will be a maximum number of items\nreturned based on the page_size field in the request.", + "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" }, "type": "array" }, "nextPageToken": { - "description": "Token to retrieve the next page of results, or empty if there are no\nmore results in the list.", + "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" } }, @@ -8549,14 +8629,14 @@ "id": "GoogleCloudDialogflowV2beta1ListEnvironmentsResponse", "properties": { "environments": { - "description": "The list of agent environments. There will be a maximum number of items\nreturned based on the page_size field in the request.", + "description": "The list of agent environments. There will be a maximum number of items returned based on the page_size field in the request.", "items": { "$ref": "GoogleCloudDialogflowV2beta1Environment" }, "type": "array" }, "nextPageToken": { - "description": "Token to retrieve the next page of results, or empty if there are no\nmore results in the list.", + "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" } }, @@ -8567,14 +8647,14 @@ "id": "GoogleCloudDialogflowV2beta1ListIntentsResponse", "properties": { "intents": { - "description": "The list of agent intents. There will be a maximum number of items\nreturned based on the page_size field in the request.", + "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" }, "nextPageToken": { - "description": "Token to retrieve the next page of results, or empty if there are no\nmore results in the list.", + "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" } }, @@ -8592,7 +8672,7 @@ "type": "array" }, "nextPageToken": { - "description": "Token to retrieve the next page of results, or empty if there are no\nmore results in the list.", + "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" } }, @@ -8603,11 +8683,11 @@ "id": "GoogleCloudDialogflowV2beta1ListSessionEntityTypesResponse", "properties": { "nextPageToken": { - "description": "Token to retrieve the next page of results, or empty if there are no\nmore results in the list.", + "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" }, "sessionEntityTypes": { - "description": "The list of session entity types. There will be a maximum number of items\nreturned based on the page_size field in the request.", + "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.", "items": { "$ref": "GoogleCloudDialogflowV2beta1SessionEntityType" }, @@ -8617,7 +8697,7 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest": { - "description": "Represents the contents of the original request that was passed to\nthe `[Streaming]DetectIntent` call.", + "description": "Represents the contents of the original request that was passed to the `[Streaming]DetectIntent` call.", "id": "GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest", "properties": { "payload": { @@ -8625,22 +8705,22 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. This field is set to the value of the `QueryParameters.payload`\nfield passed in the request. Some integrations that query a Dialogflow\nagent may provide additional information in the payload.\n\nIn particular, for the Dialogflow Phone Gateway integration, this field has\nthe form:\n
{\n \"telephony\": {\n   \"caller_id\": \"+18558363987\"\n }\n}
\nNote: The caller ID field (`caller_id`) will be redacted for Standard\nEdition agents and populated with the caller ID in [E.164\nformat](https://en.wikipedia.org/wiki/E.164) for Enterprise Edition agents.", + "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 Standard Edition agents and populated with the caller ID in [E.164 format](https://en.wikipedia.org/wiki/E.164) for Enterprise Edition agents.", "type": "object" }, "source": { - "description": "The source of this request, e.g., `google`, `facebook`, `slack`. It is set\nby Dialogflow-owned servers.", + "description": "The source of this request, e.g., `google`, `facebook`, `slack`. It is set by Dialogflow-owned servers.", "type": "string" }, "version": { - "description": "Optional. The version of the protocol used for this request.\nThis field is AoG-specific.", + "description": "Optional. The version of the protocol used for this request. This field is AoG-specific.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1OutputAudioConfig": { - "description": "Instructs the speech synthesizer how to generate the output audio content.\nIf this audio config is supplied in a request, it overrides all existing\ntext-to-speech settings applied to the agent.", + "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": { "audioEncoding": { @@ -8653,14 +8733,14 @@ ], "enumDescriptions": [ "Not specified.", - "Uncompressed 16-bit signed little-endian samples (Linear PCM).\nAudio content returned as LINEAR16 also contains a WAV header.", + "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\nfile which can be played natively on Android, and in browsers (at least\nChrome and Firefox). The quality of the encoding is considerably higher\nthan MP3 while using approximately the same bitrate." + "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" }, "sampleRateHertz": { - "description": "The synthesis sample rate (in hertz) for this audio. If not\nprovided, then the synthesizer will use the default sample rate based on\nthe audio encoding. If this is different from the voice's natural sample\nrate, then the synthesizer will honor this request by converting to the\ndesired sample rate (which might result in worse audio quality).", + "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).", "format": "int32", "type": "integer" }, @@ -8672,7 +8752,7 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1QueryInput": { - "description": "Represents the query input. It can contain either:\n\n1. An audio config which\n instructs the speech recognizer how to process the speech audio.\n\n2. A conversational query in the form of text.\n\n3. An event that specifies which intent to trigger.", + "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.", "id": "GoogleCloudDialogflowV2beta1QueryInput", "properties": { "audioConfig": { @@ -8695,7 +8775,7 @@ "id": "GoogleCloudDialogflowV2beta1QueryParameters", "properties": { "contexts": { - "description": "The collection of contexts to be activated before this query is\nexecuted.", + "description": "The collection of contexts to be activated before this query is executed.", "items": { "$ref": "GoogleCloudDialogflowV2beta1Context" }, @@ -8706,7 +8786,7 @@ "description": "The geo location of this conversational query." }, "knowledgeBaseNames": { - "description": "KnowledgeBases to get alternative results from. If not set, the\nKnowledgeBases enabled in the agent (through UI) will be used.\nFormat: `projects//knowledgeBases/`.", + "description": "KnowledgeBases to get alternative results from. If not set, the KnowledgeBases enabled in the agent (through UI) will be used. Format: `projects//knowledgeBases/`.", "items": { "type": "string" }, @@ -8717,40 +8797,40 @@ "description": "Properties of the object.", "type": "any" }, - "description": "This field can be used to pass custom data to your webhook.\nArbitrary JSON objects are supported.\nIf supplied, the value is used to populate the\n`WebhookRequest.original_detect_intent_request.payload`\nfield sent to your webhook.", + "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.", "type": "object" }, "resetContexts": { - "description": "Specifies whether to delete all contexts in the current session\nbefore the new ones are activated.", + "description": "Specifies whether to delete all contexts in the current session before the new ones are activated.", "type": "boolean" }, "sentimentAnalysisRequestConfig": { "$ref": "GoogleCloudDialogflowV2beta1SentimentAnalysisRequestConfig", - "description": "Configures the type of sentiment analysis to perform. If not\nprovided, sentiment analysis is not performed.\nNote: Sentiment Analysis is only currently available for Enterprise Edition\nagents." + "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 Enterprise Edition agents." }, "sessionEntityTypes": { - "description": "Additional session entity types to replace or extend developer\nentity types with. The entity synonyms apply to all languages and persist\nfor the session of this query.", + "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.", "items": { "$ref": "GoogleCloudDialogflowV2beta1SessionEntityType" }, "type": "array" }, "subAgents": { - "description": "For mega agent query, directly specify which sub agents to query.\nIf any specified sub agent is not linked to the mega agent, an error will\nbe returned. If empty, Dialogflow will decide which sub agents to query.\nIf specified for a non-mega-agent query, will be silently ignored.", + "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.", "items": { "$ref": "GoogleCloudDialogflowV2beta1SubAgent" }, "type": "array" }, "timeZone": { - "description": "The time zone of this conversational query from the\n[time zone database](https://www.iana.org/time-zones), e.g.,\nAmerica/New_York, Europe/Paris. If not provided, the time zone specified in\nagent settings is used.", + "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.", "type": "string" }, "webhookHeaders": { "additionalProperties": { "type": "string" }, - "description": "This field can be used to pass HTTP headers for a webhook\ncall. These headers will be sent to webhook alone with the headers that\nhave been configured through Dialogflow web console. The headers defined\nwithin this field will overwrite the headers configured through Dialogflow\nconsole if there is a conflict. Header names are case-insensitive.\nGoogle's specified headers are not allowed. Including: \"Host\",\n\"Content-Length\", \"Connection\", \"From\", \"User-Agent\", \"Accept-Encoding\",\n\"If-Modified-Since\", \"If-None-Match\", \"X-Forwarded-For\", etc.", + "description": "This field can be used to pass HTTP headers for a webhook call. These headers will be sent to webhook alone 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.", "type": "object" } }, @@ -8765,7 +8845,7 @@ "type": "string" }, "allRequiredParamsPresent": { - "description": "This field is set to:\n\n- `false` if the matched intent has required parameters and not all of\n the required parameter values have been collected.\n- `true` if all required parameter values have been collected, or if the\n matched intent doesn't contain any required parameters.", + "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" }, "diagnosticInfo": { @@ -8773,7 +8853,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Free-form diagnostic information for the associated detect intent request.\nThe fields of this data can change without notice, so you should not write\ncode that depends on its structure.\nThe data may contain:\n\n- webhook call latency\n- webhook errors", + "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", "type": "object" }, "fulfillmentMessages": { @@ -8784,28 +8864,28 @@ "type": "array" }, "fulfillmentText": { - "description": "The text to be pronounced to the user or shown on the screen.\nNote: This is a legacy field, `fulfillment_messages` should be preferred.", + "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" }, "intent": { "$ref": "GoogleCloudDialogflowV2beta1Intent", - "description": "The intent that matched the conversational query. Some, not\nall fields are filled in this message, including but not limited to:\n`name`, `display_name`, `end_interaction` and `is_fallback`." + "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`." }, "intentDetectionConfidence": { - "description": "The intent detection confidence. Values range from 0.0\n(completely uncertain) to 1.0 (completely certain).\nThis value is for informational purpose only and is only used to\nhelp match the best intent within the classification threshold.\nThis value may change for the same end-user expression at any time due to a\nmodel retraining or change in implementation.\nIf there are `multiple knowledge_answers` messages, this value is set to\nthe greatest `knowledgeAnswers.match_confidence` value in the list.", + "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\n`KnowledgeAnswers.match_confidence`." + "description": "The result from Knowledge Connector (if any), ordered by decreasing `KnowledgeAnswers.match_confidence`." }, "languageCode": { - "description": "The language that was triggered during intent detection.\nSee [Language\nSupport](https://cloud.google.com/dialogflow/docs/reference/language)\nfor a list of the currently supported language codes.", + "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.", "type": "string" }, "outputContexts": { - "description": "The collection of output contexts. If applicable,\n`output_contexts.parameters` contains entries with name\n`.original` containing the original parameter values\nbefore the query.", + "description": "The collection of output contexts. If applicable, `output_contexts.parameters` contains entries with name `.original` containing the original parameter values before the query.", "items": { "$ref": "GoogleCloudDialogflowV2beta1Context" }, @@ -8816,19 +8896,19 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of extracted parameters.\n\nDepending on your protocol or client library language, this is a\nmap, associative array, symbol table, dictionary, or JSON object\ncomposed of a collection of (MapKey, MapValue) pairs:\n\n- MapKey type: string\n- MapKey value: parameter name\n- MapValue type:\n - If parameter's entity type is a composite entity: map\n - Else: string or number, depending on parameter value type\n- MapValue value:\n - If parameter's entity type is a composite entity:\n map from composite entity property names to property values\n - Else: parameter value", + "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", "type": "object" }, "queryText": { - "description": "The original conversational query text:\n\n- If natural language text was provided as input, `query_text` contains\n a copy of the input.\n- If natural language speech audio was provided as input, `query_text`\n contains the speech recognition result. If speech recognizer produced\n multiple alternatives, a particular one is picked.\n- If automatic spell correction is enabled, `query_text` will contain the\n corrected user input.", + "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" }, "sentimentAnalysisResult": { "$ref": "GoogleCloudDialogflowV2beta1SentimentAnalysisResult", - "description": "The sentiment analysis result, which depends on the\n`sentiment_analysis_request_config` specified in the request." + "description": "The sentiment analysis result, which depends on the `sentiment_analysis_request_config` specified in the request." }, "speechRecognitionConfidence": { - "description": "The Speech recognition confidence between 0.0 and 1.0. A higher number\nindicates an estimated greater likelihood that the recognized words are\ncorrect. The default of 0.0 is a sentinel value indicating that confidence\nwas not set.\n\nThis field is not guaranteed to be accurate or set. In particular this\nfield isn't set for StreamingDetectIntent since the streaming endpoint has\nseparate confidence estimates per portion of the audio in\nStreamingRecognitionResult.", + "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.", "format": "float", "type": "number" }, @@ -8837,11 +8917,11 @@ "description": "Properties of the object.", "type": "any" }, - "description": "If the query was fulfilled by a webhook call, this field is set to the\nvalue of the `payload` field returned in the webhook response.", + "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" }, "webhookSource": { - "description": "If the query was fulfilled by a webhook call, this field is set to the\nvalue of the `source` field returned in the webhook response.", + "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.", "type": "string" } }, @@ -8853,7 +8933,7 @@ "properties": { "gcsSource": { "$ref": "GoogleCloudDialogflowV2beta1GcsSource", - "description": "The path for a Cloud Storage source file for reloading document content.\nIf not provided, the Document's existing source will be reloaded." + "description": "The path for a Cloud Storage source file for reloading document content. If not provided, the Document's existing source will be reloaded." } }, "type": "object" @@ -8868,7 +8948,7 @@ "type": "string" }, "agentUri": { - "description": "The URI to a Google Cloud Storage file containing the agent to restore.\nNote: The URI must start with \"gs://\".", + "description": "The URI to a Google Cloud Storage file containing the agent to restore. Note: The URI must start with \"gs://\".", "type": "string" } }, @@ -8879,30 +8959,30 @@ "id": "GoogleCloudDialogflowV2beta1SearchAgentsResponse", "properties": { "agents": { - "description": "The list of agents. There will be a maximum number of items returned based\non the page_size field in the request.", + "description": "The list of agents. There will be a maximum number of items returned based on the page_size field in the request.", "items": { "$ref": "GoogleCloudDialogflowV2beta1Agent" }, "type": "array" }, "nextPageToken": { - "description": "Token to retrieve the next page of results, or empty if there are no\nmore results in the list.", + "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1Sentiment": { - "description": "The sentiment, such as positive/negative feeling or association, for a unit\nof analysis, such as the query text.", + "description": "The sentiment, such as positive/negative feeling or association, for a unit of analysis, such as the query text.", "id": "GoogleCloudDialogflowV2beta1Sentiment", "properties": { "magnitude": { - "description": "A non-negative number in the [0, +inf) range, which represents the absolute\nmagnitude of sentiment, regardless of score (positive or negative).", + "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", "type": "number" }, "score": { - "description": "Sentiment score between -1.0 (negative sentiment) and 1.0 (positive\nsentiment).", + "description": "Sentiment score between -1.0 (negative sentiment) and 1.0 (positive sentiment).", "format": "float", "type": "number" } @@ -8914,14 +8994,14 @@ "id": "GoogleCloudDialogflowV2beta1SentimentAnalysisRequestConfig", "properties": { "analyzeQueryTextSentiment": { - "description": "Instructs the service to perform sentiment analysis on\n`query_text`. If not provided, sentiment analysis is not performed on\n`query_text`.", + "description": "Instructs the service to perform sentiment analysis on `query_text`. If not provided, sentiment analysis is not performed on `query_text`.", "type": "boolean" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1SentimentAnalysisResult": { - "description": "The result of sentiment analysis. Sentiment analysis inspects user input\nand identifies the prevailing subjective opinion, especially to determine a\nuser's attitude as positive, negative, or neutral.\nFor Participants.AnalyzeContent, it needs to be configured in\nDetectIntentRequest.query_params. For\nParticipants.StreamingAnalyzeContent, it needs to be configured in\nStreamingDetectIntentRequest.query_params.\nAnd for Participants.AnalyzeContent and\nParticipants.StreamingAnalyzeContent, it needs to be configured in\nConversationProfile.human_agent_assistant_config", + "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.AnalyzeContent, it needs to be configured in DetectIntentRequest.query_params. For Participants.StreamingAnalyzeContent, 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", "properties": { "queryTextSentiment": { @@ -8932,18 +9012,18 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1SessionEntityType": { - "description": "A session represents a conversation between a Dialogflow agent and an\nend-user. You can create special entities, called session entities, during a\nsession. Session entities can extend or replace custom entity types and only\nexist during the session that they were created for. All session data,\nincluding session entities, is stored by Dialogflow for 20 minutes.\n\nFor more information, see the [session entity\nguide](https://cloud.google.com/dialogflow/docs/entities-session).", + "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\ntype.", + "description": "Required. The collection of entities associated with this session entity type.", "items": { "$ref": "GoogleCloudDialogflowV2beta1EntityTypeEntity" }, "type": "array" }, "entityOverrideMode": { - "description": "Required. Indicates whether the additional data should override or\nsupplement the custom entity type definition.", + "description": "Required. Indicates whether the additional data should override or supplement the custom entity type definition.", "enum": [ "ENTITY_OVERRIDE_MODE_UNSPECIFIED", "ENTITY_OVERRIDE_MODE_OVERRIDE", @@ -8951,29 +9031,29 @@ ], "enumDescriptions": [ "Not specified. This value should be never used.", - "The collection of session entities overrides the collection of entities\nin the corresponding custom entity type.", - "The collection of session entities extends the collection of entities in\nthe corresponding custom entity type.\n\nNote: Even in this override mode calls to `ListSessionEntityTypes`,\n`GetSessionEntityType`, `CreateSessionEntityType` and\n`UpdateSessionEntityType` only return the additional entities added in\nthis session entity type. If you want to get the supplemented list,\nplease call EntityTypes.GetEntityType on the custom entity type\nand merge." + "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" }, "name": { - "description": "Required. The unique identifier of this session entity type. Format:\n`projects//agent/sessions//entityTypes/`, or\n`projects//agent/environments//users//sessions//entityTypes/`.\nIf `Environment ID` is not specified, we assume default 'draft'\nenvironment. If `User ID` is not specified, we assume default '-' user.\n\n`` must be the display name of an existing entity\ntype in the same agent that will be overridden or supplemented.", + "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.", "type": "string" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1SpeechContext": { - "description": "Hints for the speech recognizer to help with recognition in a specific\nconversation state.", + "description": "Hints for the speech recognizer to help with recognition in a specific conversation state.", "id": "GoogleCloudDialogflowV2beta1SpeechContext", "properties": { "boost": { - "description": "Optional. Boost for this context compared to other contexts:\n\n* If the boost is positive, Dialogflow will increase the probability that\n the phrases in this context are recognized over similar sounding phrases.\n* If the boost is unspecified or non-positive, Dialogflow will not apply\n any boost.\n\nDialogflow recommends that you use boosts in the range (0, 20] and that you\nfind a value that fits your use case with binary search.", + "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.", "format": "float", "type": "number" }, "phrases": { - "description": "Optional. A list of strings containing words and phrases that the speech\nrecognizer should recognize with higher likelihood.\n\nThis list can be used to:\n\n* improve accuracy for words and phrases you expect the user to say,\n e.g. typical commands for your Dialogflow agent\n* add additional words to the speech recognizer vocabulary\n* ...\n\nSee the [Cloud Speech\ndocumentation](https://cloud.google.com/speech-to-text/quotas) for usage\nlimits.", + "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" }, @@ -8987,11 +9067,11 @@ "id": "GoogleCloudDialogflowV2beta1SubAgent", "properties": { "environment": { - "description": "Optional. The unique identifier (`environment name` in dialogflow console)\nof this sub-agent environment. Assumes draft environment if `environment`\nis not set.", + "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.\nFormat: `projects/`.", + "description": "Required. The project of this agent. Format: `projects/`.", "type": "string" } }, @@ -9002,19 +9082,19 @@ "id": "GoogleCloudDialogflowV2beta1SynthesizeSpeechConfig", "properties": { "effectsProfileId": { - "description": "Optional. An identifier which selects 'audio effects' profiles that are\napplied on (post synthesized) text to speech. Effects are applied on top of\neach other in the order they are given.", + "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.", "items": { "type": "string" }, "type": "array" }, "pitch": { - "description": "Optional. Speaking pitch, in the range [-20.0, 20.0]. 20 means increase 20\nsemitones from the original pitch. -20 means decrease 20 semitones from the\noriginal pitch.", + "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.", "format": "double", "type": "number" }, "speakingRate": { - "description": "Optional. Speaking rate/speed, in the range [0.25, 4.0]. 1.0 is the normal\nnative speed supported by the specific voice. 2.0 is twice as fast, and\n0.5 is half as fast. If unset(0.0), defaults to the native 1.0 speed. Any\nother values < 0.25 or > 4.0 will return an error.", + "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 < 0.25 or > 4.0 will return an error.", "format": "double", "type": "number" }, @@ -9023,7 +9103,7 @@ "description": "Optional. The desired voice of the synthesized audio." }, "volumeGainDb": { - "description": "Optional. Volume gain (in dB) of the normal native volume supported by the\nspecific voice, in the range [-96.0, 16.0]. If unset, or set to a value of\n0.0 (dB), will play at normal native signal amplitude. A value of -6.0 (dB)\nwill play at approximately half the amplitude of the normal native signal\namplitude. A value of +6.0 (dB) will play at approximately twice the\namplitude of the normal native signal amplitude. We strongly recommend not\nto exceed +10 (dB) as there's usually no effective increase in loudness for\nany value greater than that.", + "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.", "format": "double", "type": "number" } @@ -9035,11 +9115,11 @@ "id": "GoogleCloudDialogflowV2beta1TextInput", "properties": { "languageCode": { - "description": "Required. The language of this conversational query. See [Language\nSupport](https://cloud.google.com/dialogflow/docs/reference/language)\nfor a list of the currently supported language codes. Note that queries in\nthe same session do not necessarily need to specify the same language.", + "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": { - "description": "Required. The UTF-8 encoded natural language text to be processed.\nText length must not exceed 256 characters.", + "description": "Required. The UTF-8 encoded natural language text to be processed. Text length must not exceed 256 characters.", "type": "string" } }, @@ -9056,7 +9136,7 @@ "id": "GoogleCloudDialogflowV2beta1ValidationError", "properties": { "entries": { - "description": "The names of the entries that the error is associated with.\nFormat:\n\n- \"projects//agent\", if the error is associated with the entire\nagent.\n- \"projects//agent/intents/\", if the error is\nassociated with certain intents.\n- \"projects//agent/intents//trainingPhrases/\", if the\nerror is associated with certain intent training phrases.\n- \"projects//agent/intents//parameters/\", if the error is associated with certain intent parameters.\n- \"projects//agent/entities/\", if the error is\nassociated with certain entities.", + "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.", "items": { "type": "string" }, @@ -9106,11 +9186,11 @@ "id": "GoogleCloudDialogflowV2beta1VoiceSelectionParams", "properties": { "name": { - "description": "Optional. The name of the voice. If not set, the service will choose a\nvoice based on the other parameters such as language_code and\nssml_gender.", + "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" }, "ssmlGender": { - "description": "Optional. The preferred gender of the voice. If not set, the service will\nchoose a voice based on the other parameters such as language_code and\nname. Note that this is only a preference, not requirement. If a\nvoice of the appropriate gender is not available, the synthesizer should\nsubstitute a voice with a different gender rather than failing the request.", + "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.", "enum": [ "SSML_VOICE_GENDER_UNSPECIFIED", "SSML_VOICE_GENDER_MALE", @@ -9118,7 +9198,7 @@ "SSML_VOICE_GENDER_NEUTRAL" ], "enumDescriptions": [ - "An unspecified gender, which means that the client doesn't care which\ngender the selected voice will have.", + "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." @@ -9141,48 +9221,48 @@ }, "originalDetectIntentRequest": { "$ref": "GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest", - "description": "Optional. The contents of the original request that was passed to\n`[Streaming]DetectIntent` call." + "description": "Optional. The contents of the original request that was passed to `[Streaming]DetectIntent` call." }, "queryResult": { "$ref": "GoogleCloudDialogflowV2beta1QueryResult", - "description": "The result of the conversational query or event processing. Contains the\nsame value as `[Streaming]DetectIntentResponse.query_result`." + "description": "The result of the conversational query or event processing. Contains the same value as `[Streaming]DetectIntentResponse.query_result`." }, "responseId": { - "description": "The unique identifier of the response. Contains the same value as\n`[Streaming]DetectIntentResponse.response_id`.", + "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.\nCan be used to identify end-user inside webhook implementation.\nFormat: `projects//agent/sessions/`, or\n`projects//agent/environments//users//sessions/`.", + "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" } }, "type": "object" }, "GoogleCloudDialogflowV2beta1WebhookResponse": { - "description": "The response message for a webhook call.\n\nThis response is validated by the Dialogflow server. If validation fails,\nan error will be returned in the QueryResult.diagnostic_info field.\nSetting JSON fields to an empty value with the wrong type is a common error.\nTo avoid this error:\n\n- Use `\"\"` for empty strings\n- Use `{}` or `null` for empty objects\n- Use `[]` or `null` for empty arrays\n\nFor more information, see the\n[Protocol Buffers Language\nGuide](https://developers.google.com/protocol-buffers/docs/proto3#json).", + "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": "GoogleCloudDialogflowV2beta1WebhookResponse", "properties": { "endInteraction": { - "description": "Optional. Indicates that this intent ends an interaction. Some integrations\n(e.g., Actions on Google or Dialogflow phone gateway) use this information\nto close interaction with an end user. Default is false.", + "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" }, "followupEventInput": { "$ref": "GoogleCloudDialogflowV2beta1EventInput", - "description": "Optional. Invokes the supplied events.\nWhen this field is set, Dialogflow ignores the `fulfillment_text`,\n`fulfillment_messages`, and `payload` fields." + "description": "Optional. Invokes the supplied events. When this field is set, Dialogflow ignores the `fulfillment_text`, `fulfillment_messages`, and `payload` fields." }, "fulfillmentMessages": { - "description": "Optional. The rich response messages intended for the end-user.\nWhen provided, Dialogflow uses this field to populate\nQueryResult.fulfillment_messages sent to the integration or API caller.", + "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.", "items": { "$ref": "GoogleCloudDialogflowV2beta1IntentMessage" }, "type": "array" }, "fulfillmentText": { - "description": "Optional. The text response message intended for the end-user.\nIt is recommended to use `fulfillment_messages.text.text[0]` instead.\nWhen provided, Dialogflow uses this field to populate\nQueryResult.fulfillment_text sent to the integration or API caller.", + "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.", "type": "string" }, "outputContexts": { - "description": "Optional. The collection of output contexts that will overwrite currently\nactive contexts for the session and reset their lifespans.\nWhen provided, Dialogflow uses this field to populate\nQueryResult.output_contexts sent to the integration or API caller.", + "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": "GoogleCloudDialogflowV2beta1Context" }, @@ -9193,18 +9273,18 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. This field can be used to pass custom data from your webhook to the\nintegration or API caller. Arbitrary JSON objects are supported.\nWhen provided, Dialogflow uses this field to populate\nQueryResult.webhook_payload sent to the integration or API caller.\nThis field is also used by the\n[Google Assistant\nintegration](https://cloud.google.com/dialogflow/docs/integrations/aog)\nfor rich response messages.\nSee the format definition at [Google Assistant Dialogflow webhook\nformat](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)", + "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" }, "sessionEntityTypes": { - "description": "Optional. Additional session entity types to replace or extend developer\nentity types with. The entity synonyms apply to all languages and persist\nfor the session. Setting this data from a webhook overwrites\nthe session entity types that have been set using `detectIntent`,\n`streamingDetectIntent` or SessionEntityType management methods.", + "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": { - "description": "Optional. A custom field used to identify the webhook source.\nArbitrary strings are supported.\nWhen provided, Dialogflow uses this field to populate\nQueryResult.webhook_source sent to the integration or API caller.", + "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" } }, @@ -9220,7 +9300,7 @@ "type": "string" }, "agentUri": { - "description": "The URI to a file containing the exported agent. This field is populated\nonly if `agent_uri` is specified in ExportAgentRequest.", + "description": "The URI to a file containing the exported agent. This field is populated only if `agent_uri` is specified in ExportAgentRequest.", "type": "string" } }, @@ -9245,11 +9325,11 @@ "type": "object" }, "GoogleLongrunningOperation": { - "description": "This resource represents a long-running operation that is the result of a\nnetwork API call.", + "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "GoogleLongrunningOperation", "properties": { "done": { - "description": "If the value is `false`, it means the operation is still in progress.\nIf `true`, the operation is completed, and either `error` or `response` is\navailable.", + "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.", "type": "boolean" }, "error": { @@ -9261,11 +9341,11 @@ "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, - "description": "Service-specific metadata associated with the operation. It typically\ncontains progress information and common metadata such as create time.\nSome services might not provide such metadata. Any method that returns a\nlong-running operation should document the metadata type, if any.", + "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" }, "name": { - "description": "The server-assigned name, which is only unique within the same service that\noriginally returns it. If you use the default HTTP mapping, the\n`name` should be a resource name ending with `operations/{unique_id}`.", + "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" }, "response": { @@ -9273,20 +9353,20 @@ "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, - "description": "The normal response of the operation in case of success. If the original\nmethod returns no data on success, such as `Delete`, the response is\n`google.protobuf.Empty`. If the original method is standard\n`Get`/`Create`/`Update`, the response should be the resource. For other\nmethods, the response should have the type `XxxResponse`, where `Xxx`\nis the original method name. For example, if the original method name\nis `TakeSnapshot()`, the inferred response type is\n`TakeSnapshotResponse`.", + "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`.", "type": "object" } }, "type": "object" }, "GoogleProtobufEmpty": { - "description": "A generic empty message that you can re-use to avoid defining duplicated\nempty messages in your APIs. A typical example is to use it as the request\nor the response type of an API method. For instance:\n\n service Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.", + "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 `{}`.", "id": "GoogleProtobufEmpty", "properties": {}, "type": "object" }, "GoogleRpcStatus": { - "description": "The `Status` type defines a logical error model that is suitable for\ndifferent programming environments, including REST APIs and RPC APIs. It is\nused by [gRPC](https://github.com/grpc). Each `Status` message contains\nthree pieces of data: error code, error message, and error details.\n\nYou can find out more about this error model and how to work with it in the\n[API Design Guide](https://cloud.google.com/apis/design/errors).", + "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).", "id": "GoogleRpcStatus", "properties": { "code": { @@ -9295,7 +9375,7 @@ "type": "integer" }, "details": { - "description": "A list of messages that carry the error details. There is a common set of\nmessage types for APIs to use.", + "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", "items": { "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", @@ -9306,14 +9386,14 @@ "type": "array" }, "message": { - "description": "A developer-facing error message, which should be in English. Any\nuser-facing error message should be localized and sent in the\ngoogle.rpc.Status.details field, or localized by the client.", + "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" } }, "type": "object" }, "GoogleTypeLatLng": { - "description": "An object representing a latitude/longitude pair. This is expressed as a pair\nof doubles representing degrees latitude and degrees longitude. Unless\nspecified otherwise, this must conform to the\nWGS84\nstandard. Values must be within normalized ranges.", + "description": "An object representing a latitude/longitude pair. This is expressed as a pair of doubles representing degrees latitude and degrees longitude. Unless specified otherwise, this must conform to the WGS84 standard. Values must be within normalized ranges.", "id": "GoogleTypeLatLng", "properties": { "latitude": { diff --git a/src/apis/dialogflow/v2.ts b/src/apis/dialogflow/v2.ts index 31cd390ad6..34182b224c 100644 --- a/src/apis/dialogflow/v2.ts +++ b/src/apis/dialogflow/v2.ts @@ -145,7 +145,7 @@ export namespace dialogflow_v2 { */ export interface Schema$GoogleCloudDialogflowCxV3beta1PageInfo { /** - * Always present for WebhookRequest. Ignored for WebhookResponse. The unique identifier of the current page. Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>/pages/<Page ID>`. + * Always present for WebhookRequest. Ignored for WebhookResponse. The unique identifier of the current page. Format: `projects//locations//agents//flows//pages/`. */ currentPage?: string | null; /** @@ -188,7 +188,7 @@ export namespace dialogflow_v2 { value?: any | null; } /** - * 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. + * 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. */ export interface Schema$GoogleCloudDialogflowCxV3beta1ResponseMessage { /** @@ -229,7 +229,7 @@ export namespace dialogflow_v2 { text?: Schema$GoogleCloudDialogflowCxV3beta1ResponseMessageText; } /** - * 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. + * 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. */ export interface Schema$GoogleCloudDialogflowCxV3beta1ResponseMessageConversationSuccess { /** @@ -242,7 +242,7 @@ export namespace dialogflow_v2 { */ export interface Schema$GoogleCloudDialogflowCxV3beta1ResponseMessageEndInteraction {} /** - * Indicates that the conversation should be handed off to a human 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. + * Indicates that the conversation should be handed off to a human 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. */ export interface Schema$GoogleCloudDialogflowCxV3beta1ResponseMessageHumanAgentHandoff { /** @@ -251,7 +251,7 @@ export namespace dialogflow_v2 { metadata?: {[key: string]: any} | null; } /** - * 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. + * 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. */ export interface Schema$GoogleCloudDialogflowCxV3beta1ResponseMessageLiveAgentHandoff { /** @@ -333,7 +333,7 @@ export namespace dialogflow_v2 { */ parameters?: {[key: string]: any} | null; /** - * 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/<Project ID>/locations/<Location ID>/agents/<Agent ID>/sessions/<Session ID>`. + * 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/`. */ session?: string | null; } @@ -384,7 +384,7 @@ export namespace dialogflow_v2 { */ export interface Schema$GoogleCloudDialogflowCxV3beta1WebhookRequestIntentInfo { /** - * Always present. The unique identifier of the last matched intent. Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/intents/<Intent ID>`. + * Always present. The unique identifier of the last matched intent. Format: `projects//locations//agents//intents/`. */ lastMatchedIntent?: string | null; /** @@ -430,11 +430,11 @@ export namespace dialogflow_v2 { */ sessionInfo?: Schema$GoogleCloudDialogflowCxV3beta1SessionInfo; /** - * The target flow to transition to. Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>`. + * The target flow to transition to. Format: `projects//locations//agents//flows/`. */ targetFlow?: string | null; /** - * The target page to transition to. Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>/pages/<Page ID>`. + * The target page to transition to. Format: `projects//locations//agents//flows//pages/`. */ targetPage?: string | null; } @@ -452,7 +452,7 @@ export namespace dialogflow_v2 { messages?: Schema$GoogleCloudDialogflowCxV3beta1ResponseMessage[]; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2Agent { /** @@ -488,7 +488,7 @@ export namespace dialogflow_v2 { */ matchMode?: string | null; /** - * Required. The project of this agent. Format: `projects/<Project ID>`. + * Required. The project of this agent. Format: `projects/`. */ parent?: string | null; /** @@ -513,7 +513,7 @@ export namespace dialogflow_v2 { */ entityType?: string | null; /** - * 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: <pre> { "amount": 5, "currency": "USD" } </pre> + * 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" } */ formattedValue?: any | null; /** @@ -539,7 +539,7 @@ export namespace dialogflow_v2 { */ export interface Schema$GoogleCloudDialogflowV2BatchDeleteEntitiesRequest { /** - * 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/<Project ID>`. + * 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/`. */ entityValues?: string[] | null; /** @@ -668,7 +668,7 @@ export namespace dialogflow_v2 { */ exampleCount?: string | null; /** - * Output only. AnnotatedConversationDataset resource name. Format: `projects/<Project ID>/conversationDatasets/<Conversation Dataset ID>/annotatedConversationDatasets/<Annotated Conversation Dataset ID>` + * Output only. AnnotatedConversationDataset resource name. Format: `projects//conversationDatasets//annotatedConversationDatasets/` */ name?: string | null; /** @@ -712,7 +712,7 @@ export namespace dialogflow_v2 { intents?: Schema$GoogleCloudDialogflowV2beta1Intent[]; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2beta1Context { /** @@ -720,16 +720,16 @@ export namespace dialogflow_v2 { */ lifespanCount?: number | null; /** - * Required. The unique identifier of the context. Format: `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID>`, or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session ID>/contexts/<Context ID>`. 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. 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` */ name?: string | null; /** - * 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 + * 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 */ parameters?: {[key: string]: any} | null; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2beta1EntityType { /** @@ -753,7 +753,7 @@ export namespace dialogflow_v2 { */ kind?: string | null; /** - * The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`. + * The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`. */ name?: string | null; } @@ -762,16 +762,16 @@ export namespace dialogflow_v2 { */ export interface Schema$GoogleCloudDialogflowV2beta1EntityTypeEntity { /** - * 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`. + * 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`. */ synonyms?: string[] | null; /** - * 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). + * 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). */ value?: string | null; } /** - * Events allow for matching intents by event name instead of the natural language input. For instance, input `<event: { name: "welcome_event", parameters: { name: "Sam" } }>` 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?"`. + * 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?"`. */ export interface Schema$GoogleCloudDialogflowV2beta1EventInput { /** @@ -783,7 +783,7 @@ export namespace dialogflow_v2 { */ name?: string | null; /** - * 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 + * 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 */ parameters?: {[key: string]: any} | null; } @@ -801,7 +801,7 @@ export namespace dialogflow_v2 { agentUri?: string | null; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2beta1Intent { /** @@ -829,7 +829,7 @@ export namespace dialogflow_v2 { */ followupIntentInfo?: Schema$GoogleCloudDialogflowV2beta1IntentFollowupIntentInfo[]; /** - * Optional. The list of context names required for this intent to be triggered. Format: `projects/<Project ID>/agent/sessions/-/contexts/<Context ID>`. + * Optional. The list of context names required for this intent to be triggered. Format: `projects//agent/sessions/-/contexts/`. */ inputContextNames?: string[] | null; /** @@ -845,15 +845,15 @@ export namespace dialogflow_v2 { */ mlDisabled?: boolean | null; /** - * 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. + * 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. */ mlEnabled?: boolean | null; /** - * Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects/<Project ID>/agent/intents/<Intent ID>`. + * Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`. */ name?: string | null; /** - * 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/<Project ID>/agent/sessions/-/contexts/<Context ID>`. + * 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/`. */ outputContexts?: Schema$GoogleCloudDialogflowV2beta1Context[]; /** @@ -861,11 +861,11 @@ export namespace dialogflow_v2 { */ parameters?: Schema$GoogleCloudDialogflowV2beta1IntentParameter[]; /** - * 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/<Project ID>/agent/intents/<Intent ID>`. + * 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/`. */ parentFollowupIntentName?: string | null; /** - * 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. + * 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. */ priority?: number | null; /** @@ -873,7 +873,7 @@ export namespace dialogflow_v2 { */ resetContexts?: boolean | null; /** - * 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/<Project ID>/agent/intents/<Intent ID>`. + * 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/`. */ rootFollowupIntentName?: string | null; /** @@ -890,11 +890,11 @@ export namespace dialogflow_v2 { */ export interface Schema$GoogleCloudDialogflowV2beta1IntentFollowupIntentInfo { /** - * The unique identifier of the followup intent. Format: `projects/<Project ID>/agent/intents/<Intent ID>`. + * The unique identifier of the followup intent. Format: `projects//agent/intents/`. */ followupIntentName?: string | null; /** - * The unique identifier of the followup intent's parent. Format: `projects/<Project ID>/agent/intents/<Intent ID>`. + * The unique identifier of the followup intent's parent. Format: `projects//agent/intents/`. */ parentFollowupIntentName?: string | null; } @@ -955,7 +955,7 @@ export namespace dialogflow_v2 { */ rbmStandaloneRichCard?: Schema$GoogleCloudDialogflowV2beta1IntentMessageRbmStandaloneCard; /** - * Rich Business Messaging (RBM) text response. RBM allows businesses to send enriched and branded versions of SMS. See https://jibe.google.com/business-messaging. + * Rich Business Messaging (RBM) text response. RBM allows businesses to send enriched and branded versions of SMS. See https://jibe.google.com/business-messaging. */ rbmText?: Schema$GoogleCloudDialogflowV2beta1IntentMessageRbmText; /** @@ -1282,7 +1282,7 @@ export namespace dialogflow_v2 { */ export interface Schema$GoogleCloudDialogflowV2beta1IntentMessageRbmCardContent { /** - * Optional. Description of the card (at most 2000 bytes). At least one of the title, description or media must be set. + * Optional. Description of the card (at most 2000 bytes). At least one of the title, description or media must be set. */ description?: string | null; /** @@ -1294,12 +1294,12 @@ export namespace dialogflow_v2 { */ suggestions?: Schema$GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestion[]; /** - * Optional. Title of the card (at most 200 bytes). At least one of the title, description or media must be set. + * Optional. Title of the card (at most 200 bytes). At least one of the title, description or media must be set. */ title?: string | null; } /** - * 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 + * 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 */ export interface Schema$GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia { /** @@ -1316,7 +1316,7 @@ export namespace dialogflow_v2 { thumbnailUri?: string | null; } /** - * 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. + * 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. */ export interface Schema$GoogleCloudDialogflowV2beta1IntentMessageRbmCarouselCard { /** @@ -1329,7 +1329,7 @@ export namespace dialogflow_v2 { cardWidth?: string | null; } /** - * 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. + * 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. */ export interface Schema$GoogleCloudDialogflowV2beta1IntentMessageRbmStandaloneCard { /** @@ -1544,12 +1544,12 @@ export namespace dialogflow_v2 { */ export interface Schema$GoogleCloudDialogflowV2beta1IntentMessageTelephonyPlayAudio { /** - * 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 `service-<Project Number>@gcp-sa-dialogflow.iam.gserviceaccount.com` service account where <Project Number> 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. + * 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 `service-@gcp-sa-dialogflow.iam.gserviceaccount.com` 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. */ audioUri?: string | null; } /** - * 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. + * 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. */ export interface Schema$GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech { /** @@ -1566,7 +1566,7 @@ export namespace dialogflow_v2 { */ export interface Schema$GoogleCloudDialogflowV2beta1IntentMessageTelephonyTransferCall { /** - * 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). + * 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). */ phoneNumber?: string | null; } @@ -1612,7 +1612,7 @@ export namespace dialogflow_v2 { */ prompts?: string[] | null; /** - * 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`. + * 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`. */ value?: string | null; } @@ -1625,7 +1625,7 @@ export namespace dialogflow_v2 { */ name?: string | null; /** - * 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. + * 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. */ parts?: Schema$GoogleCloudDialogflowV2beta1IntentTrainingPhrasePart[]; /** @@ -1684,11 +1684,11 @@ export namespace dialogflow_v2 { */ matchConfidence?: number | null; /** - * The system's confidence level that this knowledge answer is a good match for this conversational query. NOTE: The confidence level for a given `<query, answer>` 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. + * 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. */ matchConfidenceLevel?: string | null; /** - * Indicates which Knowledge Document this answer was extracted from. Format: `projects/<Project ID>/knowledgeBases/<Knowledge Base ID>/documents/<Document ID>`. + * Indicates which Knowledge Document this answer was extracted from. Format: `projects//knowledgeBases//documents/`. */ source?: string | null; } @@ -1715,7 +1715,7 @@ export namespace dialogflow_v2 { */ export interface Schema$GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest { /** - * 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: <pre>{ "telephony": { "caller_id": "+18558363987" } }</pre> Note: The caller ID field (`caller_id`) will be redacted for Standard Edition agents and populated with the caller ID in [E.164 format](https://en.wikipedia.org/wiki/E.164) for Enterprise Edition agents. + * 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 Standard Edition agents and populated with the caller ID in [E.164 format](https://en.wikipedia.org/wiki/E.164) for Enterprise Edition agents. */ payload?: {[key: string]: any} | null; /** @@ -1736,11 +1736,11 @@ export namespace dialogflow_v2 { */ action?: string | null; /** - * 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. + * 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. */ allRequiredParamsPresent?: boolean | null; /** - * 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 + * 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 */ diagnosticInfo?: {[key: string]: any} | null; /** @@ -1768,15 +1768,15 @@ export namespace dialogflow_v2 { */ languageCode?: string | null; /** - * The collection of output contexts. If applicable, `output_contexts.parameters` contains entries with name `<parameter name>.original` containing the original parameter values before the query. + * The collection of output contexts. If applicable, `output_contexts.parameters` contains entries with name `.original` containing the original parameter values before the query. */ outputContexts?: Schema$GoogleCloudDialogflowV2beta1Context[]; /** - * 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 + * 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 */ parameters?: {[key: string]: any} | null; /** - * 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. + * 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. */ queryText?: string | null; /** @@ -1784,7 +1784,7 @@ export namespace dialogflow_v2 { */ sentimentAnalysisResult?: Schema$GoogleCloudDialogflowV2beta1SentimentAnalysisResult; /** - * 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. + * 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. */ speechRecognitionConfidence?: number | null; /** @@ -1819,7 +1819,7 @@ export namespace dialogflow_v2 { queryTextSentiment?: Schema$GoogleCloudDialogflowV2beta1Sentiment; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2beta1SessionEntityType { /** @@ -1831,7 +1831,7 @@ export namespace dialogflow_v2 { */ entityOverrideMode?: string | null; /** - * Required. The unique identifier of this session entity type. Format: `projects/<Project ID>/agent/sessions/<Session ID>/entityTypes/<Entity Type Display Name>`, or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session ID>/entityTypes/<Entity Type Display Name>`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. `<Entity Type Display Name>` must be the display name of an existing entity type in the same agent that will be overridden or supplemented. + * 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. */ name?: string | null; } @@ -1856,12 +1856,12 @@ export namespace dialogflow_v2 { */ responseId?: string | null; /** - * The unique identifier of detectIntent request session. Can be used to identify end-user inside webhook implementation. Format: `projects/<Project ID>/agent/sessions/<Session ID>`, or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session ID>`. + * 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/`. */ session?: string | null; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2beta1WebhookResponse { /** @@ -1898,7 +1898,7 @@ export namespace dialogflow_v2 { source?: string | null; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2Context { /** @@ -1906,11 +1906,11 @@ export namespace dialogflow_v2 { */ lifespanCount?: number | null; /** - * Required. The unique identifier of the context. Format: `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID>`, or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session ID>/contexts/<Context ID>`. 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. 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` */ name?: string | null; /** - * 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 + * 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 */ parameters?: {[key: string]: any} | null; } @@ -1919,7 +1919,7 @@ export namespace dialogflow_v2 { */ export interface Schema$GoogleCloudDialogflowV2ConversationEvent { /** - * The unique identifier of the conversation this notification refers to. Format: `projects/<Project ID>/conversations/<Conversation ID>`. + * The unique identifier of the conversation this notification refers to. Format: `projects//conversations/`. */ conversation?: string | null; /** @@ -1948,11 +1948,11 @@ export namespace dialogflow_v2 { */ outputAudioConfig?: Schema$GoogleCloudDialogflowV2OutputAudioConfig; /** - * 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. + * 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. */ outputAudioConfigMask?: string | null; /** - * 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. + * 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. */ queryInput?: Schema$GoogleCloudDialogflowV2QueryInput; /** @@ -1965,7 +1965,7 @@ export namespace dialogflow_v2 { */ export interface Schema$GoogleCloudDialogflowV2DetectIntentResponse { /** - * 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. + * 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. */ outputAudio?: string | null; /** @@ -1986,7 +1986,7 @@ export namespace dialogflow_v2 { webhookStatus?: Schema$GoogleRpcStatus; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2EntityType { /** @@ -2010,7 +2010,7 @@ export namespace dialogflow_v2 { */ kind?: string | null; /** - * The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`. + * The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`. */ name?: string | null; } @@ -2028,20 +2028,20 @@ export namespace dialogflow_v2 { */ export interface Schema$GoogleCloudDialogflowV2EntityTypeEntity { /** - * 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`. + * 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`. */ synonyms?: string[] | null; /** - * 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). + * 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). */ value?: string | null; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2Environment { /** - * Optional. The agent version loaded into this environment. Format: `projects/<Project ID>/agent/versions/<Version ID>`. + * Optional. The agent version loaded into this environment. Format: `projects//agent/versions/`. */ agentVersion?: string | null; /** @@ -2049,7 +2049,7 @@ export namespace dialogflow_v2 { */ description?: string | null; /** - * Output only. The unique identifier of this agent environment. Format: `projects/<Project ID>/agent/environments/<Environment ID>`. For Environment ID, "-" is reserved for 'draft' environment. + * Output only. The unique identifier of this agent environment. Format: `projects//agent/environments/`. For Environment ID, "-" is reserved for 'draft' environment. */ name?: string | null; /** @@ -2062,7 +2062,7 @@ export namespace dialogflow_v2 { updateTime?: string | null; } /** - * Events allow for matching intents by event name instead of the natural language input. For instance, input `<event: { name: "welcome_event", parameters: { name: "Sam" } }>` 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?"`. + * 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?"`. */ export interface Schema$GoogleCloudDialogflowV2EventInput { /** @@ -2074,7 +2074,7 @@ export namespace dialogflow_v2 { */ name?: string | null; /** - * 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 + * 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 */ parameters?: {[key: string]: any} | null; } @@ -2083,7 +2083,7 @@ export namespace dialogflow_v2 { */ export interface Schema$GoogleCloudDialogflowV2ExportAgentRequest { /** - * Required. The [Google Cloud Storage](https://cloud.google.com/storage/docs/) URI to export the agent to. The format of this URI must be `gs://<bucket-name>/<object-name>`. If left unspecified, the serialized agent is returned inline. + * Required. 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. */ agentUri?: string | null; } @@ -2101,7 +2101,7 @@ export namespace dialogflow_v2 { agentUri?: string | null; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2Fulfillment { /** @@ -2121,7 +2121,7 @@ export namespace dialogflow_v2 { */ genericWebService?: Schema$GoogleCloudDialogflowV2FulfillmentGenericWebService; /** - * Required. The unique identifier of the fulfillment. Format: `projects/<Project ID>/agent/fulfillment`. + * Required. The unique identifier of the fulfillment. Format: `projects//agent/fulfillment`. */ name?: string | null; } @@ -2197,7 +2197,7 @@ export namespace dialogflow_v2 { */ modelVariant?: string | null; /** - * 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](). + * 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](). */ phraseHints?: string[] | null; /** @@ -2209,12 +2209,12 @@ export namespace dialogflow_v2 { */ singleUtterance?: boolean | null; /** - * 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. + * 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. */ speechContexts?: Schema$GoogleCloudDialogflowV2SpeechContext[]; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2Intent { /** @@ -2238,7 +2238,7 @@ export namespace dialogflow_v2 { */ followupIntentInfo?: Schema$GoogleCloudDialogflowV2IntentFollowupIntentInfo[]; /** - * Optional. The list of context names required for this intent to be triggered. Format: `projects/<Project ID>/agent/sessions/-/contexts/<Context ID>`. + * Optional. The list of context names required for this intent to be triggered. Format: `projects//agent/sessions/-/contexts/`. */ inputContextNames?: string[] | null; /** @@ -2254,11 +2254,11 @@ export namespace dialogflow_v2 { */ mlDisabled?: boolean | null; /** - * Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects/<Project ID>/agent/intents/<Intent ID>`. + * Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`. */ name?: string | null; /** - * 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/<Project ID>/agent/sessions/-/contexts/<Context ID>`. + * 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/`. */ outputContexts?: Schema$GoogleCloudDialogflowV2Context[]; /** @@ -2266,11 +2266,11 @@ export namespace dialogflow_v2 { */ parameters?: Schema$GoogleCloudDialogflowV2IntentParameter[]; /** - * 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/<Project ID>/agent/intents/<Intent ID>`. + * 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/`. */ parentFollowupIntentName?: string | null; /** - * 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. + * 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. */ priority?: number | null; /** @@ -2278,7 +2278,7 @@ export namespace dialogflow_v2 { */ resetContexts?: boolean | null; /** - * 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/<Project ID>/agent/intents/<Intent ID>`. + * 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/`. */ rootFollowupIntentName?: string | null; /** @@ -2304,11 +2304,11 @@ export namespace dialogflow_v2 { */ export interface Schema$GoogleCloudDialogflowV2IntentFollowupIntentInfo { /** - * The unique identifier of the followup intent. Format: `projects/<Project ID>/agent/intents/<Intent ID>`. + * The unique identifier of the followup intent. Format: `projects//agent/intents/`. */ followupIntentName?: string | null; /** - * The unique identifier of the followup intent's parent. Format: `projects/<Project ID>/agent/intents/<Intent ID>`. + * The unique identifier of the followup intent's parent. Format: `projects//agent/intents/`. */ parentFollowupIntentName?: string | null; } @@ -2817,7 +2817,7 @@ export namespace dialogflow_v2 { */ prompts?: string[] | null; /** - * 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`. + * 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`. */ value?: string | null; } @@ -2830,7 +2830,7 @@ export namespace dialogflow_v2 { */ name?: string | null; /** - * 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. + * 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. */ parts?: Schema$GoogleCloudDialogflowV2IntentTrainingPhrasePart[]; /** @@ -2949,7 +2949,7 @@ export namespace dialogflow_v2 { */ messageAnnotation?: Schema$GoogleCloudDialogflowV2MessageAnnotation; /** - * The unique identifier of the message. Format: `projects/<Project ID>/conversations/<Conversation ID>/messages/<Message ID>`. + * The unique identifier of the message. Format: `projects//conversations//messages/`. */ name?: string | null; /** @@ -2979,7 +2979,7 @@ export namespace dialogflow_v2 { */ export interface Schema$GoogleCloudDialogflowV2OriginalDetectIntentRequest { /** - * 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: <pre>{ "telephony": { "caller_id": "+18558363987" } }</pre> Note: The caller ID field (`caller_id`) will be redacted for Standard Edition agents and populated with the caller ID in [E.164 format](https://en.wikipedia.org/wiki/E.164) for Enterprise Edition agents. + * 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 Standard Edition agents and populated with the caller ID in [E.164 format](https://en.wikipedia.org/wiki/E.164) for Enterprise Edition agents. */ payload?: {[key: string]: any} | null; /** @@ -3009,7 +3009,7 @@ export namespace dialogflow_v2 { synthesizeSpeechConfig?: Schema$GoogleCloudDialogflowV2SynthesizeSpeechConfig; } /** - * 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. + * 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. */ export interface Schema$GoogleCloudDialogflowV2QueryInput { /** @@ -3067,11 +3067,11 @@ export namespace dialogflow_v2 { */ action?: string | null; /** - * 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. + * 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. */ allRequiredParamsPresent?: boolean | null; /** - * 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 + * 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 */ diagnosticInfo?: {[key: string]: any} | null; /** @@ -3095,15 +3095,15 @@ export namespace dialogflow_v2 { */ languageCode?: string | null; /** - * The collection of output contexts. If applicable, `output_contexts.parameters` contains entries with name `<parameter name>.original` containing the original parameter values before the query. + * The collection of output contexts. If applicable, `output_contexts.parameters` contains entries with name `.original` containing the original parameter values before the query. */ outputContexts?: Schema$GoogleCloudDialogflowV2Context[]; /** - * 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 + * 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 */ parameters?: {[key: string]: any} | null; /** - * 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. + * 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. */ queryText?: string | null; /** @@ -3111,7 +3111,7 @@ export namespace dialogflow_v2 { */ sentimentAnalysisResult?: Schema$GoogleCloudDialogflowV2SentimentAnalysisResult; /** - * 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. + * 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. */ speechRecognitionConfidence?: number | null; /** @@ -3181,7 +3181,7 @@ export namespace dialogflow_v2 { queryTextSentiment?: Schema$GoogleCloudDialogflowV2Sentiment; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2SessionEntityType { /** @@ -3193,7 +3193,7 @@ export namespace dialogflow_v2 { */ entityOverrideMode?: string | null; /** - * Required. The unique identifier of this session entity type. Format: `projects/<Project ID>/agent/sessions/<Session ID>/entityTypes/<Entity Type Display Name>`, or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session ID>/entityTypes/<Entity Type Display Name>`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. `<Entity Type Display Name>` must be the display name of an existing entity type in the same agent that will be overridden or supplemented. + * 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. */ name?: string | null; } @@ -3202,11 +3202,11 @@ export namespace dialogflow_v2 { */ export interface Schema$GoogleCloudDialogflowV2SpeechContext { /** - * 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. + * 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. */ boost?: number | null; /** - * 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. + * 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. */ phrases?: string[] | null; } @@ -3257,7 +3257,7 @@ export namespace dialogflow_v2 { */ export interface Schema$GoogleCloudDialogflowV2ValidationError { /** - * The names of the entries that the error is associated with. Format: - "projects/<Project ID>/agent", if the error is associated with the entire agent. - "projects/<Project ID>/agent/intents/<Intent ID>", if the error is associated with certain intents. - "projects/<Project ID>/agent/intents/<Intent Id>/trainingPhrases/<Training Phrase ID>", if the error is associated with certain intent training phrases. - "projects/<Project ID>/agent/intents/<Intent Id>/parameters/<Parameter ID>", if the error is associated with certain intent parameters. - "projects/<Project ID>/agent/entities/<Entity ID>", if the error is associated with certain entities. + * 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. */ entries?: string[] | null; /** @@ -3308,12 +3308,12 @@ export namespace dialogflow_v2 { */ responseId?: string | null; /** - * The unique identifier of detectIntent request session. Can be used to identify end-user inside webhook implementation. Format: `projects/<Project ID>/agent/sessions/<Session ID>`, or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session ID>`. + * 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/`. */ session?: string | null; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2WebhookResponse { /** @@ -3384,7 +3384,7 @@ export namespace dialogflow_v2 { */ error?: Schema$GoogleRpcStatus; /** - * 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. + * 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. */ metadata?: {[key: string]: any} | null; /** @@ -3392,16 +3392,16 @@ export namespace dialogflow_v2 { */ name?: string | null; /** - * 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`. + * 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`. */ response?: {[key: string]: any} | null; } /** - * 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 `{}`. + * 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 `{}`. */ export interface Schema$GoogleProtobufEmpty {} /** - * 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). + * 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). */ export interface Schema$GoogleRpcStatus { /** @@ -3409,7 +3409,7 @@ export namespace dialogflow_v2 { */ code?: number | null; /** - * A list of messages that carry the error details. There is a common set of message types for APIs to use. + * A list of messages that carry the error details. There is a common set of message types for APIs to use. */ details?: Array<{[key: string]: any}> | null; /** @@ -3418,7 +3418,7 @@ export namespace dialogflow_v2 { message?: string | null; } /** - * An object representing a latitude/longitude pair. This is expressed as a pair of doubles representing degrees latitude and degrees longitude. Unless specified otherwise, this must conform to the <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84 standard</a>. Values must be within normalized ranges. + * An object representing a latitude/longitude pair. This is expressed as a pair of doubles representing degrees latitude and degrees longitude. Unless specified otherwise, this must conform to the WGS84 standard. Values must be within normalized ranges. */ export interface Schema$GoogleTypeLatLng { /** @@ -3473,8 +3473,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.deleteAgent({ - * // Required. The project that the agent to delete is associated with. - * // Format: `projects/`. + * // Required. The project that the agent to delete is associated with. Format: `projects/`. * parent: 'projects/my-project', * }); * console.log(res.data); @@ -3492,7 +3491,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project that the agent to delete is associated with. Format: `projects/`. + * @param {string} params.parent Required. The project that the agent to delete is associated with. Format: `projects/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -3611,8 +3610,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.getAgent({ - * // Required. The project that the agent to fetch is associated with. - * // Format: `projects/`. + * // Required. The project that the agent to fetch is associated with. Format: `projects/`. * parent: 'projects/my-project', * }); * console.log(res.data); @@ -3643,7 +3641,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project that the agent to fetch is associated with. Format: `projects/`. + * @param {string} params.parent Required. The project that the agent to fetch is associated with. Format: `projects/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -3766,8 +3764,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.setAgent({ - * // Required. The project of this agent. - * // Format: `projects/`. + * // Required. The project of this agent. Format: `projects/`. * parent: 'projects/my-project', * // Optional. The mask to control which fields get updated. * updateMask: 'placeholder-value', @@ -3819,7 +3816,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project of this agent. Format: `projects/`. + * @param {string} params.parent Required. The project of this agent. Format: `projects/`. * @param {string=} params.updateMask Optional. The mask to control which fields get updated. * @param {().GoogleCloudDialogflowV2Agent} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -3918,21 +3915,21 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Deleteagent extends StandardParameters { /** - * Required. The project that the agent to delete is associated with. Format: `projects/`. + * Required. The project that the agent to delete is associated with. Format: `projects/`. */ parent?: string; } export interface Params$Resource$Projects$Getagent extends StandardParameters { /** - * Required. The project that the agent to fetch is associated with. Format: `projects/`. + * Required. The project that the agent to fetch is associated with. Format: `projects/`. */ parent?: string; } export interface Params$Resource$Projects$Setagent extends StandardParameters { /** - * Required. The project of this agent. Format: `projects/`. + * Required. The project of this agent. Format: `projects/`. */ parent?: string; /** @@ -3964,7 +3961,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.export - * @desc Exports the specified agent to a ZIP file. Operation + * @desc Exports the specified agent to a ZIP file. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -3992,8 +3989,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.export({ - * // Required. The project that the agent to export is associated with. - * // Format: `projects/`. + * // Required. The project that the agent to export is associated with. Format: `projects/`. * parent: 'projects/my-project', * * // Request body metadata @@ -4025,7 +4021,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project that the agent to export is associated with. Format: `projects/`. + * @param {string} params.parent Required. The project that the agent to export is associated with. Format: `projects/`. * @param {().GoogleCloudDialogflowV2ExportAgentRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -4147,8 +4143,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.getFulfillment({ - * // Required. The name of the fulfillment. - * // Format: `projects//agent/fulfillment`. + * // Required. The name of the fulfillment. Format: `projects//agent/fulfillment`. * name: 'projects/my-project/agent/fulfillment', * }); * console.log(res.data); @@ -4172,7 +4167,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the fulfillment. Format: `projects//agent/fulfillment`. + * @param {string} params.name Required. The name of the fulfillment. Format: `projects//agent/fulfillment`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -4292,14 +4287,9 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.getValidationResult({ - * // 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. + * // 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. * languageCode: 'placeholder-value', - * // Required. The project that the agent is associated with. - * // Format: `projects/`. + * // Required. The project that the agent is associated with. Format: `projects/`. * parent: 'projects/my-project', * }); * console.log(res.data); @@ -4320,7 +4310,7 @@ export namespace dialogflow_v2 { * * @param {object} params Parameters for request * @param {string=} params.languageCode 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. - * @param {string} params.parent Required. The project that the agent is associated with. Format: `projects/`. + * @param {string} params.parent Required. The project that the agent is associated with. Format: `projects/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -4421,7 +4411,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.import - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -4449,8 +4439,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.import({ - * // Required. The project that the agent to import is associated with. - * // Format: `projects/`. + * // Required. The project that the agent to import is associated with. Format: `projects/`. * parent: 'projects/my-project', * * // Request body metadata @@ -4483,7 +4472,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project that the agent to import is associated with. Format: `projects/`. + * @param {string} params.parent Required. The project that the agent to import is associated with. Format: `projects/`. * @param {().GoogleCloudDialogflowV2ImportAgentRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -4577,7 +4566,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.restore - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -4605,8 +4594,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.restore({ - * // Required. The project that the agent to restore is associated with. - * // Format: `projects/`. + * // Required. The project that the agent to restore is associated with. Format: `projects/`. * parent: 'projects/my-project', * * // Request body metadata @@ -4639,7 +4627,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project that the agent to restore is associated with. Format: `projects/`. + * @param {string} params.parent Required. The project that the agent to restore is associated with. Format: `projects/`. * @param {().GoogleCloudDialogflowV2RestoreAgentRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -4733,7 +4721,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.search - * @desc 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). + * @desc 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). * @example * // Before running the sample: * // - Enable the API at: @@ -4761,13 +4749,11 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.search({ - * // Optional. The maximum number of items to return in a single page. By - * // default 100 and at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The project to list agents from. - * // Format: `projects/`. + * // Required. The project to list agents from. Format: `projects/`. * parent: 'projects/my-project', * }); * console.log(res.data); @@ -4790,7 +4776,7 @@ export namespace dialogflow_v2 { * @param {object} params Parameters for request * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The project to list agents from. Format: `projects/`. + * @param {string} params.parent Required. The project to list agents from. Format: `projects/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -4899,7 +4885,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.train - * @desc Trains the specified agent. Operation + * @desc Trains the specified agent. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -4927,8 +4913,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.train({ - * // Required. The project that the agent to train is associated with. - * // Format: `projects/`. + * // Required. The project that the agent to train is associated with. Format: `projects/`. * parent: 'projects/my-project', * * // Request body metadata @@ -4958,7 +4943,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project that the agent to train is associated with. Format: `projects/`. + * @param {string} params.parent Required. The project that the agent to train is associated with. Format: `projects/`. * @param {().GoogleCloudDialogflowV2TrainAgentRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -5080,11 +5065,9 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.updateFulfillment({ - * // Required. The unique identifier of the fulfillment. - * // Format: `projects//agent/fulfillment`. + * // Required. The unique identifier of the fulfillment. Format: `projects//agent/fulfillment`. * name: 'projects/my-project/agent/fulfillment', - * // Required. The mask to control which fields get updated. If the mask is not - * // present, all fields will be updated. + * // Required. The mask to control which fields get updated. If the mask is not present, all fields will be updated. * updateMask: 'placeholder-value', * * // Request body metadata @@ -5120,7 +5103,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The unique identifier of the fulfillment. Format: `projects//agent/fulfillment`. + * @param {string} params.name Required. The unique identifier of the fulfillment. Format: `projects//agent/fulfillment`. * @param {string=} params.updateMask Required. The mask to control which fields get updated. If the mask is not present, all fields will be updated. * @param {().GoogleCloudDialogflowV2Fulfillment} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -5216,7 +5199,7 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Export extends StandardParameters { /** - * Required. The project that the agent to export is associated with. Format: `projects/`. + * Required. The project that the agent to export is associated with. Format: `projects/`. */ parent?: string; @@ -5228,7 +5211,7 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Getfulfillment extends StandardParameters { /** - * Required. The name of the fulfillment. Format: `projects//agent/fulfillment`. + * Required. The name of the fulfillment. Format: `projects//agent/fulfillment`. */ name?: string; } @@ -5239,14 +5222,14 @@ export namespace dialogflow_v2 { */ languageCode?: string; /** - * Required. The project that the agent is associated with. Format: `projects/`. + * Required. The project that the agent is associated with. Format: `projects/`. */ parent?: string; } export interface Params$Resource$Projects$Agent$Import extends StandardParameters { /** - * Required. The project that the agent to import is associated with. Format: `projects/`. + * Required. The project that the agent to import is associated with. Format: `projects/`. */ parent?: string; @@ -5258,7 +5241,7 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Restore extends StandardParameters { /** - * Required. The project that the agent to restore is associated with. Format: `projects/`. + * Required. The project that the agent to restore is associated with. Format: `projects/`. */ parent?: string; @@ -5278,14 +5261,14 @@ export namespace dialogflow_v2 { */ pageToken?: string; /** - * Required. The project to list agents from. Format: `projects/`. + * Required. The project to list agents from. Format: `projects/`. */ parent?: string; } export interface Params$Resource$Projects$Agent$Train extends StandardParameters { /** - * Required. The project that the agent to train is associated with. Format: `projects/`. + * Required. The project that the agent to train is associated with. Format: `projects/`. */ parent?: string; @@ -5297,7 +5280,7 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Updatefulfillment extends StandardParameters { /** - * Required. The unique identifier of the fulfillment. Format: `projects//agent/fulfillment`. + * Required. The unique identifier of the fulfillment. Format: `projects//agent/fulfillment`. */ name?: string; /** @@ -5323,7 +5306,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.entityTypes.batchDelete - * @desc Deletes entity types in the specified agent. Operation + * @desc Deletes entity types in the specified agent. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -5351,8 +5334,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.entityTypes.batchDelete({ - * // Required. The name of the agent to delete all entities types for. Format: - * // `projects//agent`. + * // Required. The name of the agent to delete all entities types for. Format: `projects//agent`. * parent: 'projects/my-project/agent', * * // Request body metadata @@ -5384,7 +5366,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the agent to delete all entities types for. Format: `projects//agent`. + * @param {string} params.parent Required. The name of the agent to delete all entities types for. Format: `projects//agent`. * @param {().GoogleCloudDialogflowV2BatchDeleteEntityTypesRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -5478,7 +5460,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.entityTypes.batchUpdate - * @desc Updates/Creates multiple entity types in the specified agent. Operation + * @desc Updates/Creates multiple entity types in the specified agent. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -5506,8 +5488,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.entityTypes.batchUpdate({ - * // Required. The name of the agent to update or create entity types in. - * // Format: `projects//agent`. + * // Required. The name of the agent to update or create entity types in. Format: `projects//agent`. * parent: 'projects/my-project/agent', * * // Request body metadata @@ -5542,7 +5523,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the agent to update or create entity types in. Format: `projects//agent`. + * @param {string} params.parent Required. The name of the agent to update or create entity types in. Format: `projects//agent`. * @param {().GoogleCloudDialogflowV2BatchUpdateEntityTypesRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -5664,14 +5645,9 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.entityTypes.create({ - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // Required. The agent to create a entity type for. - * // Format: `projects//agent`. + * // Required. The agent to create a entity type for. Format: `projects//agent`. * parent: 'projects/my-project/agent', * * // Request body metadata @@ -5710,7 +5686,7 @@ export namespace dialogflow_v2 { * * @param {object} params Parameters for request * @param {string=} params.languageCode 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). - * @param {string} params.parent Required. The agent to create a entity type for. Format: `projects//agent`. + * @param {string} params.parent Required. The agent to create a entity type for. Format: `projects//agent`. * @param {().GoogleCloudDialogflowV2EntityType} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -5834,8 +5810,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.entityTypes.delete({ - * // Required. The name of the entity type to delete. - * // Format: `projects//agent/entityTypes/`. + * // Required. The name of the entity type to delete. Format: `projects//agent/entityTypes/`. * name: 'projects/my-project/agent/entityTypes/my-entityType', * }); * console.log(res.data); @@ -5853,7 +5828,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the entity type to delete. Format: `projects//agent/entityTypes/`. + * @param {string} params.name Required. The name of the entity type to delete. Format: `projects//agent/entityTypes/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -5967,14 +5942,9 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.entityTypes.get({ - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // Required. The name of the entity type. - * // Format: `projects//agent/entityTypes/`. + * // Required. The name of the entity type. Format: `projects//agent/entityTypes/`. * name: 'projects/my-project/agent/entityTypes/my-entityType', * }); * console.log(res.data); @@ -6000,7 +5970,7 @@ export namespace dialogflow_v2 { * * @param {object} params Parameters for request * @param {string=} params.languageCode 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). - * @param {string} params.name Required. The name of the entity type. Format: `projects//agent/entityTypes/`. + * @param {string} params.name Required. The name of the entity type. Format: `projects//agent/entityTypes/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -6120,19 +6090,13 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.entityTypes.list({ - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // Optional. The maximum number of items to return in a single page. By - * // default 100 and at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The agent to list all entity types from. - * // Format: `projects//agent`. + * // Required. The agent to list all entity types from. Format: `projects//agent`. * parent: 'projects/my-project/agent', * }); * console.log(res.data); @@ -6156,7 +6120,7 @@ export namespace dialogflow_v2 { * @param {string=} params.languageCode 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). * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The agent to list all entity types from. Format: `projects//agent`. + * @param {string} params.parent Required. The agent to list all entity types from. Format: `projects//agent`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -6293,16 +6257,9 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.entityTypes.patch({ - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // The unique identifier of the entity type. - * // Required for EntityTypes.UpdateEntityType and - * // EntityTypes.BatchUpdateEntityTypes methods. - * // Format: `projects//agent/entityTypes/`. + * // The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`. * name: 'projects/my-project/agent/entityTypes/my-entityType', * // Optional. The mask to control which fields get updated. * updateMask: 'placeholder-value', @@ -6343,7 +6300,7 @@ export namespace dialogflow_v2 { * * @param {object} params Parameters for request * @param {string=} params.languageCode 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). - * @param {string} params.name The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`. + * @param {string} params.name The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`. * @param {string=} params.updateMask Optional. The mask to control which fields get updated. * @param {().GoogleCloudDialogflowV2EntityType} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -6439,7 +6396,7 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Entitytypes$Batchdelete extends StandardParameters { /** - * Required. The name of the agent to delete all entities types for. Format: `projects//agent`. + * Required. The name of the agent to delete all entities types for. Format: `projects//agent`. */ parent?: string; @@ -6451,7 +6408,7 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Entitytypes$Batchupdate extends StandardParameters { /** - * Required. The name of the agent to update or create entity types in. Format: `projects//agent`. + * Required. The name of the agent to update or create entity types in. Format: `projects//agent`. */ parent?: string; @@ -6467,7 +6424,7 @@ export namespace dialogflow_v2 { */ languageCode?: string; /** - * Required. The agent to create a entity type for. Format: `projects//agent`. + * Required. The agent to create a entity type for. Format: `projects//agent`. */ parent?: string; @@ -6479,7 +6436,7 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Entitytypes$Delete extends StandardParameters { /** - * Required. The name of the entity type to delete. Format: `projects//agent/entityTypes/`. + * Required. The name of the entity type to delete. Format: `projects//agent/entityTypes/`. */ name?: string; } @@ -6490,7 +6447,7 @@ export namespace dialogflow_v2 { */ languageCode?: string; /** - * Required. The name of the entity type. Format: `projects//agent/entityTypes/`. + * Required. The name of the entity type. Format: `projects//agent/entityTypes/`. */ name?: string; } @@ -6509,7 +6466,7 @@ export namespace dialogflow_v2 { */ pageToken?: string; /** - * Required. The agent to list all entity types from. Format: `projects//agent`. + * Required. The agent to list all entity types from. Format: `projects//agent`. */ parent?: string; } @@ -6520,7 +6477,7 @@ export namespace dialogflow_v2 { */ languageCode?: string; /** - * The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`. + * The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`. */ name?: string; /** @@ -6542,7 +6499,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.entityTypes.entities.batchCreate - * @desc Creates multiple new entities in the specified entity type. Operation + * @desc Creates multiple new entities in the specified entity type. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -6570,8 +6527,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.entityTypes.entities.batchCreate({ - * // Required. The name of the entity type to create entities in. Format: - * // `projects//agent/entityTypes/`. + * // Required. The name of the entity type to create entities in. Format: `projects//agent/entityTypes/`. * parent: 'projects/my-project/agent/entityTypes/my-entityType', * * // Request body metadata @@ -6604,7 +6560,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the entity type to create entities in. Format: `projects//agent/entityTypes/`. + * @param {string} params.parent Required. The name of the entity type to create entities in. Format: `projects//agent/entityTypes/`. * @param {().GoogleCloudDialogflowV2BatchCreateEntitiesRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -6698,7 +6654,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.entityTypes.entities.batchDelete - * @desc Deletes entities in the specified entity type. Operation + * @desc Deletes entities in the specified entity type. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -6726,8 +6682,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.entityTypes.entities.batchDelete({ - * // Required. The name of the entity type to delete entries for. Format: - * // `projects//agent/entityTypes/`. + * // Required. The name of the entity type to delete entries for. Format: `projects//agent/entityTypes/`. * parent: 'projects/my-project/agent/entityTypes/my-entityType', * * // Request body metadata @@ -6760,7 +6715,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the entity type to delete entries for. Format: `projects//agent/entityTypes/`. + * @param {string} params.parent Required. The name of the entity type to delete entries for. Format: `projects//agent/entityTypes/`. * @param {().GoogleCloudDialogflowV2BatchDeleteEntitiesRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -6854,7 +6809,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.entityTypes.entities.batchUpdate - * @desc 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 + * @desc 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 * @example * // Before running the sample: * // - Enable the API at: @@ -6882,8 +6837,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.entityTypes.entities.batchUpdate({ - * // Required. The name of the entity type to update or create entities in. - * // Format: `projects//agent/entityTypes/`. + * // Required. The name of the entity type to update or create entities in. Format: `projects//agent/entityTypes/`. * parent: 'projects/my-project/agent/entityTypes/my-entityType', * * // Request body metadata @@ -6917,7 +6871,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the entity type to update or create entities in. Format: `projects//agent/entityTypes/`. + * @param {string} params.parent Required. The name of the entity type to update or create entities in. Format: `projects//agent/entityTypes/`. * @param {().GoogleCloudDialogflowV2BatchUpdateEntitiesRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -7013,7 +6967,7 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Entitytypes$Entities$Batchcreate extends StandardParameters { /** - * Required. The name of the entity type to create entities in. Format: `projects//agent/entityTypes/`. + * Required. The name of the entity type to create entities in. Format: `projects//agent/entityTypes/`. */ parent?: string; @@ -7025,7 +6979,7 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Entitytypes$Entities$Batchdelete extends StandardParameters { /** - * Required. The name of the entity type to delete entries for. Format: `projects//agent/entityTypes/`. + * Required. The name of the entity type to delete entries for. Format: `projects//agent/entityTypes/`. */ parent?: string; @@ -7037,7 +6991,7 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Entitytypes$Entities$Batchupdate extends StandardParameters { /** - * Required. The name of the entity type to update or create entities in. Format: `projects//agent/entityTypes/`. + * Required. The name of the entity type to update or create entities in. Format: `projects//agent/entityTypes/`. */ parent?: string; @@ -7085,13 +7039,11 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.environments.list({ - * // Optional. The maximum number of items to return in a single page. By default 100 and - * // at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The agent to list all environments from. - * // Format: `projects//agent`. + * // Required. The agent to list all environments from. Format: `projects//agent`. * parent: 'projects/my-project/agent', * }); * console.log(res.data); @@ -7114,7 +7066,7 @@ export namespace dialogflow_v2 { * @param {object} params Parameters for request * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The agent to list all environments from. Format: `projects//agent`. + * @param {string} params.parent Required. The agent to list all environments from. Format: `projects//agent`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -7232,7 +7184,7 @@ export namespace dialogflow_v2 { */ pageToken?: string; /** - * Required. The agent to list all environments from. Format: `projects//agent`. + * Required. The agent to list all environments from. Format: `projects//agent`. */ parent?: string; } @@ -7293,12 +7245,7 @@ export namespace dialogflow_v2 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.deleteContexts( * { - * // Required. The name of the session to delete all contexts from. Format: - * // `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. - * // If `Environment ID` is not specified we assume default 'draft' environment. - * // If `User ID` is not specified, we assume default '-' user. + * // Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session', * } @@ -7318,7 +7265,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -7438,18 +7385,7 @@ export namespace dialogflow_v2 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.detectIntent( * { - * // Required. The name of the session this query is sent to. Format: - * // `projects//agent/sessions/`, or - * // `projects//agent/environments//users//sessions/`. 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. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). * session: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session', * @@ -7487,7 +7423,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.session Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). + * @param {string} params.session Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). * @param {().GoogleCloudDialogflowV2DetectIntentRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -7599,14 +7535,14 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Environments$Users$Sessions$Deletecontexts extends StandardParameters { /** - * Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; } export interface Params$Resource$Projects$Agent$Environments$Users$Sessions$Detectintent extends StandardParameters { /** - * Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). */ session?: string; @@ -7624,7 +7560,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.environments.users.sessions.contexts.create - * @desc Creates a context. If the specified context already exists, overrides the context. + * @desc Creates a context. If the specified context already exists, overrides the context. * @example * // Before running the sample: * // - Enable the API at: @@ -7653,12 +7589,7 @@ export namespace dialogflow_v2 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.contexts.create( * { - * // Required. The session to create a context for. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users//sessions/`. - * // If `Environment ID` is not specified, we assume default 'draft' - * // environment. If `User ID` is not specified, we assume default '-' user. + * // Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session', * @@ -7692,7 +7623,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {().GoogleCloudDialogflowV2Context} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -7817,12 +7748,7 @@ export namespace dialogflow_v2 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.contexts.delete( * { - * // Required. The name of the context to delete. Format: - * // `projects//agent/sessions//contexts/` - * // or `projects//agent/environments//users//sessions//contexts/`. - * // If `Environment ID` is not specified, we assume default 'draft' - * // environment. If `User ID` is not specified, we assume default '-' user. + * // Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * name: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session/contexts/my-context', * } @@ -7842,7 +7768,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.name Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -7957,12 +7883,7 @@ export namespace dialogflow_v2 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.contexts.get( * { - * // Required. The name of the context. Format: - * // `projects//agent/sessions//contexts/` - * // or `projects//agent/environments//users//sessions//contexts/`. - * // If `Environment ID` is not specified, we assume default 'draft' - * // environment. If `User ID` is not specified, we assume default '-' user. + * // Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * name: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session/contexts/my-context', * } @@ -7986,7 +7907,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.name Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -8107,17 +8028,11 @@ export namespace dialogflow_v2 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.contexts.list( * { - * // Optional. The maximum number of items to return in a single page. By - * // default 100 and at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The session to list all contexts from. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users//sessions/`. - * // If `Environment ID` is not specified, we assume default 'draft' - * // environment. If `User ID` is not specified, we assume default '-' user. + * // Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session', * } @@ -8142,7 +8057,7 @@ export namespace dialogflow_v2 { * @param {object} params Parameters for request * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -8280,23 +8195,7 @@ export namespace dialogflow_v2 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.contexts.patch( * { - * // 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` + * // 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` * name: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session/contexts/my-context', * // Optional. The mask to control which fields get updated. @@ -8332,7 +8231,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name 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` + * @param {string} params.name 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` * @param {string=} params.updateMask Optional. The mask to control which fields get updated. * @param {().GoogleCloudDialogflowV2Context} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -8428,7 +8327,7 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Environments$Users$Sessions$Contexts$Create extends StandardParameters { /** - * Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; @@ -8440,14 +8339,14 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Environments$Users$Sessions$Contexts$Delete extends StandardParameters { /** - * Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ name?: string; } export interface Params$Resource$Projects$Agent$Environments$Users$Sessions$Contexts$Get extends StandardParameters { /** - * Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ name?: string; } @@ -8462,14 +8361,14 @@ export namespace dialogflow_v2 { */ pageToken?: string; /** - * Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; } export interface Params$Resource$Projects$Agent$Environments$Users$Sessions$Contexts$Patch extends StandardParameters { /** - * 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` + * 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` */ name?: string; /** @@ -8491,7 +8390,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.environments.users.sessions.entityTypes.create - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -8520,12 +8419,7 @@ export namespace dialogflow_v2 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.entityTypes.create( * { - * // Required. The session to create a session entity type for. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users// - * // sessions/`. - * // If `Environment ID` is not specified, we assume default 'draft' - * // environment. If `User ID` is not specified, we assume default '-' user. + * // Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session', * @@ -8559,7 +8453,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {().GoogleCloudDialogflowV2SessionEntityType} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -8661,7 +8555,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.environments.users.sessions.entityTypes.delete - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -8690,13 +8584,7 @@ export namespace dialogflow_v2 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.entityTypes.delete( * { - * // Required. The name of the entity type to delete. 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. + * // Required. The name of the entity type to delete. 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. * name: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session/entityTypes/my-entityType', * } @@ -8716,7 +8604,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the entity type to delete. 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. + * @param {string} params.name Required. The name of the entity type to delete. 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. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -8802,7 +8690,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.environments.users.sessions.entityTypes.get - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -8831,13 +8719,7 @@ export namespace dialogflow_v2 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.entityTypes.get( * { - * // Required. The name of the 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. + * // Required. The name of the 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. * name: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session/entityTypes/my-entityType', * } @@ -8861,7 +8743,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the 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. + * @param {string} params.name Required. The name of the 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. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -8959,7 +8841,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.environments.users.sessions.entityTypes.list - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -8988,17 +8870,11 @@ export namespace dialogflow_v2 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.entityTypes.list( * { - * // Optional. The maximum number of items to return in a single page. By - * // default 100 and at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The session to list all session entity types from. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users// - * // sessions/`. - * // If `Environment ID` is not specified, we assume default 'draft' - * // environment. If `User ID` is not specified, we assume default '-' user. + * // Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session', * } @@ -9023,7 +8899,7 @@ export namespace dialogflow_v2 { * @param {object} params Parameters for request * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -9135,7 +9011,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.environments.users.sessions.entityTypes.patch - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -9164,16 +9040,7 @@ export namespace dialogflow_v2 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.entityTypes.patch( * { - * // 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. + * // 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. * name: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session/entityTypes/my-entityType', * // Optional. The mask to control which fields get updated. @@ -9209,7 +9076,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name 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. + * @param {string} params.name 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. * @param {string=} params.updateMask Optional. The mask to control which fields get updated. * @param {().GoogleCloudDialogflowV2SessionEntityType} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -9311,7 +9178,7 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Environments$Users$Sessions$Entitytypes$Create extends StandardParameters { /** - * Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; @@ -9323,14 +9190,14 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Environments$Users$Sessions$Entitytypes$Delete extends StandardParameters { /** - * Required. The name of the entity type to delete. 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. + * Required. The name of the entity type to delete. 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. */ name?: string; } export interface Params$Resource$Projects$Agent$Environments$Users$Sessions$Entitytypes$Get extends StandardParameters { /** - * Required. The name of the 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. + * Required. The name of the 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. */ name?: string; } @@ -9345,14 +9212,14 @@ export namespace dialogflow_v2 { */ pageToken?: string; /** - * Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; } export interface Params$Resource$Projects$Agent$Environments$Users$Sessions$Entitytypes$Patch extends StandardParameters { /** - * 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. + * 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. */ name?: string; /** @@ -9374,7 +9241,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.intents.batchDelete - * @desc Deletes intents in the specified agent. Operation + * @desc Deletes intents in the specified agent. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -9402,8 +9269,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.intents.batchDelete({ - * // Required. The name of the agent to delete all entities types for. Format: - * // `projects//agent`. + * // Required. The name of the agent to delete all entities types for. Format: `projects//agent`. * parent: 'projects/my-project/agent', * * // Request body metadata @@ -9435,7 +9301,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the agent to delete all entities types for. Format: `projects//agent`. + * @param {string} params.parent Required. The name of the agent to delete all entities types for. Format: `projects//agent`. * @param {().GoogleCloudDialogflowV2BatchDeleteIntentsRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -9529,7 +9395,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.intents.batchUpdate - * @desc Updates/Creates multiple intents in the specified agent. Operation + * @desc Updates/Creates multiple intents in the specified agent. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -9557,8 +9423,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.intents.batchUpdate({ - * // Required. The name of the agent to update or create intents in. - * // Format: `projects//agent`. + * // Required. The name of the agent to update or create intents in. Format: `projects//agent`. * parent: 'projects/my-project/agent', * * // Request body metadata @@ -9594,7 +9459,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the agent to update or create intents in. Format: `projects//agent`. + * @param {string} params.parent Required. The name of the agent to update or create intents in. Format: `projects//agent`. * @param {().GoogleCloudDialogflowV2BatchUpdateIntentsRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -9718,14 +9583,9 @@ export namespace dialogflow_v2 { * const res = await dialogflow.projects.agent.intents.create({ * // Optional. The resource view to apply to the returned intent. * intentView: 'placeholder-value', - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // Required. The agent to create a intent for. - * // Format: `projects//agent`. + * // Required. The agent to create a intent for. Format: `projects//agent`. * parent: 'projects/my-project/agent', * * // Request body metadata @@ -9789,7 +9649,7 @@ export namespace dialogflow_v2 { * @param {object} params Parameters for request * @param {string=} params.intentView Optional. The resource view to apply to the returned intent. * @param {string=} params.languageCode 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). - * @param {string} params.parent Required. The agent to create a intent for. Format: `projects//agent`. + * @param {string} params.parent Required. The agent to create a intent for. Format: `projects//agent`. * @param {().GoogleCloudDialogflowV2Intent} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -9913,9 +9773,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.intents.delete({ - * // Required. The name of the intent to delete. If this intent has direct or - * // indirect followup intents, we also delete them. - * // Format: `projects//agent/intents/`. + * // Required. The name of the intent to delete. If this intent has direct or indirect followup intents, we also delete them. Format: `projects//agent/intents/`. * name: 'projects/my-project/agent/intents/my-intent', * }); * console.log(res.data); @@ -9933,7 +9791,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the intent to delete. If this intent has direct or indirect followup intents, we also delete them. Format: `projects//agent/intents/`. + * @param {string} params.name Required. The name of the intent to delete. If this intent has direct or indirect followup intents, we also delete them. Format: `projects//agent/intents/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -10049,14 +9907,9 @@ export namespace dialogflow_v2 { * const res = await dialogflow.projects.agent.intents.get({ * // Optional. The resource view to apply to the returned intent. * intentView: 'placeholder-value', - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // Required. The name of the intent. - * // Format: `projects//agent/intents/`. + * // Required. The name of the intent. Format: `projects//agent/intents/`. * name: 'projects/my-project/agent/intents/my-intent', * }); * console.log(res.data); @@ -10095,7 +9948,7 @@ export namespace dialogflow_v2 { * @param {object} params Parameters for request * @param {string=} params.intentView Optional. The resource view to apply to the returned intent. * @param {string=} params.languageCode 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). - * @param {string} params.name Required. The name of the intent. Format: `projects//agent/intents/`. + * @param {string} params.name Required. The name of the intent. Format: `projects//agent/intents/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -10217,19 +10070,13 @@ export namespace dialogflow_v2 { * const res = await dialogflow.projects.agent.intents.list({ * // Optional. The resource view to apply to the returned intent. * intentView: 'placeholder-value', - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // Optional. The maximum number of items to return in a single page. By - * // default 100 and at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The agent to list all intents from. - * // Format: `projects//agent`. + * // Required. The agent to list all intents from. Format: `projects//agent`. * parent: 'projects/my-project/agent', * }); * console.log(res.data); @@ -10254,7 +10101,7 @@ export namespace dialogflow_v2 { * @param {string=} params.languageCode 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). * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The agent to list all intents from. Format: `projects//agent`. + * @param {string} params.parent Required. The agent to list all intents from. Format: `projects//agent`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -10393,16 +10240,9 @@ export namespace dialogflow_v2 { * const res = await dialogflow.projects.agent.intents.patch({ * // Optional. The resource view to apply to the returned intent. * intentView: 'placeholder-value', - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // Optional. The unique identifier of this intent. - * // Required for Intents.UpdateIntent and Intents.BatchUpdateIntents - * // methods. - * // Format: `projects//agent/intents/`. + * // Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`. * name: 'projects/my-project/agent/intents/my-intent', * // Optional. The mask to control which fields get updated. * updateMask: 'placeholder-value', @@ -10468,7 +10308,7 @@ export namespace dialogflow_v2 { * @param {object} params Parameters for request * @param {string=} params.intentView Optional. The resource view to apply to the returned intent. * @param {string=} params.languageCode 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). - * @param {string} params.name Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`. + * @param {string} params.name Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`. * @param {string=} params.updateMask Optional. The mask to control which fields get updated. * @param {().GoogleCloudDialogflowV2Intent} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -10564,7 +10404,7 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Intents$Batchdelete extends StandardParameters { /** - * Required. The name of the agent to delete all entities types for. Format: `projects//agent`. + * Required. The name of the agent to delete all entities types for. Format: `projects//agent`. */ parent?: string; @@ -10576,7 +10416,7 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Intents$Batchupdate extends StandardParameters { /** - * Required. The name of the agent to update or create intents in. Format: `projects//agent`. + * Required. The name of the agent to update or create intents in. Format: `projects//agent`. */ parent?: string; @@ -10596,7 +10436,7 @@ export namespace dialogflow_v2 { */ languageCode?: string; /** - * Required. The agent to create a intent for. Format: `projects//agent`. + * Required. The agent to create a intent for. Format: `projects//agent`. */ parent?: string; @@ -10608,7 +10448,7 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Intents$Delete extends StandardParameters { /** - * Required. The name of the intent to delete. If this intent has direct or indirect followup intents, we also delete them. Format: `projects//agent/intents/`. + * Required. The name of the intent to delete. If this intent has direct or indirect followup intents, we also delete them. Format: `projects//agent/intents/`. */ name?: string; } @@ -10623,7 +10463,7 @@ export namespace dialogflow_v2 { */ languageCode?: string; /** - * Required. The name of the intent. Format: `projects//agent/intents/`. + * Required. The name of the intent. Format: `projects//agent/intents/`. */ name?: string; } @@ -10646,7 +10486,7 @@ export namespace dialogflow_v2 { */ pageToken?: string; /** - * Required. The agent to list all intents from. Format: `projects//agent`. + * Required. The agent to list all intents from. Format: `projects//agent`. */ parent?: string; } @@ -10661,7 +10501,7 @@ export namespace dialogflow_v2 { */ languageCode?: string; /** - * Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`. + * Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`. */ name?: string; /** @@ -10719,12 +10559,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.deleteContexts({ - * // Required. The name of the session to delete all contexts from. Format: - * // `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. - * // If `Environment ID` is not specified we assume default 'draft' environment. - * // If `User ID` is not specified, we assume default '-' user. + * // Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: 'projects/my-project/agent/sessions/my-session', * }); * console.log(res.data); @@ -10742,7 +10577,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -10861,18 +10696,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.detectIntent({ - * // Required. The name of the session this query is sent to. Format: - * // `projects//agent/sessions/`, or - * // `projects//agent/environments//users//sessions/`. 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. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). * session: 'projects/my-project/agent/sessions/my-session', * * // Request body metadata @@ -10908,7 +10732,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.session Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). + * @param {string} params.session Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). * @param {().GoogleCloudDialogflowV2DetectIntentRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -11020,14 +10844,14 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Sessions$Deletecontexts extends StandardParameters { /** - * Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; } export interface Params$Resource$Projects$Agent$Sessions$Detectintent extends StandardParameters { /** - * Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). */ session?: string; @@ -11045,7 +10869,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.sessions.contexts.create - * @desc Creates a context. If the specified context already exists, overrides the context. + * @desc Creates a context. If the specified context already exists, overrides the context. * @example * // Before running the sample: * // - Enable the API at: @@ -11073,12 +10897,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.contexts.create({ - * // Required. The session to create a context for. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users//sessions/`. - * // If `Environment ID` is not specified, we assume default 'draft' - * // environment. If `User ID` is not specified, we assume default '-' user. + * // Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: 'projects/my-project/agent/sessions/my-session', * * // Request body metadata @@ -11110,7 +10929,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {().GoogleCloudDialogflowV2Context} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -11234,12 +11053,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.contexts.delete({ - * // Required. The name of the context to delete. Format: - * // `projects//agent/sessions//contexts/` - * // or `projects//agent/environments//users//sessions//contexts/`. - * // If `Environment ID` is not specified, we assume default 'draft' - * // environment. If `User ID` is not specified, we assume default '-' user. + * // Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * name: 'projects/my-project/agent/sessions/my-session/contexts/my-context', * }); * console.log(res.data); @@ -11257,7 +11071,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.name Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -11371,12 +11185,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.contexts.get({ - * // Required. The name of the context. Format: - * // `projects//agent/sessions//contexts/` - * // or `projects//agent/environments//users//sessions//contexts/`. - * // If `Environment ID` is not specified, we assume default 'draft' - * // environment. If `User ID` is not specified, we assume default '-' user. + * // Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * name: 'projects/my-project/agent/sessions/my-session/contexts/my-context', * }); * console.log(res.data); @@ -11398,7 +11207,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.name Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -11518,17 +11327,11 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.contexts.list({ - * // Optional. The maximum number of items to return in a single page. By - * // default 100 and at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The session to list all contexts from. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users//sessions/`. - * // If `Environment ID` is not specified, we assume default 'draft' - * // environment. If `User ID` is not specified, we assume default '-' user. + * // Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: 'projects/my-project/agent/sessions/my-session', * }); * console.log(res.data); @@ -11551,7 +11354,7 @@ export namespace dialogflow_v2 { * @param {object} params Parameters for request * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -11688,23 +11491,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.contexts.patch({ - * // 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` + * // 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` * name: 'projects/my-project/agent/sessions/my-session/contexts/my-context', * // Optional. The mask to control which fields get updated. * updateMask: 'placeholder-value', @@ -11738,7 +11525,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name 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` + * @param {string} params.name 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` * @param {string=} params.updateMask Optional. The mask to control which fields get updated. * @param {().GoogleCloudDialogflowV2Context} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -11834,7 +11621,7 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Sessions$Contexts$Create extends StandardParameters { /** - * Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; @@ -11846,14 +11633,14 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Sessions$Contexts$Delete extends StandardParameters { /** - * Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ name?: string; } export interface Params$Resource$Projects$Agent$Sessions$Contexts$Get extends StandardParameters { /** - * Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ name?: string; } @@ -11868,14 +11655,14 @@ export namespace dialogflow_v2 { */ pageToken?: string; /** - * Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; } export interface Params$Resource$Projects$Agent$Sessions$Contexts$Patch extends StandardParameters { /** - * 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` + * 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` */ name?: string; /** @@ -11897,7 +11684,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.sessions.entityTypes.create - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -11925,12 +11712,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.entityTypes.create({ - * // Required. The session to create a session entity type for. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users// - * // sessions/`. - * // If `Environment ID` is not specified, we assume default 'draft' - * // environment. If `User ID` is not specified, we assume default '-' user. + * // Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: 'projects/my-project/agent/sessions/my-session', * * // Request body metadata @@ -11962,7 +11744,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {().GoogleCloudDialogflowV2SessionEntityType} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -12064,7 +11846,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.sessions.entityTypes.delete - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -12092,13 +11874,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.entityTypes.delete({ - * // Required. The name of the entity type to delete. 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. + * // Required. The name of the entity type to delete. 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. * name: * 'projects/my-project/agent/sessions/my-session/entityTypes/my-entityType', * }); @@ -12117,7 +11893,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the entity type to delete. 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. + * @param {string} params.name Required. The name of the entity type to delete. 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. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -12203,7 +11979,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.sessions.entityTypes.get - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -12231,13 +12007,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.entityTypes.get({ - * // Required. The name of the 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. + * // Required. The name of the 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. * name: * 'projects/my-project/agent/sessions/my-session/entityTypes/my-entityType', * }); @@ -12260,7 +12030,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the 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. + * @param {string} params.name Required. The name of the 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. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -12358,7 +12128,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.sessions.entityTypes.list - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -12386,17 +12156,11 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.entityTypes.list({ - * // Optional. The maximum number of items to return in a single page. By - * // default 100 and at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The session to list all session entity types from. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users// - * // sessions/`. - * // If `Environment ID` is not specified, we assume default 'draft' - * // environment. If `User ID` is not specified, we assume default '-' user. + * // Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: 'projects/my-project/agent/sessions/my-session', * }); * console.log(res.data); @@ -12419,7 +12183,7 @@ export namespace dialogflow_v2 { * @param {object} params Parameters for request * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -12531,7 +12295,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.agent.sessions.entityTypes.patch - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -12559,16 +12323,7 @@ export namespace dialogflow_v2 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.entityTypes.patch({ - * // 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. + * // 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. * name: * 'projects/my-project/agent/sessions/my-session/entityTypes/my-entityType', * // Optional. The mask to control which fields get updated. @@ -12603,7 +12358,7 @@ export namespace dialogflow_v2 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name 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. + * @param {string} params.name 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. * @param {string=} params.updateMask Optional. The mask to control which fields get updated. * @param {().GoogleCloudDialogflowV2SessionEntityType} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -12705,7 +12460,7 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Sessions$Entitytypes$Create extends StandardParameters { /** - * Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; @@ -12717,14 +12472,14 @@ export namespace dialogflow_v2 { export interface Params$Resource$Projects$Agent$Sessions$Entitytypes$Delete extends StandardParameters { /** - * Required. The name of the entity type to delete. 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. + * Required. The name of the entity type to delete. 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. */ name?: string; } export interface Params$Resource$Projects$Agent$Sessions$Entitytypes$Get extends StandardParameters { /** - * Required. The name of the 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. + * Required. The name of the 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. */ name?: string; } @@ -12739,14 +12494,14 @@ export namespace dialogflow_v2 { */ pageToken?: string; /** - * Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; } export interface Params$Resource$Projects$Agent$Sessions$Entitytypes$Patch extends StandardParameters { /** - * 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. + * 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. */ name?: string; /** @@ -12779,7 +12534,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.locations.operations.cancel - * @desc 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`. + * @desc 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`. * @example * // Before running the sample: * // - Enable the API at: @@ -12911,7 +12666,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.locations.operations.get - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -13053,7 +12808,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.locations.operations.list - * @desc 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/x/operations`. To override the binding, API services can add a binding such as `"/v1/{name=users/x}/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. + * @desc 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/x/operations`. To override the binding, API services can add a binding such as `"/v1/{name=users/x}/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. * @example * // Before running the sample: * // - Enable the API at: @@ -13253,7 +13008,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.operations.cancel - * @desc 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`. + * @desc 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`. * @example * // Before running the sample: * // - Enable the API at: @@ -13385,7 +13140,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.operations.get - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -13527,7 +13282,7 @@ export namespace dialogflow_v2 { /** * dialogflow.projects.operations.list - * @desc 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/x/operations`. To override the binding, API services can add a binding such as `"/v1/{name=users/x}/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. + * @desc 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/x/operations`. To override the binding, API services can add a binding such as `"/v1/{name=users/x}/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. * @example * // Before running the sample: * // - Enable the API at: diff --git a/src/apis/dialogflow/v2beta1.ts b/src/apis/dialogflow/v2beta1.ts index 101d32160a..60689b12c9 100644 --- a/src/apis/dialogflow/v2beta1.ts +++ b/src/apis/dialogflow/v2beta1.ts @@ -145,7 +145,7 @@ export namespace dialogflow_v2beta1 { */ export interface Schema$GoogleCloudDialogflowCxV3beta1PageInfo { /** - * Always present for WebhookRequest. Ignored for WebhookResponse. The unique identifier of the current page. Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>/pages/<Page ID>`. + * Always present for WebhookRequest. Ignored for WebhookResponse. The unique identifier of the current page. Format: `projects//locations//agents//flows//pages/`. */ currentPage?: string | null; /** @@ -188,7 +188,7 @@ export namespace dialogflow_v2beta1 { value?: any | null; } /** - * 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. + * 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. */ export interface Schema$GoogleCloudDialogflowCxV3beta1ResponseMessage { /** @@ -229,7 +229,7 @@ export namespace dialogflow_v2beta1 { text?: Schema$GoogleCloudDialogflowCxV3beta1ResponseMessageText; } /** - * 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. + * 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. */ export interface Schema$GoogleCloudDialogflowCxV3beta1ResponseMessageConversationSuccess { /** @@ -242,7 +242,7 @@ export namespace dialogflow_v2beta1 { */ export interface Schema$GoogleCloudDialogflowCxV3beta1ResponseMessageEndInteraction {} /** - * Indicates that the conversation should be handed off to a human 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. + * Indicates that the conversation should be handed off to a human 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. */ export interface Schema$GoogleCloudDialogflowCxV3beta1ResponseMessageHumanAgentHandoff { /** @@ -251,7 +251,7 @@ export namespace dialogflow_v2beta1 { metadata?: {[key: string]: any} | null; } /** - * 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. + * 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. */ export interface Schema$GoogleCloudDialogflowCxV3beta1ResponseMessageLiveAgentHandoff { /** @@ -333,7 +333,7 @@ export namespace dialogflow_v2beta1 { */ parameters?: {[key: string]: any} | null; /** - * 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/<Project ID>/locations/<Location ID>/agents/<Agent ID>/sessions/<Session ID>`. + * 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/`. */ session?: string | null; } @@ -384,7 +384,7 @@ export namespace dialogflow_v2beta1 { */ export interface Schema$GoogleCloudDialogflowCxV3beta1WebhookRequestIntentInfo { /** - * Always present. The unique identifier of the last matched intent. Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/intents/<Intent ID>`. + * Always present. The unique identifier of the last matched intent. Format: `projects//locations//agents//intents/`. */ lastMatchedIntent?: string | null; /** @@ -430,11 +430,11 @@ export namespace dialogflow_v2beta1 { */ sessionInfo?: Schema$GoogleCloudDialogflowCxV3beta1SessionInfo; /** - * The target flow to transition to. Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>`. + * The target flow to transition to. Format: `projects//locations//agents//flows/`. */ targetFlow?: string | null; /** - * The target page to transition to. Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>/pages/<Page ID>`. + * The target page to transition to. Format: `projects//locations//agents//flows//pages/`. */ targetPage?: string | null; } @@ -460,7 +460,7 @@ export namespace dialogflow_v2beta1 { */ entityType?: string | null; /** - * 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: <pre> { "amount": 5, "currency": "USD" } </pre> + * 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" } */ formattedValue?: any | null; /** @@ -487,7 +487,7 @@ export namespace dialogflow_v2beta1 { intents?: Schema$GoogleCloudDialogflowV2Intent[]; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2beta1Agent { /** @@ -523,7 +523,7 @@ export namespace dialogflow_v2beta1 { */ matchMode?: string | null; /** - * Required. The project of this agent. Format: `projects/<Project ID>`. + * Required. The project of this agent. Format: `projects/`. */ parent?: string | null; /** @@ -564,7 +564,7 @@ export namespace dialogflow_v2beta1 { */ exampleCount?: string | null; /** - * Output only. AnnotatedConversationDataset resource name. Format: `projects/<Project ID>/conversationDatasets/<Conversation Dataset ID>/annotatedConversationDatasets/<Annotated Conversation Dataset ID>` + * Output only. AnnotatedConversationDataset resource name. Format: `projects//conversationDatasets//annotatedConversationDatasets/` */ name?: string | null; /** @@ -607,7 +607,7 @@ export namespace dialogflow_v2beta1 { */ export interface Schema$GoogleCloudDialogflowV2beta1BatchDeleteEntitiesRequest { /** - * 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/<Project ID>`. + * 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/`. */ entityValues?: string[] | null; /** @@ -715,7 +715,7 @@ export namespace dialogflow_v2beta1 { intents?: Schema$GoogleCloudDialogflowV2beta1Intent[]; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2beta1Context { /** @@ -723,11 +723,11 @@ export namespace dialogflow_v2beta1 { */ lifespanCount?: number | null; /** - * Required. The unique identifier of the context. Format: `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID>`, or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session ID>/contexts/<Context ID>`. 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. 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` */ name?: string | null; /** - * 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 + * 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 */ parameters?: {[key: string]: any} | null; } @@ -744,11 +744,11 @@ export namespace dialogflow_v2beta1 { */ outputAudioConfig?: Schema$GoogleCloudDialogflowV2beta1OutputAudioConfig; /** - * 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. + * 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. */ outputAudioConfigMask?: string | null; /** - * 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. + * 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. */ queryInput?: Schema$GoogleCloudDialogflowV2beta1QueryInput; /** @@ -765,7 +765,7 @@ export namespace dialogflow_v2beta1 { */ alternativeQueryResults?: Schema$GoogleCloudDialogflowV2beta1QueryResult[]; /** - * 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. + * 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. */ outputAudio?: string | null; /** @@ -786,7 +786,7 @@ export namespace dialogflow_v2beta1 { webhookStatus?: Schema$GoogleRpcStatus; } /** - * 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`. + * 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`. */ export interface Schema$GoogleCloudDialogflowV2beta1Document { /** @@ -794,7 +794,7 @@ export namespace dialogflow_v2beta1 { */ content?: string | null; /** - * The URI where the file content is located. For documents stored in Google Cloud Storage, these URIs must have the form `gs://<bucket-name>/<object-name>`. 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. + * 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. */ contentUri?: string | null; /** @@ -802,7 +802,7 @@ export namespace dialogflow_v2beta1 { */ displayName?: string | null; /** - * 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. + * 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. */ enableAutoReload?: boolean | null; /** @@ -818,7 +818,7 @@ export namespace dialogflow_v2beta1 { */ mimeType?: string | null; /** - * Optional. The document resource name. The name must be empty when creating a document. Format: `projects/<Project ID>/knowledgeBases/<Knowledge Base ID>/documents/<Document ID>`. + * Optional. The document resource name. The name must be empty when creating a document. Format: `projects//knowledgeBases//documents/`. */ name?: string | null; /** @@ -840,7 +840,7 @@ export namespace dialogflow_v2beta1 { time?: string | null; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2beta1EntityType { /** @@ -864,7 +864,7 @@ export namespace dialogflow_v2beta1 { */ kind?: string | null; /** - * The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`. + * The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`. */ name?: string | null; } @@ -882,20 +882,20 @@ export namespace dialogflow_v2beta1 { */ export interface Schema$GoogleCloudDialogflowV2beta1EntityTypeEntity { /** - * 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`. + * 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`. */ synonyms?: string[] | null; /** - * 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). + * 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). */ value?: string | null; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2beta1Environment { /** - * Optional. The agent version loaded into this environment. Format: `projects/<Project ID>/agent/versions/<Version ID>`. + * Optional. The agent version loaded into this environment. Format: `projects//agent/versions/`. */ agentVersion?: string | null; /** @@ -903,7 +903,7 @@ export namespace dialogflow_v2beta1 { */ description?: string | null; /** - * Output only. The unique identifier of this agent environment. Format: - `projects/<Project Number / ID>/agent/environments/<Environment ID>` - `projects/<Project Number / ID>/locations/<Location ID>/agent/environments/<Environment ID>` + * Output only. The unique identifier of this agent environment. Format: - `projects//agent/environments/` - `projects//locations//agent/environments/` */ name?: string | null; /** @@ -916,7 +916,7 @@ export namespace dialogflow_v2beta1 { updateTime?: string | null; } /** - * Events allow for matching intents by event name instead of the natural language input. For instance, input `<event: { name: "welcome_event", parameters: { name: "Sam" } }>` 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?"`. + * 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?"`. */ export interface Schema$GoogleCloudDialogflowV2beta1EventInput { /** @@ -928,7 +928,7 @@ export namespace dialogflow_v2beta1 { */ name?: string | null; /** - * 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 + * 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 */ parameters?: {[key: string]: any} | null; } @@ -937,7 +937,7 @@ export namespace dialogflow_v2beta1 { */ export interface Schema$GoogleCloudDialogflowV2beta1ExportAgentRequest { /** - * 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://<bucket-name>/<object-name>`. If left unspecified, the serialized agent is returned inline. + * 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. */ agentUri?: string | null; } @@ -955,7 +955,7 @@ export namespace dialogflow_v2beta1 { agentUri?: string | null; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2beta1Fulfillment { /** @@ -975,7 +975,7 @@ export namespace dialogflow_v2beta1 { */ genericWebService?: Schema$GoogleCloudDialogflowV2beta1FulfillmentGenericWebService; /** - * Required. The unique identifier of the fulfillment. Format: `projects/<Project ID>/agent/fulfillment`. + * Required. The unique identifier of the fulfillment. Format: `projects//agent/fulfillment`. */ name?: string | null; } @@ -1018,7 +1018,7 @@ export namespace dialogflow_v2beta1 { */ export interface Schema$GoogleCloudDialogflowV2beta1GcsSource { /** - * 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. + * 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. */ uri?: string | null; } @@ -1060,7 +1060,7 @@ export namespace dialogflow_v2beta1 { */ modelVariant?: string | null; /** - * 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](). + * 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](). */ phraseHints?: string[] | null; /** @@ -1072,12 +1072,12 @@ export namespace dialogflow_v2beta1 { */ singleUtterance?: boolean | null; /** - * 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. + * 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. */ speechContexts?: Schema$GoogleCloudDialogflowV2beta1SpeechContext[]; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2beta1Intent { /** @@ -1105,7 +1105,7 @@ export namespace dialogflow_v2beta1 { */ followupIntentInfo?: Schema$GoogleCloudDialogflowV2beta1IntentFollowupIntentInfo[]; /** - * Optional. The list of context names required for this intent to be triggered. Format: `projects/<Project ID>/agent/sessions/-/contexts/<Context ID>`. + * Optional. The list of context names required for this intent to be triggered. Format: `projects//agent/sessions/-/contexts/`. */ inputContextNames?: string[] | null; /** @@ -1121,15 +1121,15 @@ export namespace dialogflow_v2beta1 { */ mlDisabled?: boolean | null; /** - * 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. + * 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. */ mlEnabled?: boolean | null; /** - * Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects/<Project ID>/agent/intents/<Intent ID>`. + * Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`. */ name?: string | null; /** - * 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/<Project ID>/agent/sessions/-/contexts/<Context ID>`. + * 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/`. */ outputContexts?: Schema$GoogleCloudDialogflowV2beta1Context[]; /** @@ -1137,11 +1137,11 @@ export namespace dialogflow_v2beta1 { */ parameters?: Schema$GoogleCloudDialogflowV2beta1IntentParameter[]; /** - * 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/<Project ID>/agent/intents/<Intent ID>`. + * 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/`. */ parentFollowupIntentName?: string | null; /** - * 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. + * 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. */ priority?: number | null; /** @@ -1149,7 +1149,7 @@ export namespace dialogflow_v2beta1 { */ resetContexts?: boolean | null; /** - * 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/<Project ID>/agent/intents/<Intent ID>`. + * 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/`. */ rootFollowupIntentName?: string | null; /** @@ -1175,11 +1175,11 @@ export namespace dialogflow_v2beta1 { */ export interface Schema$GoogleCloudDialogflowV2beta1IntentFollowupIntentInfo { /** - * The unique identifier of the followup intent. Format: `projects/<Project ID>/agent/intents/<Intent ID>`. + * The unique identifier of the followup intent. Format: `projects//agent/intents/`. */ followupIntentName?: string | null; /** - * The unique identifier of the followup intent's parent. Format: `projects/<Project ID>/agent/intents/<Intent ID>`. + * The unique identifier of the followup intent's parent. Format: `projects//agent/intents/`. */ parentFollowupIntentName?: string | null; } @@ -1240,7 +1240,7 @@ export namespace dialogflow_v2beta1 { */ rbmStandaloneRichCard?: Schema$GoogleCloudDialogflowV2beta1IntentMessageRbmStandaloneCard; /** - * Rich Business Messaging (RBM) text response. RBM allows businesses to send enriched and branded versions of SMS. See https://jibe.google.com/business-messaging. + * Rich Business Messaging (RBM) text response. RBM allows businesses to send enriched and branded versions of SMS. See https://jibe.google.com/business-messaging. */ rbmText?: Schema$GoogleCloudDialogflowV2beta1IntentMessageRbmText; /** @@ -1567,7 +1567,7 @@ export namespace dialogflow_v2beta1 { */ export interface Schema$GoogleCloudDialogflowV2beta1IntentMessageRbmCardContent { /** - * Optional. Description of the card (at most 2000 bytes). At least one of the title, description or media must be set. + * Optional. Description of the card (at most 2000 bytes). At least one of the title, description or media must be set. */ description?: string | null; /** @@ -1579,12 +1579,12 @@ export namespace dialogflow_v2beta1 { */ suggestions?: Schema$GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestion[]; /** - * Optional. Title of the card (at most 200 bytes). At least one of the title, description or media must be set. + * Optional. Title of the card (at most 200 bytes). At least one of the title, description or media must be set. */ title?: string | null; } /** - * 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 + * 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 */ export interface Schema$GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia { /** @@ -1601,7 +1601,7 @@ export namespace dialogflow_v2beta1 { thumbnailUri?: string | null; } /** - * 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. + * 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. */ export interface Schema$GoogleCloudDialogflowV2beta1IntentMessageRbmCarouselCard { /** @@ -1614,7 +1614,7 @@ export namespace dialogflow_v2beta1 { cardWidth?: string | null; } /** - * 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. + * 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. */ export interface Schema$GoogleCloudDialogflowV2beta1IntentMessageRbmStandaloneCard { /** @@ -1829,12 +1829,12 @@ export namespace dialogflow_v2beta1 { */ export interface Schema$GoogleCloudDialogflowV2beta1IntentMessageTelephonyPlayAudio { /** - * 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 `service-<Project Number>@gcp-sa-dialogflow.iam.gserviceaccount.com` service account where <Project Number> 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. + * 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 `service-@gcp-sa-dialogflow.iam.gserviceaccount.com` 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. */ audioUri?: string | null; } /** - * 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. + * 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. */ export interface Schema$GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech { /** @@ -1851,7 +1851,7 @@ export namespace dialogflow_v2beta1 { */ export interface Schema$GoogleCloudDialogflowV2beta1IntentMessageTelephonyTransferCall { /** - * 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). + * 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). */ phoneNumber?: string | null; } @@ -1897,7 +1897,7 @@ export namespace dialogflow_v2beta1 { */ prompts?: string[] | null; /** - * 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`. + * 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`. */ value?: string | null; } @@ -1910,7 +1910,7 @@ export namespace dialogflow_v2beta1 { */ name?: string | null; /** - * 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. + * 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. */ parts?: Schema$GoogleCloudDialogflowV2beta1IntentTrainingPhrasePart[]; /** @@ -1969,16 +1969,16 @@ export namespace dialogflow_v2beta1 { */ matchConfidence?: number | null; /** - * The system's confidence level that this knowledge answer is a good match for this conversational query. NOTE: The confidence level for a given `<query, answer>` 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. + * 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. */ matchConfidenceLevel?: string | null; /** - * Indicates which Knowledge Document this answer was extracted from. Format: `projects/<Project ID>/knowledgeBases/<Knowledge Base ID>/documents/<Document ID>`. + * Indicates which Knowledge Document this answer was extracted from. Format: `projects//knowledgeBases//documents/`. */ source?: string | null; } /** - * 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`. + * 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`. */ export interface Schema$GoogleCloudDialogflowV2beta1KnowledgeBase { /** @@ -1990,7 +1990,7 @@ export namespace dialogflow_v2beta1 { */ languageCode?: string | null; /** - * The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects/<Project ID>/knowledgeBases/<Knowledge Base ID>`. + * The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`. */ name?: string | null; } @@ -2108,7 +2108,7 @@ export namespace dialogflow_v2beta1 { */ export interface Schema$GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest { /** - * 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: <pre>{ "telephony": { "caller_id": "+18558363987" } }</pre> Note: The caller ID field (`caller_id`) will be redacted for Standard Edition agents and populated with the caller ID in [E.164 format](https://en.wikipedia.org/wiki/E.164) for Enterprise Edition agents. + * 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 Standard Edition agents and populated with the caller ID in [E.164 format](https://en.wikipedia.org/wiki/E.164) for Enterprise Edition agents. */ payload?: {[key: string]: any} | null; /** @@ -2138,7 +2138,7 @@ export namespace dialogflow_v2beta1 { synthesizeSpeechConfig?: Schema$GoogleCloudDialogflowV2beta1SynthesizeSpeechConfig; } /** - * 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. + * 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. */ export interface Schema$GoogleCloudDialogflowV2beta1QueryInput { /** @@ -2167,7 +2167,7 @@ export namespace dialogflow_v2beta1 { */ geoLocation?: Schema$GoogleTypeLatLng; /** - * KnowledgeBases to get alternative results from. If not set, the KnowledgeBases enabled in the agent (through UI) will be used. Format: `projects/<Project ID>/knowledgeBases/<Knowledge Base ID>`. + * KnowledgeBases to get alternative results from. If not set, the KnowledgeBases enabled in the agent (through UI) will be used. Format: `projects//knowledgeBases/`. */ knowledgeBaseNames?: string[] | null; /** @@ -2208,11 +2208,11 @@ export namespace dialogflow_v2beta1 { */ action?: string | null; /** - * 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. + * 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. */ allRequiredParamsPresent?: boolean | null; /** - * 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 + * 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 */ diagnosticInfo?: {[key: string]: any} | null; /** @@ -2240,15 +2240,15 @@ export namespace dialogflow_v2beta1 { */ languageCode?: string | null; /** - * The collection of output contexts. If applicable, `output_contexts.parameters` contains entries with name `<parameter name>.original` containing the original parameter values before the query. + * The collection of output contexts. If applicable, `output_contexts.parameters` contains entries with name `.original` containing the original parameter values before the query. */ outputContexts?: Schema$GoogleCloudDialogflowV2beta1Context[]; /** - * 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 + * 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 */ parameters?: {[key: string]: any} | null; /** - * 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. + * 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. */ queryText?: string | null; /** @@ -2256,7 +2256,7 @@ export namespace dialogflow_v2beta1 { */ sentimentAnalysisResult?: Schema$GoogleCloudDialogflowV2beta1SentimentAnalysisResult; /** - * 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. + * 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. */ speechRecognitionConfidence?: number | null; /** @@ -2335,7 +2335,7 @@ export namespace dialogflow_v2beta1 { queryTextSentiment?: Schema$GoogleCloudDialogflowV2beta1Sentiment; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2beta1SessionEntityType { /** @@ -2347,7 +2347,7 @@ export namespace dialogflow_v2beta1 { */ entityOverrideMode?: string | null; /** - * Required. The unique identifier of this session entity type. Format: `projects/<Project ID>/agent/sessions/<Session ID>/entityTypes/<Entity Type Display Name>`, or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session ID>/entityTypes/<Entity Type Display Name>`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. `<Entity Type Display Name>` must be the display name of an existing entity type in the same agent that will be overridden or supplemented. + * 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. */ name?: string | null; } @@ -2356,11 +2356,11 @@ export namespace dialogflow_v2beta1 { */ export interface Schema$GoogleCloudDialogflowV2beta1SpeechContext { /** - * 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. + * 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. */ boost?: number | null; /** - * 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. + * 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. */ phrases?: string[] | null; } @@ -2373,7 +2373,7 @@ export namespace dialogflow_v2beta1 { */ environment?: string | null; /** - * Required. The project of this agent. Format: `projects/<Project ID>`. + * Required. The project of this agent. Format: `projects/`. */ project?: string | null; } @@ -2424,7 +2424,7 @@ export namespace dialogflow_v2beta1 { */ export interface Schema$GoogleCloudDialogflowV2beta1ValidationError { /** - * The names of the entries that the error is associated with. Format: - "projects/<Project ID>/agent", if the error is associated with the entire agent. - "projects/<Project ID>/agent/intents/<Intent ID>", if the error is associated with certain intents. - "projects/<Project ID>/agent/intents/<Intent Id>/trainingPhrases/<Training Phrase ID>", if the error is associated with certain intent training phrases. - "projects/<Project ID>/agent/intents/<Intent Id>/parameters/<Parameter ID>", if the error is associated with certain intent parameters. - "projects/<Project ID>/agent/entities/<Entity ID>", if the error is associated with certain entities. + * 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. */ entries?: string[] | null; /** @@ -2479,12 +2479,12 @@ export namespace dialogflow_v2beta1 { */ responseId?: string | null; /** - * The unique identifier of detectIntent request session. Can be used to identify end-user inside webhook implementation. Format: `projects/<Project ID>/agent/sessions/<Session ID>`, or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session ID>`. + * 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/`. */ session?: string | null; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2beta1WebhookResponse { /** @@ -2521,7 +2521,7 @@ export namespace dialogflow_v2beta1 { source?: string | null; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2Context { /** @@ -2529,11 +2529,11 @@ export namespace dialogflow_v2beta1 { */ lifespanCount?: number | null; /** - * Required. The unique identifier of the context. Format: `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID>`, or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session ID>/contexts/<Context ID>`. 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. 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` */ name?: string | null; /** - * 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 + * 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 */ parameters?: {[key: string]: any} | null; } @@ -2542,7 +2542,7 @@ export namespace dialogflow_v2beta1 { */ export interface Schema$GoogleCloudDialogflowV2ConversationEvent { /** - * The unique identifier of the conversation this notification refers to. Format: `projects/<Project ID>/conversations/<Conversation ID>`. + * The unique identifier of the conversation this notification refers to. Format: `projects//conversations/`. */ conversation?: string | null; /** @@ -2559,7 +2559,7 @@ export namespace dialogflow_v2beta1 { type?: string | null; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2EntityType { /** @@ -2583,7 +2583,7 @@ export namespace dialogflow_v2beta1 { */ kind?: string | null; /** - * The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`. + * The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`. */ name?: string | null; } @@ -2592,16 +2592,16 @@ export namespace dialogflow_v2beta1 { */ export interface Schema$GoogleCloudDialogflowV2EntityTypeEntity { /** - * 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`. + * 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`. */ synonyms?: string[] | null; /** - * 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). + * 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). */ value?: string | null; } /** - * Events allow for matching intents by event name instead of the natural language input. For instance, input `<event: { name: "welcome_event", parameters: { name: "Sam" } }>` 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?"`. + * 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?"`. */ export interface Schema$GoogleCloudDialogflowV2EventInput { /** @@ -2613,7 +2613,7 @@ export namespace dialogflow_v2beta1 { */ name?: string | null; /** - * 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 + * 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 */ parameters?: {[key: string]: any} | null; } @@ -2631,7 +2631,7 @@ export namespace dialogflow_v2beta1 { agentUri?: string | null; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2Intent { /** @@ -2655,7 +2655,7 @@ export namespace dialogflow_v2beta1 { */ followupIntentInfo?: Schema$GoogleCloudDialogflowV2IntentFollowupIntentInfo[]; /** - * Optional. The list of context names required for this intent to be triggered. Format: `projects/<Project ID>/agent/sessions/-/contexts/<Context ID>`. + * Optional. The list of context names required for this intent to be triggered. Format: `projects//agent/sessions/-/contexts/`. */ inputContextNames?: string[] | null; /** @@ -2671,11 +2671,11 @@ export namespace dialogflow_v2beta1 { */ mlDisabled?: boolean | null; /** - * Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects/<Project ID>/agent/intents/<Intent ID>`. + * Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`. */ name?: string | null; /** - * 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/<Project ID>/agent/sessions/-/contexts/<Context ID>`. + * 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/`. */ outputContexts?: Schema$GoogleCloudDialogflowV2Context[]; /** @@ -2683,11 +2683,11 @@ export namespace dialogflow_v2beta1 { */ parameters?: Schema$GoogleCloudDialogflowV2IntentParameter[]; /** - * 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/<Project ID>/agent/intents/<Intent ID>`. + * 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/`. */ parentFollowupIntentName?: string | null; /** - * 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. + * 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. */ priority?: number | null; /** @@ -2695,7 +2695,7 @@ export namespace dialogflow_v2beta1 { */ resetContexts?: boolean | null; /** - * 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/<Project ID>/agent/intents/<Intent ID>`. + * 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/`. */ rootFollowupIntentName?: string | null; /** @@ -2712,11 +2712,11 @@ export namespace dialogflow_v2beta1 { */ export interface Schema$GoogleCloudDialogflowV2IntentFollowupIntentInfo { /** - * The unique identifier of the followup intent. Format: `projects/<Project ID>/agent/intents/<Intent ID>`. + * The unique identifier of the followup intent. Format: `projects//agent/intents/`. */ followupIntentName?: string | null; /** - * The unique identifier of the followup intent's parent. Format: `projects/<Project ID>/agent/intents/<Intent ID>`. + * The unique identifier of the followup intent's parent. Format: `projects//agent/intents/`. */ parentFollowupIntentName?: string | null; } @@ -3225,7 +3225,7 @@ export namespace dialogflow_v2beta1 { */ prompts?: string[] | null; /** - * 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`. + * 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`. */ value?: string | null; } @@ -3238,7 +3238,7 @@ export namespace dialogflow_v2beta1 { */ name?: string | null; /** - * 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. + * 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. */ parts?: Schema$GoogleCloudDialogflowV2IntentTrainingPhrasePart[]; /** @@ -3292,7 +3292,7 @@ export namespace dialogflow_v2beta1 { */ messageAnnotation?: Schema$GoogleCloudDialogflowV2MessageAnnotation; /** - * The unique identifier of the message. Format: `projects/<Project ID>/conversations/<Conversation ID>/messages/<Message ID>`. + * The unique identifier of the message. Format: `projects//conversations//messages/`. */ name?: string | null; /** @@ -3322,7 +3322,7 @@ export namespace dialogflow_v2beta1 { */ export interface Schema$GoogleCloudDialogflowV2OriginalDetectIntentRequest { /** - * 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: <pre>{ "telephony": { "caller_id": "+18558363987" } }</pre> Note: The caller ID field (`caller_id`) will be redacted for Standard Edition agents and populated with the caller ID in [E.164 format](https://en.wikipedia.org/wiki/E.164) for Enterprise Edition agents. + * 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 Standard Edition agents and populated with the caller ID in [E.164 format](https://en.wikipedia.org/wiki/E.164) for Enterprise Edition agents. */ payload?: {[key: string]: any} | null; /** @@ -3343,11 +3343,11 @@ export namespace dialogflow_v2beta1 { */ action?: string | null; /** - * 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. + * 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. */ allRequiredParamsPresent?: boolean | null; /** - * 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 + * 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 */ diagnosticInfo?: {[key: string]: any} | null; /** @@ -3371,15 +3371,15 @@ export namespace dialogflow_v2beta1 { */ languageCode?: string | null; /** - * The collection of output contexts. If applicable, `output_contexts.parameters` contains entries with name `<parameter name>.original` containing the original parameter values before the query. + * The collection of output contexts. If applicable, `output_contexts.parameters` contains entries with name `.original` containing the original parameter values before the query. */ outputContexts?: Schema$GoogleCloudDialogflowV2Context[]; /** - * 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 + * 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 */ parameters?: {[key: string]: any} | null; /** - * 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. + * 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. */ queryText?: string | null; /** @@ -3387,7 +3387,7 @@ export namespace dialogflow_v2beta1 { */ sentimentAnalysisResult?: Schema$GoogleCloudDialogflowV2SentimentAnalysisResult; /** - * 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. + * 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. */ speechRecognitionConfidence?: number | null; /** @@ -3422,7 +3422,7 @@ export namespace dialogflow_v2beta1 { queryTextSentiment?: Schema$GoogleCloudDialogflowV2Sentiment; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2SessionEntityType { /** @@ -3434,7 +3434,7 @@ export namespace dialogflow_v2beta1 { */ entityOverrideMode?: string | null; /** - * Required. The unique identifier of this session entity type. Format: `projects/<Project ID>/agent/sessions/<Session ID>/entityTypes/<Entity Type Display Name>`, or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session ID>/entityTypes/<Entity Type Display Name>`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. `<Entity Type Display Name>` must be the display name of an existing entity type in the same agent that will be overridden or supplemented. + * 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. */ name?: string | null; } @@ -3455,12 +3455,12 @@ export namespace dialogflow_v2beta1 { */ responseId?: string | null; /** - * The unique identifier of detectIntent request session. Can be used to identify end-user inside webhook implementation. Format: `projects/<Project ID>/agent/sessions/<Session ID>`, or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session ID>`. + * 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/`. */ session?: string | null; } /** - * 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). + * 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). */ export interface Schema$GoogleCloudDialogflowV2WebhookResponse { /** @@ -3531,7 +3531,7 @@ export namespace dialogflow_v2beta1 { */ error?: Schema$GoogleRpcStatus; /** - * 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. + * 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. */ metadata?: {[key: string]: any} | null; /** @@ -3539,16 +3539,16 @@ export namespace dialogflow_v2beta1 { */ name?: string | null; /** - * 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`. + * 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`. */ response?: {[key: string]: any} | null; } /** - * 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 `{}`. + * 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 `{}`. */ export interface Schema$GoogleProtobufEmpty {} /** - * 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). + * 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). */ export interface Schema$GoogleRpcStatus { /** @@ -3556,7 +3556,7 @@ export namespace dialogflow_v2beta1 { */ code?: number | null; /** - * A list of messages that carry the error details. There is a common set of message types for APIs to use. + * A list of messages that carry the error details. There is a common set of message types for APIs to use. */ details?: Array<{[key: string]: any}> | null; /** @@ -3565,7 +3565,7 @@ export namespace dialogflow_v2beta1 { message?: string | null; } /** - * An object representing a latitude/longitude pair. This is expressed as a pair of doubles representing degrees latitude and degrees longitude. Unless specified otherwise, this must conform to the <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84 standard</a>. Values must be within normalized ranges. + * An object representing a latitude/longitude pair. This is expressed as a pair of doubles representing degrees latitude and degrees longitude. Unless specified otherwise, this must conform to the WGS84 standard. Values must be within normalized ranges. */ export interface Schema$GoogleTypeLatLng { /** @@ -3622,8 +3622,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.deleteAgent({ - * // Required. The project that the agent to delete is associated with. - * // Format: `projects/`. + * // Required. The project that the agent to delete is associated with. Format: `projects/`. * parent: 'projects/my-project', * }); * console.log(res.data); @@ -3641,7 +3640,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project that the agent to delete is associated with. Format: `projects/`. + * @param {string} params.parent Required. The project that the agent to delete is associated with. Format: `projects/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -3760,8 +3759,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.getAgent({ - * // Required. The project that the agent to fetch is associated with. - * // Format: `projects/`. + * // Required. The project that the agent to fetch is associated with. Format: `projects/`. * parent: 'projects/my-project', * }); * console.log(res.data); @@ -3792,7 +3790,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project that the agent to fetch is associated with. Format: `projects/`. + * @param {string} params.parent Required. The project that the agent to fetch is associated with. Format: `projects/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -3915,8 +3913,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.setAgent({ - * // Required. The project of this agent. - * // Format: `projects/`. + * // Required. The project of this agent. Format: `projects/`. * parent: 'projects/my-project', * // Optional. The mask to control which fields get updated. * updateMask: 'placeholder-value', @@ -3968,7 +3965,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project of this agent. Format: `projects/`. + * @param {string} params.parent Required. The project of this agent. Format: `projects/`. * @param {string=} params.updateMask Optional. The mask to control which fields get updated. * @param {().GoogleCloudDialogflowV2beta1Agent} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -4067,21 +4064,21 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Deleteagent extends StandardParameters { /** - * Required. The project that the agent to delete is associated with. Format: `projects/`. + * Required. The project that the agent to delete is associated with. Format: `projects/`. */ parent?: string; } export interface Params$Resource$Projects$Getagent extends StandardParameters { /** - * Required. The project that the agent to fetch is associated with. Format: `projects/`. + * Required. The project that the agent to fetch is associated with. Format: `projects/`. */ parent?: string; } export interface Params$Resource$Projects$Setagent extends StandardParameters { /** - * Required. The project of this agent. Format: `projects/`. + * Required. The project of this agent. Format: `projects/`. */ parent?: string; /** @@ -4117,7 +4114,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.export - * @desc Exports the specified agent to a ZIP file. Operation + * @desc Exports the specified agent to a ZIP file. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -4145,8 +4142,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.export({ - * // Required. The project that the agent to export is associated with. - * // Format: `projects/`. + * // Required. The project that the agent to export is associated with. Format: `projects/`. * parent: 'projects/my-project', * * // Request body metadata @@ -4178,7 +4174,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project that the agent to export is associated with. Format: `projects/`. + * @param {string} params.parent Required. The project that the agent to export is associated with. Format: `projects/`. * @param {().GoogleCloudDialogflowV2beta1ExportAgentRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -4300,8 +4296,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.getFulfillment({ - * // Required. The name of the fulfillment. - * // Format: `projects//agent/fulfillment`. + * // Required. The name of the fulfillment. Format: `projects//agent/fulfillment`. * name: 'projects/my-project/agent/fulfillment', * }); * console.log(res.data); @@ -4325,7 +4320,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the fulfillment. Format: `projects//agent/fulfillment`. + * @param {string} params.name Required. The name of the fulfillment. Format: `projects//agent/fulfillment`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -4451,14 +4446,9 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.getValidationResult({ - * // 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. + * // 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. * languageCode: 'placeholder-value', - * // Required. The project that the agent is associated with. - * // Format: `projects/`. + * // Required. The project that the agent is associated with. Format: `projects/`. * parent: 'projects/my-project', * }); * console.log(res.data); @@ -4479,7 +4469,7 @@ export namespace dialogflow_v2beta1 { * * @param {object} params Parameters for request * @param {string=} params.languageCode 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. - * @param {string} params.parent Required. The project that the agent is associated with. Format: `projects/`. + * @param {string} params.parent Required. The project that the agent is associated with. Format: `projects/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -4587,7 +4577,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.import - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -4615,8 +4605,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.import({ - * // Required. The project that the agent to import is associated with. - * // Format: `projects/`. + * // Required. The project that the agent to import is associated with. Format: `projects/`. * parent: 'projects/my-project', * * // Request body metadata @@ -4649,7 +4638,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project that the agent to import is associated with. Format: `projects/`. + * @param {string} params.parent Required. The project that the agent to import is associated with. Format: `projects/`. * @param {().GoogleCloudDialogflowV2beta1ImportAgentRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -4743,7 +4732,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.restore - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -4771,8 +4760,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.restore({ - * // Required. The project that the agent to restore is associated with. - * // Format: `projects/`. + * // Required. The project that the agent to restore is associated with. Format: `projects/`. * parent: 'projects/my-project', * * // Request body metadata @@ -4805,7 +4793,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project that the agent to restore is associated with. Format: `projects/`. + * @param {string} params.parent Required. The project that the agent to restore is associated with. Format: `projects/`. * @param {().GoogleCloudDialogflowV2beta1RestoreAgentRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -4927,13 +4915,11 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.search({ - * // Optional. The maximum number of items to return in a single page. By - * // default 100 and at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The project to list agents from. - * // Format: `projects/`. + * // Required. The project to list agents from. Format: `projects/`. * parent: 'projects/my-project', * }); * console.log(res.data); @@ -4956,7 +4942,7 @@ export namespace dialogflow_v2beta1 { * @param {object} params Parameters for request * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The project to list agents from. Format: `projects/`. + * @param {string} params.parent Required. The project to list agents from. Format: `projects/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -5064,7 +5050,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.train - * @desc Trains the specified agent. Operation + * @desc Trains the specified agent. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -5092,8 +5078,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.train({ - * // Required. The project that the agent to train is associated with. - * // Format: `projects/`. + * // Required. The project that the agent to train is associated with. Format: `projects/`. * parent: 'projects/my-project', * * // Request body metadata @@ -5123,7 +5108,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project that the agent to train is associated with. Format: `projects/`. + * @param {string} params.parent Required. The project that the agent to train is associated with. Format: `projects/`. * @param {().GoogleCloudDialogflowV2beta1TrainAgentRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -5245,11 +5230,9 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.updateFulfillment({ - * // Required. The unique identifier of the fulfillment. - * // Format: `projects//agent/fulfillment`. + * // Required. The unique identifier of the fulfillment. Format: `projects//agent/fulfillment`. * name: 'projects/my-project/agent/fulfillment', - * // Required. The mask to control which fields get updated. If the mask is not - * // present, all fields will be updated. + * // Required. The mask to control which fields get updated. If the mask is not present, all fields will be updated. * updateMask: 'placeholder-value', * * // Request body metadata @@ -5285,7 +5268,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The unique identifier of the fulfillment. Format: `projects//agent/fulfillment`. + * @param {string} params.name Required. The unique identifier of the fulfillment. Format: `projects//agent/fulfillment`. * @param {string=} params.updateMask Required. The mask to control which fields get updated. If the mask is not present, all fields will be updated. * @param {().GoogleCloudDialogflowV2beta1Fulfillment} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -5387,7 +5370,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Export extends StandardParameters { /** - * Required. The project that the agent to export is associated with. Format: `projects/`. + * Required. The project that the agent to export is associated with. Format: `projects/`. */ parent?: string; @@ -5399,7 +5382,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Getfulfillment extends StandardParameters { /** - * Required. The name of the fulfillment. Format: `projects//agent/fulfillment`. + * Required. The name of the fulfillment. Format: `projects//agent/fulfillment`. */ name?: string; } @@ -5410,14 +5393,14 @@ export namespace dialogflow_v2beta1 { */ languageCode?: string; /** - * Required. The project that the agent is associated with. Format: `projects/`. + * Required. The project that the agent is associated with. Format: `projects/`. */ parent?: string; } export interface Params$Resource$Projects$Agent$Import extends StandardParameters { /** - * Required. The project that the agent to import is associated with. Format: `projects/`. + * Required. The project that the agent to import is associated with. Format: `projects/`. */ parent?: string; @@ -5429,7 +5412,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Restore extends StandardParameters { /** - * Required. The project that the agent to restore is associated with. Format: `projects/`. + * Required. The project that the agent to restore is associated with. Format: `projects/`. */ parent?: string; @@ -5449,14 +5432,14 @@ export namespace dialogflow_v2beta1 { */ pageToken?: string; /** - * Required. The project to list agents from. Format: `projects/`. + * Required. The project to list agents from. Format: `projects/`. */ parent?: string; } export interface Params$Resource$Projects$Agent$Train extends StandardParameters { /** - * Required. The project that the agent to train is associated with. Format: `projects/`. + * Required. The project that the agent to train is associated with. Format: `projects/`. */ parent?: string; @@ -5468,7 +5451,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Updatefulfillment extends StandardParameters { /** - * Required. The unique identifier of the fulfillment. Format: `projects//agent/fulfillment`. + * Required. The unique identifier of the fulfillment. Format: `projects//agent/fulfillment`. */ name?: string; /** @@ -5494,7 +5477,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.entityTypes.batchDelete - * @desc Deletes entity types in the specified agent. Operation + * @desc Deletes entity types in the specified agent. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -5522,8 +5505,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.entityTypes.batchDelete({ - * // Required. The name of the agent to delete all entities types for. Format: - * // `projects//agent`. + * // Required. The name of the agent to delete all entities types for. Format: `projects//agent`. * parent: 'projects/my-project/agent', * * // Request body metadata @@ -5555,7 +5537,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the agent to delete all entities types for. Format: `projects//agent`. + * @param {string} params.parent Required. The name of the agent to delete all entities types for. Format: `projects//agent`. * @param {().GoogleCloudDialogflowV2beta1BatchDeleteEntityTypesRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -5648,7 +5630,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.entityTypes.batchUpdate - * @desc Updates/Creates multiple entity types in the specified agent. Operation + * @desc Updates/Creates multiple entity types in the specified agent. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -5676,8 +5658,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.entityTypes.batchUpdate({ - * // Required. The name of the agent to update or create entity types in. - * // Format: `projects//agent`. + * // Required. The name of the agent to update or create entity types in. Format: `projects//agent`. * parent: 'projects/my-project/agent', * * // Request body metadata @@ -5712,7 +5693,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the agent to update or create entity types in. Format: `projects//agent`. + * @param {string} params.parent Required. The name of the agent to update or create entity types in. Format: `projects//agent`. * @param {().GoogleCloudDialogflowV2beta1BatchUpdateEntityTypesRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -5833,14 +5814,9 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.entityTypes.create({ - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // Required. The agent to create a entity type for. - * // Format: `projects//agent`. + * // Required. The agent to create a entity type for. Format: `projects//agent`. * parent: 'projects/my-project/agent', * * // Request body metadata @@ -5879,7 +5855,7 @@ export namespace dialogflow_v2beta1 { * * @param {object} params Parameters for request * @param {string=} params.languageCode 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). - * @param {string} params.parent Required. The agent to create a entity type for. Format: `projects//agent`. + * @param {string} params.parent Required. The agent to create a entity type for. Format: `projects//agent`. * @param {().GoogleCloudDialogflowV2beta1EntityType} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -6009,8 +5985,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.entityTypes.delete({ - * // Required. The name of the entity type to delete. - * // Format: `projects//agent/entityTypes/`. + * // Required. The name of the entity type to delete. Format: `projects//agent/entityTypes/`. * name: 'projects/my-project/agent/entityTypes/my-entityType', * }); * console.log(res.data); @@ -6028,7 +6003,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the entity type to delete. Format: `projects//agent/entityTypes/`. + * @param {string} params.name Required. The name of the entity type to delete. Format: `projects//agent/entityTypes/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -6142,14 +6117,9 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.entityTypes.get({ - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // Required. The name of the entity type. - * // Format: `projects//agent/entityTypes/`. + * // Required. The name of the entity type. Format: `projects//agent/entityTypes/`. * name: 'projects/my-project/agent/entityTypes/my-entityType', * }); * console.log(res.data); @@ -6175,7 +6145,7 @@ export namespace dialogflow_v2beta1 { * * @param {object} params Parameters for request * @param {string=} params.languageCode 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). - * @param {string} params.name Required. The name of the entity type. Format: `projects//agent/entityTypes/`. + * @param {string} params.name Required. The name of the entity type. Format: `projects//agent/entityTypes/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -6301,19 +6271,13 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.entityTypes.list({ - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // Optional. The maximum number of items to return in a single page. By - * // default 100 and at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The agent to list all entity types from. - * // Format: `projects//agent`. + * // Required. The agent to list all entity types from. Format: `projects//agent`. * parent: 'projects/my-project/agent', * }); * console.log(res.data); @@ -6337,7 +6301,7 @@ export namespace dialogflow_v2beta1 { * @param {string=} params.languageCode 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). * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The agent to list all entity types from. Format: `projects//agent`. + * @param {string} params.parent Required. The agent to list all entity types from. Format: `projects//agent`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -6477,16 +6441,9 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.entityTypes.patch({ - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // The unique identifier of the entity type. - * // Required for EntityTypes.UpdateEntityType and - * // EntityTypes.BatchUpdateEntityTypes methods. - * // Format: `projects//agent/entityTypes/`. + * // The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`. * name: 'projects/my-project/agent/entityTypes/my-entityType', * // Optional. The mask to control which fields get updated. * updateMask: 'placeholder-value', @@ -6527,7 +6484,7 @@ export namespace dialogflow_v2beta1 { * * @param {object} params Parameters for request * @param {string=} params.languageCode 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). - * @param {string} params.name The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`. + * @param {string} params.name The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`. * @param {string=} params.updateMask Optional. The mask to control which fields get updated. * @param {().GoogleCloudDialogflowV2beta1EntityType} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -6629,7 +6586,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Entitytypes$Batchdelete extends StandardParameters { /** - * Required. The name of the agent to delete all entities types for. Format: `projects//agent`. + * Required. The name of the agent to delete all entities types for. Format: `projects//agent`. */ parent?: string; @@ -6641,7 +6598,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Entitytypes$Batchupdate extends StandardParameters { /** - * Required. The name of the agent to update or create entity types in. Format: `projects//agent`. + * Required. The name of the agent to update or create entity types in. Format: `projects//agent`. */ parent?: string; @@ -6657,7 +6614,7 @@ export namespace dialogflow_v2beta1 { */ languageCode?: string; /** - * Required. The agent to create a entity type for. Format: `projects//agent`. + * Required. The agent to create a entity type for. Format: `projects//agent`. */ parent?: string; @@ -6669,7 +6626,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Entitytypes$Delete extends StandardParameters { /** - * Required. The name of the entity type to delete. Format: `projects//agent/entityTypes/`. + * Required. The name of the entity type to delete. Format: `projects//agent/entityTypes/`. */ name?: string; } @@ -6680,7 +6637,7 @@ export namespace dialogflow_v2beta1 { */ languageCode?: string; /** - * Required. The name of the entity type. Format: `projects//agent/entityTypes/`. + * Required. The name of the entity type. Format: `projects//agent/entityTypes/`. */ name?: string; } @@ -6699,7 +6656,7 @@ export namespace dialogflow_v2beta1 { */ pageToken?: string; /** - * Required. The agent to list all entity types from. Format: `projects//agent`. + * Required. The agent to list all entity types from. Format: `projects//agent`. */ parent?: string; } @@ -6710,7 +6667,7 @@ export namespace dialogflow_v2beta1 { */ languageCode?: string; /** - * The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`. + * The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`. */ name?: string; /** @@ -6732,7 +6689,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.entityTypes.entities.batchCreate - * @desc Creates multiple new entities in the specified entity type. Operation + * @desc Creates multiple new entities in the specified entity type. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -6760,8 +6717,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.entityTypes.entities.batchCreate({ - * // Required. The name of the entity type to create entities in. Format: - * // `projects//agent/entityTypes/`. + * // Required. The name of the entity type to create entities in. Format: `projects//agent/entityTypes/`. * parent: 'projects/my-project/agent/entityTypes/my-entityType', * * // Request body metadata @@ -6794,7 +6750,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the entity type to create entities in. Format: `projects//agent/entityTypes/`. + * @param {string} params.parent Required. The name of the entity type to create entities in. Format: `projects//agent/entityTypes/`. * @param {().GoogleCloudDialogflowV2beta1BatchCreateEntitiesRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -6888,7 +6844,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.entityTypes.entities.batchDelete - * @desc Deletes entities in the specified entity type. Operation + * @desc Deletes entities in the specified entity type. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -6916,8 +6872,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.entityTypes.entities.batchDelete({ - * // Required. The name of the entity type to delete entries for. Format: - * // `projects//agent/entityTypes/`. + * // Required. The name of the entity type to delete entries for. Format: `projects//agent/entityTypes/`. * parent: 'projects/my-project/agent/entityTypes/my-entityType', * * // Request body metadata @@ -6950,7 +6905,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the entity type to delete entries for. Format: `projects//agent/entityTypes/`. + * @param {string} params.parent Required. The name of the entity type to delete entries for. Format: `projects//agent/entityTypes/`. * @param {().GoogleCloudDialogflowV2beta1BatchDeleteEntitiesRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -7044,7 +6999,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.entityTypes.entities.batchUpdate - * @desc 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 + * @desc 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 * @example * // Before running the sample: * // - Enable the API at: @@ -7072,8 +7027,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.entityTypes.entities.batchUpdate({ - * // Required. The name of the entity type to update or create entities in. - * // Format: `projects//agent/entityTypes/`. + * // Required. The name of the entity type to update or create entities in. Format: `projects//agent/entityTypes/`. * parent: 'projects/my-project/agent/entityTypes/my-entityType', * * // Request body metadata @@ -7107,7 +7061,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the entity type to update or create entities in. Format: `projects//agent/entityTypes/`. + * @param {string} params.parent Required. The name of the entity type to update or create entities in. Format: `projects//agent/entityTypes/`. * @param {().GoogleCloudDialogflowV2beta1BatchUpdateEntitiesRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -7203,7 +7157,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Entitytypes$Entities$Batchcreate extends StandardParameters { /** - * Required. The name of the entity type to create entities in. Format: `projects//agent/entityTypes/`. + * Required. The name of the entity type to create entities in. Format: `projects//agent/entityTypes/`. */ parent?: string; @@ -7215,7 +7169,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Entitytypes$Entities$Batchdelete extends StandardParameters { /** - * Required. The name of the entity type to delete entries for. Format: `projects//agent/entityTypes/`. + * Required. The name of the entity type to delete entries for. Format: `projects//agent/entityTypes/`. */ parent?: string; @@ -7227,7 +7181,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Entitytypes$Entities$Batchupdate extends StandardParameters { /** - * Required. The name of the entity type to update or create entities in. Format: `projects//agent/entityTypes/`. + * Required. The name of the entity type to update or create entities in. Format: `projects//agent/entityTypes/`. */ parent?: string; @@ -7275,16 +7229,11 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.environments.list({ - * // Optional. The maximum number of items to return in a single page. By default 100 and - * // at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The agent to list all environments from. - * // Format: - * // - `projects//agent` - * // - `projects//locations//agent + * // Required. The agent to list all environments from. Format: - `projects//agent` - `projects//locations//agent * parent: 'projects/my-project/agent', * }); * console.log(res.data); @@ -7307,7 +7256,7 @@ export namespace dialogflow_v2beta1 { * @param {object} params Parameters for request * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The agent to list all environments from. Format: - `projects//agent` - `projects//locations//agent + * @param {string} params.parent Required. The agent to list all environments from. Format: - `projects//agent` - `projects//locations//agent * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -7429,7 +7378,7 @@ export namespace dialogflow_v2beta1 { */ pageToken?: string; /** - * Required. The agent to list all environments from. Format: - `projects//agent` - `projects//locations//agent + * Required. The agent to list all environments from. Format: - `projects//agent` - `projects//locations//agent */ parent?: string; } @@ -7490,11 +7439,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.deleteContexts( * { - * // Required. The name of the session to delete all contexts from. Format: - * // `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' - * // environment. If `User ID` is not specified, we assume default '-' user. + * // Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session', * } @@ -7514,7 +7459,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -7634,18 +7579,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.detectIntent( * { - * // Required. The name of the session this query is sent to. Format: - * // `projects//agent/sessions/`, or - * // `projects//agent/environments//users//sessions/`. 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. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). * session: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session', * @@ -7684,7 +7618,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.session Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). + * @param {string} params.session Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). * @param {().GoogleCloudDialogflowV2beta1DetectIntentRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -7795,14 +7729,14 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Environments$Users$Sessions$Deletecontexts extends StandardParameters { /** - * Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; } export interface Params$Resource$Projects$Agent$Environments$Users$Sessions$Detectintent extends StandardParameters { /** - * Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). */ session?: string; @@ -7820,7 +7754,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.environments.users.sessions.contexts.create - * @desc Creates a context. If the specified context already exists, overrides the context. + * @desc Creates a context. If the specified context already exists, overrides the context. * @example * // Before running the sample: * // - Enable the API at: @@ -7849,12 +7783,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.contexts.create( * { - * // Required. The session to create a context for. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume - * // default 'draft' environment. If `User ID` is not specified, we assume - * // default '-' user. + * // Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session', * @@ -7888,7 +7817,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {().GoogleCloudDialogflowV2beta1Context} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -8013,12 +7942,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.contexts.delete( * { - * // Required. The name of the context to delete. Format: - * // `projects//agent/sessions//contexts/` - * // or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is - * // not specified, we assume default 'draft' environment. If `User ID` is not - * // specified, we assume default '-' user. + * // Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * name: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session/contexts/my-context', * } @@ -8038,7 +7962,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.name Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -8153,12 +8077,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.contexts.get( * { - * // Required. The name of the context. Format: - * // `projects//agent/sessions//contexts/` - * // or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is - * // not specified, we assume default 'draft' environment. If `User ID` is not - * // specified, we assume default '-' user. + * // Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * name: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session/contexts/my-context', * } @@ -8182,7 +8101,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.name Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -8303,17 +8222,11 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.contexts.list( * { - * // Optional. The maximum number of items to return in a single page. By - * // default 100 and at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The session to list all contexts from. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume - * // default 'draft' environment. If `User ID` is not specified, we assume - * // default '-' user. + * // Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session', * } @@ -8338,7 +8251,7 @@ export namespace dialogflow_v2beta1 { * @param {object} params Parameters for request * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -8475,23 +8388,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.contexts.patch( * { - * // 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` + * // 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` * name: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session/contexts/my-context', * // Optional. The mask to control which fields get updated. @@ -8527,7 +8424,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name 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` + * @param {string} params.name 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` * @param {string=} params.updateMask Optional. The mask to control which fields get updated. * @param {().GoogleCloudDialogflowV2beta1Context} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -8623,7 +8520,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Environments$Users$Sessions$Contexts$Create extends StandardParameters { /** - * Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; @@ -8635,14 +8532,14 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Environments$Users$Sessions$Contexts$Delete extends StandardParameters { /** - * Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ name?: string; } export interface Params$Resource$Projects$Agent$Environments$Users$Sessions$Contexts$Get extends StandardParameters { /** - * Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ name?: string; } @@ -8657,14 +8554,14 @@ export namespace dialogflow_v2beta1 { */ pageToken?: string; /** - * Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; } export interface Params$Resource$Projects$Agent$Environments$Users$Sessions$Contexts$Patch extends StandardParameters { /** - * 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` + * 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` */ name?: string; /** @@ -8686,7 +8583,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.environments.users.sessions.entityTypes.create - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -8715,12 +8612,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.entityTypes.create( * { - * // Required. The session to create a session entity type for. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users// - * // sessions/`. If `Environment ID` is not specified, we assume - * // default 'draft' environment. If `User ID` is not specified, we assume - * // default '-' user. + * // Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session', * @@ -8754,7 +8646,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {().GoogleCloudDialogflowV2beta1SessionEntityType} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -8864,7 +8756,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.environments.users.sessions.entityTypes.delete - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -8893,12 +8785,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.entityTypes.delete( * { - * // Required. The name of the entity type to delete. 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. + * // Required. The name of the entity type to delete. 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. * name: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session/entityTypes/my-entityType', * } @@ -8918,7 +8805,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the entity type to delete. 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. + * @param {string} params.name Required. The name of the entity type to delete. 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. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -9004,7 +8891,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.environments.users.sessions.entityTypes.get - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -9033,12 +8920,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.entityTypes.get( * { - * // Required. The name of the 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. + * // Required. The name of the 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. * name: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session/entityTypes/my-entityType', * } @@ -9062,7 +8944,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the 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. + * @param {string} params.name Required. The name of the 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. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -9168,7 +9050,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.environments.users.sessions.entityTypes.list - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -9197,17 +9079,11 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.entityTypes.list( * { - * // Optional. The maximum number of items to return in a single page. By - * // default 100 and at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The session to list all session entity types from. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users// - * // sessions/`. - * // If `Environment ID` is not specified, we assume default 'draft' - * // environment. If `User ID` is not specified, we assume default '-' user. + * // Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session', * } @@ -9232,7 +9108,7 @@ export namespace dialogflow_v2beta1 { * @param {object} params Parameters for request * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -9344,7 +9220,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.environments.users.sessions.entityTypes.patch - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -9373,16 +9249,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.agent.environments.users.sessions.entityTypes.patch( * { - * // 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. + * // 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. * name: * 'projects/my-project/agent/environments/my-environment/users/my-user/sessions/my-session/entityTypes/my-entityType', * // Optional. The mask to control which fields get updated. @@ -9418,7 +9285,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name 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. + * @param {string} params.name 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. * @param {string=} params.updateMask Optional. The mask to control which fields get updated. * @param {().GoogleCloudDialogflowV2beta1SessionEntityType} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -9528,7 +9395,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Environments$Users$Sessions$Entitytypes$Create extends StandardParameters { /** - * Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; @@ -9540,14 +9407,14 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Environments$Users$Sessions$Entitytypes$Delete extends StandardParameters { /** - * Required. The name of the entity type to delete. 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. + * Required. The name of the entity type to delete. 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. */ name?: string; } export interface Params$Resource$Projects$Agent$Environments$Users$Sessions$Entitytypes$Get extends StandardParameters { /** - * Required. The name of the 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. + * Required. The name of the 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. */ name?: string; } @@ -9562,14 +9429,14 @@ export namespace dialogflow_v2beta1 { */ pageToken?: string; /** - * Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; } export interface Params$Resource$Projects$Agent$Environments$Users$Sessions$Entitytypes$Patch extends StandardParameters { /** - * 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. + * 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. */ name?: string; /** @@ -9591,7 +9458,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.intents.batchDelete - * @desc Deletes intents in the specified agent. Operation + * @desc Deletes intents in the specified agent. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -9619,8 +9486,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.intents.batchDelete({ - * // Required. The name of the agent to delete all entities types for. Format: - * // `projects//agent`. + * // Required. The name of the agent to delete all entities types for. Format: `projects//agent`. * parent: 'projects/my-project/agent', * * // Request body metadata @@ -9652,7 +9518,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the agent to delete all entities types for. Format: `projects//agent`. + * @param {string} params.parent Required. The name of the agent to delete all entities types for. Format: `projects//agent`. * @param {().GoogleCloudDialogflowV2beta1BatchDeleteIntentsRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -9746,7 +9612,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.intents.batchUpdate - * @desc Updates/Creates multiple intents in the specified agent. Operation + * @desc Updates/Creates multiple intents in the specified agent. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -9774,8 +9640,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.intents.batchUpdate({ - * // Required. The name of the agent to update or create intents in. - * // Format: `projects//agent`. + * // Required. The name of the agent to update or create intents in. Format: `projects//agent`. * parent: 'projects/my-project/agent', * * // Request body metadata @@ -9811,7 +9676,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the agent to update or create intents in. Format: `projects//agent`. + * @param {string} params.parent Required. The name of the agent to update or create intents in. Format: `projects//agent`. * @param {().GoogleCloudDialogflowV2beta1BatchUpdateIntentsRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -9935,14 +9800,9 @@ export namespace dialogflow_v2beta1 { * const res = await dialogflow.projects.agent.intents.create({ * // Optional. The resource view to apply to the returned intent. * intentView: 'placeholder-value', - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // Required. The agent to create a intent for. - * // Format: `projects//agent`. + * // Required. The agent to create a intent for. Format: `projects//agent`. * parent: 'projects/my-project/agent', * * // Request body metadata @@ -10010,7 +9870,7 @@ export namespace dialogflow_v2beta1 { * @param {object} params Parameters for request * @param {string=} params.intentView Optional. The resource view to apply to the returned intent. * @param {string=} params.languageCode 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). - * @param {string} params.parent Required. The agent to create a intent for. Format: `projects//agent`. + * @param {string} params.parent Required. The agent to create a intent for. Format: `projects//agent`. * @param {().GoogleCloudDialogflowV2beta1Intent} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -10134,10 +9994,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.intents.delete({ - * // Required. The name of the intent to delete. If this intent has direct or - * // indirect followup intents, we also delete them. - * // - * // Format: `projects//agent/intents/`. + * // Required. The name of the intent to delete. If this intent has direct or indirect followup intents, we also delete them. Format: `projects//agent/intents/`. * name: 'projects/my-project/agent/intents/my-intent', * }); * console.log(res.data); @@ -10155,7 +10012,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the intent to delete. If this intent has direct or indirect followup intents, we also delete them. Format: `projects//agent/intents/`. + * @param {string} params.name Required. The name of the intent to delete. If this intent has direct or indirect followup intents, we also delete them. Format: `projects//agent/intents/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -10271,14 +10128,9 @@ export namespace dialogflow_v2beta1 { * const res = await dialogflow.projects.agent.intents.get({ * // Optional. The resource view to apply to the returned intent. * intentView: 'placeholder-value', - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // Required. The name of the intent. - * // Format: `projects//agent/intents/`. + * // Required. The name of the intent. Format: `projects//agent/intents/`. * name: 'projects/my-project/agent/intents/my-intent', * }); * console.log(res.data); @@ -10319,7 +10171,7 @@ export namespace dialogflow_v2beta1 { * @param {object} params Parameters for request * @param {string=} params.intentView Optional. The resource view to apply to the returned intent. * @param {string=} params.languageCode 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). - * @param {string} params.name Required. The name of the intent. Format: `projects//agent/intents/`. + * @param {string} params.name Required. The name of the intent. Format: `projects//agent/intents/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -10441,19 +10293,13 @@ export namespace dialogflow_v2beta1 { * const res = await dialogflow.projects.agent.intents.list({ * // Optional. The resource view to apply to the returned intent. * intentView: 'placeholder-value', - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // Optional. The maximum number of items to return in a single page. By - * // default 100 and at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The agent to list all intents from. - * // Format: `projects//agent`. + * // Required. The agent to list all intents from. Format: `projects//agent`. * parent: 'projects/my-project/agent', * }); * console.log(res.data); @@ -10478,7 +10324,7 @@ export namespace dialogflow_v2beta1 { * @param {string=} params.languageCode 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). * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The agent to list all intents from. Format: `projects//agent`. + * @param {string} params.parent Required. The agent to list all intents from. Format: `projects//agent`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -10616,16 +10462,9 @@ export namespace dialogflow_v2beta1 { * const res = await dialogflow.projects.agent.intents.patch({ * // Optional. The resource view to apply to the returned intent. * intentView: 'placeholder-value', - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // Optional. The unique identifier of this intent. - * // Required for Intents.UpdateIntent and Intents.BatchUpdateIntents - * // methods. - * // Format: `projects//agent/intents/`. + * // Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`. * name: 'projects/my-project/agent/intents/my-intent', * // Optional. The mask to control which fields get updated. * updateMask: 'placeholder-value', @@ -10695,7 +10534,7 @@ export namespace dialogflow_v2beta1 { * @param {object} params Parameters for request * @param {string=} params.intentView Optional. The resource view to apply to the returned intent. * @param {string=} params.languageCode 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). - * @param {string} params.name Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`. + * @param {string} params.name Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`. * @param {string=} params.updateMask Optional. The mask to control which fields get updated. * @param {().GoogleCloudDialogflowV2beta1Intent} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -10791,7 +10630,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Intents$Batchdelete extends StandardParameters { /** - * Required. The name of the agent to delete all entities types for. Format: `projects//agent`. + * Required. The name of the agent to delete all entities types for. Format: `projects//agent`. */ parent?: string; @@ -10803,7 +10642,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Intents$Batchupdate extends StandardParameters { /** - * Required. The name of the agent to update or create intents in. Format: `projects//agent`. + * Required. The name of the agent to update or create intents in. Format: `projects//agent`. */ parent?: string; @@ -10823,7 +10662,7 @@ export namespace dialogflow_v2beta1 { */ languageCode?: string; /** - * Required. The agent to create a intent for. Format: `projects//agent`. + * Required. The agent to create a intent for. Format: `projects//agent`. */ parent?: string; @@ -10835,7 +10674,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Intents$Delete extends StandardParameters { /** - * Required. The name of the intent to delete. If this intent has direct or indirect followup intents, we also delete them. Format: `projects//agent/intents/`. + * Required. The name of the intent to delete. If this intent has direct or indirect followup intents, we also delete them. Format: `projects//agent/intents/`. */ name?: string; } @@ -10850,7 +10689,7 @@ export namespace dialogflow_v2beta1 { */ languageCode?: string; /** - * Required. The name of the intent. Format: `projects//agent/intents/`. + * Required. The name of the intent. Format: `projects//agent/intents/`. */ name?: string; } @@ -10873,7 +10712,7 @@ export namespace dialogflow_v2beta1 { */ pageToken?: string; /** - * Required. The agent to list all intents from. Format: `projects//agent`. + * Required. The agent to list all intents from. Format: `projects//agent`. */ parent?: string; } @@ -10888,7 +10727,7 @@ export namespace dialogflow_v2beta1 { */ languageCode?: string; /** - * Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`. + * Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`. */ name?: string; /** @@ -10914,7 +10753,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.knowledgeBases.create - * @desc Creates a knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`. + * @desc Creates a knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`. * @example * // Before running the sample: * // - Enable the API at: @@ -10942,8 +10781,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.knowledgeBases.create({ - * // Required. The project to create a knowledge base for. - * // Format: `projects/`. + * // Required. The project to create a knowledge base for. Format: `projects/`. * parent: 'projects/my-project/agent', * * // Request body metadata @@ -10975,7 +10813,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project to create a knowledge base for. Format: `projects/`. + * @param {string} params.parent Required. The project to create a knowledge base for. Format: `projects/`. * @param {().GoogleCloudDialogflowV2beta1KnowledgeBase} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -11079,7 +10917,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.knowledgeBases.delete - * @desc Deletes the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`. + * @desc Deletes the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`. * @example * // Before running the sample: * // - Enable the API at: @@ -11107,11 +10945,9 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.knowledgeBases.delete({ - * // Optional. Force deletes the knowledge base. When set to true, any documents - * // in the knowledge base are also deleted. + * // Optional. Force deletes the knowledge base. When set to true, any documents in the knowledge base are also deleted. * force: 'placeholder-value', - * // Required. The name of the knowledge base to delete. - * // Format: `projects//knowledgeBases/`. + * // Required. The name of the knowledge base to delete. Format: `projects//knowledgeBases/`. * name: 'projects/my-project/agent/knowledgeBases/my-knowledgeBase', * }); * console.log(res.data); @@ -11130,7 +10966,7 @@ export namespace dialogflow_v2beta1 { * * @param {object} params Parameters for request * @param {boolean=} params.force Optional. Force deletes the knowledge base. When set to true, any documents in the knowledge base are also deleted. - * @param {string} params.name Required. The name of the knowledge base to delete. Format: `projects//knowledgeBases/`. + * @param {string} params.name Required. The name of the knowledge base to delete. Format: `projects//knowledgeBases/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -11216,7 +11052,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.knowledgeBases.get - * @desc Retrieves the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`. + * @desc Retrieves the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`. * @example * // Before running the sample: * // - Enable the API at: @@ -11244,8 +11080,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.knowledgeBases.get({ - * // Required. The name of the knowledge base to retrieve. - * // Format `projects//knowledgeBases/`. + * // Required. The name of the knowledge base to retrieve. Format `projects//knowledgeBases/`. * name: 'projects/my-project/agent/knowledgeBases/my-knowledgeBase', * }); * console.log(res.data); @@ -11267,7 +11102,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the knowledge base to retrieve. Format `projects//knowledgeBases/`. + * @param {string} params.name Required. The name of the knowledge base to retrieve. Format `projects//knowledgeBases/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -11367,7 +11202,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.knowledgeBases.list - * @desc Returns the list of all knowledge bases of the specified agent. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`. + * @desc Returns the list of all knowledge bases of the specified agent. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`. * @example * // Before running the sample: * // - Enable the API at: @@ -11395,13 +11230,11 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.knowledgeBases.list({ - * // Optional. The maximum number of items to return in a single page. By - * // default 10 and at most 100. + * // Optional. The maximum number of items to return in a single page. By default 10 and at most 100. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The project to list of knowledge bases for. - * // Format: `projects/`. + * // Required. The project to list of knowledge bases for. Format: `projects/`. * parent: 'projects/my-project/agent', * }); * console.log(res.data); @@ -11424,7 +11257,7 @@ export namespace dialogflow_v2beta1 { * @param {object} params Parameters for request * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 10 and at most 100. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The project to list of knowledge bases for. Format: `projects/`. + * @param {string} params.parent Required. The project to list of knowledge bases for. Format: `projects/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -11536,7 +11369,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.knowledgeBases.patch - * @desc Updates the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`. + * @desc Updates the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`. * @example * // Before running the sample: * // - Enable the API at: @@ -11564,13 +11397,9 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.knowledgeBases.patch({ - * // The knowledge base resource name. - * // The name must be empty when creating a knowledge base. - * // Format: `projects//knowledgeBases/`. + * // The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`. * name: 'projects/my-project/agent/knowledgeBases/my-knowledgeBase', - * // Optional. Not specified means `update all`. - * // Currently, only `display_name` can be updated, an InvalidArgument will be - * // returned for attempting to update other fields. + * // Optional. Not specified means `update all`. Currently, only `display_name` can be updated, an InvalidArgument will be returned for attempting to update other fields. * updateMask: 'placeholder-value', * * // Request body metadata @@ -11602,7 +11431,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`. + * @param {string} params.name The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`. * @param {string=} params.updateMask Optional. Not specified means `update all`. Currently, only `display_name` can be updated, an InvalidArgument will be returned for attempting to update other fields. * @param {().GoogleCloudDialogflowV2beta1KnowledgeBase} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -11706,7 +11535,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Knowledgebases$Create extends StandardParameters { /** - * Required. The project to create a knowledge base for. Format: `projects/`. + * Required. The project to create a knowledge base for. Format: `projects/`. */ parent?: string; @@ -11722,14 +11551,14 @@ export namespace dialogflow_v2beta1 { */ force?: boolean; /** - * Required. The name of the knowledge base to delete. Format: `projects//knowledgeBases/`. + * Required. The name of the knowledge base to delete. Format: `projects//knowledgeBases/`. */ name?: string; } export interface Params$Resource$Projects$Agent$Knowledgebases$Get extends StandardParameters { /** - * Required. The name of the knowledge base to retrieve. Format `projects//knowledgeBases/`. + * Required. The name of the knowledge base to retrieve. Format `projects//knowledgeBases/`. */ name?: string; } @@ -11744,14 +11573,14 @@ export namespace dialogflow_v2beta1 { */ pageToken?: string; /** - * Required. The project to list of knowledge bases for. Format: `projects/`. + * Required. The project to list of knowledge bases for. Format: `projects/`. */ parent?: string; } export interface Params$Resource$Projects$Agent$Knowledgebases$Patch extends StandardParameters { /** - * The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`. + * The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`. */ name?: string; /** @@ -11773,7 +11602,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.knowledgeBases.documents.create - * @desc Creates a new document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. + * @desc Creates a new document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. * @example * // Before running the sample: * // - Enable the API at: @@ -11801,8 +11630,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.knowledgeBases.documents.create({ - * // Required. The knoweldge base to create a document for. - * // Format: `projects//knowledgeBases/`. + * // Required. The knoweldge base to create a document for. Format: `projects//knowledgeBases/`. * parent: 'projects/my-project/agent/knowledgeBases/my-knowledgeBase', * * // Request body metadata @@ -11842,7 +11670,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The knoweldge base to create a document for. Format: `projects//knowledgeBases/`. + * @param {string} params.parent Required. The knoweldge base to create a document for. Format: `projects//knowledgeBases/`. * @param {().GoogleCloudDialogflowV2beta1Document} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -11936,7 +11764,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.knowledgeBases.documents.delete - * @desc Deletes the specified document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. + * @desc Deletes the specified document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. * @example * // Before running the sample: * // - Enable the API at: @@ -11964,9 +11792,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.knowledgeBases.documents.delete({ - * // Required. The name of the document to delete. - * // Format: `projects//knowledgeBases//documents/`. + * // Required. The name of the document to delete. Format: `projects//knowledgeBases//documents/`. * name: * 'projects/my-project/agent/knowledgeBases/my-knowledgeBase/documents/my-document', * }); @@ -11991,7 +11817,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the document to delete. Format: `projects//knowledgeBases//documents/`. + * @param {string} params.name Required. The name of the document to delete. Format: `projects//knowledgeBases//documents/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -12081,7 +11907,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.knowledgeBases.documents.get - * @desc Retrieves the specified document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. + * @desc Retrieves the specified document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. * @example * // Before running the sample: * // - Enable the API at: @@ -12109,9 +11935,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.knowledgeBases.documents.get({ - * // Required. The name of the document to retrieve. - * // Format `projects//knowledgeBases//documents/`. + * // Required. The name of the document to retrieve. Format `projects//knowledgeBases//documents/`. * name: * 'projects/my-project/agent/knowledgeBases/my-knowledgeBase/documents/my-document', * }); @@ -12140,7 +11964,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the document to retrieve. Format `projects//knowledgeBases//documents/`. + * @param {string} params.name Required. The name of the document to retrieve. Format `projects//knowledgeBases//documents/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -12238,7 +12062,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.knowledgeBases.documents.list - * @desc Returns the list of all documents of the knowledge base. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. + * @desc Returns the list of all documents of the knowledge base. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. * @example * // Before running the sample: * // - Enable the API at: @@ -12266,13 +12090,11 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.knowledgeBases.documents.list({ - * // The maximum number of items to return in a single page. By - * // default 10 and at most 100. + * // The maximum number of items to return in a single page. By default 10 and at most 100. * pageSize: 'placeholder-value', * // The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The knowledge base to list all documents for. - * // Format: `projects//knowledgeBases/`. + * // Required. The knowledge base to list all documents for. Format: `projects//knowledgeBases/`. * parent: 'projects/my-project/agent/knowledgeBases/my-knowledgeBase', * }); * console.log(res.data); @@ -12295,7 +12117,7 @@ export namespace dialogflow_v2beta1 { * @param {object} params Parameters for request * @param {integer=} params.pageSize The maximum number of items to return in a single page. By default 10 and at most 100. * @param {string=} params.pageToken The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The knowledge base to list all documents for. Format: `projects//knowledgeBases/`. + * @param {string} params.parent Required. The knowledge base to list all documents for. Format: `projects//knowledgeBases/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -12403,7 +12225,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.knowledgeBases.documents.patch - * @desc Updates the specified document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. + * @desc Updates the specified document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. * @example * // Before running the sample: * // - Enable the API at: @@ -12431,15 +12253,10 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.knowledgeBases.documents.patch({ - * // Optional. The document resource name. - * // The name must be empty when creating a document. - * // Format: `projects//knowledgeBases//documents/`. + * // Optional. The document resource name. The name must be empty when creating a document. Format: `projects//knowledgeBases//documents/`. * name: * 'projects/my-project/agent/knowledgeBases/my-knowledgeBase/documents/my-document', - * // Optional. Not specified means `update all`. - * // Currently, only `display_name` can be updated, an InvalidArgument will be - * // returned for attempting to update other fields. + * // Optional. Not specified means `update all`. Currently, only `display_name` can be updated, an InvalidArgument will be returned for attempting to update other fields. * updateMask: 'placeholder-value', * * // Request body metadata @@ -12479,7 +12296,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Optional. The document resource name. The name must be empty when creating a document. Format: `projects//knowledgeBases//documents/`. + * @param {string} params.name Optional. The document resource name. The name must be empty when creating a document. Format: `projects//knowledgeBases//documents/`. * @param {string=} params.updateMask Optional. Not specified means `update all`. Currently, only `display_name` can be updated, an InvalidArgument will be returned for attempting to update other fields. * @param {().GoogleCloudDialogflowV2beta1Document} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -12571,7 +12388,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.knowledgeBases.documents.reload - * @desc 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: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. + * @desc 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: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. * @example * // Before running the sample: * // - Enable the API at: @@ -12599,9 +12416,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.knowledgeBases.documents.reload({ - * // Required. The name of the document to reload. - * // Format: `projects//knowledgeBases//documents/` + * // Required. The name of the document to reload. Format: `projects//knowledgeBases//documents/` * name: * 'projects/my-project/agent/knowledgeBases/my-knowledgeBase/documents/my-document', * @@ -12634,7 +12449,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the document to reload. Format: `projects//knowledgeBases//documents/` + * @param {string} params.name Required. The name of the document to reload. Format: `projects//knowledgeBases//documents/` * @param {().GoogleCloudDialogflowV2beta1ReloadDocumentRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -12730,7 +12545,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Knowledgebases$Documents$Create extends StandardParameters { /** - * Required. The knoweldge base to create a document for. Format: `projects//knowledgeBases/`. + * Required. The knoweldge base to create a document for. Format: `projects//knowledgeBases/`. */ parent?: string; @@ -12742,14 +12557,14 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Knowledgebases$Documents$Delete extends StandardParameters { /** - * Required. The name of the document to delete. Format: `projects//knowledgeBases//documents/`. + * Required. The name of the document to delete. Format: `projects//knowledgeBases//documents/`. */ name?: string; } export interface Params$Resource$Projects$Agent$Knowledgebases$Documents$Get extends StandardParameters { /** - * Required. The name of the document to retrieve. Format `projects//knowledgeBases//documents/`. + * Required. The name of the document to retrieve. Format `projects//knowledgeBases//documents/`. */ name?: string; } @@ -12764,14 +12579,14 @@ export namespace dialogflow_v2beta1 { */ pageToken?: string; /** - * Required. The knowledge base to list all documents for. Format: `projects//knowledgeBases/`. + * Required. The knowledge base to list all documents for. Format: `projects//knowledgeBases/`. */ parent?: string; } export interface Params$Resource$Projects$Agent$Knowledgebases$Documents$Patch extends StandardParameters { /** - * Optional. The document resource name. The name must be empty when creating a document. Format: `projects//knowledgeBases//documents/`. + * Optional. The document resource name. The name must be empty when creating a document. Format: `projects//knowledgeBases//documents/`. */ name?: string; /** @@ -12787,7 +12602,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Knowledgebases$Documents$Reload extends StandardParameters { /** - * Required. The name of the document to reload. Format: `projects//knowledgeBases//documents/` + * Required. The name of the document to reload. Format: `projects//knowledgeBases//documents/` */ name?: string; @@ -12841,11 +12656,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.deleteContexts({ - * // Required. The name of the session to delete all contexts from. Format: - * // `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' - * // environment. If `User ID` is not specified, we assume default '-' user. + * // Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: 'projects/my-project/agent/sessions/my-session', * }); * console.log(res.data); @@ -12863,7 +12674,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -12982,18 +12793,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.detectIntent({ - * // Required. The name of the session this query is sent to. Format: - * // `projects//agent/sessions/`, or - * // `projects//agent/environments//users//sessions/`. 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. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). * session: 'projects/my-project/agent/sessions/my-session', * * // Request body metadata @@ -13030,7 +12830,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.session Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). + * @param {string} params.session Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). * @param {().GoogleCloudDialogflowV2beta1DetectIntentRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -13141,14 +12941,14 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Sessions$Deletecontexts extends StandardParameters { /** - * Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; } export interface Params$Resource$Projects$Agent$Sessions$Detectintent extends StandardParameters { /** - * Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). */ session?: string; @@ -13166,7 +12966,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.sessions.contexts.create - * @desc Creates a context. If the specified context already exists, overrides the context. + * @desc Creates a context. If the specified context already exists, overrides the context. * @example * // Before running the sample: * // - Enable the API at: @@ -13194,12 +12994,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.contexts.create({ - * // Required. The session to create a context for. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume - * // default 'draft' environment. If `User ID` is not specified, we assume - * // default '-' user. + * // Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: 'projects/my-project/agent/sessions/my-session', * * // Request body metadata @@ -13231,7 +13026,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {().GoogleCloudDialogflowV2beta1Context} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -13355,12 +13150,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.contexts.delete({ - * // Required. The name of the context to delete. Format: - * // `projects//agent/sessions//contexts/` - * // or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is - * // not specified, we assume default 'draft' environment. If `User ID` is not - * // specified, we assume default '-' user. + * // Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * name: 'projects/my-project/agent/sessions/my-session/contexts/my-context', * }); * console.log(res.data); @@ -13378,7 +13168,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.name Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -13492,12 +13282,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.contexts.get({ - * // Required. The name of the context. Format: - * // `projects//agent/sessions//contexts/` - * // or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is - * // not specified, we assume default 'draft' environment. If `User ID` is not - * // specified, we assume default '-' user. + * // Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * name: 'projects/my-project/agent/sessions/my-session/contexts/my-context', * }); * console.log(res.data); @@ -13519,7 +13304,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.name Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -13639,17 +13424,11 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.contexts.list({ - * // Optional. The maximum number of items to return in a single page. By - * // default 100 and at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The session to list all contexts from. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume - * // default 'draft' environment. If `User ID` is not specified, we assume - * // default '-' user. + * // Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: 'projects/my-project/agent/sessions/my-session', * }); * console.log(res.data); @@ -13672,7 +13451,7 @@ export namespace dialogflow_v2beta1 { * @param {object} params Parameters for request * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -13808,23 +13587,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.contexts.patch({ - * // 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` + * // 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` * name: 'projects/my-project/agent/sessions/my-session/contexts/my-context', * // Optional. The mask to control which fields get updated. * updateMask: 'placeholder-value', @@ -13858,7 +13621,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name 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` + * @param {string} params.name 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` * @param {string=} params.updateMask Optional. The mask to control which fields get updated. * @param {().GoogleCloudDialogflowV2beta1Context} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -13954,7 +13717,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Sessions$Contexts$Create extends StandardParameters { /** - * Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; @@ -13966,14 +13729,14 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Sessions$Contexts$Delete extends StandardParameters { /** - * Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ name?: string; } export interface Params$Resource$Projects$Agent$Sessions$Contexts$Get extends StandardParameters { /** - * Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ name?: string; } @@ -13988,14 +13751,14 @@ export namespace dialogflow_v2beta1 { */ pageToken?: string; /** - * Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; } export interface Params$Resource$Projects$Agent$Sessions$Contexts$Patch extends StandardParameters { /** - * 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` + * 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` */ name?: string; /** @@ -14017,7 +13780,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.sessions.entityTypes.create - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -14045,12 +13808,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.entityTypes.create({ - * // Required. The session to create a session entity type for. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users// - * // sessions/`. If `Environment ID` is not specified, we assume - * // default 'draft' environment. If `User ID` is not specified, we assume - * // default '-' user. + * // Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: 'projects/my-project/agent/sessions/my-session', * * // Request body metadata @@ -14082,7 +13840,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {().GoogleCloudDialogflowV2beta1SessionEntityType} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -14192,7 +13950,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.sessions.entityTypes.delete - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -14220,12 +13978,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.entityTypes.delete({ - * // Required. The name of the entity type to delete. 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. + * // Required. The name of the entity type to delete. 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. * name: * 'projects/my-project/agent/sessions/my-session/entityTypes/my-entityType', * }); @@ -14244,7 +13997,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the entity type to delete. 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. + * @param {string} params.name Required. The name of the entity type to delete. 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. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -14330,7 +14083,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.sessions.entityTypes.get - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -14358,12 +14111,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.entityTypes.get({ - * // Required. The name of the 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. + * // Required. The name of the 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. * name: * 'projects/my-project/agent/sessions/my-session/entityTypes/my-entityType', * }); @@ -14386,7 +14134,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the 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. + * @param {string} params.name Required. The name of the 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. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -14492,7 +14240,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.sessions.entityTypes.list - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -14520,17 +14268,11 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.entityTypes.list({ - * // Optional. The maximum number of items to return in a single page. By - * // default 100 and at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The session to list all session entity types from. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users// - * // sessions/`. - * // If `Environment ID` is not specified, we assume default 'draft' - * // environment. If `User ID` is not specified, we assume default '-' user. + * // Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: 'projects/my-project/agent/sessions/my-session', * }); * console.log(res.data); @@ -14553,7 +14295,7 @@ export namespace dialogflow_v2beta1 { * @param {object} params Parameters for request * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -14665,7 +14407,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.agent.sessions.entityTypes.patch - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -14693,16 +14435,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.agent.sessions.entityTypes.patch({ - * // 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. + * // 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. * name: * 'projects/my-project/agent/sessions/my-session/entityTypes/my-entityType', * // Optional. The mask to control which fields get updated. @@ -14737,7 +14470,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name 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. + * @param {string} params.name 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. * @param {string=} params.updateMask Optional. The mask to control which fields get updated. * @param {().GoogleCloudDialogflowV2beta1SessionEntityType} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -14847,7 +14580,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Sessions$Entitytypes$Create extends StandardParameters { /** - * Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; @@ -14859,14 +14592,14 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Agent$Sessions$Entitytypes$Delete extends StandardParameters { /** - * Required. The name of the entity type to delete. 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. + * Required. The name of the entity type to delete. 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. */ name?: string; } export interface Params$Resource$Projects$Agent$Sessions$Entitytypes$Get extends StandardParameters { /** - * Required. The name of the 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. + * Required. The name of the 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. */ name?: string; } @@ -14881,14 +14614,14 @@ export namespace dialogflow_v2beta1 { */ pageToken?: string; /** - * Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; } export interface Params$Resource$Projects$Agent$Sessions$Entitytypes$Patch extends StandardParameters { /** - * 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. + * 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. */ name?: string; /** @@ -14914,7 +14647,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.knowledgeBases.create - * @desc Creates a knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`. + * @desc Creates a knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`. * @example * // Before running the sample: * // - Enable the API at: @@ -14942,8 +14675,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.knowledgeBases.create({ - * // Required. The project to create a knowledge base for. - * // Format: `projects/`. + * // Required. The project to create a knowledge base for. Format: `projects/`. * parent: 'projects/my-project', * * // Request body metadata @@ -14975,7 +14707,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project to create a knowledge base for. Format: `projects/`. + * @param {string} params.parent Required. The project to create a knowledge base for. Format: `projects/`. * @param {().GoogleCloudDialogflowV2beta1KnowledgeBase} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -15079,7 +14811,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.knowledgeBases.delete - * @desc Deletes the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`. + * @desc Deletes the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`. * @example * // Before running the sample: * // - Enable the API at: @@ -15107,11 +14839,9 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.knowledgeBases.delete({ - * // Optional. Force deletes the knowledge base. When set to true, any documents - * // in the knowledge base are also deleted. + * // Optional. Force deletes the knowledge base. When set to true, any documents in the knowledge base are also deleted. * force: 'placeholder-value', - * // Required. The name of the knowledge base to delete. - * // Format: `projects//knowledgeBases/`. + * // Required. The name of the knowledge base to delete. Format: `projects//knowledgeBases/`. * name: 'projects/my-project/knowledgeBases/my-knowledgeBase', * }); * console.log(res.data); @@ -15130,7 +14860,7 @@ export namespace dialogflow_v2beta1 { * * @param {object} params Parameters for request * @param {boolean=} params.force Optional. Force deletes the knowledge base. When set to true, any documents in the knowledge base are also deleted. - * @param {string} params.name Required. The name of the knowledge base to delete. Format: `projects//knowledgeBases/`. + * @param {string} params.name Required. The name of the knowledge base to delete. Format: `projects//knowledgeBases/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -15216,7 +14946,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.knowledgeBases.get - * @desc Retrieves the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`. + * @desc Retrieves the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`. * @example * // Before running the sample: * // - Enable the API at: @@ -15244,8 +14974,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.knowledgeBases.get({ - * // Required. The name of the knowledge base to retrieve. - * // Format `projects//knowledgeBases/`. + * // Required. The name of the knowledge base to retrieve. Format `projects//knowledgeBases/`. * name: 'projects/my-project/knowledgeBases/my-knowledgeBase', * }); * console.log(res.data); @@ -15267,7 +14996,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the knowledge base to retrieve. Format `projects//knowledgeBases/`. + * @param {string} params.name Required. The name of the knowledge base to retrieve. Format `projects//knowledgeBases/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -15367,7 +15096,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.knowledgeBases.list - * @desc Returns the list of all knowledge bases of the specified agent. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`. + * @desc Returns the list of all knowledge bases of the specified agent. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`. * @example * // Before running the sample: * // - Enable the API at: @@ -15395,13 +15124,11 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.knowledgeBases.list({ - * // Optional. The maximum number of items to return in a single page. By - * // default 10 and at most 100. + * // Optional. The maximum number of items to return in a single page. By default 10 and at most 100. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The project to list of knowledge bases for. - * // Format: `projects/`. + * // Required. The project to list of knowledge bases for. Format: `projects/`. * parent: 'projects/my-project', * }); * console.log(res.data); @@ -15424,7 +15151,7 @@ export namespace dialogflow_v2beta1 { * @param {object} params Parameters for request * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 10 and at most 100. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The project to list of knowledge bases for. Format: `projects/`. + * @param {string} params.parent Required. The project to list of knowledge bases for. Format: `projects/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -15536,7 +15263,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.knowledgeBases.patch - * @desc Updates the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`. + * @desc Updates the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`. * @example * // Before running the sample: * // - Enable the API at: @@ -15564,13 +15291,9 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.knowledgeBases.patch({ - * // The knowledge base resource name. - * // The name must be empty when creating a knowledge base. - * // Format: `projects//knowledgeBases/`. + * // The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`. * name: 'projects/my-project/knowledgeBases/my-knowledgeBase', - * // Optional. Not specified means `update all`. - * // Currently, only `display_name` can be updated, an InvalidArgument will be - * // returned for attempting to update other fields. + * // Optional. Not specified means `update all`. Currently, only `display_name` can be updated, an InvalidArgument will be returned for attempting to update other fields. * updateMask: 'placeholder-value', * * // Request body metadata @@ -15602,7 +15325,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`. + * @param {string} params.name The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`. * @param {string=} params.updateMask Optional. Not specified means `update all`. Currently, only `display_name` can be updated, an InvalidArgument will be returned for attempting to update other fields. * @param {().GoogleCloudDialogflowV2beta1KnowledgeBase} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -15706,7 +15429,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Knowledgebases$Create extends StandardParameters { /** - * Required. The project to create a knowledge base for. Format: `projects/`. + * Required. The project to create a knowledge base for. Format: `projects/`. */ parent?: string; @@ -15722,14 +15445,14 @@ export namespace dialogflow_v2beta1 { */ force?: boolean; /** - * Required. The name of the knowledge base to delete. Format: `projects//knowledgeBases/`. + * Required. The name of the knowledge base to delete. Format: `projects//knowledgeBases/`. */ name?: string; } export interface Params$Resource$Projects$Knowledgebases$Get extends StandardParameters { /** - * Required. The name of the knowledge base to retrieve. Format `projects//knowledgeBases/`. + * Required. The name of the knowledge base to retrieve. Format `projects//knowledgeBases/`. */ name?: string; } @@ -15744,14 +15467,14 @@ export namespace dialogflow_v2beta1 { */ pageToken?: string; /** - * Required. The project to list of knowledge bases for. Format: `projects/`. + * Required. The project to list of knowledge bases for. Format: `projects/`. */ parent?: string; } export interface Params$Resource$Projects$Knowledgebases$Patch extends StandardParameters { /** - * The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`. + * The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`. */ name?: string; /** @@ -15773,7 +15496,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.knowledgeBases.documents.create - * @desc Creates a new document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. + * @desc Creates a new document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. * @example * // Before running the sample: * // - Enable the API at: @@ -15801,8 +15524,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.knowledgeBases.documents.create({ - * // Required. The knoweldge base to create a document for. - * // Format: `projects//knowledgeBases/`. + * // Required. The knoweldge base to create a document for. Format: `projects//knowledgeBases/`. * parent: 'projects/my-project/knowledgeBases/my-knowledgeBase', * * // Request body metadata @@ -15842,7 +15564,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The knoweldge base to create a document for. Format: `projects//knowledgeBases/`. + * @param {string} params.parent Required. The knoweldge base to create a document for. Format: `projects//knowledgeBases/`. * @param {().GoogleCloudDialogflowV2beta1Document} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -15936,7 +15658,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.knowledgeBases.documents.delete - * @desc Deletes the specified document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. + * @desc Deletes the specified document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. * @example * // Before running the sample: * // - Enable the API at: @@ -15964,9 +15686,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.knowledgeBases.documents.delete({ - * // Required. The name of the document to delete. - * // Format: `projects//knowledgeBases//documents/`. + * // Required. The name of the document to delete. Format: `projects//knowledgeBases//documents/`. * name: * 'projects/my-project/knowledgeBases/my-knowledgeBase/documents/my-document', * }); @@ -15991,7 +15711,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the document to delete. Format: `projects//knowledgeBases//documents/`. + * @param {string} params.name Required. The name of the document to delete. Format: `projects//knowledgeBases//documents/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -16081,7 +15801,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.knowledgeBases.documents.get - * @desc Retrieves the specified document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. + * @desc Retrieves the specified document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. * @example * // Before running the sample: * // - Enable the API at: @@ -16109,9 +15829,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.knowledgeBases.documents.get({ - * // Required. The name of the document to retrieve. - * // Format `projects//knowledgeBases//documents/`. + * // Required. The name of the document to retrieve. Format `projects//knowledgeBases//documents/`. * name: * 'projects/my-project/knowledgeBases/my-knowledgeBase/documents/my-document', * }); @@ -16140,7 +15858,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the document to retrieve. Format `projects//knowledgeBases//documents/`. + * @param {string} params.name Required. The name of the document to retrieve. Format `projects//knowledgeBases//documents/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -16238,7 +15956,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.knowledgeBases.documents.list - * @desc Returns the list of all documents of the knowledge base. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. + * @desc Returns the list of all documents of the knowledge base. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. * @example * // Before running the sample: * // - Enable the API at: @@ -16266,13 +15984,11 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.knowledgeBases.documents.list({ - * // The maximum number of items to return in a single page. By - * // default 10 and at most 100. + * // The maximum number of items to return in a single page. By default 10 and at most 100. * pageSize: 'placeholder-value', * // The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The knowledge base to list all documents for. - * // Format: `projects//knowledgeBases/`. + * // Required. The knowledge base to list all documents for. Format: `projects//knowledgeBases/`. * parent: 'projects/my-project/knowledgeBases/my-knowledgeBase', * }); * console.log(res.data); @@ -16295,7 +16011,7 @@ export namespace dialogflow_v2beta1 { * @param {object} params Parameters for request * @param {integer=} params.pageSize The maximum number of items to return in a single page. By default 10 and at most 100. * @param {string=} params.pageToken The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The knowledge base to list all documents for. Format: `projects//knowledgeBases/`. + * @param {string} params.parent Required. The knowledge base to list all documents for. Format: `projects//knowledgeBases/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -16403,7 +16119,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.knowledgeBases.documents.patch - * @desc Updates the specified document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. + * @desc Updates the specified document. Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. * @example * // Before running the sample: * // - Enable the API at: @@ -16431,15 +16147,10 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.knowledgeBases.documents.patch({ - * // Optional. The document resource name. - * // The name must be empty when creating a document. - * // Format: `projects//knowledgeBases//documents/`. + * // Optional. The document resource name. The name must be empty when creating a document. Format: `projects//knowledgeBases//documents/`. * name: * 'projects/my-project/knowledgeBases/my-knowledgeBase/documents/my-document', - * // Optional. Not specified means `update all`. - * // Currently, only `display_name` can be updated, an InvalidArgument will be - * // returned for attempting to update other fields. + * // Optional. Not specified means `update all`. Currently, only `display_name` can be updated, an InvalidArgument will be returned for attempting to update other fields. * updateMask: 'placeholder-value', * * // Request body metadata @@ -16479,7 +16190,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Optional. The document resource name. The name must be empty when creating a document. Format: `projects//knowledgeBases//documents/`. + * @param {string} params.name Optional. The document resource name. The name must be empty when creating a document. Format: `projects//knowledgeBases//documents/`. * @param {string=} params.updateMask Optional. Not specified means `update all`. Currently, only `display_name` can be updated, an InvalidArgument will be returned for attempting to update other fields. * @param {().GoogleCloudDialogflowV2beta1Document} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -16571,7 +16282,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.knowledgeBases.documents.reload - * @desc 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: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. + * @desc 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: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use `projects.knowledgeBases.documents`. * @example * // Before running the sample: * // - Enable the API at: @@ -16599,9 +16310,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.knowledgeBases.documents.reload({ - * // Required. The name of the document to reload. - * // Format: `projects//knowledgeBases//documents/` + * // Required. The name of the document to reload. Format: `projects//knowledgeBases//documents/` * name: * 'projects/my-project/knowledgeBases/my-knowledgeBase/documents/my-document', * @@ -16634,7 +16343,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the document to reload. Format: `projects//knowledgeBases//documents/` + * @param {string} params.name Required. The name of the document to reload. Format: `projects//knowledgeBases//documents/` * @param {().GoogleCloudDialogflowV2beta1ReloadDocumentRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -16730,7 +16439,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Knowledgebases$Documents$Create extends StandardParameters { /** - * Required. The knoweldge base to create a document for. Format: `projects//knowledgeBases/`. + * Required. The knoweldge base to create a document for. Format: `projects//knowledgeBases/`. */ parent?: string; @@ -16742,14 +16451,14 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Knowledgebases$Documents$Delete extends StandardParameters { /** - * Required. The name of the document to delete. Format: `projects//knowledgeBases//documents/`. + * Required. The name of the document to delete. Format: `projects//knowledgeBases//documents/`. */ name?: string; } export interface Params$Resource$Projects$Knowledgebases$Documents$Get extends StandardParameters { /** - * Required. The name of the document to retrieve. Format `projects//knowledgeBases//documents/`. + * Required. The name of the document to retrieve. Format `projects//knowledgeBases//documents/`. */ name?: string; } @@ -16764,14 +16473,14 @@ export namespace dialogflow_v2beta1 { */ pageToken?: string; /** - * Required. The knowledge base to list all documents for. Format: `projects//knowledgeBases/`. + * Required. The knowledge base to list all documents for. Format: `projects//knowledgeBases/`. */ parent?: string; } export interface Params$Resource$Projects$Knowledgebases$Documents$Patch extends StandardParameters { /** - * Optional. The document resource name. The name must be empty when creating a document. Format: `projects//knowledgeBases//documents/`. + * Optional. The document resource name. The name must be empty when creating a document. Format: `projects//knowledgeBases//documents/`. */ name?: string; /** @@ -16787,7 +16496,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Knowledgebases$Documents$Reload extends StandardParameters { /** - * Required. The name of the document to reload. Format: `projects//knowledgeBases//documents/` + * Required. The name of the document to reload. Format: `projects//knowledgeBases//documents/` */ name?: string; @@ -16839,8 +16548,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.locations.deleteAgent({ - * // Required. The project that the agent to delete is associated with. - * // Format: `projects/`. + * // Required. The project that the agent to delete is associated with. Format: `projects/`. * parent: 'projects/my-project/locations/my-location', * }); * console.log(res.data); @@ -16858,7 +16566,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project that the agent to delete is associated with. Format: `projects/`. + * @param {string} params.parent Required. The project that the agent to delete is associated with. Format: `projects/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -16977,8 +16685,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.locations.getAgent({ - * // Required. The project that the agent to fetch is associated with. - * // Format: `projects/`. + * // Required. The project that the agent to fetch is associated with. Format: `projects/`. * parent: 'projects/my-project/locations/my-location', * }); * console.log(res.data); @@ -17009,7 +16716,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project that the agent to fetch is associated with. Format: `projects/`. + * @param {string} params.parent Required. The project that the agent to fetch is associated with. Format: `projects/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -17132,8 +16839,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.locations.setAgent({ - * // Required. The project of this agent. - * // Format: `projects/`. + * // Required. The project of this agent. Format: `projects/`. * parent: 'projects/my-project/locations/my-location', * // Optional. The mask to control which fields get updated. * updateMask: 'placeholder-value', @@ -17185,7 +16891,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project of this agent. Format: `projects/`. + * @param {string} params.parent Required. The project of this agent. Format: `projects/`. * @param {string=} params.updateMask Optional. The mask to control which fields get updated. * @param {().GoogleCloudDialogflowV2beta1Agent} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -17284,21 +16990,21 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Deleteagent extends StandardParameters { /** - * Required. The project that the agent to delete is associated with. Format: `projects/`. + * Required. The project that the agent to delete is associated with. Format: `projects/`. */ parent?: string; } export interface Params$Resource$Projects$Locations$Getagent extends StandardParameters { /** - * Required. The project that the agent to fetch is associated with. Format: `projects/`. + * Required. The project that the agent to fetch is associated with. Format: `projects/`. */ parent?: string; } export interface Params$Resource$Projects$Locations$Setagent extends StandardParameters { /** - * Required. The project of this agent. Format: `projects/`. + * Required. The project of this agent. Format: `projects/`. */ parent?: string; /** @@ -17336,7 +17042,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.export - * @desc Exports the specified agent to a ZIP file. Operation + * @desc Exports the specified agent to a ZIP file. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -17364,8 +17070,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.locations.agent.export({ - * // Required. The project that the agent to export is associated with. - * // Format: `projects/`. + * // Required. The project that the agent to export is associated with. Format: `projects/`. * parent: 'projects/my-project/locations/my-location', * * // Request body metadata @@ -17397,7 +17102,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project that the agent to export is associated with. Format: `projects/`. + * @param {string} params.parent Required. The project that the agent to export is associated with. Format: `projects/`. * @param {().GoogleCloudDialogflowV2beta1ExportAgentRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -17519,8 +17224,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.locations.agent.getFulfillment({ - * // Required. The name of the fulfillment. - * // Format: `projects//agent/fulfillment`. + * // Required. The name of the fulfillment. Format: `projects//agent/fulfillment`. * name: 'projects/my-project/locations/my-location/agent/fulfillment', * }); * console.log(res.data); @@ -17544,7 +17248,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the fulfillment. Format: `projects//agent/fulfillment`. + * @param {string} params.name Required. The name of the fulfillment. Format: `projects//agent/fulfillment`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -17642,7 +17346,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.import - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -17670,8 +17374,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.locations.agent.import({ - * // Required. The project that the agent to import is associated with. - * // Format: `projects/`. + * // Required. The project that the agent to import is associated with. Format: `projects/`. * parent: 'projects/my-project/locations/my-location', * * // Request body metadata @@ -17704,7 +17407,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project that the agent to import is associated with. Format: `projects/`. + * @param {string} params.parent Required. The project that the agent to import is associated with. Format: `projects/`. * @param {().GoogleCloudDialogflowV2beta1ImportAgentRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -17798,7 +17501,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.restore - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -17826,8 +17529,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.locations.agent.restore({ - * // Required. The project that the agent to restore is associated with. - * // Format: `projects/`. + * // Required. The project that the agent to restore is associated with. Format: `projects/`. * parent: 'projects/my-project/locations/my-location', * * // Request body metadata @@ -17860,7 +17562,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project that the agent to restore is associated with. Format: `projects/`. + * @param {string} params.parent Required. The project that the agent to restore is associated with. Format: `projects/`. * @param {().GoogleCloudDialogflowV2beta1RestoreAgentRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -17982,13 +17684,11 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.locations.agent.search({ - * // Optional. The maximum number of items to return in a single page. By - * // default 100 and at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The project to list agents from. - * // Format: `projects/`. + * // Required. The project to list agents from. Format: `projects/`. * parent: 'projects/my-project/locations/my-location', * }); * console.log(res.data); @@ -18011,7 +17711,7 @@ export namespace dialogflow_v2beta1 { * @param {object} params Parameters for request * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The project to list agents from. Format: `projects/`. + * @param {string} params.parent Required. The project to list agents from. Format: `projects/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -18119,7 +17819,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.train - * @desc Trains the specified agent. Operation + * @desc Trains the specified agent. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -18147,8 +17847,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.locations.agent.train({ - * // Required. The project that the agent to train is associated with. - * // Format: `projects/`. + * // Required. The project that the agent to train is associated with. Format: `projects/`. * parent: 'projects/my-project/locations/my-location', * * // Request body metadata @@ -18178,7 +17877,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The project that the agent to train is associated with. Format: `projects/`. + * @param {string} params.parent Required. The project that the agent to train is associated with. Format: `projects/`. * @param {().GoogleCloudDialogflowV2beta1TrainAgentRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -18300,11 +17999,9 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.locations.agent.updateFulfillment({ - * // Required. The unique identifier of the fulfillment. - * // Format: `projects//agent/fulfillment`. + * // Required. The unique identifier of the fulfillment. Format: `projects//agent/fulfillment`. * name: 'projects/my-project/locations/my-location/agent/fulfillment', - * // Required. The mask to control which fields get updated. If the mask is not - * // present, all fields will be updated. + * // Required. The mask to control which fields get updated. If the mask is not present, all fields will be updated. * updateMask: 'placeholder-value', * * // Request body metadata @@ -18340,7 +18037,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The unique identifier of the fulfillment. Format: `projects//agent/fulfillment`. + * @param {string} params.name Required. The unique identifier of the fulfillment. Format: `projects//agent/fulfillment`. * @param {string=} params.updateMask Required. The mask to control which fields get updated. If the mask is not present, all fields will be updated. * @param {().GoogleCloudDialogflowV2beta1Fulfillment} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -18442,7 +18139,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Export extends StandardParameters { /** - * Required. The project that the agent to export is associated with. Format: `projects/`. + * Required. The project that the agent to export is associated with. Format: `projects/`. */ parent?: string; @@ -18454,14 +18151,14 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Getfulfillment extends StandardParameters { /** - * Required. The name of the fulfillment. Format: `projects//agent/fulfillment`. + * Required. The name of the fulfillment. Format: `projects//agent/fulfillment`. */ name?: string; } export interface Params$Resource$Projects$Locations$Agent$Import extends StandardParameters { /** - * Required. The project that the agent to import is associated with. Format: `projects/`. + * Required. The project that the agent to import is associated with. Format: `projects/`. */ parent?: string; @@ -18473,7 +18170,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Restore extends StandardParameters { /** - * Required. The project that the agent to restore is associated with. Format: `projects/`. + * Required. The project that the agent to restore is associated with. Format: `projects/`. */ parent?: string; @@ -18493,14 +18190,14 @@ export namespace dialogflow_v2beta1 { */ pageToken?: string; /** - * Required. The project to list agents from. Format: `projects/`. + * Required. The project to list agents from. Format: `projects/`. */ parent?: string; } export interface Params$Resource$Projects$Locations$Agent$Train extends StandardParameters { /** - * Required. The project that the agent to train is associated with. Format: `projects/`. + * Required. The project that the agent to train is associated with. Format: `projects/`. */ parent?: string; @@ -18512,7 +18209,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Updatefulfillment extends StandardParameters { /** - * Required. The unique identifier of the fulfillment. Format: `projects//agent/fulfillment`. + * Required. The unique identifier of the fulfillment. Format: `projects//agent/fulfillment`. */ name?: string; /** @@ -18538,7 +18235,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.entityTypes.batchDelete - * @desc Deletes entity types in the specified agent. Operation + * @desc Deletes entity types in the specified agent. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -18567,8 +18264,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.entityTypes.batchDelete( * { - * // Required. The name of the agent to delete all entities types for. Format: - * // `projects//agent`. + * // Required. The name of the agent to delete all entities types for. Format: `projects//agent`. * parent: 'projects/my-project/locations/my-location/agent', * * // Request body metadata @@ -18601,7 +18297,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the agent to delete all entities types for. Format: `projects//agent`. + * @param {string} params.parent Required. The name of the agent to delete all entities types for. Format: `projects//agent`. * @param {().GoogleCloudDialogflowV2beta1BatchDeleteEntityTypesRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -18694,7 +18390,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.entityTypes.batchUpdate - * @desc Updates/Creates multiple entity types in the specified agent. Operation + * @desc Updates/Creates multiple entity types in the specified agent. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -18723,8 +18419,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.entityTypes.batchUpdate( * { - * // Required. The name of the agent to update or create entity types in. - * // Format: `projects//agent`. + * // Required. The name of the agent to update or create entity types in. Format: `projects//agent`. * parent: 'projects/my-project/locations/my-location/agent', * * // Request body metadata @@ -18760,7 +18455,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the agent to update or create entity types in. Format: `projects//agent`. + * @param {string} params.parent Required. The name of the agent to update or create entity types in. Format: `projects//agent`. * @param {().GoogleCloudDialogflowV2beta1BatchUpdateEntityTypesRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -18881,14 +18576,9 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.locations.agent.entityTypes.create({ - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // Required. The agent to create a entity type for. - * // Format: `projects//agent`. + * // Required. The agent to create a entity type for. Format: `projects//agent`. * parent: 'projects/my-project/locations/my-location/agent', * * // Request body metadata @@ -18927,7 +18617,7 @@ export namespace dialogflow_v2beta1 { * * @param {object} params Parameters for request * @param {string=} params.languageCode 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). - * @param {string} params.parent Required. The agent to create a entity type for. Format: `projects//agent`. + * @param {string} params.parent Required. The agent to create a entity type for. Format: `projects//agent`. * @param {().GoogleCloudDialogflowV2beta1EntityType} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -19057,8 +18747,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.locations.agent.entityTypes.delete({ - * // Required. The name of the entity type to delete. - * // Format: `projects//agent/entityTypes/`. + * // Required. The name of the entity type to delete. Format: `projects//agent/entityTypes/`. * name: * 'projects/my-project/locations/my-location/agent/entityTypes/my-entityType', * }); @@ -19077,7 +18766,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the entity type to delete. Format: `projects//agent/entityTypes/`. + * @param {string} params.name Required. The name of the entity type to delete. Format: `projects//agent/entityTypes/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -19191,14 +18880,9 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.locations.agent.entityTypes.get({ - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // Required. The name of the entity type. - * // Format: `projects//agent/entityTypes/`. + * // Required. The name of the entity type. Format: `projects//agent/entityTypes/`. * name: * 'projects/my-project/locations/my-location/agent/entityTypes/my-entityType', * }); @@ -19225,7 +18909,7 @@ export namespace dialogflow_v2beta1 { * * @param {object} params Parameters for request * @param {string=} params.languageCode 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). - * @param {string} params.name Required. The name of the entity type. Format: `projects//agent/entityTypes/`. + * @param {string} params.name Required. The name of the entity type. Format: `projects//agent/entityTypes/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -19351,19 +19035,13 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.locations.agent.entityTypes.list({ - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // Optional. The maximum number of items to return in a single page. By - * // default 100 and at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The agent to list all entity types from. - * // Format: `projects//agent`. + * // Required. The agent to list all entity types from. Format: `projects//agent`. * parent: 'projects/my-project/locations/my-location/agent', * }); * console.log(res.data); @@ -19387,7 +19065,7 @@ export namespace dialogflow_v2beta1 { * @param {string=} params.languageCode 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). * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The agent to list all entity types from. Format: `projects//agent`. + * @param {string} params.parent Required. The agent to list all entity types from. Format: `projects//agent`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -19527,16 +19205,9 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.locations.agent.entityTypes.patch({ - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // The unique identifier of the entity type. - * // Required for EntityTypes.UpdateEntityType and - * // EntityTypes.BatchUpdateEntityTypes methods. - * // Format: `projects//agent/entityTypes/`. + * // The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`. * name: * 'projects/my-project/locations/my-location/agent/entityTypes/my-entityType', * // Optional. The mask to control which fields get updated. @@ -19578,7 +19249,7 @@ export namespace dialogflow_v2beta1 { * * @param {object} params Parameters for request * @param {string=} params.languageCode 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). - * @param {string} params.name The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`. + * @param {string} params.name The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`. * @param {string=} params.updateMask Optional. The mask to control which fields get updated. * @param {().GoogleCloudDialogflowV2beta1EntityType} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -19680,7 +19351,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Entitytypes$Batchdelete extends StandardParameters { /** - * Required. The name of the agent to delete all entities types for. Format: `projects//agent`. + * Required. The name of the agent to delete all entities types for. Format: `projects//agent`. */ parent?: string; @@ -19692,7 +19363,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Entitytypes$Batchupdate extends StandardParameters { /** - * Required. The name of the agent to update or create entity types in. Format: `projects//agent`. + * Required. The name of the agent to update or create entity types in. Format: `projects//agent`. */ parent?: string; @@ -19708,7 +19379,7 @@ export namespace dialogflow_v2beta1 { */ languageCode?: string; /** - * Required. The agent to create a entity type for. Format: `projects//agent`. + * Required. The agent to create a entity type for. Format: `projects//agent`. */ parent?: string; @@ -19720,7 +19391,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Entitytypes$Delete extends StandardParameters { /** - * Required. The name of the entity type to delete. Format: `projects//agent/entityTypes/`. + * Required. The name of the entity type to delete. Format: `projects//agent/entityTypes/`. */ name?: string; } @@ -19731,7 +19402,7 @@ export namespace dialogflow_v2beta1 { */ languageCode?: string; /** - * Required. The name of the entity type. Format: `projects//agent/entityTypes/`. + * Required. The name of the entity type. Format: `projects//agent/entityTypes/`. */ name?: string; } @@ -19750,7 +19421,7 @@ export namespace dialogflow_v2beta1 { */ pageToken?: string; /** - * Required. The agent to list all entity types from. Format: `projects//agent`. + * Required. The agent to list all entity types from. Format: `projects//agent`. */ parent?: string; } @@ -19761,7 +19432,7 @@ export namespace dialogflow_v2beta1 { */ languageCode?: string; /** - * The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`. + * The unique identifier of the entity type. Required for EntityTypes.UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Format: `projects//agent/entityTypes/`. */ name?: string; /** @@ -19783,7 +19454,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.entityTypes.entities.batchCreate - * @desc Creates multiple new entities in the specified entity type. Operation + * @desc Creates multiple new entities in the specified entity type. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -19812,8 +19483,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.entityTypes.entities.batchCreate( * { - * // Required. The name of the entity type to create entities in. Format: - * // `projects//agent/entityTypes/`. + * // Required. The name of the entity type to create entities in. Format: `projects//agent/entityTypes/`. * parent: * 'projects/my-project/locations/my-location/agent/entityTypes/my-entityType', * @@ -19848,7 +19518,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the entity type to create entities in. Format: `projects//agent/entityTypes/`. + * @param {string} params.parent Required. The name of the entity type to create entities in. Format: `projects//agent/entityTypes/`. * @param {().GoogleCloudDialogflowV2beta1BatchCreateEntitiesRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -19942,7 +19612,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.entityTypes.entities.batchDelete - * @desc Deletes entities in the specified entity type. Operation + * @desc Deletes entities in the specified entity type. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -19971,8 +19641,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.entityTypes.entities.batchDelete( * { - * // Required. The name of the entity type to delete entries for. Format: - * // `projects//agent/entityTypes/`. + * // Required. The name of the entity type to delete entries for. Format: `projects//agent/entityTypes/`. * parent: * 'projects/my-project/locations/my-location/agent/entityTypes/my-entityType', * @@ -20007,7 +19676,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the entity type to delete entries for. Format: `projects//agent/entityTypes/`. + * @param {string} params.parent Required. The name of the entity type to delete entries for. Format: `projects//agent/entityTypes/`. * @param {().GoogleCloudDialogflowV2beta1BatchDeleteEntitiesRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -20101,7 +19770,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.entityTypes.entities.batchUpdate - * @desc 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 + * @desc 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 * @example * // Before running the sample: * // - Enable the API at: @@ -20130,8 +19799,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.entityTypes.entities.batchUpdate( * { - * // Required. The name of the entity type to update or create entities in. - * // Format: `projects//agent/entityTypes/`. + * // Required. The name of the entity type to update or create entities in. Format: `projects//agent/entityTypes/`. * parent: * 'projects/my-project/locations/my-location/agent/entityTypes/my-entityType', * @@ -20167,7 +19835,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the entity type to update or create entities in. Format: `projects//agent/entityTypes/`. + * @param {string} params.parent Required. The name of the entity type to update or create entities in. Format: `projects//agent/entityTypes/`. * @param {().GoogleCloudDialogflowV2beta1BatchUpdateEntitiesRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -20263,7 +19931,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Entitytypes$Entities$Batchcreate extends StandardParameters { /** - * Required. The name of the entity type to create entities in. Format: `projects//agent/entityTypes/`. + * Required. The name of the entity type to create entities in. Format: `projects//agent/entityTypes/`. */ parent?: string; @@ -20275,7 +19943,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Entitytypes$Entities$Batchdelete extends StandardParameters { /** - * Required. The name of the entity type to delete entries for. Format: `projects//agent/entityTypes/`. + * Required. The name of the entity type to delete entries for. Format: `projects//agent/entityTypes/`. */ parent?: string; @@ -20287,7 +19955,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Entitytypes$Entities$Batchupdate extends StandardParameters { /** - * Required. The name of the entity type to update or create entities in. Format: `projects//agent/entityTypes/`. + * Required. The name of the entity type to update or create entities in. Format: `projects//agent/entityTypes/`. */ parent?: string; @@ -20337,16 +20005,11 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.locations.agent.environments.list({ - * // Optional. The maximum number of items to return in a single page. By default 100 and - * // at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The agent to list all environments from. - * // Format: - * // - `projects//agent` - * // - `projects//locations//agent + * // Required. The agent to list all environments from. Format: - `projects//agent` - `projects//locations//agent * parent: 'projects/my-project/locations/my-location/agent', * }); * console.log(res.data); @@ -20369,7 +20032,7 @@ export namespace dialogflow_v2beta1 { * @param {object} params Parameters for request * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The agent to list all environments from. Format: - `projects//agent` - `projects//locations//agent + * @param {string} params.parent Required. The agent to list all environments from. Format: - `projects//agent` - `projects//locations//agent * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -20491,7 +20154,7 @@ export namespace dialogflow_v2beta1 { */ pageToken?: string; /** - * Required. The agent to list all environments from. Format: - `projects//agent` - `projects//locations//agent + * Required. The agent to list all environments from. Format: - `projects//agent` - `projects//locations//agent */ parent?: string; } @@ -20552,11 +20215,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.environments.users.sessions.deleteContexts( * { - * // Required. The name of the session to delete all contexts from. Format: - * // `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' - * // environment. If `User ID` is not specified, we assume default '-' user. + * // Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: * 'projects/my-project/locations/my-location/agent/environments/my-environment/users/my-user/sessions/my-session', * } @@ -20576,7 +20235,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -20696,18 +20355,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.environments.users.sessions.detectIntent( * { - * // Required. The name of the session this query is sent to. Format: - * // `projects//agent/sessions/`, or - * // `projects//agent/environments//users//sessions/`. 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. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). * session: * 'projects/my-project/locations/my-location/agent/environments/my-environment/users/my-user/sessions/my-session', * @@ -20746,7 +20394,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.session Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). + * @param {string} params.session Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). * @param {().GoogleCloudDialogflowV2beta1DetectIntentRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -20857,14 +20505,14 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Environments$Users$Sessions$Deletecontexts extends StandardParameters { /** - * Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; } export interface Params$Resource$Projects$Locations$Agent$Environments$Users$Sessions$Detectintent extends StandardParameters { /** - * Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). */ session?: string; @@ -20882,7 +20530,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.environments.users.sessions.contexts.create - * @desc Creates a context. If the specified context already exists, overrides the context. + * @desc Creates a context. If the specified context already exists, overrides the context. * @example * // Before running the sample: * // - Enable the API at: @@ -20911,12 +20559,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.environments.users.sessions.contexts.create( * { - * // Required. The session to create a context for. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume - * // default 'draft' environment. If `User ID` is not specified, we assume - * // default '-' user. + * // Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: * 'projects/my-project/locations/my-location/agent/environments/my-environment/users/my-user/sessions/my-session', * @@ -20950,7 +20593,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {().GoogleCloudDialogflowV2beta1Context} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -21075,12 +20718,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.environments.users.sessions.contexts.delete( * { - * // Required. The name of the context to delete. Format: - * // `projects//agent/sessions//contexts/` - * // or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is - * // not specified, we assume default 'draft' environment. If `User ID` is not - * // specified, we assume default '-' user. + * // Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * name: * 'projects/my-project/locations/my-location/agent/environments/my-environment/users/my-user/sessions/my-session/contexts/my-context', * } @@ -21100,7 +20738,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.name Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -21215,12 +20853,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.environments.users.sessions.contexts.get( * { - * // Required. The name of the context. Format: - * // `projects//agent/sessions//contexts/` - * // or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is - * // not specified, we assume default 'draft' environment. If `User ID` is not - * // specified, we assume default '-' user. + * // Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * name: * 'projects/my-project/locations/my-location/agent/environments/my-environment/users/my-user/sessions/my-session/contexts/my-context', * } @@ -21244,7 +20877,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.name Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -21365,17 +20998,11 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.environments.users.sessions.contexts.list( * { - * // Optional. The maximum number of items to return in a single page. By - * // default 100 and at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The session to list all contexts from. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume - * // default 'draft' environment. If `User ID` is not specified, we assume - * // default '-' user. + * // Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: * 'projects/my-project/locations/my-location/agent/environments/my-environment/users/my-user/sessions/my-session', * } @@ -21400,7 +21027,7 @@ export namespace dialogflow_v2beta1 { * @param {object} params Parameters for request * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -21537,23 +21164,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.environments.users.sessions.contexts.patch( * { - * // 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` + * // 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` * name: * 'projects/my-project/locations/my-location/agent/environments/my-environment/users/my-user/sessions/my-session/contexts/my-context', * // Optional. The mask to control which fields get updated. @@ -21589,7 +21200,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name 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` + * @param {string} params.name 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` * @param {string=} params.updateMask Optional. The mask to control which fields get updated. * @param {().GoogleCloudDialogflowV2beta1Context} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -21685,7 +21296,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Environments$Users$Sessions$Contexts$Create extends StandardParameters { /** - * Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; @@ -21697,14 +21308,14 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Environments$Users$Sessions$Contexts$Delete extends StandardParameters { /** - * Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ name?: string; } export interface Params$Resource$Projects$Locations$Agent$Environments$Users$Sessions$Contexts$Get extends StandardParameters { /** - * Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ name?: string; } @@ -21719,14 +21330,14 @@ export namespace dialogflow_v2beta1 { */ pageToken?: string; /** - * Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; } export interface Params$Resource$Projects$Locations$Agent$Environments$Users$Sessions$Contexts$Patch extends StandardParameters { /** - * 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` + * 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` */ name?: string; /** @@ -21748,7 +21359,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.environments.users.sessions.entityTypes.create - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -21777,12 +21388,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.environments.users.sessions.entityTypes.create( * { - * // Required. The session to create a session entity type for. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users// - * // sessions/`. If `Environment ID` is not specified, we assume - * // default 'draft' environment. If `User ID` is not specified, we assume - * // default '-' user. + * // Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: * 'projects/my-project/locations/my-location/agent/environments/my-environment/users/my-user/sessions/my-session', * @@ -21816,7 +21422,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {().GoogleCloudDialogflowV2beta1SessionEntityType} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -21926,7 +21532,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.environments.users.sessions.entityTypes.delete - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -21955,12 +21561,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.environments.users.sessions.entityTypes.delete( * { - * // Required. The name of the entity type to delete. 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. + * // Required. The name of the entity type to delete. 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. * name: * 'projects/my-project/locations/my-location/agent/environments/my-environment/users/my-user/sessions/my-session/entityTypes/my-entityType', * } @@ -21980,7 +21581,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the entity type to delete. 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. + * @param {string} params.name Required. The name of the entity type to delete. 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. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -22066,7 +21667,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.environments.users.sessions.entityTypes.get - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -22095,12 +21696,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.environments.users.sessions.entityTypes.get( * { - * // Required. The name of the 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. + * // Required. The name of the 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. * name: * 'projects/my-project/locations/my-location/agent/environments/my-environment/users/my-user/sessions/my-session/entityTypes/my-entityType', * } @@ -22124,7 +21720,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the 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. + * @param {string} params.name Required. The name of the 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. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -22230,7 +21826,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.environments.users.sessions.entityTypes.list - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -22259,17 +21855,11 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.environments.users.sessions.entityTypes.list( * { - * // Optional. The maximum number of items to return in a single page. By - * // default 100 and at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The session to list all session entity types from. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users// - * // sessions/`. - * // If `Environment ID` is not specified, we assume default 'draft' - * // environment. If `User ID` is not specified, we assume default '-' user. + * // Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: * 'projects/my-project/locations/my-location/agent/environments/my-environment/users/my-user/sessions/my-session', * } @@ -22294,7 +21884,7 @@ export namespace dialogflow_v2beta1 { * @param {object} params Parameters for request * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -22406,7 +21996,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.environments.users.sessions.entityTypes.patch - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -22435,16 +22025,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.environments.users.sessions.entityTypes.patch( * { - * // 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. + * // 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. * name: * 'projects/my-project/locations/my-location/agent/environments/my-environment/users/my-user/sessions/my-session/entityTypes/my-entityType', * // Optional. The mask to control which fields get updated. @@ -22480,7 +22061,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name 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. + * @param {string} params.name 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. * @param {string=} params.updateMask Optional. The mask to control which fields get updated. * @param {().GoogleCloudDialogflowV2beta1SessionEntityType} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -22590,7 +22171,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Environments$Users$Sessions$Entitytypes$Create extends StandardParameters { /** - * Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; @@ -22602,14 +22183,14 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Environments$Users$Sessions$Entitytypes$Delete extends StandardParameters { /** - * Required. The name of the entity type to delete. 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. + * Required. The name of the entity type to delete. 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. */ name?: string; } export interface Params$Resource$Projects$Locations$Agent$Environments$Users$Sessions$Entitytypes$Get extends StandardParameters { /** - * Required. The name of the 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. + * Required. The name of the 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. */ name?: string; } @@ -22624,14 +22205,14 @@ export namespace dialogflow_v2beta1 { */ pageToken?: string; /** - * Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; } export interface Params$Resource$Projects$Locations$Agent$Environments$Users$Sessions$Entitytypes$Patch extends StandardParameters { /** - * 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. + * 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. */ name?: string; /** @@ -22653,7 +22234,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.intents.batchDelete - * @desc Deletes intents in the specified agent. Operation + * @desc Deletes intents in the specified agent. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -22681,8 +22262,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.locations.agent.intents.batchDelete({ - * // Required. The name of the agent to delete all entities types for. Format: - * // `projects//agent`. + * // Required. The name of the agent to delete all entities types for. Format: `projects//agent`. * parent: 'projects/my-project/locations/my-location/agent', * * // Request body metadata @@ -22714,7 +22294,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the agent to delete all entities types for. Format: `projects//agent`. + * @param {string} params.parent Required. The name of the agent to delete all entities types for. Format: `projects//agent`. * @param {().GoogleCloudDialogflowV2beta1BatchDeleteIntentsRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -22808,7 +22388,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.intents.batchUpdate - * @desc Updates/Creates multiple intents in the specified agent. Operation + * @desc Updates/Creates multiple intents in the specified agent. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -22836,8 +22416,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.locations.agent.intents.batchUpdate({ - * // Required. The name of the agent to update or create intents in. - * // Format: `projects//agent`. + * // Required. The name of the agent to update or create intents in. Format: `projects//agent`. * parent: 'projects/my-project/locations/my-location/agent', * * // Request body metadata @@ -22873,7 +22452,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the agent to update or create intents in. Format: `projects//agent`. + * @param {string} params.parent Required. The name of the agent to update or create intents in. Format: `projects//agent`. * @param {().GoogleCloudDialogflowV2beta1BatchUpdateIntentsRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -22997,14 +22576,9 @@ export namespace dialogflow_v2beta1 { * const res = await dialogflow.projects.locations.agent.intents.create({ * // Optional. The resource view to apply to the returned intent. * intentView: 'placeholder-value', - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // Required. The agent to create a intent for. - * // Format: `projects//agent`. + * // Required. The agent to create a intent for. Format: `projects//agent`. * parent: 'projects/my-project/locations/my-location/agent', * * // Request body metadata @@ -23072,7 +22646,7 @@ export namespace dialogflow_v2beta1 { * @param {object} params Parameters for request * @param {string=} params.intentView Optional. The resource view to apply to the returned intent. * @param {string=} params.languageCode 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). - * @param {string} params.parent Required. The agent to create a intent for. Format: `projects//agent`. + * @param {string} params.parent Required. The agent to create a intent for. Format: `projects//agent`. * @param {().GoogleCloudDialogflowV2beta1Intent} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -23196,10 +22770,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.locations.agent.intents.delete({ - * // Required. The name of the intent to delete. If this intent has direct or - * // indirect followup intents, we also delete them. - * // - * // Format: `projects//agent/intents/`. + * // Required. The name of the intent to delete. If this intent has direct or indirect followup intents, we also delete them. Format: `projects//agent/intents/`. * name: 'projects/my-project/locations/my-location/agent/intents/my-intent', * }); * console.log(res.data); @@ -23217,7 +22788,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the intent to delete. If this intent has direct or indirect followup intents, we also delete them. Format: `projects//agent/intents/`. + * @param {string} params.name Required. The name of the intent to delete. If this intent has direct or indirect followup intents, we also delete them. Format: `projects//agent/intents/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -23333,14 +22904,9 @@ export namespace dialogflow_v2beta1 { * const res = await dialogflow.projects.locations.agent.intents.get({ * // Optional. The resource view to apply to the returned intent. * intentView: 'placeholder-value', - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // Required. The name of the intent. - * // Format: `projects//agent/intents/`. + * // Required. The name of the intent. Format: `projects//agent/intents/`. * name: 'projects/my-project/locations/my-location/agent/intents/my-intent', * }); * console.log(res.data); @@ -23381,7 +22947,7 @@ export namespace dialogflow_v2beta1 { * @param {object} params Parameters for request * @param {string=} params.intentView Optional. The resource view to apply to the returned intent. * @param {string=} params.languageCode 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). - * @param {string} params.name Required. The name of the intent. Format: `projects//agent/intents/`. + * @param {string} params.name Required. The name of the intent. Format: `projects//agent/intents/`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -23503,19 +23069,13 @@ export namespace dialogflow_v2beta1 { * const res = await dialogflow.projects.locations.agent.intents.list({ * // Optional. The resource view to apply to the returned intent. * intentView: 'placeholder-value', - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // Optional. The maximum number of items to return in a single page. By - * // default 100 and at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The agent to list all intents from. - * // Format: `projects//agent`. + * // Required. The agent to list all intents from. Format: `projects//agent`. * parent: 'projects/my-project/locations/my-location/agent', * }); * console.log(res.data); @@ -23540,7 +23100,7 @@ export namespace dialogflow_v2beta1 { * @param {string=} params.languageCode 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). * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The agent to list all intents from. Format: `projects//agent`. + * @param {string} params.parent Required. The agent to list all intents from. Format: `projects//agent`. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -23678,16 +23238,9 @@ export namespace dialogflow_v2beta1 { * const res = await dialogflow.projects.locations.agent.intents.patch({ * // Optional. The resource view to apply to the returned intent. * intentView: 'placeholder-value', - * // 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). + * // 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). * languageCode: 'placeholder-value', - * // Optional. The unique identifier of this intent. - * // Required for Intents.UpdateIntent and Intents.BatchUpdateIntents - * // methods. - * // Format: `projects//agent/intents/`. + * // Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`. * name: 'projects/my-project/locations/my-location/agent/intents/my-intent', * // Optional. The mask to control which fields get updated. * updateMask: 'placeholder-value', @@ -23757,7 +23310,7 @@ export namespace dialogflow_v2beta1 { * @param {object} params Parameters for request * @param {string=} params.intentView Optional. The resource view to apply to the returned intent. * @param {string=} params.languageCode 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). - * @param {string} params.name Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`. + * @param {string} params.name Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`. * @param {string=} params.updateMask Optional. The mask to control which fields get updated. * @param {().GoogleCloudDialogflowV2beta1Intent} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -23853,7 +23406,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Intents$Batchdelete extends StandardParameters { /** - * Required. The name of the agent to delete all entities types for. Format: `projects//agent`. + * Required. The name of the agent to delete all entities types for. Format: `projects//agent`. */ parent?: string; @@ -23865,7 +23418,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Intents$Batchupdate extends StandardParameters { /** - * Required. The name of the agent to update or create intents in. Format: `projects//agent`. + * Required. The name of the agent to update or create intents in. Format: `projects//agent`. */ parent?: string; @@ -23885,7 +23438,7 @@ export namespace dialogflow_v2beta1 { */ languageCode?: string; /** - * Required. The agent to create a intent for. Format: `projects//agent`. + * Required. The agent to create a intent for. Format: `projects//agent`. */ parent?: string; @@ -23897,7 +23450,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Intents$Delete extends StandardParameters { /** - * Required. The name of the intent to delete. If this intent has direct or indirect followup intents, we also delete them. Format: `projects//agent/intents/`. + * Required. The name of the intent to delete. If this intent has direct or indirect followup intents, we also delete them. Format: `projects//agent/intents/`. */ name?: string; } @@ -23912,7 +23465,7 @@ export namespace dialogflow_v2beta1 { */ languageCode?: string; /** - * Required. The name of the intent. Format: `projects//agent/intents/`. + * Required. The name of the intent. Format: `projects//agent/intents/`. */ name?: string; } @@ -23935,7 +23488,7 @@ export namespace dialogflow_v2beta1 { */ pageToken?: string; /** - * Required. The agent to list all intents from. Format: `projects//agent`. + * Required. The agent to list all intents from. Format: `projects//agent`. */ parent?: string; } @@ -23950,7 +23503,7 @@ export namespace dialogflow_v2beta1 { */ languageCode?: string; /** - * Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`. + * Optional. The unique identifier of this intent. Required for Intents.UpdateIntent and Intents.BatchUpdateIntents methods. Format: `projects//agent/intents/`. */ name?: string; /** @@ -24009,11 +23562,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.sessions.deleteContexts( * { - * // Required. The name of the session to delete all contexts from. Format: - * // `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' - * // environment. If `User ID` is not specified, we assume default '-' user. + * // Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: * 'projects/my-project/locations/my-location/agent/sessions/my-session', * } @@ -24033,7 +23582,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -24152,18 +23701,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.locations.agent.sessions.detectIntent({ - * // Required. The name of the session this query is sent to. Format: - * // `projects//agent/sessions/`, or - * // `projects//agent/environments//users//sessions/`. 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. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). * session: * 'projects/my-project/locations/my-location/agent/sessions/my-session', * @@ -24201,7 +23739,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.session Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). + * @param {string} params.session Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). * @param {().GoogleCloudDialogflowV2beta1DetectIntentRequest} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -24312,14 +23850,14 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Sessions$Deletecontexts extends StandardParameters { /** - * Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The name of the session to delete all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; } export interface Params$Resource$Projects$Locations$Agent$Sessions$Detectintent extends StandardParameters { /** - * Required. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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. The name of the session this query is sent to. Format: `projects//agent/sessions/`, or `projects//agent/environments//users//sessions/`. 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). */ session?: string; @@ -24337,7 +23875,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.sessions.contexts.create - * @desc Creates a context. If the specified context already exists, overrides the context. + * @desc Creates a context. If the specified context already exists, overrides the context. * @example * // Before running the sample: * // - Enable the API at: @@ -24366,12 +23904,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.sessions.contexts.create( * { - * // Required. The session to create a context for. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume - * // default 'draft' environment. If `User ID` is not specified, we assume - * // default '-' user. + * // Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: * 'projects/my-project/locations/my-location/agent/sessions/my-session', * @@ -24405,7 +23938,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {().GoogleCloudDialogflowV2beta1Context} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -24530,12 +24063,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.sessions.contexts.delete( * { - * // Required. The name of the context to delete. Format: - * // `projects//agent/sessions//contexts/` - * // or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is - * // not specified, we assume default 'draft' environment. If `User ID` is not - * // specified, we assume default '-' user. + * // Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * name: * 'projects/my-project/locations/my-location/agent/sessions/my-session/contexts/my-context', * } @@ -24555,7 +24083,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.name Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -24669,12 +24197,7 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.locations.agent.sessions.contexts.get({ - * // Required. The name of the context. Format: - * // `projects//agent/sessions//contexts/` - * // or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is - * // not specified, we assume default 'draft' environment. If `User ID` is not - * // specified, we assume default '-' user. + * // Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * name: * 'projects/my-project/locations/my-location/agent/sessions/my-session/contexts/my-context', * }); @@ -24697,7 +24220,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.name Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -24817,17 +24340,11 @@ export namespace dialogflow_v2beta1 { * * // Do the magic * const res = await dialogflow.projects.locations.agent.sessions.contexts.list({ - * // Optional. The maximum number of items to return in a single page. By - * // default 100 and at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The session to list all contexts from. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume - * // default 'draft' environment. If `User ID` is not specified, we assume - * // default '-' user. + * // Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: * 'projects/my-project/locations/my-location/agent/sessions/my-session', * }); @@ -24851,7 +24368,7 @@ export namespace dialogflow_v2beta1 { * @param {object} params Parameters for request * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -24988,23 +24505,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.sessions.contexts.patch( * { - * // 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` + * // 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` * name: * 'projects/my-project/locations/my-location/agent/sessions/my-session/contexts/my-context', * // Optional. The mask to control which fields get updated. @@ -25040,7 +24541,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name 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` + * @param {string} params.name 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` * @param {string=} params.updateMask Optional. The mask to control which fields get updated. * @param {().GoogleCloudDialogflowV2beta1Context} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -25136,7 +24637,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Sessions$Contexts$Create extends StandardParameters { /** - * Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to create a context for. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; @@ -25148,14 +24649,14 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Sessions$Contexts$Delete extends StandardParameters { /** - * Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The name of the context to delete. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ name?: string; } export interface Params$Resource$Projects$Locations$Agent$Sessions$Contexts$Get extends StandardParameters { /** - * Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The name of the context. Format: `projects//agent/sessions//contexts/` or `projects//agent/environments//users//sessions//contexts/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ name?: string; } @@ -25170,14 +24671,14 @@ export namespace dialogflow_v2beta1 { */ pageToken?: string; /** - * Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to list all contexts from. Format: `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; } export interface Params$Resource$Projects$Locations$Agent$Sessions$Contexts$Patch extends StandardParameters { /** - * 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` + * 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` */ name?: string; /** @@ -25199,7 +24700,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.sessions.entityTypes.create - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -25228,12 +24729,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.sessions.entityTypes.create( * { - * // Required. The session to create a session entity type for. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users// - * // sessions/`. If `Environment ID` is not specified, we assume - * // default 'draft' environment. If `User ID` is not specified, we assume - * // default '-' user. + * // Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: * 'projects/my-project/locations/my-location/agent/sessions/my-session', * @@ -25267,7 +24763,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.parent Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {().GoogleCloudDialogflowV2beta1SessionEntityType} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -25377,7 +24873,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.sessions.entityTypes.delete - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -25406,12 +24902,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.sessions.entityTypes.delete( * { - * // Required. The name of the entity type to delete. 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. + * // Required. The name of the entity type to delete. 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. * name: * 'projects/my-project/locations/my-location/agent/sessions/my-session/entityTypes/my-entityType', * } @@ -25431,7 +24922,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the entity type to delete. 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. + * @param {string} params.name Required. The name of the entity type to delete. 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. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -25517,7 +25008,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.sessions.entityTypes.get - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -25546,12 +25037,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.sessions.entityTypes.get( * { - * // Required. The name of the 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. + * // Required. The name of the 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. * name: * 'projects/my-project/locations/my-location/agent/sessions/my-session/entityTypes/my-entityType', * } @@ -25575,7 +25061,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name Required. The name of the 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. + * @param {string} params.name Required. The name of the 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. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -25681,7 +25167,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.sessions.entityTypes.list - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -25710,17 +25196,11 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.sessions.entityTypes.list( * { - * // Optional. The maximum number of items to return in a single page. By - * // default 100 and at most 1000. + * // Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * pageSize: 'placeholder-value', * // Optional. The next_page_token value returned from a previous list request. * pageToken: 'placeholder-value', - * // Required. The session to list all session entity types from. - * // Format: `projects//agent/sessions/` or - * // `projects//agent/environments//users// - * // sessions/`. - * // If `Environment ID` is not specified, we assume default 'draft' - * // environment. If `User ID` is not specified, we assume default '-' user. + * // Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * parent: * 'projects/my-project/locations/my-location/agent/sessions/my-session', * } @@ -25745,7 +25225,7 @@ export namespace dialogflow_v2beta1 { * @param {object} params Parameters for request * @param {integer=} params.pageSize Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. * @param {string=} params.pageToken Optional. The next_page_token value returned from a previous list request. - * @param {string} params.parent Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * @param {string} params.parent Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object @@ -25857,7 +25337,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.agent.sessions.entityTypes.patch - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -25886,16 +25366,7 @@ export namespace dialogflow_v2beta1 { * // Do the magic * const res = await dialogflow.projects.locations.agent.sessions.entityTypes.patch( * { - * // 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. + * // 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. * name: * 'projects/my-project/locations/my-location/agent/sessions/my-session/entityTypes/my-entityType', * // Optional. The mask to control which fields get updated. @@ -25931,7 +25402,7 @@ export namespace dialogflow_v2beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string} params.name 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. + * @param {string} params.name 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. * @param {string=} params.updateMask Optional. The mask to control which fields get updated. * @param {().GoogleCloudDialogflowV2beta1SessionEntityType} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -26041,7 +25512,7 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Sessions$Entitytypes$Create extends StandardParameters { /** - * Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to create a session entity type for. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; @@ -26053,14 +25524,14 @@ export namespace dialogflow_v2beta1 { export interface Params$Resource$Projects$Locations$Agent$Sessions$Entitytypes$Delete extends StandardParameters { /** - * Required. The name of the entity type to delete. 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. + * Required. The name of the entity type to delete. 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. */ name?: string; } export interface Params$Resource$Projects$Locations$Agent$Sessions$Entitytypes$Get extends StandardParameters { /** - * Required. The name of the 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. + * Required. The name of the 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. */ name?: string; } @@ -26075,14 +25546,14 @@ export namespace dialogflow_v2beta1 { */ pageToken?: string; /** - * Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. + * Required. The session to list all session entity types from. Format: `projects//agent/sessions/` or `projects//agent/environments//users// sessions/`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. */ parent?: string; } export interface Params$Resource$Projects$Locations$Agent$Sessions$Entitytypes$Patch extends StandardParameters { /** - * 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. + * 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. */ name?: string; /** @@ -26104,7 +25575,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.operations.cancel - * @desc 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`. + * @desc 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`. * @example * // Before running the sample: * // - Enable the API at: @@ -26239,7 +25710,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.operations.get - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -26381,7 +25852,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.locations.operations.list - * @desc 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/x/operations`. To override the binding, API services can add a binding such as `"/v1/{name=users/x}/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. + * @desc 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/x/operations`. To override the binding, API services can add a binding such as `"/v1/{name=users/x}/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. * @example * // Before running the sample: * // - Enable the API at: @@ -26581,7 +26052,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.operations.cancel - * @desc 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`. + * @desc 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`. * @example * // Before running the sample: * // - Enable the API at: @@ -26716,7 +26187,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.operations.get - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -26858,7 +26329,7 @@ export namespace dialogflow_v2beta1 { /** * dialogflow.projects.operations.list - * @desc 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/x/operations`. To override the binding, API services can add a binding such as `"/v1/{name=users/x}/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. + * @desc 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/x/operations`. To override the binding, API services can add a binding such as `"/v1/{name=users/x}/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. * @example * // Before running the sample: * // - Enable the API at: