Bắt đầu
API Ví Google là gì?
API Ví Google 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, chúng tôi thêm một loại thẻ và vé chung để 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à độ phức tạp kinh doanh của tôi?
Dưới đây là các hướng dẫn có thể dùng để thiết lập môi trường phát triển phù hợp với nhiều cấp độ phức tạp và bảo mật của doanh nghiệp. Việc sử dụng nhiều tài khoản dịch vụ có thể cho phép nhà phát triển tạo một môi trường TEST tách biệt với môi trường PROD.
Mức độ phức tạp của quy trình thiết lập cơ bản
1 tài khoản Business Console hoặc 1 tài khoản chính trong Business Console với nhiều tài khoản người phát hành.
- Lựa chọn này cho phép áp dụng phương pháp được quản lý tập trung thông qua 1 tài khoản chính, không có hoặc có nhiều công ty phát hành phụ.
- 1 dự án trên Google Cloud.
- 1 thông tin xác thực tài khoản dịch vụ.
- Một nhóm người dùng duy nhất.
Độ phức tạp trung bình khi thiết lập
1 tài khoản mẹ cho nhiều tài khoản phát hành.
- Lựa chọn này cho phép áp dụng phương pháp quản lý tập trung bằng cách sử dụng 1 tài khoản chính có nhiều doanh nghiệp phụ.
- 1 Dự án trên Google Cloud.
- Số người dùng bảng điều khiển doanh nghiệp riêng biệt cho mỗi tổ chức phát hành.
- Từ 1 đến nhiều thông tin đăng nhập tài khoản dịch vụ.
- 1 thông tin xác thực cho mỗi doanh nghiệp/đơn vị phát hành.
- Quyền truy cập bằng thông tin xác thực khác nhau cho mỗi doanh nghiệp.
Độ phức tạp của việc thiết lập phức tạp
1 tài khoản mẹ cho nhiều tài khoản công ty phát hành.
- Lựa chọn này cho phép áp dụng phương pháp quản lý tập trung thông qua 1 tài khoản chính có nhiều doanh nghiệp phụ.
- 1 đến nhiều Dự án trên Google Cloud.
- Số người dùng bảng điều khiển doanh nghiệp riêng biệt trên mỗi tổ chức phát hành.
- Từ 1 đến nhiều thông tin đăng nhập tài khoản dịch vụ.
- 1 thông tin xác thực PROD cho mỗi doanh nghiệp/phát hành viên.
- 1 thông tin xác thực dành cho nhà phát triển cho mỗi doanh nghiệp/đơn vị phát hành.
Làm việc với thẻ và vé
Làm cách nào để xoá lớp hoặc đối tượng?
Hiện tại, bạn không thể xoá các lớp hoặc đối tượng khỏi Google Wallet. Tuy nhiên, người dùng có thể huỷ liên kết đố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 để tìm hiểu cách cập nhật một phần bằng các yêu cầu PATCH.
Tôi có thể tạo thẻ/vé theo lô không?
Làm theo hướng dẫn về hiệu suất của chúng tôi để hiểu cách thực hiện 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à gì?
Số lượng lệnh gọi đến API Ví Google được giới hạn ở mức 20 yêu cầu mỗi giây.
Tại sao hình ảnh cá nhân bị cấm xuất hiện trên thẻ/vé trong Google Wallet?
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 thu thập hoặc xử lý dữ liệu nhạy cảm. Khi dữ liệu nhạy cảm (hình ảnh cá nhân) là một phần của đối tượng có giá trị (trong JWT), có thể sẽ có những mối lo ngại 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 sử dụ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.
API Ví Google trả về những mã lỗi nào?
Để biết 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ẽ gửi thông báo kịp thời cho các thẻ và vé sau. 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 | tài liệu |
| Thẻ lên máy bay | Lời nhắc sắp tới | 3 giờ trước giờ khởi hành của chuyến bay | tài liệu |
| Thẻ lên máy bay | Cập nhật thẻ và vé | Thay đổi về nhà ga khởi hành, cổng, thời gian lên máy bay hoặc thời gian khởi hành | docs |
| Thẻ ưu đãi | Lời nhắc về thời điểm hết hạn | 48 giờ trước khi thẻ ưu đãi hết hạn | tài liệu |
| Thông tin chung | Lời nhắc sắp tới | 24 giờ trước khi "khoảng thời gian" bắt đầu | docs |
| Thông tin chung | Lời nhắc hết hạn | 48 giờ trước khi "thời gian nội bộ" kết thúc | tài liệu |
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ã nhận dạng người bán khỏi Google Pay & Wallet Console.
Làm cách nào để sử dụng tính năng Liên kết ứng dụng?
Việc liên kết ứng dụng cần phải đưa bạn vào danh sách cho phép. Bạn có thể yêu cầu tại đây.
Google Wallet có hỗ trợ Khoanh vùng địa lý không?
Hiện chưa hỗ trợ tính năng khoanh vùng đị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 thẻ đi phương tiện công cộng cho Google?
Vui lòng dùng biểu mẫu này để gửi biểu trưng cho Google để đưa vào danh sách cho phép.
Làm cách nào để xử lý đúng cách dữ liệu UserProfile được mã hoá Base64?
Hãy đảm bảo rằng bạn sử dụng bộ mã hoá UTF-8 trong suốt quy trình. Chuỗi JSON được mã hoá UTF-8 đầu tiên rồi được mã hoá bằng android.util.Base64 với các tuỳ chọn NO_WRAP và URL_SAFE. Điều này tương ứng với mục 4 của RFC 3548.
Làm cách nào để tạo tài khoản Đơn vị 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 người phát hành thông qua API.
Chạm thông minh
Tôi có cần máy đọc NFC đặc biệt cho thẻ và vé Google SmartTap không?
Đó phải là thiết bị đầu cuối có thể sử dụng tính năng Chạm thông minh. 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à vé bằng tính năng Chạm thông minh.
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, cho phép bạn xác minh nội dung mà bạn đang gửi. Xin lưu ý rằng Google không có mối liên kết và không đề xuất cụ thể bất kỳ bên thứ ba nào như vậy.
URL đường liên kết JWT của tôi vượt quá giới hạn 1800 ký tự của trình duyệt. Tôi cần làm gì?
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é (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 cho sự kiện?
Thời gian hiển thị trên thẻ và vé là giờ địa phương của sự kiện, cộng với chênh lệch giờ của sự kiện.
Biểu trưng của tôi sẽ không hiển thị trên Thẻ và vé mà tôi đã tạo. Nguyên nhân có thể là gì?
- Trước tiên, hãy đảm bảo biểu trưng của bạn tuân thủ nguyên tắc và được lưu ở định dạng PNG.
- Đảm bảo biểu trưng hiển thị dễ sử dụng với độ tin cậy cao. Không được chuyển hướng đến các tệp hình ảnh có thể gây ra lỗi 404. Hình ảnh của bạn phải được lưu trữ trên vị trí HTTPS, nếu không thì hình ảnh sẽ không xuất hiện trong Google Wallet.
- Đảm bảo rằng tất cả các trường bắt buộc được đánh dấu là bắt buộc trong API đều được đặt trong thẻ và vé.
Hỗ trợ và phản hồi
Làm cách nào để liên hệ với bộ phận 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 để để lạ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" trong góc phần tư phía 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ề sản phẩm". Tiếp theo, hãy mô tả ý kiến phản hồi của bạn trong khu vực 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?
Để để lạ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 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 khu vực văn bản rồi nhấp vào "Gửi".