Authentication

Wszystkie wywołania interfejsu Google Ad Manager API muszą być autoryzowane za pomocą OAuth2, otwartego standardu, który umożliwia użytkownikom przyznawanie uprawnień aplikacjom innych firm, dzięki czemu aplikacja może w imieniu użytkownika wchodzić w interakcje z usługami internetowymi. 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 ani hasła.

Generowanie danych logowania OAuth2

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

1. Określanie typu uwierzytelniania

W tabeli poniżej znajdziesz informacje o tym, który typ uwierzytelniania jest najbardziej odpowiedni w przypadku Twojej aplikacji interfejsu API Ad Managera:

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. W 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. Kliknij Nowe konto usługi i wybierz 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 (opcjonalnie możesz też edytować podany identyfikator projektu) i kliknij Utwórz.
3. Na stronie Dane logowania kliknij Utwórz dane logowania, a potem Identyfikator klienta OAuth.
4. Może pojawić się prośba o ustawienie nazwy usługi 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. Jako Typ aplikacji wybierz Aplikacja internetowa. Postępuj zgodnie z instrukcjami, aby wpisać źródła JavaScript, identyfikatory URI przekierowania lub oba te elementy.
6. Kliknij Utwórz.
7. Na wyświetlonej stronie skopiuj do schowka identyfikator klienta i tajny klucz klienta, ponieważ będą one potrzebne podczas konfigurowania biblioteki klienta.

3. Konfigurowanie sieci Ad Managera

Jeśli jesteś deweloperem zewnętrznym, być może będziesz musiał poprosić klienta o wykonanie tego kroku.

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 nie chcesz korzystać z żadnej 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ę to, co dzieje się w tle. 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 Ad Managera API 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

Jeden token dostępu może przyznawać różny poziom dostępu do wielu interfejsów API. Parametr zmienny 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.