Google API 클라이언트 라이브러리를 사용하여 Content API for Shopping을 설정하는 것이 좋습니다. 이 가이드에서는 Python Content API 클라이언트 라이브러리를 예로 사용하지만, 이 라이브러리는 다양한 인기 프로그래밍 언어에서 사용할 수 있으며 인증, 요청 전송, 응답 파싱과 같은 일반적인 API 작업을 간소화합니다. 다른 언어의 클라이언트 라이브러리 설정에 관한 도움말은 GitHub의 googleads/googleads-shopping-samples 저장소에 있는 해당 언어의 README.md를 참고하세요.
Python용 Google API 클라이언트 라이브러리를 설정하려면 다음 단계를 완료하세요.
클라이언트 라이브러리의 구성 및 인증 파일을 위한 디렉터리를 만듭니다. 홈 디렉터리 내에 다음 디렉터리를 만듭니다.
페이지 상단의 메뉴에서 프로젝트를 선택합니다. 아직 프로젝트가 없으면 새 프로젝트를 클릭하여 만듭니다.
이 프로젝트에 Content API for Shopping을 아직 사용 설정하지 않은 경우 Google API 목록에서 검색하여 사용 설정합니다.
왼쪽의 사이드바에서 사용자 인증 정보를 선택합니다. 이를 확인하려면 왼쪽 상단의 화살표를 클릭해야 할 수 있습니다.
서비스 계정을 설정하려면 사용자 인증 정보 만들기를 선택한 다음 서비스 계정을 선택합니다.
새 서비스 계정의 이름을 지정합니다. 이는 서비스 계정 ID의 기본 사용자 이름으로도 사용됩니다. 나중에 사용할 수 있도록 '@' 문자 뒤의 부분을 포함하여 서비스 계정 ID를 기록합니다. 만들기를 클릭한 다음 프로젝트 및 사용자 액세스 권한 부여의 선택 단계를 거쳐 완료를 클릭합니다.
새 서비스 계정에 액세스할 수 있는 서비스 계정 페이지로 이동합니다.
JSON 비공개 키를 가져오려면 서비스 계정을 클릭한 다음 키 탭을 클릭합니다. 키 추가 > 새 키 만들기를 클릭한 다음 키 유형으로 JSON을 선택합니다. 만들기를 클릭하여 비공개 키를 컴퓨터에 다운로드합니다.
새 키가 자동으로 다운로드됩니다.
다운로드한 사용자 인증 정보 파일의 이름을 service-account.json으로 바꿉니다.
service-account.json 파일을 home directory/shopping-samples/content/로 이동합니다.
home directory/shopping-samples/content/에서 빈 merchant-info.json 파일을 만듭니다.
merchant-info.json에 다음 텍스트를 추가합니다.
{"merchantId":yourMerchantCentermerchantID,"accountSampleUser":"the email address associated with your Merchant Center account"}
새 서비스 계정을 판매자 센터 계정에 사용자로 추가합니다. 서드 파티 개발자인 경우 클라이언트가 이 단계를 대신 수행해야 합니다.
[null,null,["최종 업데이트: 2025-08-13(UTC)"],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and represents the future of product data integration.\u003c/p\u003e\n"],["\u003cp\u003eTo use the Merchant API, you need to set up the Google API client libraries, which are available for various programming languages and simplify API interactions.\u003c/p\u003e\n"],["\u003cp\u003eSetup involves creating necessary directories, downloading service account credentials, configuring a \u003ccode\u003emerchant-info.json\u003c/code\u003e file, and adding the service account to your Merchant Center account.\u003c/p\u003e\n"],["\u003cp\u003eYou'll need to clone the \u003ccode\u003egoogleads/googleads-shopping-samples\u003c/code\u003e GitHub repo and install the required dependencies using \u003ccode\u003epip install -r requirements.txt\u003c/code\u003e.\u003c/p\u003e\n"]]],["The content details the setup for using the Google API client library with the new Merchant API beta, an evolution of the Content API for Shopping. Key steps include: creating directories for configuration and authentication files; downloading service account credentials (including generating a JSON private key); setting up `merchant-info.json` with Merchant Center ID and email; adding the service account as a Merchant Center user with Admin access; cloning or downloading the `googleads-shopping-samples` repository; and installing required Python dependencies via `pip`.\n"],null,["# Set up a client library\n\nWe recommend using the\n[Google API client libraries](/api-client-library) to set\nup the Content API for Shopping. This guide uses the Python Content API client\nlibraries as an example, but they're available for many popular programming\nlanguages and simplify common API tasks like authentication, sending requests,\nand parsing responses. For help setting up client libraries for\nother languages, see the **README.md** for the language within the\n[googleads/googleads-shopping-samples](//github.com/googleads/googleads-shopping-samples)\nrepo on GitHub.\n| **Note:** You need to install several required libraries to use the sample code in Python. For this reason, we recommend creating a Python virtual environment before you proceed. For more information, see [Installing packages using pip and virtual environments](//packaging.python.org/guides/installing-using-pip-and-virtual-environments/).\n\nTo set up the Google API client library for Python, complete the following steps:\n\n1. Create a directory for the client library's configuration and authentication\n files. Within your home directory, create the following directories:\n\n **\\~/shopping-samples/content/**\n | **Note:** This path, as well as the filename for the **merchant-info.json** file created in step 5, are defined in the **python/shopping/content/common.py** file within the Content API samples directory downloaded in step 7.\n2. To download your service account credentials, complete the following steps:\n\n 1. Go to the [Google API library](//console.cloud.google.com/apis/library).\n 2. Select a project in the menu at the top of the page. If you don't have one yet, create one by clicking **New project**.\n 3. If you haven't already enabled the Content API for Shopping for this project, then search for it in the list of Google APIs and enable it.\n 4. In the sidebar on the left, select **Credentials**. You may need to click the left-pointing arrow at the top left to see this.\n 5. To set up a service account, select **Create credentials** , and then **Service account**.\n 6. Name the new service account. This also serves as the default username for the service account ID. Record the service account ID, including the part after the '@' character, for later use. Click **Create** , then go through the optional steps of granting access to project and users, and click **Done**.\n 7. You will be directed to the Service Accounts page where your new service account can be accessed.\n3. To obtain a JSON private key, click the service account, then the **Keys**\n tab. Click **Add key** \\\u003e **Create new key** , and then select JSON as the\n key type. Click **Create** to download the private key to your computer.\n The new key downloads automatically.\n\n4. Rename the downloaded credentials file to **service-account.json**.\n\n | **Note:** This filename is defined in the **_constants.py** file, which is located in **python/shopping/content/** within the Content API samples directory downloaded in step 7.\n5. Move the **service-account.json** file to your\n **\u003cvar translate=\"no\"\u003ehome directory\u003c/var\u003e/shopping-samples/content/**.\n\n6. In your **\u003cvar translate=\"no\"\u003ehome directory\u003c/var\u003e/shopping-samples/content/** , create an\n empty **merchant-info.json** file.\n\n7. In **merchant-info.json**, add the following text:\n\n {\n \"merchantId\": \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-err\"\u003eyour\u003c/span\u003e\u003cspan class=\"devsite-syntax-w\"\u003e \u003c/span\u003e\u003cspan class=\"devsite-syntax-err\"\u003eMercha\u003c/span\u003e\u003cspan class=\"devsite-syntax-kc\"\u003ent\u003c/span\u003e\u003cspan class=\"devsite-syntax-w\"\u003e \u003c/span\u003e\u003cspan class=\"devsite-syntax-err\"\u003eCe\u003c/span\u003e\u003cspan class=\"devsite-syntax-kc\"\u003enter\u003c/span\u003e\u003cspan class=\"devsite-syntax-w\"\u003e \u003c/span\u003e\u003cspan class=\"devsite-syntax-err\"\u003emercha\u003c/span\u003e\u003cspan class=\"devsite-syntax-kc\"\u003ent\u003c/span\u003e\u003cspan class=\"devsite-syntax-w\"\u003e \u003c/span\u003e\u003cspan class=\"devsite-syntax-err\"\u003eID\u003c/span\u003e\u003c/var\u003e,\n \"accountSampleUser\": \"\u003cvar translate=\"no\"\u003ethe email address associated with your Merchant Center account\u003c/var\u003e\"\n }\n\n8. Add the new service account as a user to your Merchant Center account. If you\n are a third-party developer, you will need to have your client do this step\n for you.\n\n 1. Go to your [Merchant Center account](//merchants.google.com).\n 2. In the settings of your Merchant Center account, select **People and\n access**.\n 3. Click **+ Add person** and use the service account ID as the email address\n for the new user.\n\n | **Note:** If you did not take note of the service account ID earlier, go to the [Service Accounts administration\n | page](//console.developers.google.com/iam-admin/serviceaccounts) and select the project you created.\n 4. The use of the `Accounts` service requires Admin access, so select\n **Admin**.\n\n 5. Click **Add user** to save preferences and be returned to the list of\n users. The service account ID is listed with the chosen user role.\n\n 6. Repeat the process for all other service accounts you want to add.\n\n9. Clone (or download and unzip) the\n [googleads/googleads-shopping-samples](//github.com/googleads/googleads-shopping-samples)\n GitHub repo to any location on your computer; it does not have to be in your\n home directory or in **\\~/shopping-samples/content/**.\n\n10. If you downloaded and unzipped the repo, instead of cloning it, rename the\n unzipped directory to **googleads-shopping-samples**.\n\n11. To install the required sample dependencies, in a terminal window,\n navigate to **googleads-shopping-samples/python/** and run:\n\n pip install -r requirements.txt\n\nYou now have the Google API client library for Python configured and ready to use with the Content API. In the next section, you'll create and send a request to insert a new product."]]
