서비스 계정

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

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

기본 요건

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

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

      Content API 메서드에 대한 액세스 권한은 판매자 센터의 서비스 계정 ID와 연결된 역할에 따라 결정되므로 서비스 계정의 역할 선택은 Content API를 호출할 수 있는 항목에 영향을 미치지 않습니다. 무엇을 선택해야 할지 잘 모르겠다면 Project > Viewer를 선택하세요.

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

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

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

자주 묻는 질문(FAQ)

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