Plac zabaw OAuth

Jednym z możliwych sposobów wygenerowania danych logowania OAuth 2 jest użycie poziomu testowego OAuth 2. OAuth2 Playground w połączeniu z konsolą interfejsu Google Ads API pozwala ręcznie tworzyć tokeny OAuth2.

Platforma do testowania OAuth2 jest przeznaczona dla użytkowników, którzy potrzebują dostępu tylko do jednego konta menedżera lub użytkownika Google Ads. Jeśli chcesz poprosić wielu użytkowników o dane logowania, lepiej skonfiguruj bibliotekę klienta dla OAuth w Search Ads 360.

Pobieranie identyfikatora i tajnego klucza klienta

Ostrzeżenie: aby korzystać z platformy Playground OAuth 2, musisz wygenerować identyfikator klienta dla aplikacji internetowej. Jest to jedyny typ aplikacji, który działa z platformą Playground OAuth 2. Więcej informacji znajdziesz w artykule Wybieranie typu aplikacji.

Jeśli nie masz projektu w chmurze:

1. Otwórz stronę Dane logowania w Konsoli interfejsów API Google.

2. W menu Projekt wybierz istniejący projekt lub utwórz nowy.

3. Na stronie Dane logowania kliknij Utwórz dane logowania, a następnie wybierz Identyfikator klienta OAuth.

4. W sekcji Typ aplikacji wybierz Aplikacja internetowa.

5. W sekcji Autoryzowane identyfikatory URI przekierowania dodaj wiersz z tymi danymi:https://developers.google.com/oauthplayground

6. Kliknij Utwórz.

7. Na stronie Identyfikator klienta zanotuj identyfikator klienta i tajny klucz klienta. Będziesz ich potrzebować w następnym kroku.

Jeśli masz już projekt w chmurze, możesz go ponownie użyć, ustawiając autoryzowane identyfikatory URI przekierowania w sposób podany powyżej.

Generowanie tokenów

Ostrzeżenie: użytkownik Search Ads 360, na którego konto jesteś zalogowany w przeglądarce, określa, do których kont będziesz mieć dostęp za pomocą wygenerowanych przez siebie danych logowania OAuth 2. Dlatego warto wykonać te czynności w oknie incognito lub gdy nie masz zalogowanego konta Search Ads 360, ponieważ użytkownik, którego danych logowania chcesz użyć, prawdopodobnie nie jest tą samą osobą, która logowała się, gdy zostały utworzone identyfikator klienta i klucz tajny.

1. Otwórz stronę OAuth 2 Playground (kliknięcie tego linku powinno wstępnie wypełnić niektóre kluczowe wartości).

2. W prawym górnym rogu kliknij ikonę koła zębatego  i zaznacz pole Użyj własnych danych logowania OAuth (jeśli nie jest już zaznaczone).

3. Sprawdź, czy:

   • Proces OAuth ma wartość Po stronie serwera.
   • Typ dostępu ma wartość Offline (dzięki temu otrzymasz token odświeżania i token dostępu zamiast tylko tokena dostępu).

4. Wpisz identyfikator klienta OAuth2 i tajny klucz klienta OAuth2 uzyskane powyżej.

   

5. W sekcji Krok 1 – wybierz i autoryzuj interfejsy API kliknij na liście Search Ads 360 Reporting API i wybierz jego zakres, https://www.googleapis.com/auth/doubleclicksearch. Następnie kliknij Autoryzuj interfejsy API:

   

6. Jeśli pojawi się taka prośba, zaloguj się na konto, któremu chcesz przyznać dostęp i autoryzację. W przeciwnym razie sprawdź, czy bieżący użytkownik w prawym górnym rogu to konto klienta lub konto menedżera, dla którego chcesz uzyskać dane logowania.

   Jeśli identyfikator klienta i klucz tajny zostały utworzone zaledwie kilka minut temu, a wystąpił błąd, np. Błąd: redirect_uri_mismatch, wprowadzone zmiany mogą nie zostać rozpowszechnione. W przeglądarce kliknij przycisk Wstecz, odczekaj kilka minut, a potem ponownie kliknij Autoryzuj interfejsy API.
   Jeśli pojawi się błąd informujący o tym, że deweloper nie przyznał Ci dostępu, a aplikacja jest obecnie testowana, przejdź na stronę ekranu zgody OAuth w projekcie GCP i wykonaj jedną z tych czynności:

   • Opublikuj aplikację.

   • Nie zmieniaj stanu aplikacji na „Testowanie” i dodaj siebie jako użytkownika testowego.

7. Pojawi się komunikat informujący, że Twoja aplikacja chce zarządzać kampaniami Search Ads 360. Aby kontynuować, kliknij Akceptuję.

8. Na karcie Krok 2. Wymień kod autoryzacji na tokeny powinien pojawić się kod autoryzacji. Kliknij Exchange authorization code for token (Kod autoryzacji giełdy dla tokenów).

   

9. Jeśli wszystko pójdzie dobrze, token odświeżania i token dostępu powinny być wypełnione (być może trzeba będzie ponownie rozwinąć sekcję Krok 2. Wymień kod autoryzacji na tokeny):

   

10. Skopiuj token odświeżania do pliku konfiguracji wybranej biblioteki klienta wraz z identyfikatorem klienta i tajnym kluczem klienta.

11. Skonfiguruj bibliotekę klienta dla OAuth w interfejsie Search Ads 360 Reporting API.

Usuwanie Playground OAuth2 z identyfikatora klienta

Skoro masz już token odświeżania, interfejs OAuth2 Playground nie musi już być autoryzowanym identyfikatorem URI przekierowania. Aby usunąć ją z listy autoryzowanych identyfikatorów URI przekierowania:

1. Otwórz stronę Dane logowania w konsoli interfejsów API Google.

2. W menu projektu wybierz swój projekt.

3. Na stronie Uprawnienia kliknij Nazwa identyfikatora klienta, aby ją edytować.

4. Usuń https://developers.google.com/oauthplayground z Autoryzowanych identyfikatorów URI przekierowania. Pamiętaj, że musisz pozostawić co najmniej jeden identyfikator URI przekierowania.

5. Kliknij Zapisz.