Limiter l'utilisation des API

Selon l'API, vous pouvez explicitement plafonner les requêtes en limitant le nombre de requêtes par jour, de requêtes par minute ou 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.

Afficher et modifier les limites du 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 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'apparaît pas dans le menu de navigation, cela signifie qu'aucun quota n'est défini pour l'API sélectionnée.
  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.

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 afin de limiter le quota disponible pour chaque utilisateur en suivant les étapes décrites dans ces instructions. Si votre API n'inclut pas cette limite par défaut dans ses quotas, il n'est pas possible de l'ajouter ni de la modifier.

Les utilisateurs individuels sont identifiés par une chaîne unique. Si vous créez une application côté serveur (où le code d'appel est hébergé sur un serveur dont vous êtes le propriétaire) qui envoie des requêtes au nom d'utilisateurs, vos requêtes adressées à l'API dont vous limitez l'utilisation doivent inclure le paramètre quotaUser. Ce paramètre est défini dans la documentation Paramètres système.

Pour identifier un utilisateur, utilisez le paramètre de requête d'URL quotaUser=userID. Cette valeur ne s'applique qu'à l'application de quotas à court terme. Vous n'avez donc pas besoin d'utiliser un vrai 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 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, les valeurs quotaUser sont ignorées.

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 d'un projet donné en consultant la page Quotas de la section IAM et administration de la 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.
  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.