Czwartek, 20 lutego 2025 r.
Co się zmienia?W tygodniu rozpoczynającym się 1 maja 2025 r. zaczniemy wdrażać rozdzielanie zgód na uwierzytelnianie użytkowników OAuth we wszystkich projektach Google Cloud utworzonych przed 2019 r. Jeśli masz aplikację, która korzysta z interfejsu API związanego z reklamami w ramach projektu Google Cloud utworzonego przed 2019 r., przed 1 maja 2025 r. może być konieczne zaktualizowanie aplikacji, aby obsługiwała ona rozdzieloną zgodę użytkownika.
Informacje ogólne
Rozdzielenie zgód w procesie uwierzytelniania użytkowników OAuth pozwala użytkownikom dostosować zakresy OAuth, do których chcą autoryzować aplikację, zamiast podejścia „wszystko albo nic”. Wszystkie projekty w konsoli Google Cloud utworzone od 2019 roku mają tę funkcję włączoną, a wszystkie projekty utworzone przed 2019 rokiem mają ją wyłączoną.
Kogo dotyczy ta zmiana?
Ta zmiana będzie miała na Ciebie wpływ, jeśli spełnione są WSZYSTKIE te warunki:
- Twoja aplikacja korzystająca z interfejsu API używa projektu konsoli Google Cloud utworzonego przed 2019 r.
- Twoja aplikacja implementuje proces uzyskiwania zgody użytkownika OAuth 2.0 – proces uwierzytelniania, w którym użytkownik loguje się za pomocą swojego konta Google i przyznaje co najmniej 1 uprawnienie, o które prosi aplikacja.
- Twoja aplikacja korzysta z więcej niż jednego interfejsu API Google, a jeden z nich to interfejs API związany z reklamami wymieniony poniżej.
Kogo nie dotyczy ta zmiana?
- Istniejące tokeny odświeżania: ta zmiana nie ma wpływu na uwierzytelnianie użytkowników, które już masz. Dotychczasowe tokeny odświeżania będą nadal działać bez żadnych zmian i nie będzie trzeba ponownie przeprowadzać uwierzytelniania.
- Aplikacje z jednym zakresem: jeśli Twoja aplikacja używa tylko jednego zakresu interfejsu API Google, ta zmiana nie będzie miała na nią wpływu, ponieważ nie ma wielu zakresów OAuth do rozdzielenia.
- Aplikacje dla jednego użytkownika / aplikacje uwierzytelniane ręcznie: Twoja aplikacja nie ma wdrożonego jawnego procesu uwierzytelniania użytkownika OAuth. Zamiast tego używasz skryptu uwierzytelniania ręcznego, takiego jak GenerateUserCredentials, gcloud CLI lub OAuth Playground, aby uwierzytelnić użytkownika, a następnie używasz tych danych logowania przez dłuższy czas. Ponieważ podczas uwierzytelniania wybierasz wszystkie zakresy, których wymaga Twoja aplikacja, ta zmiana nie ma na nią wpływu.
- Konta usługi: jeśli Twoja aplikacja używa konta usługi do uwierzytelniania wywołań interfejsu API, ta zmiana nie będzie miała na nią wpływu.
Co muszę zrobić?
Musisz upewnić się, że Twoja aplikacja może obsługiwać częściową zgodę użytkownika. W tym celu
- Poproś o listę zakresów OAuth, na które użytkownik wyraził zgodę, uwzględniając parametr
include_granted_scopesw procesie OAuth. - Sprawdź rzeczywistą listę zakresów protokołu OAuth, na które użytkownik wyraził zgodę użytkownika w odpowiedzi protokołu OAuth.
- Zaimplementuj w aplikacji autoryzację przyrostową.
Zapoznaj się z naszym przewodnikiem po szczegółowej zgodzie OAuth, aby dowiedzieć się więcej o wymaganiach i sprawdzonych metodach dotyczących obsługi szczegółowej zgody.
Jak przetestować tę funkcję?
Tę funkcję można przetestować na 2 sposoby:
- Utwórz nowy projekt Google Cloud: w nowych projektach Google Cloud włączone jest rozdzielanie zgody OAuth. Możesz utworzyć nowy projekt Google Cloud i użyć go do przetestowania aplikacji.
- Włączanie rozdzielania zgód w istniejącym projekcie: możesz ustawić parametr
enable_granular_consentna wartość „true” w żądaniu autoryzacji OAuth.
Których zakresów interfejsów API dotyczy ta zmiana?
Ta zmiana dotyczy następujących interfejsów API związanych z reklamami.
Jak uzyskać pomoc
Jeśli masz pytania lub potrzebujesz pomocy, skontaktuj się z zespołem pomocy odpowiedniego interfejsu API.
– Anash P. Oommen, zespół ds. interfejsu Google Ads API
Etykiety: authentication, oauth