Method: advertisers.audit

Sprawdza reklamodawcę. Zwraca liczbę użytych elementów według typu zasobu w przypadku reklamodawcy. Użyte elementy wliczają się do odpowiedniego limitu zasobów. Więcej informacji znajdziesz na stronie https://support.google.com/displayvideo/answer/6071450.

Żądanie HTTP

GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}:audit

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
advertiserId

string (int64 format)

Wymagane. Identyfikator reklamodawcy, który ma zostać poddany kontroli.

Parametry zapytania

Parametry
readMask

string (FieldMask format)

Opcjonalnie: Konkretne pola do zwrócenia. Jeśli nie podasz maski, wszystkie pola w protokole odpowiedzi zostaną wypełnione. Prawidłowe wartości to:

  • usedLineItemsCount
  • usedInsertionOrdersCount
  • usedCampaignsCount
  • channelsCount
  • negativelyTargetedChannelsCount
  • negativeKeywordListsCount
  • adGroupCriteriaCount
  • campaignCriteriaCount

Jest to lista w pełni kwalifikowanych nazw pól rozdzielonych przecinkami. Przykład: "user.displayName,photo".

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Wiadomość odpowiedzi dla AdvertiserService.AuditAdvertiser.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "usedLineItemsCount": string,
  "usedInsertionOrdersCount": string,
  "usedCampaignsCount": string,
  "channelsCount": string,
  "negativelyTargetedChannelsCount": string,
  "negativeKeywordListsCount": string,
  "adGroupCriteriaCount": string,
  "campaignCriteriaCount": string
}
Pola
usedLineItemsCount

string (int64 format)

Liczba elementów zamówienia w stanach AKTYWNY, WSTRZYMANY i WERSJA ROBOCZA w przypadku tego reklamodawcy. Te elementy zamówienia wliczają się do limitu 9999 elementów zamówienia na reklamodawcę.
usedInsertionOrdersCount

string (int64 format)

Liczba zamówień reklamowych w stanie AKTYWNE, WSTRZYMANE i WERSJA ROBOCZA w ramach tego reklamodawcy. Te zamówienia reklamowe wliczają się do limitu 9999 zamówień reklamowych na reklamodawcę.
usedCampaignsCount

string (int64 format)

Liczba AKTYWNYCH i WSTRZYMANYCH kampanii danego reklamodawcy. Te kampanie wliczają się do limitu 9999 kampanii na reklamodawcę.
channelsCount

string (int64 format)

Liczba kanałów utworzonych w ramach tego reklamodawcy. Te kanały wliczają się do limitu 1000 kanałów na reklamodawcę.
negativelyTargetedChannelsCount

string (int64 format)

Liczba kanałów z wykluczonym kierowaniem utworzonych w ramach tego reklamodawcy. Te wykluczone kanały wliczają się do limitu 5 wykluczonych kanałów na reklamodawcę.
negativeKeywordListsCount

string (int64 format)

Liczba list wykluczających słów kluczowych utworzonych w przypadku tego reklamodawcy. Te listy wykluczających słów kluczowych wliczają się do limitu 20 list wykluczających słów kluczowych na reklamodawcę.
adGroupCriteriaCount

string (int64 format)

Liczba pojedynczych opcji kierowania w tych typach kierowania, które są przypisane do elementu zamówienia w tym reklamodawcy. Te poszczególne opcje kierowania wliczają się do limitu 4 500 000 opcji kierowania w grupach reklam na reklamodawcę.

Kwalifikujące się typy kierowania:

  • Kanały, adresy URL, aplikacje i kolekcje
  • Grupa demograficzna
  • Odbiorcy Google, w tym odbiorcy o podobnych zainteresowaniach, niestandardowi odbiorcy o podobnych zainteresowaniach i odbiorcy na rynku
  • Źródło zasobów reklamowych
  • Słowo kluczowe
  • Kategoria aplikacji mobilnej
  • Listy użytkowników
  • Kierowanie wideo
  • Widoczność
campaignCriteriaCount

string (int64 format)

Liczba pojedynczych opcji kierowania w tych typach kierowania, które są przypisane do elementu zamówienia w tym reklamodawcy. Te poszczególne opcje kierowania wliczają się do limitu 900 000 opcji kierowania w kampanii na reklamodawcę.

Kwalifikujące się typy kierowania:

  • Pozycja
  • Przeglądarka
  • Szybkość połączenia
  • Data i godzina
  • Urządzenie i system operacyjny
  • Oznaczenie treści cyfrowych
  • Reklamy o charakterze kontrowersyjnym
  • Środowisko
  • Dane geograficzne, w tym sieci placówek firm oraz bliskość
  • ISP
  • Język
  • Weryfikacja przez usługi zewnętrzne

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/display-video

Więcej informacji znajdziesz w sekcji OAuth 2.0 Overview.