Xác thực bằng API Đặt trước của Maps

Để cập nhật thông tin theo thời gian thực, bạn cần phải yêu cầu tới API Đặt chỗ của Maps. API Đặt chỗ của Maps yêu cầu bạn xác thực yêu cầu của mình qua OAuth 2.0 bằng tài khoản dịch vụ GCP có quyền truy cập vào API và đã được phân bổ QPS cần thiết. Hướng dẫn này sẽ trình bày các bước để:

  1. Thiết lập dự án trên Google Cloud
  2. Tạo một tài khoản dịch vụ
  3. Bật API đặt trước của Maps trong dự án GCP
  4. Gỡ lỗi các vấn đề thường gặp

Để biết thông tin về cách gửi yêu cầu đối với API, hãy xem phần cập nhật API theo thời gian thực của chúng tôi trong Hướng dẫn toàn diện về hoạt động Đặt trước.

Thiết lập dự án trên Google Cloud bằng Actions Center

  1. Đăng nhập vào tài khoản Google Cloud Platform.
  2. Bạn có thể tạo một dự án mới hoặc sử dụng dự án hiện có cho mục đích này.
    • Vui lòng ghi lại số dự án trên đám mây để bạn cần đến trong các bước tiếp theo. Bạn cũng có thể tìm thấy số dự án trên đám mây của mình trên Trang chủ Google Cloud Platform. Số dự án trên đám mây luôn chỉ ở dạng số.
  3. Đăng nhập vào Cổng đối tác.
  4. Hoàn thành bước 1 trên trang Tác vụ giới thiệu của Cổng đối tác bằng cách gửi số dự án trên đám mây và địa chỉ email của dự án trên đám mây (email dùng để quản trị dự án trên đám mây).

Tạo tài khoản dịch vụ và thông tin xác thực OAuth

  1. Đăng nhập lại vào tài khoản Google Cloud Platform.
  2. Chuyển đến phần IAM & admin > Service accounts (IAM và quản trị viên > Tài khoản dịch vụ).
  3. Tìm mã dự án hiện có hoặc mã dự án trên đám mây mới tạo.
  4. Tạo tài khoản dịch vụ.
  5. Điền thông tin chi tiết về tài khoản dịch vụ.
  6. Chỉ định vai trò phù hợp nhất với nhu cầu của ứng dụng cho tài khoản dịch vụ mới. Lựa chọn vai trò cho tài khoản dịch vụ sẽ không ảnh hưởng đến những lệnh gọi có thể thực hiện đến API đặt phòng của Google Maps, vì việc phân bổ đủ hạn mức để sử dụng các vai trò đó được xác định bằng việc liên kết số dự án của bạn trong cấu hình Trung tâm hành động. Nếu không chắc nên chọn vai trò nào, bạn chỉ cần chọn Dự án > Người xem.
  7. Sau khi nhấp vào “tiếp tục” ở bước (6), bạn sẽ thấy một lựa chọn để tạo khoá JSON.
  8. Lưu thông tin xác thực json. Hãy nhớ lưu trữ những dữ liệu này ở nơi an toàn vì sau này bạn sẽ không thể truy xuất chúng.
  9. Đăng nhập lại vào Cổng đối tác và hoàn tất các tác vụ còn lại trên trang Tác vụ giới thiệu của Cổng đối tác.

Bật MapsBooking API

  1. Đăng nhập vào tài khoản Google Cloud Platform.
  2. Chuyển đến API và Dịch vụ > Trang tổng quan.
  3. Nhấp vào Enable APIs and Services (Bật API và dịch vụ) rồi tìm Google Maps Booking API.
  4. Bật các API sau:
    • API Đặt chỗ trên Google Maps
    • API đặt phòng của Google Maps (Nhà phát triển)

Lỗi phổ biến

Có nhiều lý do khiến bạn có thể gặp vấn đề về việc uỷ quyền khi gửi yêu cầu Cập nhật theo thời gian thực. Nếu bạn cần hướng dẫn chung về cách đưa ra yêu cầu Cập nhật theo thời gian thực, hãy xem phần cập nhật API theo thời gian thực của chúng tôi trong Hướng dẫn toàn diện về Yêu cầu đặt trước. Bạn cũng có thể tìm thấy các ứng dụng mẫu bằng nhiều ngôn ngữ trong phần Mã mẫu.

Nếu bạn gặp lỗi 403, hãy kiểm tra để đảm bảo rằng bạn đang tuân thủ tất cả các yêu cầu sau:

  1. Sử dụng Thư viện ứng dụng của Google.
  2. Tạo Thông tin xác thực OAuth bằng tính năng Xác thực tài khoản dịch vụ.
  3. Ủy quyền dựa trên phạm vi phù hợp.
  4. Gọi lệnh đến điểm cuối phù hợp (trong danh sách dưới đây).

Đảm bảo bạn đang thực hiện lệnh gọi đến đúng điểm cuối:

  1. Hộp cát: https://partnerdev-mapsbooking.googleapis.com/v1alpha/...
  2. Sản xuất: https://mapsbooking.googleapis.com/v1alpha/...

Hãy đảm bảo bạn đang uỷ quyền đúng cách cho yêu cầu thông tin xác thực OAuth:

  1. Bạn đang uỷ quyền dựa trên phạm vi "https://www.googleapis.com/auth/mapsbooking".
  2. Bạn đang dùng khoá tài khoản dịch vụ được tạo trong phần Tạo tài khoản dịch vụ và thông tin xác thực OAuth.

Bạn vẫn gặp lỗi?

Nếu bạn vẫn gặp lỗi sau khi làm theo các bước này, hãy liên hệ với người liên hệ của bạn trên Trung tâm hành động để cung cấp những thông tin sau:

  • Số dự án trên đám mây và mã dự án kèm ảnh chụp màn hình
  • Mã tài khoản dịch vụ
  • Email dùng để tạo tài khoản dịch vụ
  • Thông tin chi tiết về điểm cuối đã gửi yêu cầu đến
  • Thời gian gửi yêu cầu
  • Yêu cầu đầy đủ và các thông báo lỗi nhận được khi đưa ra yêu cầu.