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

Giới thiệu Merchant API, sản phẩm kế nhiệm chính thức của Content API for Shopping. Merchant API đang ở giai đoạn thử nghiệm.

Hãy xem các thông báo mới nhất để tìm hiểu về các tính năng mới, nội dung cập nhật chính trong tài liệu, bản sửa lỗi và thông tin cập nhật về bản phát hành của Merchant API.

Để tìm hiểu cách quản lý cách doanh nghiệp và sản phẩm của bạn xuất hiện trên Google, cũng như cách truy cập có lập trình vào dữ liệu, thông tin chi tiết và các tính năng độc đáo trên quy mô lớn, hãy xem bài viết Bắt đầu sử dụng Merchant API.

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 các thư viện này cũng 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 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ột môi trường ảo Python trước khi tiếp tục. Để biết thêm thông tin, hãy xem bài viết Cài đặt gói bằng pip và môi trường ảo.

Để 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:

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 cho tệp merchant-info.json được 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 xác thực tài khoản dịch vụ 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ó dự án, hãy tạo 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 dự án này, hãy tìm API đó trong danh sách API của Google rồi bật API đó.
   4. Trong thanh bên ở bên trái, hãy chọn 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 để xem.
   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, sau đó chọn Tài khoản dịch vụ.
   6. Đặ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.
   7. Bạn sẽ được chuyển đến trang Tài khoản dịch vụ để truy cập vào tài khoản dịch vụ mới.

3. Để lấy khoá riêng tư JSON, hãy nhấp vào tài khoản dịch vụ, sau đó nhấp vào thẻ Khoá. Nhấp vào Thêm khoá > Tạo khoá mới, sau đó 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.

4. Đổi tên tệp thông tin xác thực đã 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 trong thư mục python/shopping/content/ trong thư mục mẫu Content API được tải xuống ở bước 7.

5. Di 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 tệp merchant-info.json trống.

7. Trong tệp 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 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 mình.

   1. Chuyển đến 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 Người dùng và quyền truy cập.

   3. Nhấp vào + Thêm người 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.

      Lưu ý: Nếu bạn chưa ghi lại mã tài khoản dịch vụ trước đó, hãy chuyển đến trang quản trị Tài khoản dịch vụ rồi chọn dự án bạn đã tạo.

   4. Để sử dụng dịch vụ Accounts, bạn cần 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 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ụ được liệt kê cùng với vai trò người dùng đã chọn.

   6. Lặp lại quy trình này cho tất 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) kho lưu trữ GitHub googleads/googleads-shopping-samples vào vị trí bất kỳ trên máy tính; không nhất thiết phải ở 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 kho lưu trữ, hãy đổi tên thư mục đã giải nén thành googleads-shopping-samples.

11. Để 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 API của Google 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.