서비스 계정

서비스 계정은 애플리케이션에서 OAuth 2.0을 통해 프로그래매틱 방식으로 Google API에 액세스하는 데 사용할 수 있는 특수한 Google 계정입니다. 서비스 계정은 사용자 승인이 필요하지 않은 OAuth 2.0 흐름을 사용합니다. 대신 애플리케이션만 액세스할 수 있는 키 파일을 사용합니다. 이 가이드에서는 서비스 계정으로 Shopping용 Content API에 액세스하는 방법을 설명합니다.

참고: 인증에 서비스 계정을 사용하는 애플리케이션은 자체 판매자 센터 계정에만 액세스할 수 있습니다. 클라이언트의 판매자 센터 계정에 액세스해야 하는 서드 파티 애플리케이션을 작성하는 경우 대신 요청 승인 가이드를 참고하세요.

기본 요건

서비스 계정을 사용하여 Shopping용 Content API에 액세스하는 단계

  1. 서비스 계정 사용자 인증 정보를 생성하거나 이미 생성한 공개 사용자 인증 정보에 액세스합니다. OAuth 2.0 클라이언트 ID를 만들고 *.json 비공개 키 파일을 가져와야 합니다.
    1. Google API 콘솔로 이동합니다.
    2. 페이지 상단의 드롭다운 메뉴에서 프로젝트를 선택합니다. 아직 프로젝트가 없는 경우 새 프로젝트 를 클릭하여 만듭니다.
    3. 이 프로젝트에 대해 Shopping용 Content API를 아직 사용 설정하지 않은 경우 Google API 목록에서 검색하여 사용 설정합니다.
    4. 왼쪽 상단의 탐색 메뉴 (☰)를 클릭하고 API 및 서비스 를 선택한 후 사용자 인증 정보 를 선택합니다.
    5. 서비스 계정을 설정하려면 사용자 인증 정보 만들기를 선택한 후 서비스 계정을 선택합니다.
    6. 새 서비스 계정의 이름을 지정합니다. 이 이름은 서비스 계정 ID의 기본 사용자 이름으로도 사용됩니다. 나중에 사용할 수 있도록 '@' 문자 뒤의 부분을 포함하여 서비스 계정 ID를 기록해 둡니다. 만들기 를 클릭한 후 프로젝트 및 사용자에게 액세스 권한을 부여하는 선택적 단계를 진행하고 완료를 클릭합니다.

      서비스 계정의 역할 선택은 Content API에 대해 수행할 수 있는 호출에 영향을 미치지 않습니다. 대신 Content API 메서드에 대한 액세스는 판매자 센터에서 서비스 계정 ID와 연결된 역할에 따라 결정됩니다. 선택할 항목이 확실하지 않은 경우 프로젝트 > 뷰어 를 선택합니다.

    7. 새 서비스 계정에 액세스할 수 있는 서비스 계정 페이지로 이동합니다.
    8. JSON 비공개 키를 가져오려면 서비스 계정을 클릭한 후 키 탭을 클릭합니다. 키 추가 > 새 키 만들기 를 클릭한 후 키 유형으로 JSON을 선택합니다. 만들기 를 클릭하여 비공개 키를 컴퓨터에 다운로드합니다.
  2. 새 서비스 계정을 판매자 센터 계정에 사용자로 추가합니다. 서드 파티 개발자인 경우 클라이언트가 이 단계를 대신 수행하도록 해야 합니다.
    1. 판매자 센터 계정으로 이동합니다.
    2. 판매자 센터 계정의 설정에서 계정 액세스 로 이동합니다.
    3. + 사용자 추가를 클릭하고 서비스 계정 ID를 신규 사용자의 이메일 주소로 사용합니다.

      이전에 서비스 계정 ID를 기록해 두지 않은 경우 서비스 계정 관리 페이지로 이동하여 만든 프로젝트를 선택합니다.

    4. 서비스 계정의 사용자 액세스 및 이메일 알림 환경설정을 지정합니다. Accounts 서비스를 사용하려면 관리자 액세스 권한이 필요합니다.
    5. 사용자 추가 를 클릭하여 환경설정을 저장하고 사용자 목록으로 돌아갑니다. 선택한 사용자 역할과 함께 서비스 계정 ID가 표시됩니다.
    6. 추가하려는 다른 모든 서비스 계정에 대해 이 프로세스를 반복합니다.
  3. 이제 Google 애플리케이션 기본 사용자 인증 정보 흐름을 사용하거나 서비스 계정 흐름을 직접 사용하여 서비스 계정으로 판매자 센터 계정에 액세스할 수 있습니다. Shopping용 Content API 샘플에서는 지원되는 각 프로그래밍 언어에서 서비스 계정 사용자 인증 정보에 두 흐름을 모두 사용하는 방법을 보여줍니다. 코드 샘플을 확인하여 새 서비스 계정을 사용해 보고 자체 코드에서 서비스 계정을 사용하려면 어떤 변경사항이 필요한지 알아보세요.

자주 묻는 질문(FAQ)

서비스 계정으로 판매자 센터 UI에 로그인할 수 있나요?
아니요. 서비스 계정은 일반 Google 계정이 아니며 판매자 센터 UI에 액세스할 수 없습니다.
서비스 계정 액세스 토큰은 얼마나 자주 새로고침해야 하나요?
액세스 토큰은 Google OAuth 2.0 승인 서버에서 발급된 후 1시간 후에 만료됩니다. 액세스 토큰이 만료되면 애플리케이션은 클라이언트 라이브러리를 사용하여 다른 액세스 토큰을 가져와야 합니다.