Limiti di frequenza dell'API Gmail: perché una grande pulizia si mette in pausa o rallenta

Cos'è davvero un limite di frequenza dell'API Gmail

Ogni chiamata che un'app fa all'API di Gmail — elencare messaggi, controllare un'etichetta, spostare un'email nel Cestino — viene misurata in unità di quota e conteggiata rispetto a un limite, non semplicemente come una «richiesta» generica.

Google applica contemporaneamente due limiti distinti su queste unità: uno legato specificamente al tuo account, l'altro condiviso tra tutti gli account collegati all'app. Raggiungere uno dei due fa sì che Google rallenti o trattenga brevemente le richieste successive finché l'utilizzo non torna sotto il limite.

I costi esatti in unità e le soglie attuali sono stabiliti da Google e pubblicati nel suo riferimento dell'API Gmail, poiché possono essere modificati nel tempo.

Perché una casella di posta enorme non può essere pulita in un'unica richiesta

Una casella di posta con decine o centinaia di migliaia di email non può essere elencata, controllata e spostata nel Cestino in un'unica chiamata API. Gli endpoint a lotti di Gmail hanno limiti pratici su quanto può contenere una singola richiesta, e inviare tutto in una volta sfonderebbe anche subito il limite di frequenza al minuto.

Quindi una pulizia completa di una casella di posta molto grande deve avvenire come una serie di richieste più piccole distribuite nel tempo, invece che come un'unica operazione gigantesca e istantanea.

Come Clean Email divide in lotti una grande pulizia

Invece di provare a elaborare un'intera casella di posta enorme in un solo passaggio, Clean Email la elabora a lotti più piccoli, uno dopo l'altro.

Ogni lotto viene scansionato e controllato secondo le stesse regole di protezione di qualsiasi altra pulizia — email contrassegnate, importanti, con etichetta, conversazioni bidirezionali, allegati e mittenti in whitelist non vengono mai toccati — prima che qualsiasi cosa in quel lotto venga spostata nel Cestino.

Poiché la casella di posta viene suddivisa in lotti invece che in un'unica richiesta massiccia, una casella di posta enorme non monopolizza la quota condivisa per progetto dell'app. Le scansioni e le pulizie degli altri utenti continuano a funzionare in parallelo, e la grande pulizia semplicemente prosegue lotto dopo lotto finché l'intera casella di posta non è stata elaborata.

• Il progresso avanza lotto dopo lotto invece che tutto in una volta
• Una pausa tra i lotti su una casella di posta grande è normale, non un errore
• Le regole di protezione vengono ricontrollate a ogni lotto prima che qualcosa venga eliminato
• Le pulizie degli altri utenti continuano a funzionare contemporaneamente

Una pulizia in pausa o lenta è normale?

Sì, su una casella di posta grande. I limiti di frequenza fanno sì che pulire una casella enorme richieda più tempo rispetto a una piccola, e può sembrare che si fermi tra un lotto e l'altro mentre elabora la casella di posta.

Ciò che non è normale è una pulizia che smette del tutto di fare progressi invece di continuare a lotti nel tempo. Se succede, contatta contact@clean-email.com.

Domande frequenti

Perché la mia pulizia di Gmail si è messa in pausa a metà?

Gmail applica un limite di frequenza sulla sua API — un tetto a quante richieste possono avvenire al minuto, sia per il tuo account che per l'app nel suo complesso. Su una casella di posta grande, Clean Email elabora le email a lotti invece che tutte insieme, quindi una pulizia può sembrare in pausa tra un lotto e l'altro. Questo è un comportamento previsto su una casella di posta grande, non un errore, e la pulizia continuerà fino a completarsi.

Cos'è un limite di frequenza dell'API Gmail?

È un tetto che Google impone a quante richieste un'app può inviare all'API di Gmail in un dato intervallo di tempo. Le richieste sono misurate in unità di quota invece che con un semplice conteggio — azioni come elencare messaggi o spostare email nel Cestino consumano ciascuna delle unità — e Google applica contemporaneamente sia un tetto per utente che un tetto per progetto (a livello di app).

Perché Clean Email non può eliminare più di 100.000 email in un'unica richiesta?

L'API di Gmail non permette a un'app di inviare un numero illimitato di messaggi in un'unica chiamata, e farlo romperebbe anche istantaneamente il limite di frequenza al minuto. Clean Email invece elabora una casella di posta enorme a lotti più piccoli, controllando regole di protezione come email contrassegnate, con etichetta e con allegati a ogni lotto prima che qualcosa venga spostato nel Cestino.

Pulire una casella di posta enorme bloccherà le pulizie di altri utenti?

No. Clean Email elabora le grandi pulizie a lotti, quindi una casella di posta molto grande avanza nella propria coda di lotti nel tempo invece di esaurire subito tutta la quota Gmail condivisa dell'app. Le scansioni e le pulizie degli altri utenti continuano a funzionare contemporaneamente.

Quanto dovrebbe durare la pulizia di una casella di posta molto grande?

Non c'è un numero fisso — dipende da quante email devono essere elaborate e da come viene usata in quel momento la quota Gmail condivisa dell'app. Una casella di posta con decine o centinaia di migliaia di email di solito richiederà notevolmente più tempo rispetto a una casella piccola, perché viene elaborata lotto dopo lotto invece che in un unico passaggio istantaneo.

Una pulizia lenta o in pausa è segno che qualcosa è rotto?

Non di per sé. Una pulizia che continua a progredire a lotti — anche lentamente su una casella di posta molto grande — è un comportamento normale causato dai limiti di frequenza di Gmail, non un malfunzionamento. Se una pulizia smette del tutto di fare progressi invece di continuare a lotti, vale la pena verificarlo contattando contact@clean-email.com.