Câu hỏi thường gặp về Google Wallet API

Bắt đầu

API Ví Google là gì?

Google Wallet API cho phép nhà phát triển tạo thẻ và vé kỹ thuật số trong Google Wallet. API Google Wallet hiện hỗ trợ thẻ lên máy bay, vé xem sự kiện, thẻ khách hàng thân thiết, ưu đãi và thẻ đi phương tiện công cộng. Gần đây hơn, một loại thẻ/vé chung đã được thêm vào để hỗ trợ các trường hợp sử dụng khác.

Làm cách nào để thiết lập môi trường phát triển dựa trên các yêu cầu và mức độ phức tạp của doanh nghiệp?

Dưới đây là các hướng dẫn mà bạn có thể dùng để thiết lập một môi trường phát triển phù hợp với các mức độ phức tạp và bảo mật khác nhau của doanh nghiệp. Việc sử dụng nhiều tài khoản dịch vụ có thể giúp nhà phát triển tạo một môi trường KIỂM THỬ riêng biệt với môi trường PHÁT HÀNH.

Độ phức tạp của quá trình thiết lập cơ bản

1 tài khoản Business Console hoặc 1 tài khoản Business Console chính cho nhiều tài khoản của nhà phát hành.

  • Lựa chọn này cho phép bạn sử dụng phương pháp quản lý tập trung bằng 1 tài khoản chính với từ 0 đến nhiều doanh nghiệp/đơn vị phát hành phụ.
  • 1 dự án trên Google Cloud.
  • 1 thông tin đăng nhập vào tài khoản dịch vụ.
  • Một nhóm người dùng.

Độ phức tạp trung bình khi thiết lập

1 tài khoản chính cho nhiều tài khoản của tổ chức phát hành.

  • Lựa chọn này cho phép bạn sử dụng phương pháp quản lý tập trung bằng 1 tài khoản chính với nhiều doanh nghiệp phụ.
  • 1 dự án trên Google Cloud.
  • Số người dùng riêng biệt trên bảng điều khiển dành cho doanh nghiệp cho mỗi tổ chức phát hành.
  • Thông tin đăng nhập vào tài khoản dịch vụ từ 1 đến nhiều.
    • 1 thông tin đăng nhập cho mỗi doanh nghiệp/đơn vị phát hành.
    • Mỗi doanh nghiệp có một thông tin đăng nhập riêng.

Độ phức tạp của chế độ thiết lập phức tạp

1 tài khoản chính cho nhiều tài khoản của tổ chức phát hành.

  • Lựa chọn này cho phép bạn sử dụng phương pháp quản lý tập trung bằng 1 tài khoản chính với nhiều doanh nghiệp phụ.
  • 1 đến nhiều dự án trên Google Cloud.
  • Số người dùng riêng biệt trên bảng điều khiển dành cho doanh nghiệp cho mỗi đơn vị phát hành.
  • Thông tin đăng nhập vào tài khoản dịch vụ từ 1 đến nhiều.
    • 1 thông tin đăng nhập PROD cho mỗi doanh nghiệp/đơn vị phát hành.
    • Mỗi doanh nghiệp/đơn vị phát hành có 1 thông tin đăng nhập DEV.

Liên hệ với bộ phận hỗ trợ

Làm việc với thẻ và vé

Làm cách nào để xoá các lớp hoặc đối tượng?

Hiện tại, bạn không thể xoá các lớp học hoặc đối tượng khỏi Google Wallet. Tuy nhiên, người dùng có thể huỷ liên kết các đối tượng khỏi Google Wallet.

Làm cách nào để nhóm nhiều thẻ và vé lại với nhau?

Việc sử dụng GroupingID giúp bạn dễ dàng nhóm các thẻ và vé lại với nhau.

Làm cách nào để chỉ cập nhật một phần của thẻ và vé?

Hãy làm theo hướng dẫn về hiệu suất của chúng tôi để biết cách thực hiện các bản cập nhật một phần bằng cách sử dụng yêu cầu PATCH.

Tôi có thể tạo thẻ/vé hàng loạt không?

