Konfigurowanie uwierzytelniania

Wdrażanie interfejsu API sprzedawcy DV360

Aby wdrożyć interfejs DV360 Seller API, musisz wykonać kilka ważnych czynności. Interfejs DV360 Seller API jest udostępniany jako interfejs Google Cloud API oparty na liście dozwolonych i używa protokołu OAuth do uwierzytelniania.

Proces dodawania do listy dozwolonych zostanie przeprowadzony przez zespół interfejsu DV360 Seller API.

Dołączenie do programu:

  1. Zarejestruj konto Google, otwierając stronę https://console.cloud.google.com/.
    • To konto będzie służyć do zarządzania tokenami dostępu do klienta produkcyjnego. Nie używaj osobistego konta Gmail.
    • Konto nie może być Grupą Google.
    • Jeśli używasz istniejącego projektu Google Cloud: konto musi być administratorem projektu.
  2. Skontaktuj się z zespołem Google DV360, podając informacje o koncie, które chcesz dodać do listy dozwolonych.
  3. Poczekaj, aż Twoje konto zostanie dodane do listy dozwolonych.
  4. Opcjonalne i nieblokujące: prześlij żądanie sprawdzenia aplikacji OAuth, aby uzyskać dostęp do zakresu(doubleclickbidmanager).
  5. Wejdź na https://console.cloud.google.com/. Otwórz Interfejsy API i usługi > Biblioteka > Prywatne. Interfejs DV360 Seller API powinien być widoczny jako jeden z dostępnych interfejsów API.
  6. Włączanie interfejsu DV360 Seller API
  7. Kliknij Dane logowania > Utwórz dane logowania > Klucz konta usługi. Postępuj zgodnie z instrukcjami podanymi tutaj: https://developers.google.com/identity/protocols/OAuth2ServiceAccount

    Skonfiguruj konto usługi:

    Uwaga: daj nam znać, jeśli chcesz ponownie użyć istniejącego konta usługi, np. do interfejsu DV360 Reporting API.

    Uwierzytelnienie i autoryzacja interfejsu Google Cloud API (zwykle określane jako „uwierzytelnianie”) są zwykle przeprowadzane za pomocą konta usługi. Konto usługi umożliwia Twojemu kodowi wysyłanie danych logowania aplikacji bezpośrednio do Cloud 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 tylko do aplikacji i może być używane tylko do uzyskiwania dostępu do interfejsu API, dla którego zostało utworzone. Na przykład pokażemy, jak utworzyć dane logowania do konta usługi za pomocą konsoli Google Cloud Platform.

    Korzystanie z konsoli Google Cloud

    Na stronie Menedżer interfejsu API → Dane logowania w konsoli Google Cloud wybierz „Utwórz dane logowania → Klucz konta usługi”.

    alt_text

    Następnie w menu „Konto usługi” kliknij „Nowe konto usługi”.

    alt_text

    Wpisz „Nazwa” tego konta usługi. Ta nazwa będzie używana jako domyślna nazwa „identyfikatora konta usługi” (po lewej stronie znaku „@” w wygenerowanym adresie identyfikatora konta usługi), ale możesz ją w razie potrzeby zmienić. Nazwy mogą być dowolne, ważne jest tylko to, aby je zapamiętać. W sekcji „Typ klucza” zalecamy pozostawienie wartości „JSON”. Kliknij „Utwórz”, a konsola GCP wygeneruje klucz JSON (jako plik tekstowy .json), wyświetli prośbę o pobranie pliku na komputer i otworzy okno Utworzono konto usługi.

    alt_text

    Wygenerowany klucz w formacie JSON będzie wyglądał podobnie do tego przykładowego klucza: 

    {
  "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"
}

    Zapisz ten plik JSON w bezpiecznym miejscu, ponieważ zawiera on klucz prywatny (i jest to jedyna kopia tego klucza). Jeśli chcesz wysłać dane logowania do interfejsu Google Cloud Platform API, musisz w kodze odwoływać się do tego pliku klucza konta usługi.

  8. Skontaktuj się z zespołem DV360, podając informacje o utworzonym koncie usługi . Potrzebujemy adresu e-mail tego konta usługi. Jest to inny proces autoryzacji na liście dozwolonych.
  9. Gdy Twoje konto usługi będzie upoważnione do wywoływania interfejsu API, możesz zapoznać się z dokumentacją interfejsu API na stronie https://developers.google.com/display-video/seller. Aby uzyskać token autoryzacji ręcznie, zapoznaj się z instrukcjami na stronie https://github.com/google/oauth2l. (musisz już mieć pobrany klucz konta usługi w formacie JSON). Szczegółowe instrukcje uzyskiwania tokena OAuth programowo znajdziesz tutaj: https://cloud.google.com/docs/authentication/production.

Ważne: zakres OAuth musi być „doubleclickbidmanager”

Wstecz
Przegląd
Dalej
Biblioteka klientów