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

Interfejs DV360 Exchange Reporting API jest dostępny jako usługa Google Cloud oparta na liście dozwolonych Interfejs API korzystający z protokołu OAuth. Proces dodawania do listy dozwolonych jest obsługiwany przez giełdę DV360 Zespół interfejsu API do raportowania.

Procedura

Oto instrukcje rozpoczęcia korzystania z interfejsu Exchange Reporting API w DV360:

  1. Zarejestruj konto Google w Google Cloud konsola.

    Pamiętaj, że to konto będzie 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 lista dozwolonych.

  3. Gdy otrzymasz informację o umieszczeniu Cię na liście dozwolonych, poproś o uwierzytelnianie OAuth weryfikacja weryfikacji aby uzyskać dostęp aplikacji do zakresu doubleclickbidmanager.

  4. Zaloguj się w konsoli Google Cloud.

    Otwórz API & Usługi > Biblioteka > Prywatna. Powinno być widoczne w DV360 Interfejs Exchange Reporting API podany jako jeden z dostępnych interfejsów API. Włącz DV360 Exchange Reporting API.

  5. Kliknij Dane logowania > Utwórz dane logowania > Klucz konta usługi. Wykonaj instrukcje tworzenia usługi, .

Konto usługi

Konto usługi pozwala za pomocą kodu wysyłać dane logowania do aplikacji bezpośrednio do interfejs API. Konto usługi, tak jak konto użytkownika, jest reprezentowane przez adres e-mail adresu. Jednak w przeciwieństwie do konta użytkownika konto usługi należy tylko do aplikacji i można go używać wyłącznie do uzyskiwania dostępu do interfejsu API, dla którego został utworzony.

Oto czynności, które musisz wykonać, aby utworzyć dane logowania do konta usługi za pomocą Google Cloud konsola:

  1. W menu Menedżer API > Credentials (Dane logowania), wybierz Utwórz dane logowania → klucz konta usługi.

  2. Z menu Konto usługi wybierz Nowe konto usługi.

    Wpisz nazwę tego konta usługi. Ta nazwa jest używana jako domyślna identyfikator konta usługi po lewej stronie ciągu @ w wygenerowanego identyfikatora konta usługi.

    W sekcji Key type (Typ klucza) zalecamy pozostawienie tej wartości na JSON. Kliknij Utwórz, aby wygenerować klucz JSON jako plik tekstowy .json. Gdy pojawi się odpowiedni komunikat, pobierz plik na swój komputer i 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. Przechowuj plik JSON w bezpieczny sposób, ponieważ zawiera on klucz prywatny. jest jedyną kopią tego klucza. Dane logowania w tym pliku są wymagane gdy kod wywołuje ten interfejs.

  4. Skontaktuj się z DV360, podając informacje o utworzonym koncie usługi. a konkretnie adres e-mail konta usługi. Jest to część proces dodawania do listy dozwolonych w celu uzyskania dostępu do interfejsu API.

Token dostępu

Gdy Twoje konto usługi zostanie uprawnione do wywoływania interfejsu API, będziesz mieć możliwość zapoznaj się z przykładami w przewodnikach po interfejsach API. Aby ręcznie uzyskać token dostępu, Możesz użyć narzędzia takiego jak oauth2l. lub skorzystaj z jednego naszego klienta biblioteki automatycznego uwierzytelniania.