Tło

Zanim rozpoczniesz

  1. Poproś swojego opiekuna klienta o przyznanie odpowiednich uprawnień dla kont dostęp aplikacji.
  2. Jeśli nie masz wiedzy na temat Authorized Buyers, zapoznaj się z artykułami na stronie Centrum pomocy Authorized Buyers eksperymentuj z interfejsem. Jeśli Twoja aplikacja ma przeprowadzać określanie stawek w czasie rzeczywistym, przeczytaj Dokumentacja protokołu RTB.
  3. Odwiedź Konsola interfejsów API aby skonfigurować nowy projekt. Zaloguj się na swoje konto Google dewelopera lub utworzyć konto. Pojawi się prośba o utworzenie projektu i wylogowanie się na kilku Warunkach korzystania z usług.

Konta nadrzędne i podrzędne

Jeśli pracujesz w strukturze konta zawierającej konto nadrzędne i podrzędne będziesz pracować wydajniej, jeśli zrozumiesz, jak interakcje. Oto krótkie podsumowanie:

Konta podrzędne

Użytkownik z danymi logowania, które przyznają dostęp do konta podrzędnego, może wyświetlać i modyfikować zasoby powiązane z kontem. Konta podrzędne nie mogą wyświetlać ani modyfikować zasobów należących do innych kont podrzędnych lub nadrzędnych.

Konta rodzica

Użytkownik z danymi logowania, które przyznają dostęp do konta rodzica, może wyświetlać te dane i modyfikować zasoby konta nadrzędnego, a także wszystkie powiązane kont dzieci. W przypadku operacji wyświetlających wszystkie dane danego zasobu ten użytkownik otrzyma odpowiedź zawierającą dane ze swojego konta kont dzieci. Pamiętaj, że w przypadku innych typów żądań kierowanych na zasoby dotyczące stanowisk podrzędnych konto nadrzędne musi określić parametr ścieżki accountId dla konta podrzędnego a nie własnego konta accountId.

Model danych interfejsu API REST

Zasób to pojedynczy element danych z unikalnym identyfikatorem. Zasób konta reprezentuje pozycję konta Authorized Buyers i jest głównym elementem klasy danych dla interfejsu Ad Exchange Buyer API. Metody interfejsu API działają na indywidualnych zasobów kont oraz kolekcji zasobów kont.

Konta Zasób zawiera: identyfikator konta, informacje używane do dopasowywania plików cookie, lokalizacje licytującego, adresy URL, na które są wysyłane pytania o stawkę, oraz aby określić maksymalną liczbę zapytań na sekundę wysyłanych przez Ad Exchange.

Oprócz zasobów i kolekcji kont Google Ad Exchange Buyer API definiuje te struktury danych:

Lokalizacja licytującego

Lokalizacje licytującego to struktury, które są zwracane wraz z zasobami kont podaj adres URL, na który Ad Exchange ma wysyłać pytania o stawkę, a pole maksymalną liczbę zapytań na sekundę wysyłanych przez Ad Exchange. Oto przykład lokalizacji licytującego w formacie JSON: 

"bidderLocation": [
    {
      "url": "http://bid.url.com/bidder",
      "maximumQps": 1500
    }
  ],

Elementy

Elementy zawierają listę kont. Oto przykłady elementów zapisanych w formacie JSON: 

{
  "kind": "adexchangebuyer#accountsList",
  "items": [
    accounts Resource
  ]
}

Obsługiwane operacje

Możesz wywołać 3 różne metody w kolekcjach i zasobach Interfejs Ad Exchange Buyer API w sposób opisany w tej tabeli. Wszystkie operacje wymagają autoryzacji.

Operacja Opis Mapowania HTTP REST
list Wyświetla listę wszystkich kont, do których ma dostęp aktualnie uwierzytelnione użytkownika. GET w identyfikatorze URI kolekcji.
pobierz Pobiera określony zasób z Konta. GET w identyfikatorze URI zasobu.
zaktualizuj Aktualizuje określony zasób dotyczący kont. PUT w identyfikatorze URI zasobu, gdzie przekazujesz dane dla zaktualizowany zasób.

Styl połączeń

REST to styl architektury oprogramowania, który zapewnia wygodne i spójne podejście do żądania i modyfikowania danych.

Skrót REST to reprezentatywny transfer stanowy. W kontekście interfejsów API Google oznacza to używanie czasowników HTTP do pobierania i modyfikowania reprezentacji danych przechowywanych przez Google.

W systemie REST zasoby są przechowywane w magazynie danych. klient wysyła żądanie, aby serwer wykonał określone działanie (takie jak utworzenie, pobranie, zaktualizowanie lub usunięcie zasobu), a serwer wykonuje tę czynność i wysyła odpowiedź, często w formie reprezentacji określonego zasobu.

W interfejsach API typu REST firmy Google klient określa działanie za pomocą czasownika HTTP, takiego jak POST, GET, PUT lub DELETE. Wskazuje zasób za pomocą globalnie unikalnego identyfikatora URI o następującej postaci:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

Ponieważ wszystkie zasoby interfejsu API mają unikalne identyfikatory URI dostępne przez HTTP, interfejs REST umożliwia buforowanie danych i jest zoptymalizowany pod kątem pracy z rozproszoną infrastrukturą sieciową.

Definicje metod znajdziesz w dokumentacji standardów HTTP 1.1. zawierają one specyfikacje GET, POST, PUT i DELETE.

REST w interfejsie Ad Exchange Buyer API

Obsługiwane operacje są mapowane bezpośrednio na czasowniki HTTP REST, zgodnie z opisem w sekcji Operacje interfejsu API

Identyfikatory URI API mają następujący format:

https://www.googleapis.com/adexchangebuyer/v1.4/resourceID?parameters

gdzie resourceID to identyfikator Zasób konta i parameters są dowolne parametry, które mają zostać zastosowane do zapytania. Zobacz standardowych parametrów zapytania, oraz dokumentacja referencyjna .

Format rozszerzeń ścieżki resourceID pozwala zidentyfikować zasób, z którego aktualnie korzystasz, np.:

https://www.googleapis.com/adexchangebuyer/v1.4/accounts
https://www.googleapis.com/adexchangebuyer/v1.4/accounts/id

Pełny zestaw identyfikatorów URI używanych w każdej obsługiwanej operacji w interfejsie API to podsumowując w dokumentacji referencyjnej.

Oto przykład, jak działa to w interfejsie Ad Exchange Buyer API.

Pobierz listę kont uwierzytelnionego użytkownika:

GET https://www.googleapis.com/adexchangebuyer/v1.4/accounts

Format danych

JSON

JSON (JavaScript Object Notation) to popularny, niezależny od języka format danych, który w prosty sposób przedstawia dowolne struktury danych w formie tekstowej. Więcej informacji znajdziesz na stronie json.org.