Hãy làm theo hướng dẫn về hiệu suất của chúng tôi để tìm hiểu cách thực hiện các yêu cầu hàng loạt bằng API.

Câu hỏi chung

Giới hạn tốc độ cho các yêu cầu được gửi đến API Ví Google là bao nhiêu?

Các lệnh gọi đến API Ví Google bị giới hạn ở mức 20 yêu cầu mỗi giây.

API Google Wallet không có SLA chính thức, nhưng bạn nên đặt thời gian chờ là 10 giây, dựa trên độ trễ ở phân vị thứ 99 là khoảng 5 giây. Ngoài ra, hãy lưu ý rằng độ trễ thường phụ thuộc vào các yếu tố bên ngoài, chẳng hạn như thời gian cần thiết để tìm nạp một hình ảnh được lưu trữ trên máy chủ bên ngoài khi chèn một đối tượng có hình ảnh đó, vì điều này phụ thuộc vào độ trễ của máy chủ bên ngoài.

Tại sao thẻ và vé trong Google Wallet không được phép có hình ảnh cá nhân?

Google Wallet không hỗ trợ hình ảnh cá nhân trên thẻ và vé vì các quy định hiện hành nêu rõ rằng tất cả người tiêu dùng đều có quyền chọn không cho phép thu thập hoặc xử lý dữ liệu nhạy cảm. Bằng cách có dữ liệu nhạy cảm (hình ảnh cá nhân) trong đối tượng có giá trị (trong JWT), có thể xảy ra các vấn đề về việc lưu trữ khi dữ liệu có thể trở thành dữ liệu công khai, nằm ngoài thoả thuận đồng ý ban đầu. Để đảm bảo tính bảo mật của dữ liệu, bạn không được phép đăng hình ảnh cá nhân. Chúng tôi đang nỗ lực để hỗ trợ hình ảnh cá nhân trong tương lai.

Google Wallet API trả về mã lỗi nào?

Để xem danh sách mã lỗi và ngoại lệ do API Ví Google trả về, hãy xem phần Mã lỗi.

Làm cách nào để bật thông báo đẩy?

Google Wallet hiện không hỗ trợ thông báo đẩy do nhà phát triển tạo. Tuy nhiên, Google Wallet sẽ cung cấp thông báo kịp thời cho các loại thẻ và vé sau đây. Google Wallet hiện không hỗ trợ thông báo đẩy do nhà phát triển tạo.

Dọc Thông báo Đã kích hoạt Tài liệu
Sự kiện Lời nhắc sắp tới 3 giờ trước sự kiện docs
Thẻ lên máy bay Lời nhắc sắp tới 3 giờ trước khi chuyến bay khởi hành docs
Thẻ lên máy bay Cập nhật thẻ và vé Thay đổi nhà ga, cửa, thời gian lên máy bay hoặc thời gian khởi hành tại điểm xuất phát docs
Thẻ ưu đãi Lời nhắc về việc hết hạn 48 giờ trước khi thẻ ưu đãi hết hạn docs
Generic Lời nhắc sắp tới 24 giờ trước khi "khoảng thời gian" bắt đầu docs
Generic Lời nhắc về việc hết hạn 48 giờ trước khi "khoảng thời gian" kết thúc docs

Tôi có thể xoá mã người bán không?

Hiện tại, bạn không thể xoá hoặc lưu trữ mã người bán trong Google Pay & Wallet Console.

Làm cách nào để sử dụng tính năng Liên kết ứng dụng?

Tính năng liên kết ứng dụng yêu cầu phải có danh sách cho phép. Bạn có thể yêu cầu tại đây.

Google Wallet có hỗ trợ tính năng hàng rào địa lý không?

Hiện không hỗ trợ tính năng hàng rào địa lý.

Làm cách nào để thiết lập chương trình khách hàng thân thiết?

Bạn có thể thiết lập chương trình đăng ký và chương trình khách hàng thân thiết bằng cách làm theo hướng dẫn này.

Làm cách nào để gửi biểu trưng của tôi cho Google đối với thẻ và vé đi phương tiện công cộng?

Vui lòng sử dụng biểu mẫu này để gửi biểu trưng cho Google nhằm đưa vào danh sách cho phép.

