Google Cloud Search API에 대한 액세스 구성

먼저 Google Cloud Search API에 대한 액세스를 구성해야 합니다. 직접 또는 SDK를 통해 이 API를 사용할 수 있습니다. 이 문서 에서는 Google Cloud Search API REST API를 사용하는 데 필요한 단계를 다룹니다.

1. API 프로젝트 만들기

API를 사용 설정하려면 먼저 Google Cloud 프로젝트를 만들어야 합니다. 이 모든 Google Cloud 서비스를 생성, 지원, 사용하기 위한 기반을 형성합니다. 여기에는 API 관리, 결제 사용 설정, 및 권한을 관리할 수 있습니다.

  1. Google Cloud 콘솔을 엽니다. 

  2. 페이지 상단에서 클릭합니다 현재 프로젝트 목록을 보여주는 대화 상자가 나타납니다.

  3. 새 프로젝트를 클릭합니다. '새 프로젝트' 화면이 나타납니다.

  4. 프로젝트 이름 필드에 프로젝트 이름을 입력합니다.

  5. (선택사항) 수정을 클릭하여 프로젝트 ID를 편집합니다. 프로젝트가 만들어진 후에는 프로젝트 ID를 변경할 수 없으므로 프로젝트의 수명 동안 필요에 맞는 ID를 선택하세요.

  6. 프로젝트의 위치를 찾아보려면 찾아보기를 클릭합니다.

  7. 프로젝트의 위치를 클릭하고 선택을 클릭합니다.

  8. 만들기를 클릭합니다. 콘솔이 대시보드 페이지로 이동합니다. 몇 분 안에 프로젝트가 생성됩니다.

프로젝트를 만들고 관리하는 방법에 대한 자세한 내용은 프로젝트 만들기 및 관리를 참조하세요.

2. API 사용 설정

Google Cloud Search API를 사용 설정하고 서비스 계정을 만들어야 합니다. 가져올 수 있습니다

  1. 새로 만든 프로젝트에 있는지 확인하려면 아이콘을 클릭합니다. Google Cloud 콘솔 배너를 클릭하고 새로 만든 프로젝트를 선택합니다.
  2. API 및 서비스 사용 설정을 클릭합니다. 'API 라이브러리에 오신 것을 환영합니다' 페이지 표시됩니다.
  3. Google Cloud Search API로 이동합니다.
  4. 사용 설정을 클릭합니다. '개요' 페이지가 나타납니다.

API 사용 설정 및 사용 중지에 대한 자세한 내용은 다음을 참조하세요. Google Cloud 콘솔에서 API 관리

3. 서비스 계정 사용자 인증 정보 만들기

  1. Google Cloud 콘솔에서 왼쪽 탐색 메뉴에서 사용자 인증 정보를 클릭합니다. 사용자 인증 정보 페이지가 나타납니다.
  2. 사용자 인증 정보 만들기 드롭다운 목록에서 다음을 선택합니다. 서비스 계정. 이 "서비스 계정 만들기" 페이지가 나타납니다.
  3. 서비스 계정 이름 필드에 이름을 입력합니다.
  4. (선택사항) 서비스 계정 ID를 편집합니다.
  5. 만들기를 클릭합니다. '서비스 계정 권한' 화면이 나타납니다.
  6. 계속을 클릭합니다. '사용자에게 이 서비스 계정에 대한 액세스 권한 부여' 화면 표시됩니다.
  7. 키 만들기를 클릭하고 완료를 클릭합니다. '비공개 키가 컴퓨터" 대화상자가 표시되고 비공개 키 사본이 있습니다.
  8. 닫기를 클릭합니다.

서비스 계정에 대한 자세한 내용은 서비스 계정, 웹 애플리케이션, 설치된 애플리케이션을 참조하세요.

4. 이메일 주소 확인

  1. Google Cloud 콘솔에서 페이지 상단에서 생성한 프로젝트를 선택합니다.
  2. Google Cloud 콘솔 배너 왼쪽에 있는 탐색 메뉴를 클릭합니다.
  3. IAM 및 관리자 > 서비스 계정을 클릭합니다.
  4. 목록의 '서비스 계정 ID'에서 생성된 이메일을 기록해 둡니다. 이 주소는 구성한 서비스 계정을 식별하는 주소입니다. 이 이메일 주소는 Cloud Search에 데이터 소스를 추가할 때 사용됩니다.

5. 서드 파티 지원 초기화

다른 Cloud Search API를 호출하려면 먼저 서드 파티 API를 초기화해야 합니다. Google Cloud Search 지원이 추가될 수 있습니다

Cloud Search에 대한 타사 지원을 초기화하려면 다음 안내를 따르세요.

  1. Cloud Search 플랫폼 프로젝트에는 서비스 계정 사용자 인증 정보가 포함되어 있습니다. 하지만 타사 지원을 초기화하려면 사용자 인증 정보를 제공합니다 웹 애플리케이션을 만드는 방법에 대한 안내 자세한 내용은 사용자 인증 정보를 만듭니다. 이 단계를 완료하면 클라이언트 ID와 클라이언트 보안 비밀번호 파일이 있어야 합니다.

  2. 사용 Google의 OAuth 2 Playground 액세스 토큰을 얻는 방법은 다음과 같습니다.

    1. 설정을 클릭하고 사용자 인증 정보 사용을 선택합니다.
    2. 1단계의 클라이언트 ID와 클라이언트 보안 비밀번호를 입력합니다.
    3. 닫기를 클릭합니다.
    4. 범위 필드에 https://www.googleapis.com/auth/cloud_search.settings를 입력합니다. 승인을 클릭합니다. OAuth 2 Playground가 승인 코드를 반환합니다.
    5. Exchange Authorization Code for 토큰을 클릭합니다. 토큰이 반환됩니다.

  3. Cloud Search에 대한 서드 파티 지원을 초기화하려면 다음 curl을 사용합니다. 명령어와 함께 사용하면 됩니다 [YOUR_ACCESS_TOKEN]를 2단계로 이동합니다.

    curl --request POST \
'https://cloudsearch.googleapis.com/v1:initializeCustomer' \
  --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{}' \
  --compressed

    요청이 성공하면 응답 본문에 operation 인스턴스가 포함됩니다. 예를 들면 다음과 같습니다.

    {
name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
}

    문제가 해결되지 않으면 Cloud Search 지원팀에 문의하세요.

  4. operations.get을 사용하여 서드 파티 지원이 초기화됩니다.

    curl \
'https://cloudsearch.googleapis.com/v1/operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY?key=
[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed

    타사 초기화가 완료되면 done 필드가 true(으)로 설정됨 예를 들면 다음과 같습니다.

    {
name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
done: true
}

다음 단계

다음과 같은 몇 가지 단계를 수행할 수 있습니다.

  1. Google Cloud Search를 Google 이외의 데이터 저장소(예: Microsoft® SharePoint®)와 함께 사용하려면 데이터 소스를 만들어야 합니다. 데이터 소스 추가에 대한 안내는 검색할 데이터 소스 추가하기를 참조하세요.

  2. 데이터 소스를 설정한 후에는 스키마를 만들고 등록하여 Google Cloud Search에서 저장소의 데이터를 나타내는 방식을 식별할 수 있습니다.