Data Analytics API with Gemini

Gemini가 포함된 Data Analytics API (geminidataanalytics.googleapis.com)는 자연어를 사용하여 데이터를 쿼리하고 분석하는 방법과 지원되는 데이터 소스에서 데이터와 상호작용하는 데이터 에이전트를 만들고 관리하는 방법을 제공합니다.

이 서비스는 미리보기 상태이며 GA 이전 제공 서비스 약관이 적용됩니다. 개발자는 안정성 요구사항에 따라 적절한 엔드포인트 경로를 선택해야 합니다.

  • 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.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
요청에 지정된 필터와 일치하는 작업을 나열합니다.