Instrukcje

Na tej stronie znajdziesz szczegółowe informacje o wykonywaniu typowych zadań za pomocą interfejsu API.

Tworzenie użytkowników

Usługa UserService umożliwia użytkownika z uprawnieniami administratora do tworzenia użytkownika bezpośrednio w jego sieci. Każdy programista może to zrobić bez by nowy użytkownik zarejestrował się jako pierwszy. Jeśli na przykład testujesz interfejs API za pierwszym razem, zamiast wykonywać każde wywołanie interfejsu API jako administrator (ustawienie domyślne dla swojego adresu e-mail), możesz utworzyć kilku użytkowników z rolami takimi jak Sprzedawca, trafiker lub reklamodawca do testowania rzeczywistych przepływów pracy.

  1. Utwórz nowe adresy Gmail, takie jak my.name.salesperson@gmail.com. Ewentualnie Rejestrowanie istniejącego adresu innego niż Gmail jako nowego Konto Google.
  2. Zadzwoń pod numer createUsers, podając ten nowy adres i wybrany adres Role.
  3. Możesz uwierzytelnić się jako nowy użytkownik, korzystając z protokołu OAuth 2.0 do wygenerowania tokena dostępu.

Uzyskiwanie głównej jednostki reklamowej

Zarówno AdUnit najwyższego poziomu, do którego możesz dodać węzły podrzędne, jak i dopuszczalna głębokość hierarchii, zależy od typu konta (Mała firma lub Premium). AdUnit najwyższego poziomu, który obsługuje modyfikowanie węzłów podrzędnych, nosi nazwę efektywnego poziomu głównego AdUnit.

Aby pobrać obowiązujący poziom główny, wywołaj NetworkService.getCurrentNetwork() i sprawdź pole effectiveRootAdUnitId w zwróconym obiekcie Network.

Uwaga: różne rodzaje kont obsługują różne wzorce hierarchii.

Wysyłanie zapytań dotyczących obiektu

Wyszukujesz obiekty według kryteriów wyszukiwania przy użyciu metody getObjectsByStatement() są udostępniane przez wiele usług, gdzie Object jest konkretnym typem obiektu. Ten pobiera zapytanie PQL, które jest podobne do zapytania SQL, ponieważ umożliwia określenie pola do wyszukiwania (gdzie nazwy pól są mapowane na właściwości w obiekcie), sortowanie, i ograniczyć przesunięcie wyników wyszukiwania. Zobacz PQL Przewodnik, z którego dowiesz się więcej o PQL i polach obiektów, które można filtrowanie według.

Tworzenie zamówienia

Aby utworzyć zamówienie, wystarczy utworzyć obiekt Order i ustawić reklamodawcę. sprzedawcy i trafikerom przypiszą odpowiednim użytkownikom unikalną nazwę, i zadzwoń pod numer createOrders(). Wynik będzie obejmował nowo utworzone Order, lub o błędzie.

Przykład

Zobacz przykładowy kod w Javie do tworzenia zamówienia.

Tworzenie elementu zamówienia

Aby utworzyć nowy element zamówienia:

  1. Utwórz nowy obiekt Order lub użyj istniejącego.
  2. Utwórz nowy obiekt LineItem i ustaw typ rotacji, tablicę rozmiaru kreacji daty rozpoczęcia i zakończenia oraz innych właściwości.
  3. Utwórz nowy obiekt InventoryTargeting i określ, które obiekty Placement lub AdUnit chcesz uwzględnić w kierowaniu lub wykluczyć.
  4. Opakuj obiekt InventoryTargeting do nowego obiektu Targeting i przypisz do właściwości kierowania tego elementu (LineItem).
  5. Wywołaj metodę usługi elementu zamówienia createLineItems() z nowym obiektem i sprawdź wynik, aby sprawdzić, czy obiekt został utworzony.

Przykład

Zobacz przykładowy kod w języku Java do tworzenia elementu zamówienia.

Tworzenie kreacji

Różne typy kreacji obsługują różne komponenty, na przykład obraz. kreacja obsługuje pojedynczy plik źródłowy obrazu; kreacja Flash obsługuje dwóch plików zasobów: pliku Flash i obrazu zapasowego (w przypadku rozszerzenia Flash nie można udostępnić pliku. W przypadku kreacji hostowanych w witrynach innych firm należy przesłać tylko fragment kodu HTML odwołujący się do pliku na serwerze firmy zewnętrznej. Zobacz konkretnej podklasy Creative, by dowiedzieć się, jakie komponenty musisz przesłać, aby utworzyć kreację.

Przykład

Zobacz przykładowy kod w języku Java do tworzenia kreacji graficznej.

Modyfikowanie istniejącego obiektu

Aby zmodyfikować istniejący obiekt, utwórz zapytanie dotyczące obiektu, wywołując funkcję getObjectsByStatement(), zaktualizuj wartości w zwróconych obiektach, a potem wywołaj updateObjects().

Uwaga: zaktualizowane obiekty całkowicie zastąpią istniejące, nie ustawisz wartości właściwości w wysyłanym obiekcie, pobierz wartość domyślną tej właściwości, a nie poprzednią.

Zmienianie stanu obiektu

Stan obiektu zmienia się przez wywołanie metody performObjectAction() ujawnione przez Twoją usługę. Ta metoda przyjmuje 2 parametry:

  • Wystąpienie obiektu działania opisującego to, co chcesz zrobić. Dla: , usługa zamówienia udostępnia kilka działań, w tym ApproveOrders, PauseOrders, i ArchiveOrders. Wszystkie obiekty akcji wywodzą się z działania podstawowego klasy odpowiedniej dla danej usługi.
  • Zapytanie PQL opisujące, które obiekty mają zostać zmienione. Możesz zmienić stan co najmniej jednego obiektu w danym momencie, określając odpowiedni PQL .

Generowanie tagów reklam

Nie można generować tagów reklam za pomocą interfejsu API. musisz użyć witryny Google Ad Managera. Przeczytaj sekcję Tagowanie Sekcja Centrum pomocy dotycząca znajdziesz więcej informacji.

Więcej przykładów

Wiele innych przykładów znajdziesz w przykładowym kodzie w naszej bibliotece klienta. różnych języków programowania. Zobacz Biblioteki klienta i Przykładowy kod , gdzie znajdziesz link do przykładów w swoim języku programowania.