Proces uwierzytelniania pojedynczego użytkownika

Podobnie jak w przypadku przepływu pracy konta usługi, przepływ uwierzytelniania pojedynczego użytkownika korzysta z funkcji autoryzacji i zarządzania użytkownikami dostępnych w interfejsie Google Ads, aby przyznać aplikacji dostęp do wszystkich niezbędnych kont. Ten przepływ pracy uwierzytelniania składa się z 2 etapów:

• Przyznajesz pojedynczemu użytkownikowi dostęp do wszystkich kont Google Ads , którymi ma zarządzać aplikacja.
• Użytkownik autoryzuje Twoją aplikację do zarządzania jego kontami Google Ads w jego imieniu, przyznając jej w ten sposób dostęp do wszystkich kont Google Ads.

Ponieważ jest tylko 1 użytkownik, zamiast tworzyć własny przepływ uwierzytelniania użytkownika OAuth 2.0, możesz korzystać z narzędzi takich jak gcloud CLI lub przykład kodu GenerateUserCredential.

Powiązany przypadek użycia tego przepływu pracy występuje wtedy, gdy do Twoich kont można uzyskać dostęp za pomocą kilku loginów użytkowników (np. 3–4 użytkowników), więc nakład pracy związany z utworzeniem pełnego przepływu pracy uwierzytelniania użytkownika OAuth nie jest uzasadniony w porównaniu z nakładem pracy związanym z uzyskaniem autoryzacji dla 3–4 użytkowników za pomocą narzędzia wiersza poleceń, takiego jak gcloud CLI.

Wady

W porównaniu z przepływem pracy konta usługi ten przepływ ma kilka wad:

1. Przepływ pracy uwierzytelniania użytkownika wymaga utworzenia identyfikatora klienta i tajnego klucza klienta OAuth 2.0 w Konsoli Google Cloud, co wymaga więcej kroków konfiguracji niż utworzenie konta usługi i klucza.
2. Twoja aplikacja może wymagać dodatkowego procesu weryfikacji aplikacji Google Cloud.
3. Jeśli autoryzowany użytkownik opuści zespół lub firmę, a Ty usuniesz go z kont lub wyłączysz jego konto, Twoja aplikacja może przestać działać. Konta usługi nie są powiązane z poszczególnymi użytkownikami, więc to ryzyko jest wyeliminowane.
4. Użytkownik autoryzujący konto Google Ads powinien podjąć dodatkowe środki ostrożności, takie jak włączenie weryfikacji dwuetapowej, aby chronić swoje konto Google przed przejęciem z powodu słabych zabezpieczeń, złośliwego oprogramowania lub wyłudzania informacji. Konta usługi są mniej podatne na ten problem, ponieważ niektóre z tych metod ataku nie mają do nich bezpośredniego zastosowania.

Generowanie danych logowania

1. Postępuj zgodnie z instrukcjami, aby skonfigurować ekran zgody OAuth dla aplikacji i dodać https://www.googleapis.com/auth/adwords jako zakres OAuth 2.0. Więcej informacji znajdziesz w artykule Konfigurowanie ekranu zgody OAuth.

2. Postępuj zgodnie z instrukcjami, aby utworzyć identyfikator klienta i tajny klucz klienta. Po utworzeniu klienta OAuth 2.0 pobierz plik JSON klienta. Najpierw kliknij ikonę Download OAuth client (Pobierz klienta OAuth), a potem przycisk DOWNLOAD JSON (POBIERZ JSON) na następnym ekranie. Zapisz plik jako credentials.json.

3. Znajdź konto użytkownika, które ma dostęp do wszystkich kont Google Ads, którymi chcesz zarządzać za pomocą aplikacji. Jeśli brakuje dostępu do niektórych kont, postępuj zgodnie z instrukcjami, aby przyznać niezbędny dostęp.

4. Pobierz i zainstaluj gcloud CLI. Po zainstalowaniu sprawdź, czy narzędzie działa prawidłowo, uruchamiając polecenie gcloud version w wierszu poleceń. Wynik może wyglądać tak:

   :~$ gcloud version
   Google Cloud SDK 492.0.0
   alpha 2024.09.06
   beta 2024.09.06
   bq 2.1.8
   bundled-python3-unix 3.11.9
   core 2024.09.06
   enterprise-certificate-proxy 0.3.2
   gcloud-crc32c 1.0.0
   gsutil 5.30

5. Wygeneruj token odświeżania OAuth 2.0, uruchamiając narzędzie gcloud CLI:

   gcloud auth application-default 
   
     login --scopes=https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform 
   
     --client-id-file=<path_to_credentials.json>

   Plik credentials.json pochodzi z poprzedniego kroku.

