Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Bạn nên sử dụng thư viện ứng dụng API của Google để thiết lập Content API for Shopping. Hướng dẫn này sử dụng thư viện ứng dụng Content API của Python làm ví dụ, nhưng thư viện này có sẵn cho nhiều ngôn ngữ lập trình phổ biến và đơn giản hoá các tác vụ API phổ biến như xác thực, gửi yêu cầu và phân tích cú pháp phản hồi. Để được trợ giúp thiết lập thư viện ứng dụng cho các ngôn ngữ khác, hãy xem tệp README.md cho ngôn ngữ đó trong kho lưu trữ googleads/googleads-shopping-samples trên GitHub.
Để thiết lập thư viện ứng dụng Google API cho Python, hãy hoàn tất các bước sau:
Tạo một thư mục cho các tệp cấu hình và xác thực của thư viện ứng dụng. Trong thư mục chính, hãy tạo các thư mục sau:
~/shopping-samples/content/
Để tải thông tin đăng nhập tài khoản dịch vụ xuống, hãy hoàn tất các bước sau:
Chọn một dự án trong trình đơn ở đầu trang. Nếu bạn chưa có dự án, hãy tạo một dự án bằng cách nhấp vào Dự án mới.
Nếu bạn chưa bật Content API for Shopping cho dự án này, hãy tìm API đó trong danh sách API của Google rồi bật API đó.
Trong thanh bên ở phía bên trái, hãy chọn Credentials (Thông tin xác thực). Bạn có thể phải nhấp vào mũi tên chỉ sang trái ở trên cùng bên trái để thấy thông tin này.
Để thiết lập tài khoản dịch vụ, hãy chọn Tạo thông tin xác thực, rồi chọn Tài khoản dịch vụ.
Đặt tên cho tài khoản dịch vụ mới. Đây cũng là tên người dùng mặc định cho mã tài khoản dịch vụ. Ghi lại mã tài khoản dịch vụ, bao gồm cả phần sau ký tự "@" để sử dụng sau này. Nhấp vào Tạo, sau đó thực hiện các bước không bắt buộc để cấp quyền truy cập vào dự án và người dùng, rồi nhấp vào Xong.
Bạn sẽ được chuyển hướng đến trang Tài khoản dịch vụ, nơi bạn có thể truy cập vào tài khoản dịch vụ mới của mình.
Để lấy khoá riêng tư JSON, hãy nhấp vào tài khoản dịch vụ, rồi nhấp vào thẻ Khoá. Nhấp vào Add key (Thêm khoá) > Create new key (Tạo khoá mới), rồi chọn JSON làm loại khoá. Nhấp vào Tạo để tải khoá riêng tư xuống máy tính.
Khoá mới sẽ tự động tải xuống.
Đổi tên tệp thông tin đăng nhập đã tải xuống thành service-account.json.
Di chuyển tệp service-account.json đến home directory/shopping-samples/content/.
Trong home directory/shopping-samples/content/, hãy tạo một tệp merchant-info.json trống.
Trong merchant-info.json, hãy thêm văn bản sau:
{"merchantId":yourMerchantCentermerchantID,"accountSampleUser":"the email address associated with your Merchant Center account"}
Thêm tài khoản dịch vụ mới làm người dùng vào tài khoản Merchant Center. Nếu là nhà phát triển bên thứ ba, bạn cần yêu cầu khách hàng thực hiện bước này cho bạn.
Trong phần cài đặt của tài khoản Merchant Center, hãy chọn Người dùng và quyền truy cập.
Nhấp vào + Thêm người rồi sử dụng mã nhận dạng tài khoản dịch vụ làm địa chỉ email cho người dùng mới.
Để sử dụng dịch vụ Accounts, bạn cần có quyền Quản trị viên, vì vậy, hãy chọn Quản trị viên.
Nhấp vào Thêm người dùng để lưu các lựa chọn ưu tiên và quay lại danh sách người dùng. Mã tài khoản dịch vụ sẽ xuất hiện cùng với vai trò người dùng đã chọn.
Lặp lại quy trình này cho tất cả các tài khoản dịch vụ khác mà bạn muốn thêm.
Sao chép (hoặc tải xuống và giải nén) kho lưu trữ googleads/googleads-shopping-samples GitHub vào bất kỳ vị trí nào trên máy tính của bạn; kho lưu trữ này không nhất thiết phải nằm trong thư mục chính hoặc trong ~/shopping-samples/content/.
Nếu bạn đã tải xuống và giải nén kho lưu trữ thay vì sao chép, hãy đổi tên thư mục đã giải nén thành googleads-shopping-samples.
Để cài đặt các phần phụ thuộc mẫu bắt buộc, trong cửa sổ dòng lệnh, hãy chuyển đến googleads-shopping-samples/python/ rồi chạy:
pip install -r requirements.txt
Giờ đây, bạn đã định cấu hình Thư viện ứng dụng Google API cho Python và sẵn sàng sử dụng với Content API. Trong phần tiếp theo, bạn sẽ tạo và gửi yêu cầu chèn một sản phẩm mới.
[null,null,["Cập nhật lần gần đây nhất: 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."]]
