Method: advertisers.audit

Richiesta HTTP
Parametri del percorso
Parametri di ricerca
Corpo della richiesta
Corpo della risposta
- Rappresentazione JSON
Ambiti di autorizzazione
Prova!

Controlla un inserzionista. Restituisce i conteggi delle entità utilizzate per tipo di risorsa in base all'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/v3/advertisers/{advertiserId}:audit

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri

Parametri
`advertiserId`	`string (int64 format)` Obbligatorio. L'ID dell'inserzionista da verificare.

advertiserId

string (int64 format)

Obbligatorio. L'ID dell'inserzionista da verificare.

Parametri di query

Parametri

Parametri
`readMask`	`string (FieldMask format)` (Facoltativo) I campi specifici da restituire. Se non viene specificata alcuna maschera, tutti i campi del proto della 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"`.

readMask

string (FieldMask format)

(Facoltativo) I campi specifici da restituire. Se non viene specificata alcuna maschera, tutti i campi del proto della 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

Messaggio di risposta per AdvertiserService.AuditAdvertiser.

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

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

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 conteggiate ai fini 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 target escluso 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 45.000.000 di opzioni di targeting per gruppo di annunci per inserzionista. Tipi di targeting idonei: Canali, URL, app e raccolte Gruppo demografico Segmenti di pubblico Google, compresi 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 Geografia, comprese 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.