Method: advertisers.audit

przeprowadza audyt reklamodawcy; Zwraca liczbę użytych encji według typu zasobu w ramach podanego reklamodawcy. Używane encje są wliczane do limitu odpowiednich zasobów. Więcej informacji znajdziesz na https://support.google.com/displayvideo/answer/6071450.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
advertiserId

string (int64 format)

Wymagane. Identyfikator reklamodawcy do kontroli.

Parametry zapytania

Parametry
readMask

string (FieldMask format)

Opcjonalnie: Określone 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 rozdzielana przecinkami lista w pełni kwalifikowanych nazw pól. Przykład: "user.displayName,photo".

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

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

Komunikat odpowiedzi dotyczący obiektu AdvertiserService.AuditAdvertiser.

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 AKTYWNE, WSTRZYMANE i WERSJA ROBOCZA związane z tym reklamodawcą. Te elementy zamówienia wliczają się do limitu 9999 elementów zamówienia na reklamodawcę.

usedInsertionOrdersCount

string (int64 format)

Liczba zamówień reklamowych AKTYWNE, WSTRZYMANE i WERSJA ROBOCZA przypisane do 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 tego reklamodawcy. Kampanie te wliczają się do limitu 9999 kampanii na reklamodawcę.

channelsCount

string (int64 format)

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

negativelyTargetedChannelsCount

string (int64 format)

Liczba kanałów wykluczonych z kierowania utworzonych w ramach tego reklamodawcy. Kanały o negatywnym kierowaniu wliczają się do limitu 5 wykluczonych kanałów 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 poszczególnych opcji kierowania z tych typów kierowania przypisanych do elementu zamówienia w ramach tego reklamodawcy. Te indywidualne opcje kierowania wliczają się do limitu 4 500 000 opcji kierowania grup 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 poszczególnych opcji kierowania z tych typów kierowania przypisanych do elementu zamówienia w ramach tego reklamodawcy. Te indywidualne opcje kierowania wliczają się do limitu 9 000 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
  • kierowanie geograficzne, w tym sieci placówek firmy i ich odległość;
  • 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 artykule Omówienie protokołu OAuth 2.0.