Wprowadzenie do interfejsu DV360 Exchange Reporting API i konfigurowanie protokołu OAuth

Interfejs API do raportowania DV360 Exchange zapewnia partnerom zewnętrznych platform wymiany (3PE) zautomatyzowany dostęp do raportów skuteczności z Display & Video 360.

Interfejs DV360 Exchange Reporting API jest udostępniany jako interfejs Google Cloud API oparty na liście dozwolonych, który korzysta z OAuth. Proces umieszczania na liście dozwolonych jest obsługiwany przez zespół interfejsu API do raportowania DV360 Exchange.

Procedura

Oto czynności, które należy wykonać, aby rozpocząć korzystanie z interfejsu DV360 Exchange Reporting API:

  1. Zarejestruj konto Google w konsoli Google Cloud.

    Pamiętaj, że to konto służy do zarządzania tokenami dostępu dla klienta produkcyjnego, więc nie używaj osobistego konta Gmail.

  2. Skontaktuj się z zespołem Google DV360 i podaj informacje o koncie, aby dodać je do listy dozwolonych.

  3. Gdy otrzymasz powiadomienie, że Twoja aplikacja znajduje się na liście dozwolonych, poproś o sprawdzenie weryfikacji OAuth, aby uzyskać dostęp do zakresu doubleclickbidmanager.

  4. Zaloguj się w konsoli Google Cloud.

    Otwórz Interfejsy API i usługi > Biblioteka > Prywatne. Na liście dostępnych interfejsów API powinien być widoczny interfejs DV360 Exchange Reporting API. Włącz interfejs API do raportowania DV360 Exchange.

  5. Kliknij Dane logowania > Utwórz dane logowania > Klucz konta usługi. Postępuj zgodnie z instrukcjami tworzenia konta usługi.

Konto usługi

Konto usługi umożliwia wysyłanie przez kod danych logowania aplikacji bezpośrednio do interfejsu API. Konto usługi, podobnie jak konto użytkownika, jest reprezentowane przez adres e-mail. W przeciwieństwie do konta użytkownika konto usługi należy jednak tylko do aplikacji i może być używane tylko do uzyskiwania dostępu do interfejsu API, dla którego zostało utworzone.

Aby utworzyć dane logowania konta usługi za pomocą konsoli Google Cloud, wykonaj te czynności:

  1. Na stronie Menedżer interfejsów API > Dane logowania wybierz Utwórz dane logowania → Klucz konta usługi.

  2. W menu Konto usługi kliknij Nowe konto usługi.

    Wpisz nazwę tego konta usługi. Ta nazwa jest używana jako domyślna nazwa identyfikatora konta usługi po lewej stronie znaku @ w wygenerowanym adresie identyfikatora konta usługi.

    W sekcji Typ klucza zalecamy pozostawienie wartości JSON. Kliknij Utwórz, aby wygenerować klucz JSON jako plik tekstowy .json. Gdy pojawi się odpowiedni komunikat, pobierz plik na komputer. Wyświetli się okno Utworzono konto usługi.

    Oto przykładowy klucz JSON:

    {
  "type": "service_account",
  "project_id": "project-id",
  "private_key_id": "some_number",
  "private_key": "-----BEGIN PRIVATE KEY-----\n....
  =\n-----END PRIVATE KEY-----\n",
  "client_email": "<api-name>api@project-id.iam.gserviceaccount.com",
  "client_id": "...",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://accounts.google.com/o/oauth2/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com"
}

  3. Zapisz plik JSON w bezpiecznym miejscu, ponieważ zawiera on klucz prywatny, a jest to jedyna kopia tego klucza. Dane logowania w tym pliku są potrzebne, gdy kod wywołuje interfejs API.

  4. Skontaktuj się z zespołem DV360, podając informacje o utworzonym koncie usługi, a w szczególności adres e-mail tego konta. Jest to część procesu dodawania do listy dozwolonych w przypadku dostępu do interfejsu API.

Token dostępu

Gdy Twoje konto usługi zostanie autoryzowane do wywoływania interfejsu API, możesz przejść do przykładów w przewodnikach po interfejsie API. Aby ręcznie uzyskać token dostępu, możesz użyć narzędzia takiego jak oauth2l lub jednej z naszych bibliotek klienta, aby uwierzytelnić się w sposób zautomatyzowany.