Làm cách nào để xử lý đúng dữ liệu userProfile được mã hoá Base64?

Đảm bảo bạn sử dụng phương thức mã hoá UTF-8 trong suốt quá trình. Trước tiên, chuỗi JSON được mã hoá UTF-8 và sau đó được mã hoá bằng android.util.Base64 với các lựa chọn NO_WRAP và URL_SAFE. Điều này tương ứng với RFC 3548 phần 4.

Làm cách nào để tạo tài khoản của Tổ chức phát hành theo phương thức lập trình?

Hãy xem hướng dẫn này để tạo tài khoản của đơn vị phát hành thông qua API.

Chạm thông minh

Tôi có cần đầu đọc NFC đặc biệt cho thẻ Google Smart Tap không?

Đó phải là một thiết bị đầu cuối có thể sử dụng tính năng Smart Tap. Bạn có thể xem danh sách các nhà cung cấp được chứng nhận tại đây.

Làm cách nào để thẻ và vé của tôi hoạt động với NFC?

Vui lòng làm theo cấu hình này để cho phép sử dụng thẻ/vé bằng tính năng Smart Tap.

Mã thông báo web JSON (JWT)

Có công cụ nào giúp đơn giản hoá việc triển khai và gỡ lỗi JWT không?

Có, các nền tảng như www.jwt.io cho phép bạn giải mã và gỡ lỗi mã thông báo trong quá trình phát triển, nhờ đó bạn có thể xác minh nội dung mà bạn đang gửi. Xin lưu ý rằng Google không liên kết và không đặc biệt đề xuất bất kỳ bên thứ ba nào như vậy.

Bạn có thể tạo trước các lớp và đối tượng bằng API trước khi tạo đường liên kết lưu thẻ và vé (JWT).

Khắc phục sự cố

Tại sao chế độ cài đặt thời gian của tôi hiển thị sai thời gian diễn ra sự kiện?

Thời gian hiển thị trên thẻ là giờ địa phương của sự kiện, có độ lệch so với thời gian diễn ra sự kiện.

Biểu trưng của tôi không hiển thị trên thẻ và vé mà tôi đã tạo. Nguyên nhân nào có thể gây ra vấn đề này?

  • Trước tiên, hãy đảm bảo biểu trưng của bạn tuân thủ các nguyên tắc và được lưu ở định dạng PNG.
  • Đảm bảo biểu trưng luôn có sẵn với độ tin cậy cao. Đừng chuyển hướng đến các tệp hình ảnh vì có thể gây ra lỗi 404. Hình ảnh của bạn phải được lưu trữ tại vị trí HTTPS, nếu không hình ảnh sẽ không xuất hiện trong Google Wallet.
  • Đảm bảo rằng bạn đã đặt tất cả các trường bắt buộc được đánh dấu là bắt buộc trong API trong thẻ và vé.

Hỗ trợ và phản hồi

Làm cách nào để liên hệ với nhóm hỗ trợ kỹ thuật?

Để được trợ giúp thêm, hãy liên hệ với nhóm hỗ trợ bằng cách nhấp vào nút "Liên hệ với nhóm hỗ trợ" ở thanh bên trái của bảng điều khiển Google Pay và Wallet.

Làm cách nào để gửi ý kiến phản hồi về sản phẩm?

Để gửi ý kiến phản hồi về sản phẩm, hãy nhấp vào nút "Gửi ý kiến phản hồi" ở góc phần tư trên cùng bên phải của trang web dành cho nhà phát triển rồi chọn "Ý kiến phản hồi về sản phẩm". Tiếp theo, hãy mô tả ý kiến phản hồi của bạn trong vùng văn bản rồi nhấp vào "Gửi".

Làm cách nào để gửi ý kiến phản hồi về tài liệu?

Để gửi ý kiến phản hồi về tài liệu, hãy nhấp vào nút "Gửi ý kiến phản hồi" ở góc trên bên phải của trang web dành cho nhà phát triển rồi chọn "Ý kiến phản hồi về tài liệu". Tiếp theo, hãy mô tả ý kiến phản hồi của bạn trong vùng văn bản rồi nhấp vào "Gửi".