Authentication

Wszystkie wywołania interfejsu API Ad Managera muszą być autoryzowane przez OAuth2, otwarty standard, który umożliwia użytkownikom przyznawanie uprawnień aplikacjom innych firm, dzięki czemu aplikacja może wchodzić w interakcje z usługami internetowymi w imieniu użytkownika. OAuth2 umożliwia aplikacji klienckiej interfejsu API Ad Managera dostęp do konta Ad Managera użytkownika bez konieczności obsługiwania lub przechowywania nazwy użytkownika i hasła.

Generowanie danych uwierzytelniających OAuth2

Aby wygenerować dane logowania OAuth2, wykonaj te czynności.

1. Określanie typu uwierzytelniania

W tabeli poniżej możesz sprawdzić, który typ uwierzytelniania jest najbardziej odpowiedni dla Twojej aplikacji korzystającej z interfejsu API Ad Managera:

Wybieranie typu uwierzytelniania OAuth2
Konto usługi

Wybierz tę opcję, jeśli potrzebujesz dostępu tylko do własnych danych Ad Managera.

Więcej informacji
Aplikacja internetowa

Wybierz tę opcję, jeśli chcesz uwierzytelniać się jako dowolny użytkownik, który przyzna Twojej aplikacji uprawnienia dostępu do swoich danych Ad Managera.

Więcej informacji

2. Tworzenie danych logowania OAuth2

Po określeniu typu uwierzytelniania kliknij odpowiednią kartę poniżej i postępuj zgodnie z instrukcjami, aby wygenerować dane logowania OAuth2:

Konto usługi
  1. Otwórz stronę Dane logowania w Konsoli interfejsów API Google.
  2. Z menu projektu wybierz Utwórz nowy projekt, wpisz nazwę projektu i opcjonalnie zmień podany identyfikator projektu. Kliknij Utwórz.
  3. Na stronie Dane logowania kliknij Utwórz dane logowania, a następnie wybierz Klucz konta usługi.
  4. Wybierz Nowe konto usługi i JSON.
  5. Kliknij Utwórz, aby pobrać plik zawierający klucz prywatny.
Aplikacja internetowa
  1. Otwórz stronę Dane logowania w Konsoli interfejsów API Google.
  2. W menu projektu wybierz Utwórz nowy projekt, wpisz nazwę projektu (i opcjonalnie zmień podany identyfikator projektu), a następnie kliknij Utwórz.
  3. Na stronie Dane logowania kliknij Utwórz dane logowania, a następnie wybierz Identyfikator klienta OAuth.
  4. Może pojawić się prośba o ustawienie nazwy produktu na stronie Ekran zgody. Jeśli tak się stanie, kliknij Skonfiguruj ekran zgody, podaj wymagane informacje i kliknij Zapisz, aby wrócić na stronę Dane logowania.
  5. W polu Application Type (Typ aplikacji) wybierz Web Application (Aplikacja internetowa). Postępuj zgodnie z instrukcjami, aby wpisać źródła JavaScript, identyfikatory URI przekierowania lub obie te informacje.
  6. Kliknij Utwórz.
  7. Na stronie, która się pojawi, skopiuj do schowka identyfikator klienta i tajny klucz klienta, ponieważ będą one potrzebne podczas konfigurowania biblioteki klienta.
Zrzut ekranu z identyfikatorem klienta i tajnym kluczem klienta

3. Konfigurowanie sieci Ad Managera

Jeśli jesteś deweloperem zewnętrznym, może być konieczne, aby klient wykonał ten krok za Ciebie.

Konto usługi
  1. Otwórz sieć Ad Managera.
  2. Kliknij kartę Administrator.
  3. Sprawdź, czy dostęp do interfejsu API jest włączony.
  4. Kliknij przycisk Dodaj użytkownika konta usługi.
  5. Wypełnij formularz, używając adresu e-mail konta usługi. Użytkownik konta usługi musi mieć uprawnienia dostępu do elementów, tak jakby miał do nich dostęp w interfejsie.
  6. Kliknij przycisk Zapisz. Powinien pojawić się komunikat potwierdzający dodanie konta usługi.
  7. Aby wyświetlić istniejących użytkowników konta usługi, otwórz kartę Użytkownicy i kliknij filtr Konto usługi.
Aplikacja internetowa
  1. Otwórz sieć Ad Managera.
  2. Kliknij kartę Administrator.
  3. Sprawdź, czy dostęp do interfejsu API jest włączony.

4. Konfigurowanie biblioteki klienta i korzystanie z niej

Aby użyć danych logowania w bibliotece klienta, postępuj zgodnie z odpowiednim przewodnikiem poniżej:

Jeśli zdecydujesz się nie korzystać z jednej z naszych bibliotek klienta, musisz samodzielnie wdrożyć proces konta usługi lub aplikacji internetowej OAuth2.

Za kulisami

Nasze biblioteki klienta automatycznie zajmują się szczegółami opisanymi poniżej, więc czytaj dalej tylko wtedy, gdy interesuje Cię, co dzieje się za kulisami. Ta sekcja jest przeznaczona dla zaawansowanych użytkowników, którzy znają już specyfikację OAuth2 i wiedzą, jak używać OAuth2 z interfejsami API Google.

Nagłówek żądania HTTP

Nagłówek HTTP w każdym żądaniu wysyłanym do interfejsu API Ad Managera musi zawierać token dostępu w tej postaci:

Authorization: Bearer ACCESS_TOKEN

Na przykład:

POST … HTTP/1.1
Host: …
Authorization: Bearer 1/fFAGRNJru1FTz70BzhT3Zg
Content-Type: text/xml;charset=UTF-8
Content-Length: …

<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope">
…
</soap:Envelope>

Zakres

Pojedynczy token dostępu może przyznawać różne poziomy dostępu do wielu interfejsów API. Zmienna o nazwie scope kontroluje zbiór zasobów i operacji, na które zezwala token dostępu. Podczas żądania tokena dostępu aplikacja wysyła co najmniej 1 wartość w parametrze scope.

Ad Manager ma tylko 1 zakres, który jest widoczny poniżej. Autoryzacja powinna być przeprowadzana na poziomie użytkownika w usłudze.

Zakres Uprawnienia
https://www.googleapis.com/auth/admanager Wyświetlanie kampanii i zarządzanie nimi w usłudze Ad Manager.