Limiti e quote

Segui questa guida per comprendere i limiti e le quote quando utilizzi l'API Data Manager.

Limiti dei progetti

Per utilizzare l'API Data Manager, devi disporre di un progetto Google Cloud. Il progetto Google Cloud fornisce il client e le credenziali OAuth che utilizzi per autenticare le richieste API.

L'API Data Manager applica limiti di frequenza a ogni progetto Google Cloud, separati per servizio e tipo di operazione (lettura e modifica):

Servizio Operazione Richieste al giorno Richieste al minuto
IngestionService Modifica (scrittura) 100.000 300
IngestionService Lettura 100.000 300
Tutti gli altri servizi combinati Modifica (scrittura) 50.000 300
Tutti gli altri servizi combinati Lettura 50.000 300

Le richieste che superano i limiti vengono rifiutate con l'errore RESOURCE_EXHAUSTED e lo stato HTTP 429 Too Many Requests.

Puoi controllare la tua app e ridurre i limiti di frequenza sia riducendo attivamente il numero di richieste sia limitando le QPS dal lato client. Puoi anche configurare avvisi quota e monitoraggio nella console Google Cloud per ricevere notifiche prima che la tua applicazione raggiunga i limiti.

Nomi delle quote

Ogni limite corrisponde a un nome e a una metrica di limite di quota in Google Cloud. Quando una richiesta supera un limite, l'API Data Manager restituisce il nome del limite di quota nel payload dei dettagli standard ErrorInfo in metadata.quota_limit:

Nome limite quota Servizio Operazione Finestra Limite
IngestionMutateRequestsPerDayPerProject IngestionService Modifica Giorno 100.000
IngestionMutateRequestsPerMinutePerProject IngestionService Modifica Minuto 300
IngestionReadRequestsPerDayPerProject IngestionService Lettura Giorno 100.000
IngestionReadRequestsPerMinutePerProject IngestionService Lettura Minuto 300
ManagementMutateRequestsPerDayPerProject Tutti gli altri servizi Modifica Giorno 50.000
ManagementMutateRequestsPerMinutePerProject Tutti gli altri servizi Modifica Minuto 300
ManagementReadRequestsPerDayPerProject Tutti gli altri servizi Lettura Giorno 50.000
ManagementReadRequestsPerMinutePerProject Tutti gli altri servizi Lettura Minuto 300

Esamina metadata.quota_limit nel payload ErrorInfo per distinguere tra errori di limite giornaliero e per minuto e determinare se mettere in pausa temporaneamente e riprovare con il backoff o mettere in pausa fino al ripristino della quota giornaliera. Per maggiori dettagli, consulta Errori relativi a quota e limitazione di frequenza.

Limiti per le richieste

Di seguito sono riportati i limiti per richieste specifiche: