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.
Ten przewodnik zawiera zalecane zmiany konfiguracji odbiorców podczas tworzenia aplikacji oraz instrukcje dotyczące weryfikacji 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 etap rozwoju (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 zasady wygasania tokenów.
Weryfikacja nie jest wymagana podczas testowania. Jeśli wybierzesz opcję Zewnętrzny, testerzy 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 OAuth Google może potrwać kilka tygodni, dlatego prześlij ją jak najszybciej, 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 do weryfikacji.
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ć ogólnodostępna 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 korzysta z 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 oczekuje na rozpatrzenie 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 do 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 wyświetlają się dokładnie te zakresy interfejsu Data Manager API, o które prosi Twoja aplikacja.
Użycie zakresów w interfejsie aplikacji: zaprezentuj funkcje aplikacji, które korzystają z żą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 nic robić. Twoja aplikacja została zweryfikowana, a użytkownicy zewnętrzni mogą ją autoryzować bez wyświetlania ekranu ostrzeżenia o niezweryfikowanej aplikacji.