Limiter l'utilisation des API

Selon l'API, vous pouvez explicitement plafonner les requêtes de différentes manières, par exemple: requêtes par jour, requêtes par minute, et le nombre de requêtes par minute et 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.

Modifier les limites sur le nombre 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 très 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. Accédez au tableau de bord API et services dans Cloud Console.
  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'élément de menu Quotas n'est pas disponible dans le menu de navigation de gauche, cela signifie que l'API que vous avez sélectionnée ne dispose d'aucun quota.
  5. Sur la ligne de quota que vous souhaitez modifier, cliquez sur l'icône de modification (), puis saisissez le quota total souhaité, dans la limite spécifiée par Google.

Certaines API vous permettent de demander une limite supérieure en soumettant un formulaire. Certaines API autorisent l'accès à des quotas plus élevés uniquement si la facturation est activée sur le projet.

Les sections du quota du forfait Premium concernent le forfait Premium Google Maps, qui n'est plus disponible. Si vous n'avez pas souscrit le forfait Google Maps Premium, veuillez ne pas modifier ces sections si vous essayez de limiter votre utilisation.

Limiter les requêtes par utilisateur

Pour empêcher des utilisateurs individuels d'utiliser votre quota d'API, certaines API incluent une limite par utilisateur et par minute. Si une limite par défaut existe, vous pouvez modifier cette valeur comme indiqué dans la section précédente pour limiter le quota disponible pour chaque utilisateur.

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 doivent inclure le paramètre quotaUser, comme décrit ci-dessous.

Pour identifier un utilisateur, utilisez le paramètre quotaUser=userID. Cette valeur est réservée à l'application de quotas à court terme. Vous n'avez donc pas besoin d'utiliser un véritable ID utilisateur. 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 n'est utilisé que pour plafonner les requêtes par utilisateur et par minute. Si vous n'envoyez pas le paramètre quotaUser, tous les appels sont attribués à vos machines serveur, auquel cas l'utilisateur ne peut pas les plafonner.

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

Vous pouvez consulter, modifier et demander des limites de quota plus élevées pour toutes les API facturables d'un projet donné en consultant la page Quotas dans IAM et administration.

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

  1. Accédez à la page Quotas de la section "IAM et administration" de Cloud Console.
  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. Utilisez le filtre au-dessus de la liste pour ajuster la liste par Service, Nom de la limite, État du quota, ID du service et/ou Statistique.
  4. Pour modifier plusieurs quotas, vous pouvez

    • cliquez sur les lignes de la liste et sélectionnez des quotas dans le panneau de droite, ou
    • Cliquez sur le bouton TOUS LES QUOTAS sur une ligne spécifique, puis sélectionnez des quotas dans la liste de la page d'informations.

    Ensuite, cliquez sur MODIFIER LES QUOTAS. La facturation doit être activée sur le projet pour que vous puissiez cocher les cases.

  5. Dans le panneau "Modifier les quotas", sélectionnez le service pour développer la vue associée, puis modifiez les quotas de ce service et cliquez sur OK.

  6. 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 comporte des erreurs de saisie.
    • Vous pouvez ajouter davantage de quotas à modifier en les sélectionnant comme décrit précédemment.
    • Vous pouvez supprimer un service du panneau "Modifier les quotas" en cliquant sur l'icône de suppression ().
  7. Lorsque vous avez terminé de modifier les quotas, cliquez sur ENVOYER LA DEMANDE ou sur SUIVANT.

  8. Si votre demande de modification de quota nécessite un examen, dans le panneau "Modifier les quotas" de droite, remplissez le formulaire avec votreVotre nom ,Envoyer par e-mail etTéléphone numéro, puis cliquez surENVOYER LA DEMANDE ...