Recommendations AI 클라이언트 라이브러리

이 페이지에서는 Retail API용 Cloud 클라이언트 라이브러리를 시작하는 방법을 보여줍니다. 클라이언트 라이브러리 설명에서 이전 Google API 클라이언트 라이브러리를 비롯한 Cloud API용 클라이언트 라이브러리에 대해 자세히 알아보세요.

클라이언트 라이브러리 설치

C#

자세한 내용은 C# 개발 환경 설정을 참조하세요.

이 클라이언트 라이브러리의 요구사항 및 설치 종속 항목은 googleapis.dev README를 참조하세요.

Go

자세한 내용은 Go 개발 환경 설정을 참조하세요.

이 클라이언트 라이브러리의 요구사항 및 설치 종속 항목은 GitHub README를 참조하세요.

자바

자세한 내용은 자바 개발 환경 설정을 참조하세요.

이 클라이언트 라이브러리의 요구사항 및 설치 종속 항목은 GitHub README를 참조하세요.

Node.js

자세한 내용은 Node.js 개발 환경 설정을 참조하세요.

이 클라이언트 라이브러리의 요구사항 및 설치 종속 항목은 GitHub README를 참조하세요.

PHP

자세한 내용은 Google Cloud에서 PHP 사용을 참조하세요.

이 클라이언트 라이브러리의 요구사항 및 설치 종속 항목은 GitHub README를 참조하세요.

Python

자세한 내용은 Python 개발 환경 설정을 참조하세요.

이 클라이언트 라이브러리의 요구사항 및 설치 종속 항목에 대한 자세한 내용은 PiPY README를 참조하세요.

Ruby

자세한 내용은 Ruby 개발 환경 설정을 참조하세요.

이 클라이언트 라이브러리의 요구사항 및 설치 종속 항목에 대한 자세한 내용은 PiPY README를 참조하세요.

인증 설정

클라이언트 라이브러리를 실행하려면 먼저 인증을 설정해야 합니다. 이를 위한 한 가지 방법은 다음 단계와 같이 서비스 계정을 만들고 환경 변수를 설정하는 것입니다. 다른 인증 방법은 서비스 계정으로 인증을 참조하세요.

Console

서비스 계정을 만듭니다.

  1. Google Cloud Console에서 서비스 계정 만들기 페이지로 이동합니다.

    서비스 계정 만들기로 이동
  2. 프로젝트를 선택합니다.

  3. 서비스 계정 이름 필드에 이름을 입력합니다. Google Cloud 콘솔은 이 이름을 기반으로 서비스 계정 ID 필드를 채웁니다.

    서비스 계정 설명 필드에 설명을 입력합니다. 예를 들면 Service account for quickstart입니다.

  4. 만들고 계속하기를 클릭합니다.

  5. 서비스 계정에 Project > Owner 역할을 부여합니다.

    역할을 부여하려면 역할 선택 목록을 찾은 후 Project > Owner을 선택합니다.

  6. 계속을 클릭합니다.

  7. 완료를 클릭하여 서비스 계정 만들기를 마칩니다.

    브라우저 창을 닫지 마세요. 다음 단계에서 사용합니다.

서비스 계정 키 만들기

  1. Google Cloud Console에서 만든 서비스 계정의 이메일 주소를 클릭합니다.
  2. 키를 클릭합니다.
  3. 키 추가를 클릭한 후 새 키 만들기를 클릭합니다.
  4. 만들기를 클릭합니다. JSON 키 파일이 컴퓨터에 다운로드됩니다.
  5. 닫기를 클릭합니다.

gcloud

인증을 설정합니다.

  1. 서비스 계정을 만듭니다. 

    gcloud iam service-accounts create SERVICE_ACCOUNT_NAME

    SERVICE_ACCOUNT_NAME을 서비스 계정 이름으로 바꿉니다.

  2. 서비스 계정에 roles/owner IAM 역할을 부여합니다. 

    gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" --role=roles/owner

    다음을 바꿉니다.

    • SERVICE_ACCOUNT_NAME: 서비스 계정의 이름입니다.
    • PROJECT_ID: 서비스 계정을 만든 프로젝트 ID입니다.

  3. 키 파일을 생성합니다. 

    gcloud iam service-accounts keys create FILE_NAME.json --iam-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

    다음을 바꿉니다.

    • FILE_NAME: 키 파일의 이름입니다.
    • SERVICE_ACCOUNT_NAME: 서비스 계정의 이름입니다.
    • PROJECT_ID: 서비스 계정을 만든 프로젝트 ID입니다.

GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 설정하여 애플리케이션 코드에 사용자 인증 정보를 제공합니다. 이 변수는 현재 셸 세션에만 적용됩니다. 이후 셸 세션에 변수를 적용하려면 셸 시작 파일(예: ~/.bashrc 또는 ~/.profile 파일)에서 변수를 설정합니다.

Linux 또는 macOS

export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

KEY_PATH를 사용자 인증 정보가 포함된 JSON 파일의 경로로 바꿉니다.

예를 들면 다음과 같습니다.

export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

Windows

PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

KEY_PATH를 사용자 인증 정보가 포함된 JSON 파일의 경로로 바꿉니다.

예를 들면 다음과 같습니다.

$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

명령 프롬프트:

set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

KEY_PATH를 사용자 인증 정보가 포함된 JSON 파일의 경로로 바꿉니다.

추가 리소스