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

Google API 클라이언트 라이브러리를 사용하여 쇼핑용 Content API를 설정하는 것이 좋습니다. 이 가이드에서는 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를 아직 사용 설정하지 않았다면 Google API 목록에서 검색하여 사용 설정합니다.
   4. 왼쪽 상단의 탐색 메뉴 (☰)를 클릭하고 API 및 서비스 를 선택한 후 사용자 인증 정보 를 선택합니다.
   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와 함께 사용할 수 있습니다. 다음 섹션에서는 새 제품을 삽입하는 요청을 만들고 전송합니다.