서비스 계정

서비스 계정은 애플리케이션에서 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 for Shopping을 사용 설정하지 않았다면 Google API 목록에서 검색하여 사용 설정합니다.
    4. 왼쪽 사이드바에서 사용자 인증 정보를 선택합니다. 이를 확인하려면 왼쪽 상단을 가리키는 왼쪽 화살표를 클릭해야 할 수도 있습니다.
    5. 서비스 계정을 설정하려면 사용자 인증 정보 만들기를 선택한 다음 서비스 계정을 선택합니다.
    6. 새 서비스 계정의 이름을 지정합니다. 또한 서비스 계정 ID의 기본 사용자 이름으로 사용됩니다. 나중에 사용할 수 있도록 '@' 문자 뒷부분을 포함하여 서비스 계정 ID를 기록합니다. 만들기를 클릭한 후 프로젝트 및 사용자에게 액세스 권한을 부여하는 선택적 단계를 진행한 후 완료를 클릭합니다.

      Content API 메서드에 대한 액세스는 판매자 센터의 서비스 계정 ID와 연결된 역할에 따라 결정되므로 서비스 계정의 역할 선택은 Content API에 대한 호출에 영향을 주지 않습니다. 무엇을 선택해야 할지 모르겠다면 프로젝트 > 뷰어를 선택하기만 하면 됩니다.

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

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

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

자주 묻는 질문(FAQ)

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