Limiter l'utilisation des API

En fonction de l'API, vous pouvez plafonner explicitement les requêtes en limitant le nombre requêtes par jour, requêtes par minute ou requêtes par minute par utilisateur.

Vous voudrez peut-être limiter l'utilisation facturable en définissant des limites. Par exemple, pour éviter de vous faire facturer une utilisation au-delà des limites d'utilisation gratuite, vous pouvez définir un nombre maximal de requêtes par jour.

Important : Les limites de quota ne sont pas toujours précises, car il existe une certaine latence entre le dépassement d'un quota et le début de l'application de la limite. Si vous utilisez un quota pour limiter la facturation, autorisez un peu de tampon.

Afficher et modifier le nombre maximal de requêtes

Vous pouvez définir des limites pour toutes les requêtes adressées à n'importe quelle API facturable. La plupart des API définissent des limites par défaut, mais vous pouvez modifier ces limites jusqu'à un maximum spécifié par Google. Certaines API définissent une limite basse jusqu'à ce que vous activiez la facturation sur votre projet.

Pour afficher ou modifier les limites de votre API, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page Tableau de bord des API et services.

   Accéder au tableau de bord des API et services

2. Dans la liste des projets, sélectionnez un projet ou créez-en un.
3. Cliquez sur le nom de l'API qui vous intéresse.
4. Cliquez sur Quotas. Si l'onglet Quotas n'est pas présent dans le panneau de navigation, cela signifie que l'API que vous avez sélectionnée n'a pas de quotas définis.
5. Pour trouver le quota que vous souhaitez limiter, saisissez les propriétés et les valeurs appropriées dans le champ Filtre. Par exemple, pour trouver le quota des Sous-réseaux, saisissez Quota:Subnetworks.
6. Cochez la case à côté du quota que vous souhaitez limiter, puis cliquez sur MODIFIER LES QUOTAS.
7. Remplissez le formulaire de modification de quota, y compris la nouvelle limite que vous souhaitez définir.
8. Cliquez sur ENVOYER LA REQUÊTE.

Certaines API vous permettent de demander une limite plus élevée en soumettant un formulaire. Certaines API vous permettent de spécifier un quota plus élevé uniquement si la facturation est activée sur le projet.

Remarque : Vous pouvez définir des limites facturables quotidiennes uniquement sur les API facturables et, dans certains cas, uniquement si la facturation est activée sur votre projet. Si votre projet n'utilise aucune API facturable, vous ne pouvez pas définir de limite quotidienne. En savoir plus sur les comptes de facturation.

Les sections de quota du forfait Premium concernent le forfait Premium Google Maps, qui n'est plus proposé. Si vous n'avez pas souscrit le forfait Premium Google Maps, ne modifiez pas ces sections.

Limiter les requêtes par utilisateur

Pour empêcher des utilisateurs individuels d'utiliser votre quota d'API, certaines API incluent une limite par défaut, par utilisateur et par minute.

Pour vérifier si votre API inclut une limite par défaut par utilisateur et par minute, recherchez-la dans vos quotas d'API, comme décrit dans les instructions de la section Afficher et modifier les limites du nombre de requêtes. Si une telle limite par défaut existe pour cette API, vous pouvez modifier cette valeur pour limiter le quota disponible pour chaque utilisateur en suivant les étapes de ces instructions. Si votre API n'inclut pas cette limite par défaut dans ses quotas, vous ne pouvez pas l'ajouter ni la modifier.

Les utilisateurs individuels sont identifiés par une chaîne unique. Si vous créez une application côté serveur (hébergeant un code sur des serveurs tiers) qui envoie des requêtes pour le compte d'autres utilisateurs, vos requêtes à l'API pour laquelle vous limitez l'utilisation doivent inclure le paramètre quotaUser. Ce paramètre est défini dans la documentation Paramètres système.

Remarque : Bien que des limites par utilisateur soient spécifiées dans les requêtes par seconde, nous autorisons des pics d'utilisation à court terme. Par conséquent, vous devez définir vos limites en fonction de niveaux de trafic moyens soutenus. Si quelqu'un tente d'utiliser une API dépassant ces limites de paramètres, les requêtes déclenchent une erreur limite dépassée.

Pour identifier un utilisateur, utilisez le paramètre de requête d'URL quotaUser=userID. Cette valeur est uniquement destinée à l'application de quotas à court terme. Vous n'avez donc pas besoin d'utiliser ID. Vous pouvez choisir n'importe quelle chaîne arbitraire de moins de quarante caractères qui identifie de manière unique un utilisateur.

Le paramètre quotaUser est uniquement utilisé pour limiter les requêtes par utilisateur et par minute. Si vous n'envoyez pas le paramètre quotaUser, tous les appels sont attribués à vos serveurs, auquel cas ils ne peuvent pas être limités par l'utilisateur.

Si votre API n'inclut pas de limite par défaut par utilisateur et par minute, alors Les valeurs quotaUser sont ignorées.

Important : Lorsque vous envoyez un identifiant d'utilisateur, assurez-vous de respecter les législations locales, y compris les lois relatives à la divulgation des informations personnelles que vous envoyez avec chaque requête. La meilleure pratique consiste à inclure le moins d'informations personnelles possible.

Afficher et modifier tous les quotas pour les API dans un projet

Vous pouvez examiner, modifier et demander des limites de quota plus élevées pour toutes les API facturables dans un projet donné en consultant la page Quotas dans la console IAM et Admin de console Google Cloud.

Pour afficher et modifier les quotas de toutes les API facturables de votre projet, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page Quotas. .

   Accéder à la section "Quotas"

2. Dans la liste des projets, sélectionnez un projet ou créez-en un. La page Quotas du projet sélectionné s'affiche. Elle répertorie une ligne pour chaque type de quota disponible dans chaque service.
3. Cliquez sur  Filtrer le tableau pour interroger votre quota selon une propriété spécifique.
4. Cochez la case à côté du ou des quotas que vous souhaitez modifier. La facturation doit être activée sur le projet pour que vous puissiez cocher certaines des cases.
   Si vous préférez modifier tous les quotas pour une seule API, cliquez sur le nom du service pour accéder à la page "Quotas" de cette API.
5. Cliquez sur Modifier les quotas.
6. Dans le volet Modifications des quotas qui s'affiche, développez la vue des services, modifiez les quotas de ce service si nécessaire, puis cliquez sur OK.
7. Répétez l'opération pour modifier les quotas dans chacun des services sélectionnés.
   • Les limites de quota actuelles sont préremplies dans les zones de saisie.
   • Un service avec une icône d'alerte () lors de l'envoi contient des erreurs d'entrée.
   • Vous pouvez ajouter davantage de quotas à modifier en les sélectionnant comme décrit précédemment.
   • Vous pouvez supprimer un service du volet Modifications de quota en passant la souris sur la vue du service non développée, puis en cliquant sur l'icône de suppression ().
8. Lorsque vous avez terminé de modifier les quotas, cliquez sur SUIVANT.
9. Si votre demande de modification de quota nécessite un examen, le formulaire Coordonnées s'affiche. Remplissez le formulaire avec vos coordonnées.
10. Cliquez sur Envoyer la requête.