Konfigurowanie dostępu do interfejsu API

Konto użytkownika

Aby uwierzytelnić się za pomocą danych logowania konta użytkownika:

1. Skonfiguruj ustawienia platformy uwierzytelniania Google dla swojego projektu.

   1. Otwórz stronę marki w konsoli Google Cloud.

   2. Wybierz projekt.

   3. Wypełnij formularz i kliknij Utwórz.

2. Zakres interfejsu Data Manager API jest zakresem wrażliwym, dlatego wymagane są te czynności:

   1. Otwórz ustawienia dostępu do danych w projekcie.

   2. Kliknij Dodaj lub usuń zakresy.

   3. Na liście zakresów zaznacz pole obok pozycji Interfejs API Menedżera danych i kliknij Zaktualizuj.

   4. Kliknij Zapisz.

   5. W konsoli Google Cloud otwórz Odbiorców i zaktualizuj stan publikacji oraz typ użytkownika. Więcej informacji o tych ustawieniach znajdziesz w artykule Zarządzanie odbiorcami aplikacji.

3. Kliknij Utwórz klienta OAuth2, aby utworzyć klienta OAuth2 w projekcie, lub postępuj zgodnie z instrukcjami, aby utworzyć klienta OAuth2 na komputer. Jeśli masz już klienta OAuth2 na komputery, którego chcesz używać w interfejsie Data Manager API, możesz pominąć ten krok.

   Jeśli klikniesz Utwórz klienta OAuth2, wybierz Aplikacja na komputer, gdy pojawi się prośba o skonfigurowanie klienta OAuth, aby móc go używać w pozostałych krokach.

   Tworzenie klienta OAuth2

   Na ostatnim etapie kliknij POBIERZ KONFIGURACJĘ KLIENTA i zanotuj wybraną lokalizację pobierania.

4. Wygeneruj lokalny plik ADC, uruchamiając to polecenie. To polecenie uruchamia proces internetowy, w którym wyświetla się prośba o zalogowanie się na konto Google używane w interfejsie API.

   Zastąp PATH_TO_CLIENT_JSON nazwą pobranego pliku JSON.

   gcloud auth application-default login \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
     --client-id-file="PATH_TO_CLIENT_JSON"
   

   Jeśli chcesz używać tych samych danych logowania w przypadku interfejsu Data Manager API i interfejsu Google Ads API, dodaj zakres Google Ads API do listy --scopes:

   gcloud auth application-default login \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform" \
     --client-id-file="PATH_TO_CLIENT_JSON"
   

   Jeśli chcesz używać tych samych danych logowania w przypadku interfejsu Data Manager API i Display & Video 360 API, dodaj zakres Display & Video 360 API do listy --scopes:

   gcloud auth application-default login \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform" \
     --client-id-file="PATH_TO_CLIENT_JSON"
   

5. Sprawdź, czy dane logowania są prawidłowo skonfigurowane, używając tego polecenia. Jeśli polecenie zadziała, w konsoli zostanie wydrukowany token dostępu.

   gcloud auth application-default print-access-token
   

Konto usługi

Aby uwierzytelnić się za pomocą podszywania się pod konto usługi, wykonaj te czynności. W tych krokach używamy przyjęcia tożsamości zamiast kluczy konta usługi, ponieważ klucze konta usługi mogą stanowić zagrożenie dla bezpieczeństwa, jeśli nie są starannie zarządzane.

1. Kliknij przycisk Utwórz konto usługi lub postępuj zgodnie z instrukcjami, aby wybrać lub utworzyć konto usługi.

   Utwórz konto usługi

2. Przypisz do konta usługi rolę uprawnień Konsument Wykorzystania usług (roles/serviceusage.serviceUsageConsumer), która obejmuje serviceusage.services.use uprawnienie umożliwiające kontu usługi wysyłanie żądań interfejsu API w projekcie.

   gcloud projects add-iam-policy-binding PROJECT_ID \
     --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
     --role="roles/serviceusage.serviceUsageConsumer"
   

3. Przypisz do konta Google rolę uprawnień Twórca tokenów konta usługi (roles/iam.serviceAccountTokenCreator) na koncie usługi.

   gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
     --member="user:USER_EMAIL" \
     --role="roles/iam.serviceAccountTokenCreator"
   

4. Skonfiguruj ADC, uruchamiając to polecenie:

   gcloud auth application-default login \
     --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform"
   

   Jeśli chcesz używać tych samych danych logowania w przypadku interfejsu Data Manager API i interfejsu Google Ads API, dodaj zakres Google Ads API do listy --scopes:

   gcloud auth application-default login \
     --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform"
   

   Jeśli chcesz używać tych samych danych logowania w przypadku interfejsu Data Manager API i Display & Video 360 API, dodaj zakres Display & Video 360 API do listy --scopes:

   gcloud auth application-default login \
     --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform"
   

   Gdy pojawi się prośba o zalogowanie się, zaloguj się na konto Google, które ma rolę twórcy tokenów konta usługi.

5. Sprawdź, czy dane logowania są prawidłowo skonfigurowane, używając tego polecenia. Jeśli polecenie zadziała, w konsoli zostanie wyświetlony token dostępu.

   gcloud auth application-default print-access-token --scopes="https://www.googleapis.com/auth/datamanager"
   

Konto użytkownika

Wybierz kartę odpowiadającą Twojemu zastosowaniu.

• Wybierz Reklamodawca, jeśli używasz danych logowania do konta Google, które jest użytkownikiem kont reklamodawców, którymi chcesz zarządzać.
• Wybierz dostawca danych, jeśli używasz danych logowania do konta Google, które jest użytkownikiem konta dostawcy danych, i chcesz zarządzać kontami reklamodawców, które mają połączenie z kontem dostawcy danych. Konta dostawców danych są przyznawane dopiero po przejściu procesu zatwierdzania. Aby rozpocząć, wypełnij formularz zgłoszeniowy.

Konto usługi

Wybierz kartę odpowiadającą Twojemu zastosowaniu.

• Wybierz Reklamodawca, jeśli używasz danych logowania do konta Google, które jest użytkownikiem kont reklamodawców, którymi chcesz zarządzać.
• Wybierz dostawca danych, jeśli używasz danych logowania do konta Google, które jest użytkownikiem konta dostawcy danych, i chcesz zarządzać kontami reklamodawców, które mają połączenie z kontem dostawcy danych. Konta dostawców danych są przyznawane dopiero po przejściu procesu zatwierdzania. Aby rozpocząć, wypełnij formularz zgłoszeniowy.