Afficher l'explorateur d'API et exécuter une méthode
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Sur la plupart des pages de documentation, un explorateur d'API condensé est visible sur la droite de l'écran. Si l'explorateur d'API n'est pas visible, cliquez sur Essayer pour afficher la version condensée de l'explorateur d'API.
Si l'option Essayer ne s'affiche pas à droite d'une page de documentation de référence, cela signifie que la méthode n'est pas compatible avec APIs Explorer. Par exemple, APIs Explorer n'est pas compatible avec les API qui nécessitent des comptes de service. Il n'apparaît donc pas sur les pages de documentation de ces API.
Afficher la version développée d'APIs Explorer
La version développée d'APIs Explorer contient des exemples de code cURL, HTTP et éventuellement d'autres. Pour afficher la version développée d'APIs Explorer, cliquez sur Plein écran fullscreen.
Exécuter une méthode
APIs Explorer vous permet de saisir les paramètres obligatoires et facultatifs, ainsi qu'un corps de requête pour les méthodes d'API, le cas échéant. Pour de nombreuses méthodes REST, telles que les méthodes de liste, il vous suffit de remplir un ou deux champs avant de pouvoir exécuter la méthode. Par exemple, la méthode books.volumes.list de l'API Books ne nécessite qu'un paramètre de requête (q) pour lister les livres. Pour essayer la méthode books.volumes.list :
Si l'explorateur d'API ne s'affiche pas, cliquez sur Essayer.
Dans le champ q, saisissez Hunger Games (sans guillemets ni caractères spéciaux).
Faites défiler la page vers le bas, puis cliquez sur Exécuter.
(Facultatif) Un écran de connexion Google vous invite à sélectionner un compte Google.
(Facultatif) Une boîte de dialogue d'autorisation Google vous demande si vous souhaitez "Gérer vos livres". Cliquez sur Autoriser. Les résultats s'affichent sous le bouton "Exécuter".
Si APIs Explorer affiche un résultat de 200, cela signifie que la méthode a réussi.
Résoudre les problèmes liés à APIs Explorer
Vous avez reçu une erreur 401 ou 403
Si vous recevez une erreur 401 ou 403 lorsque vous exécutez une méthode à l'aide d'APIs Explorer, cela est probablement dû à un problème lié à l'un des éléments suivants :
Vous utilisez le mauvais type d'autorisation (clé API au lieu d'OAuth 2.0).
Essayez de changer le type d'autorisation.
Vous utilisez OAuth 2.0, mais avec un champ d'application trop restreint. Essayez d'utiliser un champ d'application plus large.
La boîte de dialogue d'autorisation ne s'affiche pas
APIs Explorer utilise un pop-up pour accorder l'accès à vos données privées. Si votre navigateur bloque les pop-ups, celui-ci ne s'affichera pas et vous ne pourrez pas accorder l'accès.
Si vous cliquez sur Autoriser dans la boîte de dialogue d'autorisation et que rien ne se passe, essayez de modifier les paramètres des pop-ups de votre navigateur pour les activer.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\u003cp\u003eThe APIs Explorer allows you to test API methods directly in the documentation by providing parameters and executing requests.\u003c/p\u003e\n"],["\u003cp\u003eTo use the APIs Explorer with methods requiring authorization, you need to generate and use your own credentials.\u003c/p\u003e\n"],["\u003cp\u003eThe expanded APIs Explorer provides code samples in various formats like cURL and HTTP for easier integration.\u003c/p\u003e\n"],["\u003cp\u003eIf you encounter a 401 or 403 error, verify the authorization type and scope, as they are the most common causes.\u003c/p\u003e\n"],["\u003cp\u003eThe APIs Explorer uses popups for authorization, so ensure your browser settings allow them to function correctly.\u003c/p\u003e\n"]]],[],null,["# Display the APIs Explorer and execute a method\n\nOn most documentation pages, a condensed APIs Explorer is visible on the\nright-hand side of the screen. If the APIs Explorer isn't visible, click\n**Try it!** to display the condensed version of the APIs Explorer.\n\nIf **Try it!** doesn't appear on the right-hand side of a reference\ndocumentation page, the method isn't supported by the APIs Explorer. For\nexample, the APIs Explorer isn't compatible with APIs that require service\naccounts, so it doesn't appear on documentation pages for those APIs.\n\nDisplay the expanded version of the APIs Explorer\n-------------------------------------------------\n\nThe expanded version of the APIs Explorer contains cURL, HTTP, and possibly\nother code samples. To display the expanded version of the APIs Explorer,\nclick Full screen fullscreen.\n| **Note:** To run the code samples, you must generate and use your own authorization credentials. For an explanation of how to create a project and generate credentials, refer to your specific Google API's documentation.\n\nExecute a method\n----------------\n\nThe APIs Explorer lets you enter required parameters, optional parameters,\nand, if applicable, a request body for API methods. For many REST methods,\nsuch as list methods, you only need to fill one or two fields before you can\nexecute the method. For example, the Books API's\n[`books.volumes.list`](/books/docs/v1/reference/volumes/list)\nmethod only requires a query parameter (`q`) to list books. To try the\n[`books.volumes.list`](/books/docs/v1/reference/volumes/list)\nmethod:\n\n1. Navigate to [`books.volumes.list`](/books/docs/v1/reference/volumes/list).\n2. If the APIs Explorer isn't displayed, click **Try it!**\n3. In the **`q`** field, type *Hunger Games* (without any quotes or special characters).\n4. Scroll down and click **Execute**.\n5. (optional) A Google sign-in screen asks you to select a Google account.\n6. (optional) A Google authorization dialog asks you if it's okay to \"Manage your books.\" Click *Allow*. The results appear below the Execute button.\n\nIf the APIs Explorer shows a result of 200, then the method was successful.\n| **Note:** After you allow the authorization screen to make an authorized request, the APIs Explorer is authorized to make other requests until the credentials expire. Therefore, you don't see the authorization screen for every subsequent method call. For further information on credentials, see [Test with different credential types and scopes](/explorer-help/authorization-and-authentication).\n\nTroubleshoot APIs Explorer issues\n---------------------------------\n\n### You received a 401 or 403 error\n\nIf you're getting a 401 or 403 error when executing a method using the APIs\nExplorer, it is likely due to a problem with one of the following:\n\n- You're using the wrong authorization type (API key instead of OAuth 2.0). Try switching the authorization type.\n- You're using OAuth 2.0, but with too narrow a scope. Try using a broader scope.\n\n### Authorization dialog doesn't appear\n\nThe APIs Explorer uses a popup to grant access to your private data. If your\nbrowser blocks popups, this popup won't appear and you won't be able to grant\naccess.\n\nIf you click **Allow** in the authorization dialog and nothing happens, try\nchanging your browser's popup settings to enable popups."]]
