Cette page a été traduite par l'API Cloud Translation.
Switch to English

Limiter l'utilisation des API

En fonction de l'API, vous pouvez explicitement limiter les requêtes de différentes manières, par exemple: requêtes par jour, requêtes par minute et 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 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 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.
  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 concernant les quotas du forfait Premium concernent le forfait Premium Google Maps, qui n'est plus proposé. 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 défaut et par utilisateur et par minute. Si une limite par défaut existe, vous pouvez modifier cette valeur comme décrit dans la section précédente afin de 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 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.

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 affichant la page Quotas disponible 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, Limit name, Quota status, Service ID et/ou Metric.
  4. Pour modifier plusieurs quotas,

    • cliquez sur les lignes de la liste et sélectionnez des quotas dans le panneau de droite.
    • Cliquez sur le bouton ALL QUOTAS sur une ligne spécifique, puis sélectionnez des quotas dans la liste figurant sur la page de détails.

    Cliquez ensuite sur MODIFIER LES QUOTAS. La facturation doit être activée sur le projet pour que vous puissiez cocher les cases correspondantes.

  5. Dans le panneau "Modifier les quotas", sélectionnez le service pour développer la vue, 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 d'entrée.
    • Vous pouvez ajouter des quotas supplémentaires à 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 doit être examinée, dans le panneau "Modifier les quotas" à droite, remplissez le formulaire avec votreNom ",Adresse e-mail l'adresseTéléphone nombre, puis cliquez surENVOYER LA DEMANDE s'affiche en haut de l'écran.