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

Bạn nên sử dụng Thư viện ứng dụng API của Google để thiết lập thiết lập Content API for Shopping. Hướng dẫn này sử dụng ứng dụng Python Content API làm ví dụ, nhưng các thư viện này có sẵn cho nhiều 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 phần README.md để biết ngôn ngữ trong phần tử googleads/googleads-shopping-samples kho lưu trữ trên GitHub.

Để 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ấu hình và xác thực của thư viện ứng dụng tệp. Trong thư mục gốc, hãy tạo các thư mục sau:

   ~/shopping-samples/content/

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. Chuyển đến thư viện API của Google.
   2. Chọn một dự án trong trình đơn ở đầu trang. Nếu bạn chưa có tài khoản nhưng hãy tạo một dự án bằng cách nhấp vào Dự án mới.
   3. Nếu bạn chưa bật Content API for Shopping cho đối tượng này dự án, sau đó tìm dự án đó trong danh sách API của Google rồi bật dự án đó.
   4. Trong thanh bên ở bên trái, hãy chọn Thông tin xác thực. Bạn có thể cần phải nhấp vào mũi tên chỉ sang trái ở trên cùng bên trái để xem nội dung này.
   5. Để 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 sau đó Tài khoản dịch vụ.
   6. Đặt tên cho tài khoản dịch vụ mới. Tên này cũng đóng vai trò 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 mã sau "@" để sử dụng sau này. Nhấp vào Tạo, rồi xem qua 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.
   7. Bạn sẽ được chuyển đến trang Tài khoản dịch vụ nơi có dịch vụ mới của bạn tài khoản của bạn.

3. Để có khoá riêng tư JSON, hãy nhấp vào tài khoản dịch vụ, sau đó nhấp vào Khoá . Nhấp vào Thêm khoá > 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 của bạn. Khoá mới sẽ tự động tải xuống.

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

5. Chuyển tệp service-account.json vào home directory/shopping-samples/content/.

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

7. 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"
   }
   

8. Thêm tài khoản dịch vụ mới vào tài khoản Merchant Center của bạn dưới dạng người dùng. Nếu bạn 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.

   1. Truy cập vào tài khoản Merchant Center.
   2. Trong phần cài đặt của tài khoản Merchant Center, hãy chọn Mọi người và truy cập.

   3. Nhấp vào + Thêm người dùng rồi sử dụng mã tài khoản dịch vụ làm địa chỉ email cho người dùng mới.

   4. Việc sử dụng dịch vụ Accounts yêu cầu phải có Quyền quản trị. Vì vậy, hãy chọn Quản trị.

   5. Nhấp vào Thêm người dùng để lưu các tuỳ chọn và sẽ được quay trở lại danh sách người dùng. Mã tài khoản dịch vụ được liệt kê cùng với vai trò của người dùng đã chọn.

   6. Lặp lại quy trình cho tất cả các tài khoản dịch vụ khác mà bạn muốn thêm.

9. Sao chép (hoặc tải xuống và giải nén) googleads/googleads-shopping-samples Kho lưu trữ GitHub vào bất kỳ vị trí nào trên máy tính của bạn; thì chương trình này không nhất thiết phải nằm trong thư mục gốc hoặc trong ~/shopping-samples/content/.

10. 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 vào googleads-shopping-samples.

11. Cách cài đặt các phần phụ thuộc mẫu bắt buộc trong cửa sổ dòng lệnh: 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.