6. Polecenie gcloud otwiera okno logowania na konto Google w nowym oknie przeglądarki i przeprowadza Cię przez kroki uwierzytelniania OAuth 2.0. Zaloguj się jako użytkownik wybrany w poprzednich krokach. Jeśli Twoja aplikacja nie jest zweryfikowana, może się wyświetlić ekran ostrzeżenia. W takich przypadkach możesz bezpiecznie kliknąć link Pokaż zaawansowane i opcję Przejdź do PROJECT_NAME (niezweryfikowany).

   

7. Po sprawdzeniu zakresów kliknij przycisk Dalej, aby przyznać uprawnienia. Przeglądarka przechodzi do adresu https://cloud.google.com/sdk/auth_success, co oznacza, że uwierzytelnianie się powiodło. Na stronie wyświetla się ten komunikat:

   Authorization code granted. Close this tab.

   Polecenie gcloud wyświetla ten komunikat:

   Credentials saved to file: [/****/.config/gcloud/application_default_credentials.json]

   Teraz otwórz plik application_default_credentials.json. Jego zawartość powinna być podobna do tej:

   {
       "account": "",
       "client_id": "******.apps.googleusercontent.com",
       "client_secret": "******",
       "refresh_token": "******",
       "type": "authorized_user",
       "universe_domain": "googleapis.com"
   }

Konfiguracja biblioteki klienta

Aby uzyskać instrukcje dotyczące konfigurowania biblioteki klienta, kliknij kartę odpowiadającą Twojemu językowi programowania.

api.googleads.clientId=INSERT_CLIENT_ID_HERE
api.googleads.clientSecret=INSERT_CLIENT_SECRET_HERE
api.googleads.refreshToken=INSERT_REFRESH_TOKEN_HERE
api.googleads.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

GoogleAdsConfig config = new GoogleAdsConfig()
{
    OAuth2Mode = OAuth2Flow.APPLICATION,
    OAuth2ClientId = "INSERT_OAUTH2_CLIENT_ID",
    OAuth2ClientSecret = "INSERT_OAUTH2_CLIENT_SECRET",
    OAuth2RefreshToken = "INSERT_OAUTH2_REFRESH_TOKEN",
    ...
};
GoogleAdsClient client = new GoogleAdsClient(config);

client_id: INSERT_OAUTH2_CLIENT_ID_HERE
client_secret: INSERT_OAUTH2_CLIENT_SECRET_HERE
refresh_token: INSERT_REFRESH_TOKEN_HERE
login_customer_id: INSERT_LOGIN_CUSTOMER_ID_HERE

[GOOGLE_ADS]
loginCustomerId = "INSERT_LOGIN_CUSTOMER_ID_HERE"

[OAUTH2]
clientId = "INSERT_OAUTH2_CLIENT_ID_HERE"
clientSecret = "INSERT_OAUTH2_CLIENT_SECRET_HERE"
refreshToken = "INSERT_OAUTH2_REFRESH_TOKEN_HERE"

Google::Ads::GoogleAds::Config.new do |c|
    c.client_id = 'INSERT_CLIENT_ID_HERE'
    c.client_secret = 'INSERT_CLIENT_SECRET_HERE'
    c.refresh_token = 'INSERT_REFRESH_TOKEN_HERE'
    c.developer_token = 'INSERT_DEVELOPER_TOKEN_HERE'
    c.login_customer_id = 'INSERT_LOGIN_CUSTOMER_ID_HERE'
end

clientId=INSERT_OAUTH2_CLIENT_ID_HERE
clientSecret=INSERT_OAUTH2_CLIENT_SECRET_HERE
refreshToken=INSERT_OAUTH2_REFRESH_TOKEN_HERE
loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE
 

curl \
--data "grant_type=refresh_token" \
--data "client_id=CLIENT_ID" \
--data "client_secret=CLIENT_SECRET" \
--data "refresh_token=REFRESH_TOKEN" \
https://www.googleapis.com/oauth2/v3/token

curl -i -X POST https://googleads.googleapis.com/v25/customers/CUSTOMER_ID/googleAds:searchStream \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "developer-token: DEVELOPER_TOKEN" \
-H "login-customer-id: LOGIN_CUSTOMER_ID" \
--data-binary "@query.json"

{
    "query": "SELECT campaign.id, campaign.name, campaign.network_settings.target_content_network FROM campaign ORDER BY campaign.id"
}