Method: advertisers.audit

Controlla un inserzionista. Restituisce il conteggio delle entità utilizzate per tipo di risorsa nell'inserzionista fornito. Le entità utilizzate vengono conteggiate ai fini del rispettivo limite di risorse. Consulta 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 ricerca

Parametri
readMask

string (FieldMask format)

Campo 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 separato da virgole di nomi completi dei campi. 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 ATTIVA, 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 conteggiate ai fini del limite di 9999 campagne per inserzionista.
channelsCount

string (int64 format)

Il numero di canali creati nell'ambito di 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 sotto questo inserzionista. Questi canali con targeting per esclusione rientrano nel limite di 5 canali con targeting per esclusione per inserzionista.
negativeKeywordListsCount

string (int64 format)

Il numero di elenchi di parole chiave escluse creati in 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 4500.000 opzioni di targeting del gruppo di annunci per inserzionista.

Tipi di targeting idonei:

  • Canali, URL, app e raccolte
  • Gruppo demografico
  • Segmenti di pubblico di Google, inclusi quelli di affinità, 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
  • linguaggio
  • 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.