Play Integrity API: Hướng dẫn về hạn mức và liên kết dự án trên đám mây

API Tính toàn vẹn của Google Play áp dụng giới hạn 10.000 yêu cầu mỗi ngày đối với lưu lượng truy cập từ các dự án Google Cloud không được liên kết với một ứng dụng trong Google Play Console hoặc với một SDK trong Play SDK Console. Hạn mức này đã được áp dụng cho hầu hết các dự án trên đám mây của Google Cloud. Một số ít dự án có hạn mức cao hơn từ trước đã được gia hạn đến ngày 16 tháng 2 năm 2027 để hoàn tất việc liên kết trước khi giới hạn được áp dụng.

Hướng dẫn này giải thích cách việc liên kết dự án ảnh hưởng đến hạn mức của bạn, cách liên kết các dự án Google Cloud với ứng dụng hoặc SDK của bạn, đồng thời giải đáp các câu hỏi thường gặp.

Tóm tắt nhanh

Thông tin chi tiết chính Mô tả
Ngày thực thi Đã hoạt động cho hầu hết các dự án.
Ngày 16 tháng 2 năm 2027 đối với những dự án đã nhận được thông báo về thời hạn.
Chính sách Các yêu cầu API Tính toàn vẹn của Play bắt nguồn từ những dự án trên Google Cloud không được liên kết với ứng dụng hoặc SDK của bạn sẽ bị giới hạn ở mức 10.000 yêu cầu mỗi ngày, bất kể hạn mức tuỳ chỉnh cao hơn được định cấu hình trên dự án.
Đối tượng bị ảnh hưởng Ứng dụng và SDK thực hiện hơn 10.000 yêu cầu mỗi ngày bằng một dự án trên đám mây của Google không được liên kết với ứng dụng đó (trong Play Console) hoặc SDK đó (trong Play SDK Console).
Việc cần làm Liên kết các dự án trên Google Cloud với ứng dụng của bạn trong Google Play Console hoặc với SDK của bạn trong Google Play SDK Console.
Lỗi khi vượt quá hạn mức Các yêu cầu chưa liên kết vượt quá 10.000 yêu cầu mỗi ngày sẽ không thành công và gặp lỗi TOO_MANY_REQUESTS (mã lỗi -8).

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

API Tính toàn vẹn của Play cung cấp cho mỗi dự án Google Cloud một hạn mức mặc định là 10.000 yêu cầu mỗi ngày. Nhà phát triển cần hạn mức cao hơn có thể yêu cầu tăng hạn mức.

Để bảo vệ ứng dụng hoặc SDK của bạn và ngăn các bên thứ ba trái phép làm cạn kiệt hạn mức của bạn, hạn mức hằng ngày tăng thêm chỉ được áp dụng cho các dự án Google Cloud được liên kết với ứng dụng của bạn trong Google Play Console hoặc với SDK của bạn trong Google Play SDK Console.

Đối với ứng dụng (Google Play Console):

  1. Đăng nhập vào Google Play Console rồi chọn ứng dụng của bạn.
  2. Trong trình đơn điều hướng bên trái, hãy chuyển đến mục Được bảo vệ bằng Play.
  3. Bên cạnh Play Integrity API, hãy chọn Bắt đầu (hoặc Quản lý).
  4. Nhấp vào Liên kết dự án trên đám mây (hoặc Thêm dự án nếu bạn đã có dự án liên kết).
  5. Chọn hoặc nhập số dự án trên Google Cloud mà bạn muốn liên kết, rồi xác nhận.

Đối với SDK (Google Play SDK Console):

  1. Đăng nhập vào Google Play SDK Console rồi chọn SDK của bạn.
  2. Trong trình đơn điều hướng bên trái, hãy chuyển đến phần Tính toàn vẹn của SDK.
  3. Bên cạnh API Tính toàn vẹn của Play, hãy nhấp vào Cài đặt.
  4. Nhấp vào Liên kết dự án trên đám mây (hoặc Thêm dự án khác nếu bạn đã có dự án được liên kết).
  5. Chọn hoặc nhập số dự án trên Google Cloud mà bạn muốn liên kết, rồi xác nhận.

Các quyền bắt buộc:

  • Play Console (đối với ứng dụng): Bạn phải có quyền "Phát hành công khai, loại trừ thiết bị và sử dụng Tính năng ký ứng dụng của Play" đối với ứng dụng.
  • Play SDK Console (đối với SDK): Bạn phải có quyền "Quản lý" đối với SDK.
  • Google Cloud (cả hai): Bạn phải có quyền "serviceusage.services.enable" và "resourcemanager.projects.get" đối với dự án Google Cloud mục tiêu.

Đối với ứng dụng (Google Play Console):

  1. Mở Google Play Console > Được bảo vệ bằng Play > Play Integrity API > Quản lý.
  2. Kiểm tra mục Cấu hình dự án.
  3. Đảm bảo số dự án được liệt kê khớp với số dự án dùng để gọi API Tính toàn vẹn của Play.

Đối với SDK (Google Play SDK Console):

  1. Mở Google Play SDK Console > Tính toàn vẹn của SDK > Cài đặt.
  2. Kiểm tra mục Cấu hình dự án.
  3. Đảm bảo số dự án được liệt kê khớp với số dự án dùng để gọi API Tính toàn vẹn của Play.

Câu hỏi 4: Làm cách nào để liên kết dự án trên đám mây nếu ứng dụng hoặc SDK của tôi không có trên Google Play?

Bạn chỉ có thể liên kết một dự án trên đám mây của Google cho các ứng dụng được quản lý trong Google Play Console và các SDK đã đăng ký trong Google Play SDK Console.

