Data Analytics API with Gemini

Gemini가 포함된 Data Analytics API (geminidataanalytics.googleapis.com)는 자연어를 사용하여 데이터를 쿼리하고 분석하는 방법과 지원되는 데이터 소스에서 데이터와 상호작용하는 데이터 에이전트를 만들고 관리하는 방법을 제공합니다. 개발자는 안정성 요구사항에 따라 적절한 엔드포인트 경로를 선택해야 합니다.

  • v1: 프로덕션 환경에 통합할 수 있는 일반 안정화 버전 기능에 권장됩니다.
  • v1beta: 프리뷰 기간에 프로덕션 환경에 새 기능을 통합하는 데 권장됩니다.
  • v1alpha: 새 기능과 출시 예정 기능을 테스트하기 위한 버전입니다. 이러한 기능은 변경되거나 삭제될 수 있으며, 이 경우 코드를 업데이트해야 할 수 있습니다.

Google Cloud 제품 출시 단계에 대해 자세히 알아보세요.

자세한 구현 가이드는 Conversational Analytics API 개요를 참고하세요.

서비스: geminidataanalytics.googleapis.com

이 서비스를 호출하려면 Google에서 제공하는 클라이언트 라이브러리를 사용하는 것이 좋습니다. 애플리케이션에서 자체 라이브러리를 사용하여 이 서비스를 호출해야 한다면 API 요청을 실행할 때 다음 정보를 사용해야 합니다.

검색 문서

탐색 문서는 머신에서 읽을 수 있는 사양이며 REST API를 설명하고 사용하는 데 참고할 수 있습니다. 또한 클라이언트 라이브러리, IDE 플러그인, 기타 Google API와 상호작용하는 도구를 빌드하는 데 사용됩니다. 하나의 서비스는 여러 개의 탐색 문서를 제공할 수 있습니다. 이 서비스는 다음 검색 문서를 제공합니다.

서비스 엔드포인트

서비스 엔드포인트는 API 서비스의 네트워크 주소를 지정하는 기준 URL입니다. 하나의 서비스는 여러 서비스 엔드포인트를 포함할 수 있습니다. 이 서비스에는 다음 서비스 엔드포인트가 포함되고, 그 아래의 모든 URI가 이 서비스 엔드포인트와 관련됩니다.

  • https://geminidataanalytics.googleapis.com

REST 리소스: v1beta.a2a.projects.locations.dataAgents.v1

메서드
getCard GET /v1beta/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/card
GetAgentCard는 에이전트의 에이전트 카드를 반환합니다.

REST 리소스: v1beta.a2a.projects.locations.dataAgents.v1.message

메서드
send POST /v1beta/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/message:send
에이전트에게 메시지를 보냅니다.
stream POST /v1beta/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/message:stream
SendStreamingMessage는 작업이 중단되거나 종료 상태가 될 때까지 작업 업데이트 이벤트 스트림을 반환하는 스트리밍 호출입니다.

REST 리소스: v1beta.projects.locations

