Method: advertisers.audit

Controlla un inserzionista. Restituisce il conteggio delle entità utilizzate per tipo di risorsa per l'inserzionista fornito. Le entità utilizzate vengono conteggiate ai fini del rispettivo limite di risorse. Visita la pagina https://support.google.com/displayvideo/answer/6071450.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
advertiserId

string (int64 format)

Obbligatorio. L'ID dell'inserzionista da controllare.

Parametri di query

Parametri
readMask

string (FieldMask format)

(Facoltativo) I campi specifici da restituire. Se non viene specificata alcuna maschera, tutti i campi del protocollo di risposta verranno compilati. I valori validi sono:

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

Si tratta di un elenco di nomi completi dei campi separati da virgole. Esempio: "user.displayName,photo".

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Messaggio di risposta per AdvertiserService.AuditAdvertiser.

Rappresentazione JSON
{
  "usedLineItemsCount": string,
  "usedInsertionOrdersCount": string,
  "usedCampaignsCount": string,
  "channelsCount": string,
  "negativelyTargetedChannelsCount": string,
  "negativeKeywordListsCount": string,
  "adGroupCriteriaCount": string,
  "campaignCriteriaCount": string
}
Campi
usedLineItemsCount

string (int64 format)

Il numero di elementi pubblicitari ATTIVI, IN PAUSA e BOZZA per questo inserzionista. Questi elementi pubblicitari vengono conteggiati ai fini del limite di 9999 elementi pubblicitari per inserzionista.

usedInsertionOrdersCount

string (int64 format)

Il numero di ordini di inserzione ATTIVI, IN PAUSA e BOZZA per questo inserzionista. Questi ordini di inserzione vengono conteggiati ai fini del limite di 9999 ordini di inserzione per inserzionista.

usedCampaignsCount

string (int64 format)

Il numero di campagne ATTIVE e IN PAUSA per questo inserzionista. Queste campagne vengono incluse nel calcolo del limite di 9999 campagne per inserzionista.

channelsCount

string (int64 format)

Il numero di canali creati per questo inserzionista. Questi canali vengono conteggiati ai fini del limite di 1000 canali per inserzionista.

negativelyTargetedChannelsCount

string (int64 format)

Il numero di canali con targeting per esclusione creati per questo inserzionista. Questi canali con targeting per esclusione vengono conteggiati ai fini del limite di 5 canali con targeting per esclusione per inserzionista.

negativeKeywordListsCount

string (int64 format)

Il numero di elenchi di parole chiave escluse creati per questo inserzionista. Questi elenchi di parole chiave escluse vengono conteggiati ai fini del limite di 20 elenchi di parole chiave escluse per inserzionista.

adGroupCriteriaCount

string (int64 format)

Il numero di singole opzioni di targeting dei seguenti tipi di targeting assegnate a un elemento pubblicitario di questo inserzionista. Queste singole opzioni di targeting vengono conteggiate ai fini del limite di 4500000 opzioni di targeting per gruppo di annunci per inserzionista.

Tipi di targeting idonei:

  • Canali, URL, app e raccolte
  • Gruppo demografico
  • Segmenti di pubblico Google, inclusi i segmenti di pubblico di affinità, di affinità personalizzata e in-market
  • Origine dell'inventario
  • Parola chiave
  • Mobile app category
  • Elenchi di utenti
  • Targeting video
  • Visibilità
campaignCriteriaCount

string (int64 format)

Il numero di singole opzioni di targeting dei seguenti tipi di targeting assegnate a un elemento pubblicitario di questo inserzionista. Queste singole opzioni di targeting vengono conteggiate ai fini del limite di 900.000 opzioni di targeting della campagna per inserzionista.

Tipi di targeting idonei:

  • Posizione
  • Browser
  • Velocità di connessione
  • Giorno e ora
  • Dispositivo e sistema operativo
  • Etichetta contenuti digitali
  • Categorie sensibili
  • Ambiente
  • Area geografica, incluse catene commerciali e prossimità
  • ISP
  • Lingua
  • Verifica di terze parti

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.