Method: advertisers.audit

Kontroluje reklamodawcę. Zwraca liczbę używanych encji według typu zasobu w ramach określonego reklamodawcy. Używane encje są wliczane do limitu odpowiednich zasobów. Patrz 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)

To pole jest wymagane. Identyfikator reklamodawcy do kontroli.

Parametry zapytania

Parametry
readMask

string (FieldMask format)

Opcjonalnie. Określone pola do zwrócenia. Jeśli nie określisz 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 rozdzielonych przecinkami pełnych i jednoznacznych 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:

Wiadomość z odpowiedzią dla usługi 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 przypisanego do tego reklamodawcy. Takie elementy zamówienia wliczają się do limitu 9999 elementów zamówienia na reklamodawcę.
usedInsertionOrdersCount

string (int64 format)

Liczba zamówień reklamowych ACTIVE, WSTRZYMANE i WERSJA ROBOCZA przypisanego do tego reklamodawcy. Te zamówienia reklamowe wliczają się do limitu 9999 zamówień 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 tego reklamodawcy utworzonych w ramach kierowania wykluczającego. Takie kanały są wliczane do limitu 5 kanałów o negatywnym kierowaniu na reklamodawcę.
negativeKeywordListsCount

string (int64 format)

Liczba list wykluczających słów kluczowych utworzonych na potrzeby 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 z tych typów kierowania przypisanych do elementu zamówienia w ramach tego reklamodawcy. Te opcje kierowania wliczają się do limitu 4500 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 pojedynczych opcji kierowania z tych typów kierowania przypisanych do elementu zamówienia w ramach tego reklamodawcy. Te 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
  • obszar geograficzny, w tym sieci placówek firm 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.