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

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

1. API 프로젝트 만들기

API를 사용 설정하려면 먼저 Google Cloud 프로젝트를 만들어야 합니다. 이 프로젝트는 API 관리, 결제 사용 설정, 공동작업자 추가 및 삭제, 권한 관리를 비롯한 모든 Google Cloud 서비스를 만들고 사용 설정하고 사용하기 위한 기반을 형성합니다.

1. Google Cloud 콘솔을 엽니다. 

2. 페이지 상단에서 'Google Cloud 콘솔' 오른쪽에 있는 arrow_drop_down를 클릭합니다. 현재 프로젝트 목록을 보여주는 대화 상자가 나타납니다.

3. 새 프로젝트를 클릭합니다. '새 프로젝트' 화면이 표시됩니다.

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

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

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

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

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

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

2. API 사용 설정

사용자 인증 정보를 얻으려면 Google Cloud Search API를 사용 설정하고 서비스 계정을 만들어야 합니다.

1. 새로 만든 프로젝트에 있으려면 Google Cloud 콘솔 배너의 오른쪽에 있는 arrow_drop_down 아이콘을 클릭하여 새로 생성된 프로젝트를 선택합니다.
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를 호출하려면 먼저 Google Cloud Search에 대한 서드 파티 지원을 초기화해야 합니다.

Cloud Search의 서드 파티 지원을 초기화하려면 다음 단계를 따르세요.

1. Cloud Search Platform 프로젝트에 서비스 계정 사용자 인증 정보가 포함되어 있습니다. 하지만 서드 파티 지원을 초기화하려면 웹 애플리케이션 사용자 인증 정보를 만들어야 합니다. 웹 애플리케이션 사용자 인증 정보를 만드는 방법에 관한 안내는 사용자 인증 정보 만들기를 참고하세요. 이 단계를 완료하면 클라이언트 ID와 클라이언트 보안 비밀 파일이 생성됩니다.

2. Google의 OAuth 2 플레이그라운드를 사용하여 액세스 토큰을 가져옵니다.

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

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에서 저장소의 데이터를 나타내는 방식을 식별할 수 있습니다.