W tabeli poniżej znajdziesz podsumowanie danych logowania, którymi musi zarządzać aplikacja. Więcej informacji o typach aplikacji znajdziesz w dokumentacji Google Identity dotyczącej protokołu OAuth 2.0.
| Przepływ pracy uwierzytelniania | Dane logowania | Typ danych logowania | Cel |
|---|---|---|---|
|
aplikacje internetowe JavaScript, Aplikacje na Androida |
Identyfikator klienta OAuth | Dane logowania aplikacji | Jednoznacznie identyfikuje aplikację podczas procesu OAuth. |
| Token dostępu i token odświeżania | Dane logowania użytkownika | Reprezentuje autoryzację użytkownika, która pozwala aplikacji na dostęp do jego konta Google Ads w jego imieniu. | |
|
Aplikacje internetowe po stronie serwera Aplikacje na komputery i iOS Aplikacje na telewizory i urządzenia |
Identyfikator klienta OAuth i tajny klucz klienta | Dane logowania aplikacji | Jednoznacznie identyfikuje aplikację podczas procesu OAuth. |
| Token dostępu i token odświeżania | Dane logowania użytkownika | Reprezentuje autoryzację użytkownika, która pozwala aplikacji na dostęp do jego konta Google Ads w jego imieniu. | |
| Konta usługi | Klucz konta usługi OAuth | Dane logowania aplikacji | Służy do podpisywania żądania OAuth. |
| Token dostępu konta usługi | Dane logowania użytkownika | Reprezentuje autoryzację konta usługi, gdy użytkownik udostępnia swoje konto Google Ads kontu usługi. |
Podczas zarządzania danymi logowania do aplikacji korzystającej z interfejsu Google Ads API musisz wziąć pod uwagę kilka kwestii.
Bezpieczne zarządzanie danymi logowania do aplikacji
Dane logowania aplikacji to ustawienia, które są specyficzne dla Twojej aplikacji i nie różnią się w zależności od użytkownika. Z danymi logowania aplikacji OAuth należy obchodzić się z największą ostrożnością, ponieważ każda osoba, która je posiada, może użyć tożsamości aplikacji, aby uzyskać dostęp do informacji o użytkownikach. Przechowuj dane logowania aplikacji OAuth w bezpiecznym miejscu i chroń je tak samo jak hasło. Jeśli to możliwe, do przechowywania danych logowania aplikacji używaj menedżera obiektów tajnych, takiego jak Google Cloud Secret Manager. Nigdy nie zapisuj danych logowania klienta w publicznie dostępnych repozytoriach kodu. Zdecydowanie zalecamy, aby nie umieszczać ich w żadnym repozytorium kodu.
Bezpieczne postępowanie z danymi logowania użytkowników
Dane logowania użytkownika to tokeny OAuth, które reprezentują autoryzację użytkownika. Są one powierzane przez użytkowników, którzy dają Ci uprawnienia do działania i uzyskiwania dostępu do danych w ich imieniu – bezpośrednio przez uwierzytelnienie aplikacji lub pośrednio przez udostępnienie konta Google Ads Twojemu kontu usługi. Nigdy nie przesyłaj tokenów w postaci zwykłego tekstu i zawsze przechowuj zaszyfrowane tokeny w stanie spoczynku, aby zapewnić dodatkową warstwę ochrony w przypadku naruszenia bezpieczeństwa danych. Unieważnij tokeny lub uprawnienia konta usługi, gdy nie potrzebujesz już dostępu do konta użytkownika. Po unieważnieniu tokenów usuń je trwale z aplikacji lub systemu.
Obsługa unieważnienia i wygaśnięcia tokena odświeżania
Jeśli używasz procesu uwierzytelniania użytkownika, pamiętaj, że tokeny odświeżania mogą zostać unieważnione w dowolnym momencie. Jeśli na przykład używasz procesu uwierzytelniania wielu użytkowników, użytkownik może zdecydować się na odebranie dostępu do aplikacji. Chociaż aplikacja, która używa procesu uwierzytelniania jednego użytkownika, jest mniej narażona na takie działanie, proces ręczny lub automatyczny zaprojektowany w celu ochrony użytkowników może nadal usunąć token odświeżania lub token odświeżania może wygasnąć. Jeśli Twoja aplikacja wymaga powiadomienia o unieważnieniu tokena, aby zapewnić użytkownikom wygodę, musisz zintegrować ją z usługą Ochrona wszystkich kont.
ponowne używanie danych logowania użytkownika w żądaniach do interfejsu API,
Tokeny dostępu OAuth są krótkotrwałe i wygasają po godzinie. Jeśli używasz biblioteki klienta interfejsu Google Ads API, obsługuje ona wygasanie tokena dostępu i odświeża go w sposób bezpieczny dla wątków. Utwórz obiekt klienta interfejsu Google Ads API z odpowiednimi danymi uwierzytelniającymi OAuth i używaj go przez cały okres jego ważności.
Jeśli tworzysz własną strategię odświeżania tokenów dostępu i zarządzania nimi, śledź datę ważności tokena dostępu i używaj tokenów ponownie, dopóki są ważne. Gdy poprosisz o odświeżenie tokena, serwer autoryzacji zwróci nowy token dostępu wraz z pozostałym czasem ważności w sekundach (expires_in). Zalecamy proaktywne odświeżanie tokena dostępu, jeśli do jego wygaśnięcia pozostało mniej niż 5 minut.