API Google Ads Transparency Center Annunci pubblicitari

Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Google Ads Transparency Center Annunci pubblicitari di EveryInfra (google_ads_transparency/ads).

Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su google_ads_transparency e action su ads, e inserisci i parametri in params.
- Parametri obbligatori:
  - advertiser: 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.
- Parametri facoltativi:
  - country: Un codice paese di due lettere come us o gb per mantenere solo gli annunci mostrati in quel paese. Omettilo per tutte le regioni.
  - end_date: Mantiene solo gli annunci mostrati per la prima volta in questa data o prima, YYYY-MM-DD; non anteriore a start_date.
  - format: Mantiene un solo formato di annuncio: text, image o video. (valori consentiti: image / text / video)
  - start_date: Mantiene solo gli annunci mostrati per la prima volta in questa data o dopo, YYYY-MM-DD.
  - surface: Mantiene solo gli annunci mostrati su un prodotto Google: search, youtube, play, maps o shopping.
  - limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 100. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 100)
- Restituisce un elenco di record. Campi principali di ogni record: rank, ad_id (ID della creatività dell'annuncio nel G…), advertiser_id (ID dell'inserzionista (inizia con AR)), advertiser_name (Nome verificato dell'inserzionista, che…), domain, format (Formato dell'annuncio: text, image o vi…), first_shown_at (Quando l'annuncio è stato mostrato per…), last_shown_at (Quando l'annuncio è stato mostrato per…), image_url (Immagine di anteprima della creatività…), url (La pagina dell'annuncio nel Google Ads…), advertiser_ads_estimate (Stima del Transparency Center del numer…).
- Esempio di corpo della richiesta:
{
  "platform": "google_ads_transparency",
  "action": "ads",
  "params": {
    "advertiser": "lululemon.com"
  }
}
- Prezzo: $0.68 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.

Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.