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

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

1. API 프로젝트 만들기

API를 사용 설정하려면 먼저 Google Cloud 프로젝트를 만드세요. 이 프로젝트는 Google Cloud 서비스를 사용하고, API를 관리하고, 권한을 설정하기 위한 기반입니다.

  1. Google Cloud 콘솔을 엽니다. 
  2. 'Google Cloud 콘솔' 오른쪽에 있는 프로젝트 드롭다운을 클릭하고 새 프로젝트를 선택합니다.
  3. 프로젝트 이름 필드에 이름을 입력합니다.
  4. (선택사항) 수정을 클릭하여 프로젝트 ID를 변경합니다. 생성 후에는 이 ID를 변경할 수 없습니다.
  5. 찾아보기를 클릭하여 위치를 선택한 다음 선택을 클릭합니다.
  6. 만들기를 클릭합니다. 일반적으로 몇 분 이내에 프로젝트가 준비됩니다.

자세한 내용은 프로젝트 만들기 및 관리를 참고하세요.

2. API 사용 설정

Cloud Search API를 사용 설정하고 서비스 계정을 만들어 사용자 인증 정보를 획득합니다.

  1. Google Cloud 콘솔 배너의 드롭다운 메뉴에서 새 프로젝트를 선택합니다.
  2. API 및 서비스 사용 설정을 클릭합니다.
  3. Google Cloud Search API를 검색하여 선택합니다.
  4. 사용 설정을 클릭합니다.

자세한 내용은 Google Cloud 콘솔에서 API 관리를 참고하세요.

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

  1. Google Cloud 콘솔의 왼쪽 탐색 메뉴에서 사용자 인증 정보를 클릭합니다.
  2. 사용자 인증 정보 만들기 드롭다운 메뉴에서 서비스 계정을 선택합니다.
  3. 서비스 계정 이름 필드에 이름을 입력합니다.
  4. (선택사항) 서비스 계정 ID를 수정합니다.
  5. 만들고 계속하기를 클릭합니다.
  6. 완료를 클릭하여 '서비스 계정' 목록으로 이동합니다.
  7. 새 서비스 계정의 이메일을 클릭한 다음 키 탭을 선택합니다.
  8. 키 추가 > 새 키 만들기를 클릭합니다.
  9. JSON을 선택하고 만들기를 클릭합니다. 비공개 키가 컴퓨터에 다운로드됩니다.

자세한 내용은 서비스 계정을 참조하세요.

4. 서비스 계정 이메일 확인

  1. Google Cloud 콘솔에서 프로젝트를 선택합니다.
  2. 탐색 메뉴 > IAM 및 관리자 > 서비스 계정을 클릭합니다.
  3. 서비스 계정의 이메일 주소를 기록해 둡니다. Cloud Search에 데이터 소스를 추가하려면 이 권한이 필요합니다.

5. 서드 파티 지원 초기화

다른 Cloud Search API를 호출하기 전에 Google Cloud Search의 서드 파티 지원을 초기화합니다.

서드 파티 지원을 초기화하려면 다음을 실행하세요.

  1. Cloud Search 플랫폼 프로젝트에서 웹 애플리케이션 사용자 인증 정보를 만듭니다. 사용자 인증 정보 만들기를 참고하세요. 클라이언트 ID와 클라이언트 보안 비밀번호가 필요합니다.
  2. OAuth 2.0 Playground를 사용하여 액세스 토큰을 가져옵니다.
    1. OAuth 2.0 구성 (설정 아이콘)을 클릭하고 자체 OAuth 사용자 인증 정보 사용을 선택합니다.
    2. 클라이언트 ID와 클라이언트 보안 비밀번호를 입력합니다.
    3. 범위 필드에 https://www.googleapis.com/auth/cloud_search.settings를 입력하고 API 승인을 클릭합니다.
    4. 승인 코드를 토큰으로 교환을 클릭합니다.

  3. 다음 curl 명령어를 실행합니다. 이때 [YOUR_ACCESS_TOKEN]을 토큰으로 바꿉니다.

    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이 포함됩니다. 실패하면 Cloud Search 지원팀에 문의하세요.

  4. operations.get을 사용하여 초기화를 확인합니다.

    curl 'https://cloudsearch.googleapis.com/v1/operations/<var>operation_name</var>?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed

    done가 true이면 초기화가 완료된 것입니다.

다음 단계

  1. Microsoft® SharePoint®와 같은 Google 이외의 저장소와 함께 Cloud Search를 사용하려면 데이터 소스를 만들어야 합니다. 검색할 데이터 소스 추가하기를 참고하세요.
  2. 데이터 소스를 설정한 후 스키마를 만들고 등록하여 Cloud Search에서 데이터를 나타내는 방식을 식별합니다.