Method: projects.locations.collections.dataStores.siteSearchEngine.fetchDomainVerificationStatus

도메인 확인 상태가 포함된 타겟 사이트 목록을 반환합니다. 이 메서드는 현재 BASIC_SITE_SEARCH 상태의 데이터 스토어에서만 호출할 수 있습니다.

HTTP 요청

GET https://discoveryengine.googleapis.com/v1/{siteSearchEngine=projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine}:fetchDomainVerificationStatus

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

경로 매개변수

매개변수
siteSearchEngine

string

필수 항목입니다. 모든 도메인 확인 상태를 가져오는 사이트 검색엔진 리소스입니다. projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/siteSearchEngine

쿼리 매개변수

파라미터
pageSize

integer

요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.

이 필드가 음수이면 INVALID_ARGUMENT 오류가 반환됩니다.

pageToken

string

이전 siteSearchEngine.fetchDomainVerificationStatus 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 siteSearchEngine.fetchDomainVerificationStatus에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

SiteSearchEngineService.FetchDomainVerificationStatus 메서드의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{
  "targetSites": [
    {
      object (TargetSite)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
필드
targetSites[]

object (TargetSite)

사이트 인증 상태가 포함된 TargetSite 목록입니다.

nextPageToken

string

다음 페이지를 검색하기 위해 pageToken으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

totalSize

integer

요청과 일치하는 항목의 총수입니다. 이 필드는 항상 응답에 채워집니다.

승인 범위

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

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

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

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

  • discoveryengine.siteSearchEngines.fetchDomainVerificationStatus

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