Konfigurowanie dostępu do interfejsu API

Oto jak skonfigurować dostęp do interfejsu Data Manager API za pomocą pakietu SDK lub REST.

Wybierz typ procesu konfiguracji, który chcesz przeprowadzić:

Wymagania wstępne

Zanim zaczniesz korzystać z interfejsu Data API, sprawdź, czy masz:

  1. Projekt Google Cloud.
  2. Konto Google, które ma uprawnienie serviceusage.services.enable w projekcie Google Cloud lub ma rolę, która obejmuje to uprawnienie. Na przykład zarówno roles/owner, jak i roles/serviceusage.serviceUsageAdmin zawierają uprawnienie serviceusage.services.enable. Aby sprawdzić uprawnienia, przeczytaj artykuł Wyświetlanie bieżącego dostępu.
  3. Interfejs wiersza poleceń Google Cloud zainstalowany.

Włącz API

Jeśli nie masz jeszcze włączonego interfejsu Data Manager API, kliknij Włącz interfejs Data Manager API lub wykonaj instrukcje, aby ręcznie wykonać ten krok.

Włączanie interfejsu Data Manager API

Jeśli nie możesz znaleźć interfejsu Data Manager API lub włączenie interfejsu Data Manager API nie powiedzie się, sprawdź, czy Twoje konto Google spełnia wymagania wstępne.

Konfigurowanie uwierzytelniania

Możesz użyć dowolnej z metod uwierzytelniania w Google z wyjątkiem kluczy interfejsu API. Zalecamy zapoznanie się z artykułem Wybieranie odpowiedniej metody uwierzytelniania w zależności od przypadku użycia, aby zdecydować, które podejście jest odpowiednie w Twoim przypadku.

Dwie popularne metody uwierzytelniania to konta użytkowników i konta usługi:

  • Konta użytkowników: reprezentują osoby, które bezpośrednio korzystają z interfejsów API i usług Google.
  • Konta usługi: reprezentują aplikacje, a nie osoby, jako użytkowników. Umożliwiają one aplikacjom zarządzanie uwierzytelnianiem i autoryzacją. Na przykład, jeśli aplikacja potrzebuje dostępu do zasobów Google Cloud.

Integracja może używać domyślnych danych uwierzytelniających aplikacji (ADC), aby automatycznie znajdować dane uwierzytelniające w środowisku. Dzięki temu nie musisz zmieniać kodu klienta w celu uwierzytelnienia.

Aby skonfigurować ADC, wybierz Konto użytkownika lub Podszywanie się pod konto usługi:

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

  1. Skonfiguruj ustawienia platformy uwierzytelniania Google w projekcie.

    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ęp do danych w projekcie.

    2. Kliknij Dodaj lub usuń zakresy.

    3. Na liście zakresów zaznacz pole wyboru obok pozycji Data Manager API 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. Możesz pominąć ten krok, jeśli masz już klienta OAuth2 na komputer, którego chcesz używać w interfejsie Data Manager API.

    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

    W ostatnim kroku 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 musisz zalogować 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 interfejsu 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. Aby sprawdzić, czy dane logowania są poprawnie skonfigurowane, użyj tego polecenia. Jeśli polecenie zadziała, w konsoli zostanie wyświetlony token dostępu.

    gcloud auth application-default print-access-token

Więcej informacji o uwierzytelnianiu i danych logowania aplikacji znajdziesz w artykułach Metody uwierzytelniania w Google i Jak działają domyślne dane logowania aplikacji.

Konfigurowanie dostępu do konta

Przyznaj adresowi e-mail powiązanemu z Twoim kontem użytkownika dostęp do Destination.

Dalsze kroki

Zainstaluj bibliotekę klienta i uruchom przykłady kodu, aby wypróbować pierwsze żądanie do interfejsu Data Manager API.

Dalej
Instalowanie biblioteki klienta