Sử dụng tài khoản dịch vụ OAuth 2.0 với API Manufacturer Center

Tài khoản dịch vụ là những Tài khoản Google đặc biệt mà các ứng dụng có thể dùng để truy cập vào API Google theo phương thức lập trình thông qua OAuth 2.0. Tài khoản dịch vụ sử dụng quy trình OAuth 2.0 không yêu cầu uỷ quyền thêm. Thay vào đó, ứng dụng này sử dụng tệp khoá mà chỉ ứng dụng của bạn mới truy cập được. Hướng dẫn này thảo luận cách truy cập vào API Manufacturer Center bằng tài khoản dịch vụ.

Điều kiện tiên quyết

Các bước sử dụng tài khoản dịch vụ để truy cập vào Manufacturer Center API

  1. Tạo thông tin xác thực tài khoản dịch vụ hoặc truy cập vào thông tin xác thực công khai mà bạn đã tạo. Bạn sẽ cần tạo Mã ứng dụng khách OAuth 2.0 và lấy tệp khoá riêng tư *.json:

    1. Chuyển đến Google API Console.

    2. Chọn một dự án trong trình đơn thả xuống ở đầu trang. Nếu bạn chưa có, hãy tạo một tài khoản bằng cách nhấp vào Create Project (Tạo dự án).

    3. Nếu bạn chưa bật API Manufacturer Center cho dự án này, hãy tìm kiếm API này trong danh sách API của Google rồi bật.

    4. Trong thanh bên ở bên trái, hãy chọn Thông tin xác thực.

    5. Để thiết lập tài khoản dịch vụ, hãy chọn Create credentials (Tạo thông tin xác thực), rồi chọn Service account key (Khoá tài khoản dịch vụ).

    Ảnh chụp màn hình thông tin đăng nhập cho tài khoản dịch vụ.

    1. Trên trang tiếp theo, hãy chọn Tài khoản dịch vụ mới trong danh sách thả xuống.

    2. Đặ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ụ. Hãy ghi nhớ mã tài khoản dịch vụ để sử dụng sau này.

    Ảnh chụp màn hình tên tài khoản dịch vụ mới.

    1. Chọn JSON cho loại khoá, sau đó nhấp vào Create (Tạo).

    2. Nút Create (Tạo) sẽ thay đổi thành Tạo.... Sau khi quá trình tạo khoá hoàn tất, hệ thống sẽ tự động tải khoá riêng tư xuống dưới dạng tệp *.json.

    1. Bạn sẽ được đưa trở lại trang Thông tin xác thực và sẽ thấy tài khoản dịch vụ mới trong danh sách khoá tài khoản dịch vụ cho tài khoản của mình.
  2. Thêm tài khoản dịch vụ mới vào tài khoản Manufacturer Center của bạn làm người dùng. 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.

    1. Truy cập vào tài khoản Manufacturer Center.

    2. Chuyển đến danh sách "Người dùng" trong phần cài đặt của tài khoản Manufacturer Center.

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

      Ảnh chụp màn hình nút Thêm người dùng tài khoản dịch vụ.

    4. Điền mã tài khoản dịch vụ vào biểu mẫu rồi chọn(các) vai trò của người dùng mà bạn muốn. Bạn phải chọn ít nhất một tài khoản và việc sử dụng dịch vụ Accounts đòi hỏi phải có vai trò Quản trị viên.

    Nếu trước đó bạn chưa ghi lại mã tài khoản dịch vụ, 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.

    Ảnh chụp màn hình trang người dùng Thêm tài khoản dịch vụ.

    1. Nhấp vào nút Save (Lưu). Bạn sẽ được đưa trở lại danh sách người dùng và mã tài khoản dịch vụ sẽ được liệt kê cùng với(các) vai trò của người dùng đã chọn.

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

    3. Xem người dùng hiện tại của tài khoản dịch vụ bằng cách chuyển đến thẻ Người dùng. Đây sẽ là những người dùng có địa chỉ email có đuôi là "gserviceaccount.com".

  3. Giờ đây, bạn có thể truy cập vào tài khoản Manufacturer Center của mình bằng tài khoản dịch vụ bằng cách sử dụng quy trình Thông tin đăng nhập mặc định của ứng dụng trên Google hoặc trực tiếp sử dụng quy trình dành cho tài khoản dịch vụ. Mẫu API Manufacturer Center cho biết cách sử dụng cả hai quy trình cho thông tin xác thực tài khoản dịch vụ trong từng ngôn ngữ lập trình được hỗ trợ. Hãy xem các mã mẫu để dùng thử tài khoản dịch vụ mới và tìm hiểu những thay đổi bạn cần thực hiện để sử dụng tài khoản dịch vụ trong mã của riêng bạn.

Câu hỏi thường gặp

Tôi có thể đăng nhập vào giao diện người dùng web của Manufacturer Center bằng tài khoản dịch vụ của mình không?

Không, tài khoản dịch vụ không phải là Tài khoản Google thông thường và không thể truy cập vào giao diện người dùng web của Manufacturer Center.

Tôi cần làm mới mã truy cập tài khoản dịch vụ bao lâu một lần?

Mã thông báo truy cập sẽ hết hạn sau một giờ kể từ khi được Máy chủ uỷ quyền Google OAuth 2.0 phát hành. Khi mã truy cập hết hạn, ứng dụng sẽ dùng thư viện ứng dụng để tìm nạp một mã truy cập khác.