Play Integrity API: przewodnik po połączeniu z projektem w chmurze i limitach

Interfejs Google Play Integrity API wymusza limit 10 tys. żądań dziennie na ruch z projektów w chmurze Google,które nie są połączone z aplikacją w Konsoli Google Play ani z pakietem SDK w Konsoli Play SDK. Ten limit jest już aktywny w przypadku większości projektów Google Cloud. W przypadku niewielkiej liczby projektów z wcześniej zwiększonym limitem termin na połączenie przed wprowadzeniem limitu został przedłużony do 16 lutego 2027 r.

Z tego przewodnika dowiesz się, jak łączenie projektów w chmurze wpływa na limity i jak połączyć projekty Google Cloud z aplikacją lub pakietem SDK. Znajdziesz tu też odpowiedzi na najczęstsze pytania.

Krótkie podsumowanie

Najważniejsze informacje Opis
Data wejścia w życie Już aktywne w przypadku większości projektów.
16 lutego 2027 r. w przypadku projektów, które otrzymały powiadomienie o terminie.
Zasady Żądania do interfejsu Play Integrity API pochodzące z projektów w chmurze, które nie są połączone z Twoją aplikacją lub pakietem SDK, są ograniczone do 10 tys. żądań do interfejsu API dziennie, niezależnie od wyższego niestandardowego limitu skonfigurowanego w projekcie.
Kogo to dotyczy Aplikacje i pakiety SDK, które wysyłają ponad 10 tys. żądań dziennie przy użyciu projektu Google Cloud, który nie jest połączony z daną aplikacją (w Konsoli Play) lub pakietem SDK (w Google Play SDK Console).
Wymagane działanie Połącz projekty Google Cloud ze swoją aplikacją w Konsoli Google Play lub z pakietem SDK w Google Play SDK Console.
Błąd po przekroczeniu limitu Żądania niepowiązane przekraczające limit 10 tys. dziennie kończą się błędem TOO_MANY_REQUESTS (kod błędu -8).

Najczęstsze pytania

Interfejs Play Integrity API zapewnia każdemu projektowi Google Cloud domyślny limit 10 tys. żądań dziennie. Deweloperzy, którzy potrzebują większej liczby, mogą poprosić o zwiększenie limitu.

Aby chronić aplikację lub pakiet SDK i zapobiec wyczerpaniu limitu przez nieupoważnione osoby trzecie, zwiększony limit dzienny jest ograniczony wyłącznie do projektów Google Cloud połączonych z aplikacją w Konsoli Google Play lub z pakietem SDK w Google Play SDK Console.

W przypadku aplikacji (Konsola Google Play):

  1. Zaloguj się w Konsoli Google Play i wybierz aplikację.
  2. W menu nawigacyjnym po lewej stronie kliknij Chronione przez Google Play.
  3. Obok opcji Play Integrity API kliknij Rozpocznij (lub Zarządzaj).
  4. Kliknij Połącz z projektem w chmurze (lub Dodaj projekt, jeśli masz już połączone projekty).
  5. Wybierz lub wpisz numer projektu Google Cloud, który chcesz połączyć, i potwierdź.

Pakiety SDK (Google Play SDK Console):

  1. Zaloguj się w Google Play SDK Console i wybierz pakiet SDK.
  2. W menu nawigacyjnym po lewej stronie kliknij Integralność pakietu SDK.
  3. Obok opcji Play Integrity API kliknij Ustawienia.
  4. Kliknij Połącz z projektem w chmurze (lub Dodaj kolejny, jeśli masz już połączone projekty).
  5. Wybierz lub wpisz numer projektu Google Cloud, który chcesz połączyć, i potwierdź.

Wymagane uprawnienia:

  • Konsola Play (w przypadku aplikacji): musisz mieć uprawnienie „Tworzenie wersji produkcyjnych, wykluczanie urządzeń i używanie podpisywania aplikacji przez Google Play” dotyczące aplikacji.
  • Play SDK Console (w przypadku pakietów SDK): musisz mieć uprawnienie Zarządzanie dotyczące pakietu SDK.
  • Google Cloud (obie opcje): musisz mieć uprawnienia 'serviceusage.services.enable' i 'resourcemanager.projects.get' w docelowym projekcie Google Cloud.

W przypadku aplikacji (Konsola Google Play):

  1. Otwórz Konsolę Google Play > Ochrona w Google Play > Play Integrity API > Zarządzaj.
  2. Sprawdź sekcję Konfiguracja projektu.
  3. Sprawdź, czy podany numer projektu jest zgodny z numerem używanym do wywoływania interfejsu Play Integrity API.

Pakiety SDK (Google Play SDK Console):

  1. Otwórz Google Play SDK Console > Integralność pakietu SDK > Ustawienia.
  2. Sprawdź sekcję Konfiguracja projektu.
  3. Sprawdź, czy podany numer projektu jest zgodny z numerem używanym do wywoływania interfejsu Play Integrity API.

Pytanie 4. Jak połączyć projekt w chmurze, jeśli moja aplikacja lub pakiet SDK nie są dostępne w Google Play?

Łączenie projektu w chmurze Google Cloud jest możliwe tylko w przypadku aplikacji zarządzanych w Konsoli Google Play i pakietów SDK zarejestrowanych w Google Play SDK Console.