메서드
chat POST /v1beta/{parent=projects/*/locations/*}:chat
Message 객체 스트림을 생성하여 데이터 질문에 답변합니다.
get GET /v1beta/{name=projects/*/locations/*}
위치 정보를 가져옵니다.
list GET /v1beta/{name=projects/*}/locations
이 서비스에 지원되는 위치 정보를 나열합니다.
queryData POST /v1beta/{parent=projects/*/locations/*}:queryData
자연어 사용자 쿼리에서 데이터를 쿼리합니다.

REST 리소스: v1beta.projects.locations.conversations

메서드
create POST /v1beta/{parent=projects/*/locations/*}/conversations
대화 기록이 유지되도록 새 대화를 만듭니다.
delete DELETE /v1beta/{name=projects/*/locations/*/conversations/*}
대화를 삭제합니다.
get GET /v1beta/{name=projects/*/locations/*/conversations/*}
대화 ID와 상위 항목을 사용하여 단일 대화의 세부정보를 가져옵니다.
list GET /v1beta/{parent=projects/*/locations/*}/conversations
지정된 상위 항목의 모든 대화를 나열합니다.

REST 리소스: v1beta.projects.locations.conversations.messages

메서드
list GET /v1beta/{parent=projects/*/locations/*/conversations/*}/messages
지정된 대화의 모든 메시지를 나열합니다.

REST 리소스: v1beta.projects.locations.dataAgents

메서드
create POST /v1beta/{parent=projects/*/locations/*}/dataAgents
특정 프로젝트와 위치에 새 DataAgent를 만듭니다.
createSync POST /v1beta/{parent=projects/*/locations/*}/dataAgents:createSync
특정 프로젝트와 위치에 새 DataAgent를 동기식으로 만듭니다.
delete DELETE /v1beta/{name=projects/*/locations/*/dataAgents/*}
단일 DataAgent를 삭제합니다.
deleteSync DELETE /v1beta/{name=projects/*/locations/*/dataAgents/*}:deleteSync
단일 DataAgent를 동기식으로 삭제합니다.
get GET /v1beta/{name=projects/*/locations/*/dataAgents/*}
단일 DataAgent의 세부정보를 가져옵니다.
getIamPolicy POST /v1beta/{resource=projects/*/locations/*/dataAgents/*}:getIamPolicy
DataAgent에 대한 IAM 정책을 가져옵니다.
list GET /v1beta/{parent=projects/*/locations/*}/dataAgents
특정 프로젝트와 위치의 DataAgent를 나열합니다.
listAccessible GET /v1beta/{parent=projects/*/locations/*}/dataAgents:listAccessible
특정 프로젝트와 위치에서 호출자가 액세스할 수 있는 DataAgent를 나열합니다.
patch PATCH /v1beta/{dataAgent.name=projects/*/locations/*/dataAgents/*}
단일 DataAgent의 파라미터를 업데이트합니다.
setIamPolicy POST /v1beta/{resource=projects/*/locations/*/dataAgents/*}:setIamPolicy
DataAgent에 대한 IAM 정책을 설정합니다.
updateSync PATCH /v1beta/{dataAgent.name=projects/*/locations/*/dataAgents/*}:updateSync
단일 DataAgent의 파라미터를 동기식으로 업데이트합니다.

REST 리소스: v1beta.projects.locations.operations

메서드
cancel POST /v1beta/{name=projects/*/locations/*/operations/*}:cancel
장기 실행 작업에 대한 비동기 취소를 시작합니다.
delete DELETE /v1beta/{name=projects/*/locations/*/operations/*}
장기 실행 작업을 삭제합니다.
get GET /v1beta/{name=projects/*/locations/*/operations/*}
장기 실행 작업의 최신 상태를 가져옵니다.
list GET /v1beta/{name=projects/*/locations/*}/operations
요청에 지정된 필터와 일치하는 작업을 나열합니다.

REST 리소스: v1alpha.projects.locations

메서드
chat POST /v1alpha/{parent=projects/*/locations/*}:chat
Message 객체 스트림을 생성하여 데이터 질문에 답변합니다.
get GET /v1alpha/{name=projects/*/locations/*}
위치 정보를 가져옵니다.
list GET /v1alpha/{name=projects/*}/locations
이 서비스에 지원되는 위치 정보를 나열합니다.
queryData POST /v1alpha/{parent=projects/*/locations/*}:queryData
자연어 사용자 쿼리에서 데이터를 쿼리합니다.

REST 리소스: v1alpha.projects.locations.conversations

메서드
create POST /v1alpha/{parent=projects/*/locations/*}/conversations
대화 기록이 유지되도록 새 대화를 만듭니다.
delete DELETE /v1alpha/{name=projects/*/locations/*/conversations/*}
대화를 삭제합니다.
get GET /v1alpha/{name=projects/*/locations/*/conversations/*}
대화 ID와 상위 항목을 사용하여 단일 대화의 세부정보를 가져옵니다.
list GET /v1alpha/{parent=projects/*/locations/*}/conversations
지정된 상위 항목의 모든 대화를 나열합니다.

REST 리소스: v1alpha.projects.locations.conversations.messages

메서드
list GET /v1alpha/{parent=projects/*/locations/*/conversations/*}/messages
지정된 대화의 모든 메시지를 나열합니다.

REST 리소스: v1alpha.projects.locations.dataAgents

메서드
create POST /v1alpha/{parent=projects/*/locations/*}/dataAgents
특정 프로젝트와 위치에 새 DataAgent를 만듭니다.
createSync POST /v1alpha/{parent=projects/*/locations/*}/dataAgents:createSync
특정 프로젝트와 위치에 새 DataAgent를 동기식으로 만듭니다.
delete DELETE /v1alpha/{name=projects/*/locations/*/dataAgents/*}
단일 DataAgent를 삭제합니다.
deleteSync DELETE /v1alpha/{name=projects/*/locations/*/dataAgents/*}:deleteSync
단일 DataAgent를 동기식으로 삭제합니다.
get GET /v1alpha/{name=projects/*/locations/*/dataAgents/*}
단일 DataAgent의 세부정보를 가져옵니다.
getIamPolicy POST /v1alpha/{resource=projects/*/locations/*/dataAgents/*}:getIamPolicy
DataAgent에 대한 IAM 정책을 가져옵니다.
list GET /v1alpha/{parent=projects/*/locations/*}/dataAgents
특정 프로젝트와 위치의 DataAgent를 나열합니다.
listAccessible GET /v1alpha/{parent=projects/*/locations/*}/dataAgents:listAccessible
특정 프로젝트와 위치에서 호출자가 액세스할 수 있는 DataAgent를 나열합니다.
patch PATCH /v1alpha/{dataAgent.name=projects/*/locations/*/dataAgents/*}
단일 DataAgent의 파라미터를 업데이트합니다.
setIamPolicy POST /v1alpha/{resource=projects/*/locations/*/dataAgents/*}:setIamPolicy
DataAgent에 대한 IAM 정책을 설정합니다.
updateSync PATCH /v1alpha/{dataAgent.name=projects/*/locations/*/dataAgents/*}:updateSync
단일 DataAgent의 파라미터를 동기식으로 업데이트합니다.

REST 리소스: v1alpha.projects.locations.operations

메서드
cancel POST /v1alpha/{name=projects/*/locations/*/operations/*}:cancel
장기 실행 작업에 대한 비동기 취소를 시작합니다.
delete DELETE /v1alpha/{name=projects/*/locations/*/operations/*}
장기 실행 작업을 삭제합니다.
get GET /v1alpha/{name=projects/*/locations/*/operations/*}
장기 실행 작업의 최신 상태를 가져옵니다.
list GET /v1alpha/{name=projects/*/locations/*}/operations
요청에 지정된 필터와 일치하는 작업을 나열합니다.

REST 리소스: v1.a2a.projects.locations.agents.v1

메서드
getCard GET /v1/a2a/{tenant=projects/*/locations/*/agents/*}/v1/card
GetAgentCard는 에이전트의 에이전트 카드를 반환합니다.

REST 리소스: v1.a2a.projects.locations.agents.v1.message

메서드
send POST /v1/a2a/{tenant=projects/*/locations/*/agents/*}/v1/message:send
에이전트에게 메시지를 보냅니다.
stream POST /v1/a2a/{tenant=projects/*/locations/*/agents/*}/v1/message:stream
SendStreamingMessage는 작업이 중단되거나 종료 상태가 될 때까지 작업 업데이트 이벤트 스트림을 반환하는 스트리밍 호출입니다.

REST 리소스: v1.a2a.projects.locations.dataAgents.v1

메서드
getCard GET /v1/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/card
GetAgentCard는 에이전트의 에이전트 카드를 반환합니다.

REST 리소스: v1.a2a.projects.locations.dataAgents.v1.message

메서드
send POST /v1/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/message:send
에이전트에게 메시지를 보냅니다.
stream POST /v1/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/message:stream
SendStreamingMessage는 작업이 중단되거나 종료 상태가 될 때까지 작업 업데이트 이벤트 스트림을 반환하는 스트리밍 호출입니다.

REST 리소스: v1.projects.locations

메서드
chat POST /v1/{parent=projects/*/locations/*}:chat
Message 객체 스트림을 생성하여 데이터 질문에 답변합니다.
get GET /v1/{name=projects/*/locations/*}
위치 정보를 가져옵니다.
list GET /v1/{name=projects/*}/locations
이 서비스에 지원되는 위치 정보를 나열합니다.

REST 리소스: v1.projects.locations.conversations

메서드
create POST /v1/{parent=projects/*/locations/*}/conversations
대화 기록이 유지되도록 새 대화를 만듭니다.
delete DELETE /v1/{name=projects/*/locations/*/conversations/*}
대화를 삭제합니다.
get GET /v1/{name=projects/*/locations/*/conversations/*}
대화 ID와 상위 항목을 사용하여 단일 대화의 세부정보를 가져옵니다.
list GET /v1/{parent=projects/*/locations/*}/conversations
지정된 상위 항목의 모든 대화를 나열합니다.

REST 리소스: v1.projects.locations.conversations.messages

메서드
list GET /v1/{parent=projects/*/locations/*/conversations/*}/messages
지정된 대화의 모든 메시지를 나열합니다.

REST 리소스: v1.projects.locations.dataAgents

메서드
create POST /v1/{parent=projects/*/locations/*}/dataAgents
특정 프로젝트와 위치에 새 DataAgent를 만듭니다.
createSync POST /v1/{parent=projects/*/locations/*}/dataAgents:createSync
특정 프로젝트와 위치에 새 DataAgent를 동기식으로 만듭니다.
delete DELETE /v1/{name=projects/*/locations/*/dataAgents/*}
단일 DataAgent를 삭제합니다.
deleteSync DELETE /v1/{name=projects/*/locations/*/dataAgents/*}:deleteSync
단일 DataAgent를 동기식으로 삭제합니다.
get GET /v1/{name=projects/*/locations/*/dataAgents/*}
단일 DataAgent의 세부정보를 가져옵니다.
getIamPolicy POST /v1/{resource=projects/*/locations/*/dataAgents/*}:getIamPolicy
DataAgent에 대한 IAM 정책을 가져옵니다.
list GET /v1/{parent=projects/*/locations/*}/dataAgents
특정 프로젝트와 위치의 DataAgent를 나열합니다.
listAccessible GET /v1/{parent=projects/*/locations/*}/dataAgents:listAccessible
특정 프로젝트와 위치에서 호출자가 액세스할 수 있는 DataAgent를 나열합니다.
patch PATCH /v1/{dataAgent.name=projects/*/locations/*/dataAgents/*}
단일 DataAgent의 파라미터를 업데이트합니다.
setIamPolicy POST /v1/{resource=projects/*/locations/*/dataAgents/*}:setIamPolicy
DataAgent에 대한 IAM 정책을 설정합니다.
updateSync PATCH /v1/{dataAgent.name=projects/*/locations/*/dataAgents/*}:updateSync
단일 DataAgent의 파라미터를 동기식으로 업데이트합니다.

REST 리소스: v1.projects.locations.operations

메서드
cancel POST /v1/{name=projects/*/locations/*/operations/*}:cancel
장기 실행 작업에 대한 비동기 취소를 시작합니다.
delete DELETE /v1/{name=projects/*/locations/*/operations/*}
장기 실행 작업을 삭제합니다.
get GET /v1/{name=projects/*/locations/*/operations/*}
장기 실행 작업의 최신 상태를 가져옵니다.
list GET /v1/{name=projects/*/locations/*}/operations
요청에 지정된 필터와 일치하는 작업을 나열합니다.