Method: advertisers.audit

Przeprowadza kontrolę reklamodawcy. Zwraca liczbę używanych elementów według typu zasobu w przypadku podanego reklamodawcy. Używane encje wliczają się do limitu odpowiednich zasobów. Więcej informacji znajdziesz na stronie https://support.google.com/displayvideo/answer/6071450.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
advertiserId

string (int64 format)

Wymagane. Identyfikator reklamodawcy, którego dotyczy kontrola.

Parametry zapytania

Parametry
readMask

string (FieldMask format)

Opcjonalnie: Konkretne pola, które mają zostać zwrócone. Jeśli nie określisz maski, wszystkie pola w proto odpowiedzi zostaną wypełnione. Prawidłowe wartości to:

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

Jest to rozdzielona przecinkami lista pełnych i jednoznacznych nazw pól. Przykład: "user.displayName,photo".

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Komunikat 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 o stanie AKTYWNY, WSTRZYMANY i WERSJA ROBOCZA u 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 tego reklamodawcy, które są AKTYWNE, WSTRZYMANE lub mają stan WERSJA ROBOCZA. Te zamówienia reklamowe wliczają się do limitu 9999 zamówień reklamowych na reklamodawcę.
usedCampaignsCount

string (int64 format)

Liczba AKTYWNYCH i WSTRZYMANYCH kampanii tego 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 kierowaniem wykluczającym utworzonych w ramach tego reklamodawcy. Te kanały z kierowaniem wykluczającym wliczają się do limitu 5 kanałów z kierowaniem wykluczającym na reklamodawcę.
negativeKeywordListsCount

string (int64 format)

Liczba list wykluczających słów kluczowych utworzonych w ramach 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 przypadku tego reklamodawcy. Te poszczególne opcje kierowania wliczają się do limitu 4 500 000 opcji kierowania grupy 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 przypadku tego reklamodawcy. Te poszczególne opcje kierowania wliczają się do limitu 900 000 opcji kierowania 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 OAuth 2.0 Overview.