Jeśli Twoja aplikacja jest rozpowszechniana wyłącznie poza Google Play lub Twój pakiet SDK nie jest dostępny w Play SDK Console, nie możesz połączyć projektu Google Cloud, a ruch w interfejsie Play Integrity API będzie ograniczony do domyślnych 10 tys. żądań dziennie. Aby uzyskać wyższy limit, opublikuj aplikację w Google Play lub zarejestruj kwalifikujący się pakiet SDK w Play SDK Console i połącz swój projekt w chmurze.

P5: Czy mogę połączyć kilka projektów Google Cloud lub udostępnić 1 projekt w różnych aplikacjach lub pakietach SDK?

  • Wiele projektów na aplikację lub pakiet SDK: z jedną aplikacją lub pakietem SDK możesz połączyć maksymalnie 5 projektów Google Cloud.
  • Jeden projekt w kilku aplikacjach: ten sam projekt Google Cloud możesz połączyć z kilkoma aplikacjami w Konsoli Google Play. Łączenie tego samego projektu Google Cloud z wieloma pakietami SDK lub z pakietem SDK i aplikacją nie jest obsługiwane.

Pytanie 6. Co zrobić, jeśli zarządzam aplikacją lub pakietem SDK, ale ktoś inny w mojej organizacji jest właścicielem projektu Google Cloud?

Aby dokończyć łączenie, użytkownik wykonujący działanie w Konsoli Play (lub Play SDK Console) musi też mieć wymagane uprawnienia w projekcie Google Cloud. Możesz to zrobić na 2 sposoby:

  • Opcja A: poproś osobę, która może zarządzać dostępem uprawnień w projekcie Google Cloud, o tymczasowe przyznanie Twojemu kontu Google uprawnień 'serviceusage.services.enable' i 'resourcemanager.projects.get'. Po połączeniu te uprawnienia nie są już wymagane do codziennych operacji.
  • Opcja B: przyznaj członkowi zespołu, który ma już uprawnienia 'serviceusage.services.enable' i 'resourcemanager.projects.get' w projekcie Google Cloud, wymagane uprawnienia konsoli, aby mógł wykonać krok połączenia:
    • W przypadku aplikacji (Konsola Play): przyznaj uprawnienie „Tworzenie wersji produkcyjnych, wykluczanie urządzeń i używanie podpisywania aplikacji przez Google Play”.
    • W przypadku pakietów SDK (Play SDK Console): przyznaj uprawnienie Zarządzaj do pakietu SDK.

P7: Co się stanie, jeśli nie połączę projektu w chmurze przed 16 lutego 2027 r.?

Jeśli po 16 lutego 2027 r. aplikacja lub pakiet SDK wyśle żądania do interfejsu Play Integrity API przy użyciu niepołączonego projektu Google Cloud:

  1. Do 10 tys. żądań dziennie: żądania są nadal realizowane normalnie w ramach domyślnego limitu podstawowego.
  2. Powyżej 10 tys. żądań dziennie: gdy niepołączony projekt osiągnie limit 10 tys. żądań dziennie, żądania będą odrzucane z błędem TOO_MANY_REQUESTS (kod błędu -8).

Natychmiastowe samodzielne rozwiązywanie problemów:

Jeśli po upływie terminu Twoja aplikacja lub pakiet SDK będą otrzymywać błędy TOO_MANY_REQUESTS z powodu niepołączonego projektu w chmurze, rozwiązaniem będzie połączenie brakującego projektu Google Cloud w Konsoli Play lub Play SDK Console.

P8: Nie używam interfejsu Play Integrity API. Dlaczego otrzymałem wiadomość z prośbą o połączenie projektu w chmurze?

Otrzymujesz to powiadomienie,ponieważ Twój projekt Google Cloud generuje dziennie ponad 10 tys. niepołączonych żądań do interfejsu Play Integrity API. Częste przyczyny:

  1. Biblioteka lub pakiet SDK skonfigurowane z numerem projektu w chmurze: niektóre biblioteki wywołują interfejs Play Integrity API za pomocą projektu Google Cloud. Jeśli Twoja aplikacja lub pakiet SDK korzysta z takiej biblioteki, połącz ten projekt z aplikacją w Konsoli Play lub z pakietem SDK w Play SDK Console.
  2. Inna aplikacja lub zespół w Twojej organizacji: inny zespół może używać tego projektu Google Cloud w swojej aplikacji lub pakiecie SDK. Skontaktuj się z zespołami inżynierów, aby zidentyfikować aplikację lub pakiet SDK, a następnie połącz projekt w Konsoli Play lub Google Play SDK Console.
  3. Nieautoryzowany ruch lub wycofana integracja: jeśli nieautoryzowane lub sklonowane aplikacje wysyłają żądania z numerem Twojego projektu lub jeśli nie używasz już interfejsu API, nie musisz nic robić. Pozostawienie limitu 10 tys. żądań dziennie bez połączenia ograniczy niechciany ruch.

Kontakt i pomoc

Jeśli masz pytania dotyczące łączenia projektu w chmurze lub zarządzania limitem interfejsu Play Integrity API: