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

Google API 클라이언트 라이브러리를 사용하여 Content API for Shopping을 설정하는 것이 좋습니다. 이 가이드에서는 Python Content API 클라이언트 라이브러리를 예로 사용하지만, 이 라이브러리는 다양한 인기 프로그래밍 언어에서 사용할 수 있으며 인증, 요청 전송, 응답 파싱과 같은 일반적인 API 작업을 간소화합니다. 다른 언어의 클라이언트 라이브러리 설정에 관한 도움말은 GitHub의 googleads/googleads-shopping-samples 저장소에 있는 해당 언어의 README.md를 참고하세요.

Python용 Google API 클라이언트 라이브러리를 설정하려면 다음 단계를 완료하세요.

1. 클라이언트 라이브러리의 구성 및 인증 파일을 위한 디렉터리를 만듭니다. 홈 디렉터리 내에 다음 디렉터리를 만듭니다.

   ~/shopping-samples/content/

2. 서비스 계정 사용자 인증 정보를 다운로드하려면 다음 단계를 완료하세요.

   1. Google API 라이브러리로 이동합니다.
   2. 페이지 상단의 메뉴에서 프로젝트를 선택합니다. 아직 프로젝트가 없으면 새 프로젝트를 클릭하여 만듭니다.
   3. 이 프로젝트에 Content API for Shopping을 아직 사용 설정하지 않은 경우 Google API 목록에서 검색하여 사용 설정합니다.
   4. 왼쪽의 사이드바에서 사용자 인증 정보를 선택합니다. 이를 확인하려면 왼쪽 상단의 화살표를 클릭해야 할 수 있습니다.
   5. 서비스 계정을 설정하려면 사용자 인증 정보 만들기를 선택한 다음 서비스 계정을 선택합니다.
   6. 새 서비스 계정의 이름을 지정합니다. 이는 서비스 계정 ID의 기본 사용자 이름으로도 사용됩니다. 나중에 사용할 수 있도록 '@' 문자 뒤의 부분을 포함하여 서비스 계정 ID를 기록합니다. 만들기를 클릭한 다음 프로젝트 및 사용자 액세스 권한 부여의 선택 단계를 거쳐 완료를 클릭합니다.
   7. 새 서비스 계정에 액세스할 수 있는 서비스 계정 페이지로 이동합니다.

3. JSON 비공개 키를 가져오려면 서비스 계정을 클릭한 다음 키 탭을 클릭합니다. 키 추가 > 새 키 만들기를 클릭한 다음 키 유형으로 JSON을 선택합니다. 만들기를 클릭하여 비공개 키를 컴퓨터에 다운로드합니다. 새 키가 자동으로 다운로드됩니다.

4. 다운로드한 사용자 인증 정보 파일의 이름을 service-account.json으로 바꿉니다.

5. service-account.json 파일을 home directory/shopping-samples/content/로 이동합니다.

6. home directory/shopping-samples/content/에서 빈 merchant-info.json 파일을 만듭니다.

7. merchant-info.json에 다음 텍스트를 추가합니다.

   {
   "merchantId": your Merchant Center merchant ID,
   "accountSampleUser": "the email address associated with your Merchant Center account"
   }
   

8. 새 서비스 계정을 판매자 센터 계정에 사용자로 추가합니다. 서드 파티 개발자인 경우 클라이언트가 이 단계를 대신 수행해야 합니다.

   1. 판매자 센터 계정으로 이동합니다.
   2. 판매자 센터 계정의 설정에서 사용자 및 액세스 권한을 선택합니다.

   3. + 사용자 추가를 클릭하고 서비스 계정 ID를 새 사용자의 이메일 주소로 사용합니다.

   4. Accounts 서비스를 사용하려면 관리자 액세스 권한이 필요하므로 관리자를 선택합니다.

   5. 사용자 추가를 클릭하여 환경설정을 저장하고 사용자 목록으로 돌아갑니다. 서비스 계정 ID가 선택한 사용자 역할과 함께 나열됩니다.

   6. 추가하려는 다른 모든 서비스 계정에 대해 이 과정을 반복합니다.

9. googleads/googleads-shopping-samples GitHub 저장소를 컴퓨터의 원하는 위치에 클론 (또는 다운로드 후 압축 해제)합니다. 홈 디렉터리나 ~/shopping-samples/content/에 있지 않아도 됩니다.

10. 저장소를 클론하는 대신 다운로드하고 압축을 해제한 경우 압축 해제된 디렉터리의 이름을 googleads-shopping-samples로 바꿉니다.

11. 필요한 샘플 종속 항목을 설치하려면 터미널 창에서 googleads-shopping-samples/python/으로 이동하여 다음을 실행합니다.

    pip install -r requirements.txt
    

이제 Python용 Google API 클라이언트 라이브러리가 구성되어 Content API와 함께 사용할 수 있습니다. 다음 섹션에서는 새 제품을 삽입하는 요청을 만들어 전송합니다.