Xác thực bằng API Đặt chỗ trên Maps

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

  1. Thiết lập dự án Google Cloud
  2. Tạo một tài khoản dịch vụ
  3. Bật API đặt chỗ trên Maps trong dự án GCP của bạn
  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 tới API, hãy xem phần thông tin cập nhật về API theo thời gian thực trong hướng dẫn toàn diện.

Thiết lập dự án Google Cloud với tính năng Đặt chỗ bằng Google

  1. Đăng nhập vào tài khoản Google Cloud Platform của bạn.
  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 theo yêu cầu 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ủ của Google Cloud Platform. Số dự án trên đám mây luôn là số.
  3. Đăng nhập vào Cổng thông tin dành cho đối tác.
  4. Hoàn tất bước 1 trên trang Nhiệm vụ tích hợp của Cổng thông tin đối tác bằng cách gửi số dự án trên đám mây và địa chỉ email dự án trên đám mây (email dùng để quản lý 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 IAM & quản trị viên > Tài khoản dịch vụ.
  3. Tìm mã dự án trên đám mây hiện có hoặc mới tạo của bạn.
  4. Tạo một 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 cho nhu cầu ứng dụng của tài khoản dịch vụ mới. Việc 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 cho API Đặt chỗ trên Google Maps, vì việc phân bổ đủ hạn mức để sử dụng chúng sẽ được xác định bằng cách liên kết số dự án của bạn trong cấu hình Đặt chỗ với Google. Nếu không biết nên chọn vai trò gì, bạn chỉ cần chọn Project > Viewer.
  7. Sau khi nhấp vào "tiếp tục" ở bước (6), bạn sẽ được cung cấp tuỳ chọn tạo khoá JSON.
  8. Lưu thông tin xác thực json. Hãy 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 thành các thao tác còn lại trên trang Nhiệm vụ tham gia của Cổng đối tác.

Bật API Maps của Maps

  1. Đăng nhập vào tài khoản Google Cloud Platform của bạn.
  2. Chuyển đến API & Services > Trang tổng quan.
  3. Nhấp vào Enable API 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 chỗ trên 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 ủy quyền khi đưa ra 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 thực hiện yêu cầu Cập nhật theo thời gian thực, hãy xem nội dung cập nhật API theo thời gian thực trong hướng dẫn hai đầu của chúng tôi. 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 phải lỗi 403, hãy kiểm tra để đảm bảo rằng bạn đang đáp ứng tất cả những yêu cầu sau:

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

Đảm bảo bạn đang gọi đến điểm cuối chính xác:

  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 uỷ quyền yêu cầu thông tin xác thực OAuth của mình đúng cách:

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

Bạn vẫn thấy lỗi?

Nếu bạn vẫn thấy lỗi sau khi làm theo các bước này, hãy liên hệ với bộ phận Đặt chỗ bằng Google kèm theo các thông tin sau:

  • Số dự án trên đám mây và mã dự án kèm theo ả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ụ
  • Chi tiết về điểm cuối đã cố gắng gửi yêu cầu đến
  • Thời gian yêu cầu
  • Toàn bộ yêu cầu và thông báo lỗi nhận được khi đưa ra yêu cầu.