Thiết lập thư viện ứng dụng

Chúng tôi muốn giới thiệu phiên bản thử nghiệm của API Người bán. Đây là phiên bản mới của Content API và tương lai.

Bạn nên 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 lấy thư viện ứng dụng Python Content API làm ví dụ, nhưng các thư viện này dùng được cho nhiều ngôn ngữ lập trình phổ biến, đồng thời đơ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 phần README.md cho ngôn ngữ trong kho lưu trữ googleads/googleads-shopping-samples trên GitHub.

Lưu ý: Bạn cần cài đặt một số thư viện bắt buộc để sử dụng mã mẫu trong Python. Vì lý do này, bạn nên tạo môi trường ảo Python trước khi tiếp tục. Để biết thêm thông tin, hãy xem phần Cài đặt gói bằng pip và môi trường ảo.

Để thiết lập thư viện ứng dụng API của Google cho Python, hãy hoàn tất các bước sau:

1. Tạo 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 gốc, hãy tạo các thư mục sau:

   ~/shopping-samples/content/

   Lưu ý: Đường dẫn này cũng như tên tệp của tệp merchant-info.json tạo ở bước 5, được xác định trong tệp python/shopping/content/common.py trong thư mục mẫu Content API được tải xuống ở bước 7.

2. Để tải thông tin đăng nhập tài khoản dịch vụ của bạn xuống, hãy hoàn tất các bước sau:

   1. Trong Merchant Center, trên trình đơn Cài đặt, hãy chọn Content API.
   2. Nhấp vào Xác thực.
   3. Nhấp vào [+] TẠO KHOÁ API.
   4. Khi được nhắc, hãy đọc và chấp nhận các điều khoản trong thoả thuận dịch vụ.

   Khoá mới sẽ tự động tải xuống.

3. Đổi tên tệp thông tin đăng nhập đã tải xuống thành service-account.json.

   Lưu ý: Tên tệp này được xác định trong tệp _Constants.py, nằm ở python/shopping/content/ trong thư mục mẫu Content API được tải xuống ở bước 7.

4. Di chuyển tệp service-account.json vào home directory/shopping-samples/content/ của bạn.

5. Trong home directory/shopping-samples/content/, hãy tạo một tệp merchant-info.json trống.

6. Trong merchant-info.json, hãy thêm văn bản sau:

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

7. 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; không nhất thiết phải nằm trong thư mục gốc hoặc trong ~/shopping-samples/content/.

8. 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.

9. Để 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
   

Bây giờ, 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 sản phẩm mới.