Elencare le istruzioni Google Ads è un GET su /google-ads/v1/prompts, nella Top-Rated Team Google Ads API: gli account Google Ads che sono stati assegnati alla tua organizzazione. Ogni richiesta porta la tua chiave in un header X-API-KEY — la stessa chiave dell’API di LinkedIn — e raggiunge solo gli account assegnati alla tua organizzazione. Un account che nessuno le ha assegnato riceve la risposta di un account che non esiste.
Nulla qui modifica un account da solo. Una modifica viene proposta, verificata da Google e registrata, e viene eseguita quando una persona la applica — con ciò che servirebbe per annullarla annotato prima, così da poterla ripristinare.
La richiesta
curl -X GET "https://top-rated.team/google-ads/v1/prompts" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Cosa torna quando non funziona
- 401 — la chiave manca, è sbagliata o è stata revocata.
- 402 — il piano non è pagato. La Top-Rated Team API risponde così quando la prova è finita.
- 404 — o la cosa non c’è, o non è della tua organizzazione. Le due risposte sono uguali di proposito, così gli id non si possono sondare.
- 429 — troppe richieste, o la piattaforma che ci chiede di rallentare. Aspetta un momento prima di riprovare.
- 502 o 503 — la piattaforma non ha risposto proprio ora. Riprova tra un momento.
Ogni errore è JSON nella stessa forma: {"type":"errors/<code>","status":<n>,"detail":"..."} — così un solo gestore li copre tutti, e il detail è scritto per essere mostrato a una persona.
Chiederlo a un assistente
Questa operazione è anche uno strumento MCP. Incolla https://top-rated.team/google-ads/mcp/<your API key> in Claude, ChatGPT o qualunque assistente che parli MCP e chiedi quello che vuoi in italiano — l’assistente sceglie la chiamata, riempie gli id e ti legge la risposta. Anche l’agente tutto in uno di https://top-rated.team/mcp/<your API key> ce l’ha, insieme all’API di LinkedIn e a tutti gli altri canali.
In una stanza di progetto
In una stanza di progetto, spunta l’agente di questa API sotto Può usare per un tuo agente IA, e questo chiama «Elencare le istruzioni Google Ads» come strumento ogni volta che la conversazione ne ha bisogno. Tutti nella stanza vedono cosa ha chiesto e cosa è tornato. Chiedi a parole tue; qui l’agente si chiama @scout:
- @scout dimmi cosa ha sprecato più soldi nei nostri termini di ricerca la settimana scorsa e scrivi le parole chiave negative come proposta da far leggere a qualcuno prima che venga eseguita.
Domande frequenti
Un agente IA può chiamare «Elencare le istruzioni Google Ads» per me?
Sì. Può farlo qualsiasi assistente che parli MCP, tramite l’indirizzo qui sopra, e così un tuo agente IA in una stanza di progetto con l’agente di questa API spuntato. Gli agenti integrati di una stanza no: consigliano, e non hanno la tua chiave.
Funziona fuori da una stanza, dal mio codice?
Sì. La richiesta qui sopra è la stessa operazione che chiama lo strumento di un agente IA, con la stessa risposta e gli stessi errori, e la tua chiave raggiunge gli stessi canali, in qualunque modo tu entri.
Funziona in una stanza con il mio marchio?
Sì. Su un indirizzo White Label l’API, il suo riferimento e il suo agente IA portano il nome del tuo prodotto, e raggiungono gli stessi canali con le stesse regole.
In quale piano
Fa parte del piano Top-Rated Team API, con la stessa chiave dell’API di LinkedIn: 9 $ per postazione al mese, 7 $ da cento postazioni. Ti servono tante postazioni quante ne hai del tipo più numeroso — account LinkedIn, numeri WhatsApp, account X o account della casella di posta — e la prova di 30 giorni ne copre una.