Nếu ứng dụng của bạn được phân phối độc quyền bên ngoài Google Play hoặc SDK của bạn không có trên Play SDK Console, thì bạn không thể liên kết một dự án trên Google Cloud và lưu lượng truy cập API Tính toàn vẹn của Play sẽ bị giới hạn ở mức mặc định là 10.000 yêu cầu mỗi ngày. Để đủ điều kiện nhận hạn mức cao hơn, hãy xuất bản ứng dụng của bạn trên Google Play hoặc đăng ký SDK đủ điều kiện trong Play SDK Console, đồng thời liên kết dự án trên đám mây của bạn.

Câu hỏi 5: Tôi có thể liên kết nhiều dự án trên Google Cloud hoặc chia sẻ một dự án giữa các ứng dụng hoặc SDK không?

  • Nhiều dự án cho mỗi ứng dụng hoặc SDK: Bạn có thể liên kết tối đa 5 dự án trên Google Cloud với một ứng dụng hoặc SDK.
  • Một dự án cho nhiều ứng dụng: Bạn có thể liên kết cùng một dự án Google Cloud với nhiều ứng dụng trong Google Play Console. Chúng tôi không hỗ trợ việc liên kết cùng một dự án trên Google Cloud với nhiều SDK hoặc với một SDK và một ứng dụng.

Câu hỏi 6: Nếu tôi quản lý ứng dụng hoặc SDK nhưng người khác trong tổ chức của tôi sở hữu dự án Google Cloud thì sao?

Để hoàn tất việc liên kết, người dùng thực hiện hành động trong Play Console (hoặc Play SDK Console) cũng phải có các quyền cần thiết đối với dự án Google Cloud. Bạn có thể điều phối việc này theo một trong hai cách:

  • Cách A: Yêu cầu người có thể quản lý quyền truy cập IAM trên dự án Google Cloud tạm thời cấp cho Tài khoản Google của bạn các quyền "serviceusage.services.enable" và "resourcemanager.projects.get". Sau khi liên kết, bạn không cần những quyền này cho các hoạt động hằng ngày nữa.
  • Cách B: Cấp cho một thành viên trong nhóm (người đã có quyền "serviceusage.services.enable" và "resourcemanager.projects.get" đối với dự án trên Google Cloud) quyền cần thiết trong Console để họ có thể thực hiện bước liên kết:
    • Đối với ứng dụng (Play Console): Cấp quyền "Phát hành công khai, loại trừ thiết bị và sử dụng Tính năng ký ứng dụng của Play" cho ứng dụng.
    • Đối với SDK (Play SDK Console): Cấp quyền "Quản lý" cho SDK.

Hỏi: Điều gì sẽ xảy ra nếu tôi không liên kết dự án trên Cloud trước ngày 16 tháng 2 năm 2027?

Nếu một ứng dụng hoặc SDK gửi yêu cầu đến API Tính toàn vẹn của Play bằng một dự án Google Cloud chưa liên kết sau ngày 16 tháng 2 năm 2027:

  1. Tối đa 10.000 yêu cầu mỗi ngày: Các yêu cầu tiếp tục thành công như bình thường theo hạn mức cơ sở mặc định.
  2. Trên 10.000 yêu cầu mỗi ngày: Sau khi dự án chưa liên kết đạt đến 10.000 yêu cầu mỗi ngày, các yêu cầu sẽ bị từ chối kèm theo lỗi TOO_MANY_REQUESTS (mã lỗi -8).

Tự khắc phục ngay lập tức:

Nếu ứng dụng hoặc SDK của bạn gặp lỗi TOO_MANY_REQUESTS sau thời hạn do chưa liên kết với một dự án trên đám mây, thì việc liên kết với dự án trên đám mây còn thiếu trong Play Console hoặc Play SDK Console sẽ giải quyết được vấn đề này.

Câu hỏi 8: Tôi không sử dụng API Tính toàn vẹn của Play. Tại sao tôi nhận được thông báo yêu cầu liên kết dự án trên đám mây?

Bạn nhận được thông báo này vì dự án trên đám mây của bạn trên Google Cloud đang tạo ra hơn 10.000 Yêu cầu API chưa liên kết mỗi ngày qua Play Integrity API. Các lý do phổ biến bao gồm:

  1. Thư viện hoặc SDK được định cấu hình bằng số dự án trên đám mây: Một số thư viện gọi Play Integrity API bằng dự án của bạn trên Google Cloud. Nếu ứng dụng hoặc SDK của bạn sử dụng một thư viện như vậy, hãy liên kết dự án đó với ứng dụng của bạn trong Play Console hoặc với SDK của bạn trong Play SDK Console.
  2. Một ứng dụng hoặc nhóm khác trong tổ chức của bạn: Một nhóm khác có thể đang sử dụng dự án trên đám mây của Google này trong ứng dụng hoặc SDK của họ. Hãy kiểm tra với nhóm kỹ thuật của bạn để xác định ứng dụng hoặc SDK, sau đó liên kết dự án trong Play Console hoặc Play SDK Console.
  3. Lưu lượng truy cập trái phép hoặc một chế độ tích hợp đã ngừng hoạt động: Nếu các ứng dụng trái phép hoặc ứng dụng nhân bản đang gửi yêu cầu bằng số dự án của bạn, hoặc nếu bạn không còn sử dụng API này nữa, thì bạn không cần làm gì cả. Việc áp dụng hạn mức 10.000 yêu cầu mỗi ngày cho các ứng dụng chưa liên kết sẽ giúp hạn chế lưu lượng truy cập không mong muốn.

Liên hệ và hỗ trợ

Nếu bạn có câu hỏi về việc liên kết dự án trên đám mây hoặc quản lý hạn mức Play Integrity API: