Method: projects.locations.sampleQuerySets.sampleQueries.import

여러 SampleQuery를 일괄 가져옵니다. 이미 존재하는 샘플 쿼리는 삭제될 수 있습니다.

참고: SampleQuery의 하위 집합을 성공적으로 가져올 수 있습니다.

HTTP 요청

POST https://discoveryengine.googleapis.com/v1alpha/{parent=projects/*/locations/*/sampleQuerySets/*}/sampleQueries:import

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 항목입니다. 상위 샘플 쿼리 세트 리소스 이름입니다(예: projects/{project}/locations/{location}/sampleQuerySets/{sampleQuerySet}).

호출자에게 이 샘플 쿼리 세트에 속한 SampleQuery를 나열할 권한이 없으면 이 샘플 쿼리 세트의 존재 여부와 관계없이 PERMISSION_DENIED 오류가 반환됩니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "errorConfig": {
    object (ImportErrorConfig)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "inlineSource": {
    object (InlineSource)
  },
  "gcsSource": {
    object (GcsSource)
  },
  "bigquerySource": {
    object (BigQuerySource)
  }
  // End of mutually exclusive fields.
}
필드
errorConfig

object (ImportErrorConfig)

가져오기 중에 발생하는 오류의 원하는 위치입니다.

샘플 쿼리의 소스입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 필드가 최대 하나 설정됩니다.
inlineSource

object (InlineSource)

샘플 쿼리 항목의 인라인 소스입니다.

gcsSource

object (GcsSource)

입력 콘텐츠의 Cloud Storage 위치입니다.

bigquerySource

object (BigQuerySource)

BigQuery 입력 소스입니다.

상호 배타적인 필드 종료

응답 본문

성공한 경우 응답 본문에 Operation의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

자세한 내용은 Authentication Overview에서 확인하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • discoveryengine.sampleQueries.import

자세한 내용은 IAM 문서를 참고하세요.

InlineSource

SampleQuery의 인라인 소스입니다.

JSON 표현
{
  "sampleQueries": [
    {
      object (SampleQuery)
    }
  ]
}
필드
sampleQueries[]

object (SampleQuery)

필수 항목입니다. 가져올 SampleQuery 목록입니다. 최대 항목은 1,000개입니다.