Zanim uruchomisz aplikację, która prosi użytkowników zewnętrznych o dane logowania do interfejsu Data Manager API, Twój projekt w chmurze Google Cloud musi przejść weryfikację aplikacji Google OAuth.
W tym przewodniku opisujemy zalecane zmiany konfiguracji odbiorców podczas tworzenia aplikacji oraz czynności, które należy wykonać, aby przejść weryfikację aplikacji Google OAuth.
Etapy odbiorców aplikacji
W zależności od etapu rozwoju skonfiguruj stronę Odbiorcy w konsoli Google Cloud, używając różnych ustawień Typ użytkownika i Stan publikacji. Aby płynnie przejść od wstępnych testów do uruchomienia w środowisku produkcyjnym, wykonaj te czynności.
Faza 1. Początkowy rozwój (testowanie)
Na początku programowania i testowania podstawowych żądań do interfejsu API:
Stan publikacji: ustaw na Testowanie.
Typ użytkownika:
Jeśli Twój projekt w chmurze Google Cloud należy do organizacji Google Workspace i tylko użytkownicy w Twojej organizacji korzystają z aplikacji, wybierz Wewnętrzny.
W przeciwnym razie wybierz Zewnętrzny.
Użytkownicy testowi: jeśli ustawisz Typ użytkownika na Zewnętrzny, kliknij Dodaj użytkowników, aby ręcznie dodać konta Google, których używasz do generowania danych logowania. Tylko wymienione konta Google mogą autoryzować aplikację. Obowiązują limity testowania i reguły wygasania tokenów.
Weryfikacja nie jest wymagana podczas testowania. Jeśli wybierzesz opcję Zewnętrzny, użytkownicy testowi zobaczą ekran ostrzeżenia z potwierdzeniem, że mają dostęp testowy do niezweryfikowanej aplikacji, zanim przejdą do ekranu zgody.
Faza 2. Przed wprowadzeniem na rynek (przesłanie do weryfikacji)
Gdy integracja zostanie ukończona, interfejs użytkownika zostanie utworzony, a Ty planujesz uruchomienie w ciągu najbliższego miesiąca:
Zaktualizuj ustawienia na stronie Odbiorcy:
Stan publikacji: zmień na W produkcji.
Typ użytkownika: ustaw Zewnętrzny, jeśli aplikacja obsługuje klientów spoza organizacji, np. klientów reklamodawcy.
Prześlij aplikację do weryfikacji. Proces weryfikacji aplikacji Google OAuth może potrwać kilka tygodni, dlatego prześlij niezbędne informacje, gdy tylko interfejs będzie gotowy.
Wymagania dotyczące weryfikacji aplikacji
Aby przesłać aplikację do weryfikacji w Centrum weryfikacji, skonfiguruj ustawienia Google Auth Platform i przygotuj wymagane materiały weryfikacyjne.
Marka i polityka prywatności
Zanim prześlesz informacje, sprawdź te szczegóły na stronie Marka w konsoli Google Cloud:
Strona główna aplikacji: strona główna musi być dostępna publicznie i zawierać widoczny link do polityki prywatności aplikacji.
Link do polityki prywatności: adres URL polityki prywatności skonfigurowany na stronie Marka musi być zgodny z adresem URL polityki prywatności podanym na stronie głównej aplikacji.
Zakresy weryfikacji
Na stronie Dostęp do danych poproś tylko o zakresy, których wymaga Twoja aplikacja. Interfejs Data Manager API używa zakresów poufnych:
https://www.googleapis.com/auth/datamanager(zakres podstawowy)https://www.googleapis.com/auth/datamanager.partnerlink(w przypadku linków partnerów)
W zgłoszeniu do weryfikacji podaj szczegółowe pisemne wyjaśnienie, dlaczego Twoja aplikacja wymaga dostępu do żądanych zakresów.
Informacje kontaktowe
Zespół Google ds. weryfikacji OAuth wysyła wszystkie powiadomienia do właścicieli projektów i edytorów projektów skonfigurowanych w projekcie Google Cloud. Dbaj o to, aby te dane kontaktowe były aktualne w konsoli Google Cloud, aby nie przegapić próśb o informacje.
Jeśli zespół weryfikacyjny wyśle dodatkowe pytania lub prośby o aktualizacje (np. zmiany w filmie demonstracyjnym lub ustawieniach ekranu zgody), sprawdzanie zostanie wstrzymane do czasu, aż odpowiesz. Jeśli Twoje zgłoszenie jest rozpatrywane od kilku tygodni i nie otrzymujesz żadnych informacji, sprawdź skrzynki odbiorcze (w tym foldery ze spamem i śmieciami) wszystkich właścicieli projektu i edytorów projektu.
Instruktażowy film wideo
Podaj link do publicznie dostępnego filmu demonstracyjnego (np. niepublicznego filmu na YouTube lub publicznego linku na Dysku Google) pokazującego, jak Twoja aplikacja korzysta z żądanych zakresów.
Upewnij się, że film spełnia wszystkie wymagania dotyczące filmu prezentującego funkcje aplikacji, w tym te dotyczące interfejsu Data Manager API:
Pełna ścieżka użytkownika i uwierzytelnienie przez OAuth: pokaż pełną ścieżkę użytkownika w aplikacji, od momentu rozpoczęcia logowania lub autoryzacji do zakończenia procesu uwierzytelniania przez OAuth.
Zgodność tożsamości aplikacji: upewnij się, że nazwa aplikacji, logo i elementy marki widoczne w filmie są zgodne z konfiguracją na stronie Marka w konsoli Google Cloud.
Cały ekran zgody OAuth w języku angielskim: pokaż cały ekran zgody OAuth z selektorem języka w lewym dolnym rogu ustawionym na English (angielski) i upewnij się, że na ekranie są widoczne dokładnie te zakresy interfejsu Data Manager API, o które prosi aplikacja.
Użycie zakresu w interfejsie aplikacji: zademonstruj funkcje aplikacji, które używają żądanych zakresów (np. tworzenie linku partnera, tworzenie listy odbiorców lub konfigurowanie pozyskiwania danych w interfejsie aplikacji).
Etap 3. Gotowe do uruchomienia (zweryfikowane)
Gdy zespół Google ds. weryfikacji OAuth powiadomi Cię, że Twoja prośba o weryfikację aplikacji została zatwierdzona, nie musisz podejmować żadnych działań. Twoja aplikacja została zweryfikowana, a użytkownicy zewnętrzni mogą ją autoryzować bez wyświetlania ekranu ostrzeżenia o niezweryfikowanej aplikacji.