API di Google Ads Transparency Center
Il Google Ads Transparency Center elenca gli annunci degli inserzionisti verificati su Google Search, YouTube, Google Play, Maps e Shopping. ads elenca fino a 100 annunci di un inserzionista, individuato tramite dominio o ID inserzionista.
Passa come advertiser un dominio, ad esempio lululemon.com, o un ID inserzionista che inizia con AR. Gli annunci sono elencati approssimativamente a partire dalla pubblicazione più recente. Le righe non contengono testo dell'annuncio, spesa o impressioni; apri url o image_url per vedere la creatività. advertiser_name è il nome verificato, che può essere quello di una società controllata o di un'agenzia. Compaiono solo gli inserzionisti che hanno completato la verifica di Google.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su google_ads_transparency e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio ads.
- 1 funzionalità
- $0.68 per 1.000 richieste
- Nessun addebito per chiamate non riuscite o risultati vuoti
Disponibilità della piattaforma
- Operatività nelle ultime 24 ore
- Normale
Ultimi 30 giorni
Funzionalità disponibili
Ogni azione di Google Ads Transparency Center: cosa fa, quanto costa e come ha funzionato nelle ultime 24 ore. Apri un'azione per vederne parametri, campi della risposta ed esempi di codice.
| Funzionalità | Cosa fa | Per 1.000 | Stato nelle ultime 24 ore · Tutto regolare |
|---|---|---|---|
Annunci pubblicitariads | Elenca fino a 100 annunci che un'azienda ha pubblicato su Google, dal Google Ads Transparency Center, in base al dominio dell'inserzionista (advertiser) o all'ID inserzionista. | $0.68 per 1.000 richieste | Normale |
Cosa accetta ogni azione di API di Google Ads Transparency Center?
Ogni risposta qui sotto associa un'azione richiamabile ai suoi input reali. Il significato dei parametri e i valori ammessi dipendono dall'azione: un nome familiare non ha lo stesso significato su tutte le piattaforme.
Le fonti ufficiali sono linkate solo per chiarire il termine della piattaforma accanto a cui compaiono. Non implicano autorizzazione o approvazione da parte della piattaforma e le funzionalità del sito ufficiale non fanno parte dell'API di EveryInfra, a meno che questa pagina non le elenchi.
Consegna Sync per ogni azione.
| Azione | Obbligatori | Facoltativi | Limite | Per 1.000 | Campi della risposta |
|---|---|---|---|---|---|
adsAnnunci pubblicitari Elenca fino a 100 annunci che un'azienda ha pubblicato su Google, dal Google Ads Transparency Center, in base al dominio dell'inserzionista ( | advertiser | country, end_date, format, start_date, surface | Valori del catalogo: defaultLimit=100, maxLimit=100. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | $0.68 per 1.000 richieste | rank · ad_id · advertiser_id · advertiser_name · domain · format · first_shown_at · last_shown_at · image_url · url · advertiser_ads_estimate · platform |
Cosa significano i parametri ads di API di Google Ads Transparency Center?
Elenca fino a 100 annunci che un'azienda ha pubblicato su Google, dal Google Ads Transparency Center, in base al dominio dell'inserzionista (advertiser) o all'ID inserzionista. Ogni riga contiene ID dell'annuncio, formato (testo, immagine o video), data della prima e dell'ultima visualizzazione, immagine di anteprima e link dell'annuncio nel Transparency Center. Filtra per country, format, surface e date di prima visualizzazione. Spesa e impressioni non sono incluse.
advertiserObbligatorio- Di chi elencare gli annunci: un dominio come
nike.como un ID inserzionista che inizia con AR, ad es.AR01614014350098432001. Funziona anche il link a un inserzionista del Transparency Center.Guida di Il mio Centro annunci: verifica degli inserzionisti e Centro per la trasparenza degli annunci — Secondo la pagina di assistenza di Google, gli inserzionisti devono verificare la propria identità con documentazione legale, e l'Ads Transparency Center ti permette di cercare per nome dell'inserzionista o sito web e di filtrare per area geografica di pubblicazione e data. La fonte supporta la ricerca per dominio o inserzionista e i filtri per paese e date; i parametri di questa API sono definiti da EveryInfra e la fonte non garantisce i risultati. · Verificato countryFacoltativo- Un codice paese di due lettere come
usogbper mantenere solo gli annunci mostrati in quel paese. Omettilo per tutte le regioni. end_dateFacoltativo- Mantiene solo gli annunci mostrati per la prima volta in questa data o prima, YYYY-MM-DD; non anteriore a
start_date. formatFacoltativo- Mantiene un solo formato di annuncio:
text,imageovideo.Valori ammessi:imagetextvideo start_dateFacoltativo- Mantiene solo gli annunci mostrati per la prima volta in questa data o dopo, YYYY-MM-DD.
surfaceFacoltativo- Mantiene solo gli annunci mostrati su un prodotto Google:
search,youtube,play,mapsoshopping.
Come usare l'API di Google Ads Transparency Center
- 01Scegli un'azione della piattaforma dal catalogo pubblico.
- 02Invia piattaforma, azione e parametri obbligatori a POST /api/v1/social.
- 03Leggi il risultato dalla risposta. Per un'azione asincrona, interroga periodicamente il job ID restituito.
- 04Salva i campi della risposta che servono alla tua applicazione.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"google_ads_transparency","action":"ads","params":{"advertiser":"<advertiser>"}}'
Domande sull'API di Google Ads Transparency Center
Cosa posso ottenere con l'API di Google Ads Transparency Center?
Imposta platform su google_ads_transparency. Il catalogo attuale elenca annunci pubblicitari. Questi nomi di azione identificano oggetti o viste diversi di Google Ads Transparency Center; non sono modalità di ricerca intercambiabili.
Quale input avvia la richiesta ads di Google Ads Transparency Center?
Di chi elencare gli annunci: un dominio come nike.com o un ID inserzionista che inizia con AR, ad es. AR01614014350098432001. Funziona anche il link a un inserzionista del Transparency Center. Invialo come advertiser all'interno di params.
Quali campi può restituire ads di Google Ads Transparency Center?
Il suo schema dichiarato include rank, ad_id, advertiser_id e advertiser_name. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di Google Ads Transparency Center rispondono subito?
Le azioni indicate come asincrone restituiscono un job ID da interrogare periodicamente. Tutte le altre azioni possono essere eseguite anche in modo asincrono: aggiungi "mode": "async" al corpo della richiesta per ricevere subito un job ID, utile per task lenti o limiti elevati. Il catalogo attuale contiene consegna sync.