Konfigurowanie uwierzytelniania

Wprowadzenie do interfejsu Display &Video 360 Seller API

Aby rozpocząć korzystanie z interfejsu Display &Video 360 Seller API, musisz wykonać kilka kluczowych czynności. Interfejs DV360 Seller API to interfejs Google Cloud API oparty na białej liście, który do uwierzytelniania i autoryzacji używa protokołu OAuth 2.0.

Proces dodawania do białej listy jest obsługiwany przez zespół interfejsu Display &Video 360 Seller API.

Kroki wprowadzenia:

  1. Zarejestruj konto Google na stronie https://console.cloud.google.com/.
    • To konto będzie używane 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 i podaj szczegóły konta, aby dodać je do białej listy.
  3. Poczekaj na potwierdzenie, że Twoje konto zostało włączone.
  4. Opcjonalnie i nieblokująco: prześlij prośbę o weryfikację OAuth swojej aplikacji, aby uzyskać dostęp do zakresu https://www.googleapis.com/auth/doubleclickbidmanager.
  5. W konsoli Google Cloud otwórz Interfejsy API i usługi > Biblioteka > Prywatne. Powinien być widoczny interfejs DV360 Seller API dostępny dla Twojego projektu.
  6. Włącz interfejs DV360 Seller API.
  7. Otwórz Interfejsy API i usługi > Dane logowania > Utwórz dane logowania > Klucz konta usługi. Postępuj zgodnie z instrukcjami konfiguracji w dokumentacji konta usługi OAuth 2.0.

    Skonfiguruj konto usługi:

    Uwaga: jeśli chcesz ponownie użyć istniejącego konta usługi, np. konta używanego w interfejsie DV360 Reporting API, poinformuj nas o tym.

    Uwierzytelnianie i autoryzacja interfejsu Google Cloud API (zwykle określane jako „autoryzacja”) odbywają się zazwyczaj za pomocą konta usługi. Konto usługi umożliwia wysyłanie danych logowania aplikacji bezpośrednio do interfejsu 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 jednak 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 konta usługi za pomocą konsoli Google Cloud Platform.

    Korzystanie z konsoli Google Cloud

    W konsoli Google Cloud na stronie Menedżer interfejsów API → Dane logowania kliknij „Utwórz dane logowania → Klucz konta usługi”.

    alt_text

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

    alt_text

    Wpisz „Nazwę” 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ą zmienić. Te nazwy mogą być dowolne. Ważne jest tylko, 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 wyświetli okno Utworzono konto usługi.

    alt_text

    Wygenerowany klucz JSON będzie podobny do tego przykładowego klucza 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"
}

    Przechowuj ten plik JSON w bezpiecznym miejscu, ponieważ zawiera on klucz prywatny (i jest jego jedyną kopią). Gdy będziesz chcieć wysłać dane logowania do interfejsu Google Cloud Platform API, musisz odwołać się do tego pliku klucza konta usługi w kodzie.

  8. Skontaktuj się z zespołem DV360 i podaj utworzone informacje o koncie usługi (w szczególności adres e-mail konta usługi). Jest to drugi krok dodawania do białej listy w celu autoryzacji.
  9. Gdy Twoje konto usługi będzie mieć uprawnienia do wywoływania interfejsu API, możesz zapoznać się z dokumentacją interfejsu DV360 Seller API. Aby ręcznie uzyskać token autoryzacji, postępuj zgodnie z instrukcjami w repozytorium narzędzia oauth2l (używając pobranego klucza JSON konta usługi). Szczegółowe instrukcje dotyczące programowego uzyskiwania tokenów OAuth znajdziesz w dokumentacji uwierzytelniania Google Cloud.

Ważne: zakres OAuth musi mieć postać https://www.googleapis.com/auth/doubleclickbidmanager

Wstecz
Przegląd
Dalej
Biblioteka klientów