Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Na maioria das páginas de documentação, um APIs Explorer condensado fica visível no lado direito da tela. Se o APIs Explorer não estiver visível, clique em Teste agora! para mostrar a versão condensada.
Se a opção Teste agora! não aparecer no lado direito de uma página de documentação de referência, o método não será compatível com o API Explorer. Por exemplo, o APIs Explorer não é compatível com APIs que exigem contas de serviço. Por isso, ele não aparece nas páginas de documentação dessas APIs.
Mostrar a versão expandida do APIs Explorer
A versão expandida do APIs Explorer contém cURL, HTTP e possivelmente
outras amostras de código. Para mostrar a versão expandida do APIs Explorer,
clique em Tela cheia fullscreen.
Executar um método
Com o APIs Explorer, é possível inserir parâmetros obrigatórios e opcionais e, se aplicável, um corpo de solicitação para métodos de API. Para muitos métodos REST, como os de lista, basta preencher um ou dois campos antes de executar o método. Por exemplo, o método
books.volumes.list
da API Books só exige um parâmetro de consulta (q) para listar livros. Para testar o método
books.volumes.list:
Se o APIs Explorer não aparecer, clique em Testar.
No campo q, digite Jogos Vorazes (sem aspas ou caracteres especiais).
Role a tela para baixo e clique em Executar.
(opcional) Uma tela de login do Google pede que você selecione uma Conta do Google.
(Opcional) Uma caixa de diálogo de autorização do Google pergunta se você concorda em "Gerenciar seus livros". Clique em Permitir. Os resultados aparecem abaixo do botão "Executar".
Se o APIs Explorer mostrar um resultado de 200, o método foi bem-sucedido.
Resolver problemas do APIs Explorer
Você recebeu um erro 401 ou 403
Se você estiver recebendo um erro 401 ou 403 ao executar um método usando o APIs
Explorer, provavelmente isso se deve a um problema com um dos seguintes itens:
Você está usando o tipo de autorização errado (chave de API em vez de OAuth 2.0).
Tente mudar o tipo de autorização.
Você está usando o OAuth 2.0, mas com um escopo muito limitado. Tente usar um escopo mais amplo.
A caixa de diálogo de autorização não aparece
O APIs Explorer usa um pop-up para conceder acesso aos seus dados particulares. Se o navegador bloquear pop-ups, essa janela não vai aparecer e você não poderá conceder acesso.
Se você clicar em Permitir na caixa de diálogo de autorização e nada acontecer, tente
mudar as configurações de pop-up do navegador para ativar os pop-ups.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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."]]
