GSP277

Informações gerais

O APIs Explorer do Google é uma ferramenta que ajuda você a explorar vários métodos de APIs do Google sem escrever código. Com o APIs Explorer, você pode:

• procurar rapidamente as APIs e versões disponíveis;
• ver os métodos disponíveis para cada API e os parâmetros suportados, além da documentação in-line;
• executar solicitações para qualquer método e ver as respostas em tempo real;
• fazer chamadas de API autenticadas e autorizadas;
• pesquisar em todos os serviços, métodos e nas suas últimas solicitações para encontrar rapidamente o que você procura.

O APIs Explorer usa as próprias chaves de API em todas as solicitações. Quando você usa o APIs Explorer para fazer uma solicitação, ele mostra a sintaxe dela, o que inclui um marcador com a etiqueta {YOUR_API_KEY}. Se você quiser fazer a mesma solicitação no seu aplicativo, substitua esse marcador pela chave de API.

Objetivos

• Criar um bucket do Cloud Storage.
• Fazer o upload de uma imagem no Cloud Storage e torná-la pública
• Fazer uma solicitação para a API Vision com a imagem

Configuração e requisitos

Antes de clicar no botão Start Lab

Leia estas instruções. Os laboratórios são cronometrados e não podem ser pausados. O timer é iniciado quando você clica em Começar o laboratório e mostra por quanto tempo os recursos do Google Cloud vão ficar disponíveis.

Este laboratório prático permite que você realize as atividades em um ambiente real de nuvem, não em uma simulação ou demonstração. Você vai receber novas credenciais temporárias para fazer login e acessar o Google Cloud durante o laboratório.

Confira os requisitos para concluir o laboratório:

• Acesso a um navegador de Internet padrão (recomendamos o Chrome).

Observação: para executar este laboratório, use o modo de navegação anônima ou uma janela anônima do navegador. Isso evita conflitos entre sua conta pessoal e a conta de estudante, o que poderia causar cobranças extras na sua conta pessoal.

• Tempo para concluir o laboratório---não se esqueça: depois de começar, não será possível pausar o laboratório.

Observação: não use seu projeto ou conta do Google Cloud neste laboratório para evitar cobranças extras na sua conta.

Como iniciar seu laboratório e fazer login no console do Google Cloud

1. Clique no botão Começar o laboratório. Se for preciso pagar, você verá um pop-up para selecionar a forma de pagamento. No painel Detalhes do laboratório à esquerda, você verá o seguinte:

   • O botão Abrir Console do Cloud
   • Tempo restante
   • As credenciais temporárias que você vai usar neste laboratório
   • Outras informações se forem necessárias

2. Clique em Abrir Console do Google. O laboratório ativa recursos e depois abre outra guia com a página Fazer login.

   Dica: coloque as guias em janelas separadas lado a lado.

   Observação: se aparecer a caixa de diálogo Escolher uma conta, clique em Usar outra conta.

3. Caso seja preciso, copie o Nome de usuário no painel Detalhes do laboratório e cole esse nome na caixa de diálogo Fazer login. Clique em Avançar.

4. Copie a Senha no painel Detalhes do laboratório e a cole na caixa de diálogo Olá. Clique em Avançar.

   Importante: você precisa usar as credenciais do painel à esquerda. Não use suas credenciais do Google Cloud Ensina. Observação: se você usar sua própria conta do Google Cloud neste laboratório, é possível que receba cobranças adicionais.

5. Acesse as próximas páginas:

   • Aceite os Termos e Condições.
   • Não adicione opções de recuperação nem autenticação de dois fatores (porque essa é uma conta temporária).
   • Não se inscreva em testes gratuitos.

Depois de alguns instantes, o console do GCP vai ser aberto nesta guia.

Observação: para ver uma lista dos produtos e serviços do Google Cloud, clique no Menu de navegação no canto superior esquerdo.

Tarefa 1: crie um bucket do Cloud Storage

1. No console do Cloud, acesse Cloud Storage > Buckets.
2. Clique em Criar bucket.
3. Dê um nome exclusivo ao bucket. Não inclua informações sensíveis no nome do bucket porque o namespace dele é global e visível para o público. Por exemplo, -bucket.
4. Clique em Escolha como controlar o acesso a objetos.
5. Desmarque a opção Aplicar a prevenção do acesso público neste bucket.
6. Selecione o controle de acesso Refinado.
7. Clique em Criar.

Teste a tarefa concluída

Clique em Verificar meu progresso para conferir a tarefa realizada. Se o bucket do Cloud Storage tiver sido criado, você receberá uma pontuação de avaliação.

Crie um bucket do Cloud Storage.

Tarefa 2: faça o upload de uma imagem

Você solicitará que a API Cloud Vision analise uma imagem por meio do APIs Explorer. Primeiro, adicione uma imagem ao seu bucket para análise. É possível usar uma imagem própria ou fazer o download da imagem abaixo no seu computador e salvá-la com o nome demo-image.jpg.

1. No seu bucket, clique em Fazer upload de arquivos e selecione o arquivo demo-image.jpg que você salvou.

Teste a tarefa concluída

Clique em Verificar meu progresso para conferir a tarefa realizada. Se você tiver feito upload de uma imagem para o bucket de armazenamento corretamente, vai receber uma pontuação de avaliação.

Faça o upload de uma imagem em um bucket de armazenamento (demo-image.jpg).

Depois que o arquivo for enviado e listado no seu bucket, compartilhe a imagem publicamente seguindo estas etapas:

1. Clique no menu expandido de três pontos verticais associados à sua imagem.
2. Selecione Editar acesso no menu suspenso.
3. Na sobreposição exibida, clique no botão + Adicionar entrada.
4. Adicione uma permissão para allUsers.
   • Selecione Pública em Entidade.
   • Digite allUsers em Nome.
   • Selecione Leitor em Acesso.
5. Clique em Salvar.

Teste a tarefa concluída

Clique em Verificar meu progresso para conferir a tarefa realizada. Se você conseguiu tornar a imagem enviada publicamente acessível, vai receber uma pontuação de avaliação.

Torne a imagem enviada disponível publicamente.

A imagem agora está disponível publicamente. Tudo pronto para usar o APIs Explorer.

Tarefa 3. faça uma solicitação ao serviço da API Cloud Vision

1. Acesse Menu de navegação > APIs e serviços.

2. Clique em + ATIVAR APIS E SERVIÇOS, pesquise Cloud Vision e selecione a API Cloud Vision na lista de resultados e clique nela.

3. Verifique se a API está ativada. Caso contrário, clique em Ativar.

4. Abra o link Cloud Vision - Teste a API.

Uma nova guia será aberta com a página do APIs Explorer carregada.

Você vai abrir a página do APIs Explorer.

Observação: Na seção abaixo, o método images.annotate da API Cloud Vision está em uso. É possível acessar todas as versões da API e os métodos relacionados na documentação de referência da API Cloud Vision.

5. Clique dentro das chaves no campo "Request body".
6. Será necessário selecionar uma propriedade, escolha requests. Isso gera o próximo nível.
7. Clique dentro das chaves e no sinal azul de mais e selecione [Add Item]. Para sua propriedade, selecione "features"
8. Dentro de "features" clique dentro das chaves, depois no ícone de adição azul e selecione [Add Item]. Em seguida, selecione "type" e LABEL_DETECTION.
9. O ícone de adição azul aparece no final do bloco "features", onde você pode adicionar "image"; "source" e "imageUri".
10. Ao lado de "imageUri" insira o caminho do arquivo de imagem no seu bucket. O formato do caminho deve ser semelhante a este: gs://MY_BUCKET/demo-image.jpg

Quando você terminar, o campo "Request body" ficará assim:

11. Verifique se as caixas de seleção Google OAuth 2.0 e API key estão marcadas na seção Credentials.

Observação: para acessar as Perguntas frequentes sobre credenciais, clique no ícone de ponto de interrogação ao lado do título Credentials.

12. No painel direito do console do APIs Explorer, você encontra uma chamada para a API Cloud Vision com cURL, HTTP e JAVASCRIPT.

13. Agora clique em Execute.

14. Selecione sua conta de estudante.

15. Na próxima tela, clique em Allow para dar acesso ao APIs Explorer.

Os resultados da análise da imagem pela API Cloud Vision serão exibidos abaixo do painel à direita. A parte superior dos resultados ficará assim:

Tarefa 4: teste seu conhecimento

Responda às perguntas de múltipla escolha abaixo para reforçar sua compreensão dos conceitos abordados neste laboratório. Use tudo o que você aprendeu até aqui.

Parabéns!

Você fez sua primeira solicitação images.annotate para o serviço da API Cloud Vision.

Termine a Quest

Este laboratório autoguiado faz parte das Quests Exploring APIs e Intro to ML: Image Processing. Uma Quest é uma série de laboratórios relacionados que formam um programa de aprendizado. Ao concluir uma Quest, você ganha um selo como reconhecimento da sua conquista. É possível publicar os selos e incluir um link para eles no seu currículo on-line ou nas redes sociais. Inscreva-se em qualquer Quest que tenha este laboratório para receber os créditos de conclusão na mesma hora. Confira o catálogo do Google Cloud Ensina para ver todas as Quests disponíveis.

Comece o próximo laboratório

Este laboratório faz parte de uma série chamada Qwik Starts. Ela foi desenvolvida para apresentar os vários recursos disponíveis no Google Cloud. Pesquise "Qwik Starts" no catálogo de laboratórios para decidir qual deles você quer fazer em seguida.

Próximas etapas / Saiba mais

• Aprenda a usar o APIs Explorer na página de Perguntas frequentes do APIs Explorer
• Leia mais sobre a API Cloud Vision.

Treinamento e certificação do Google Cloud

Esses treinamentos ajudam você a aproveitar as tecnologias do Google Cloud ao máximo. Nossas aulas incluem habilidades técnicas e práticas recomendadas para ajudar você a alcançar rapidamente o nível esperado e continuar sua jornada de aprendizado. Oferecemos treinamentos que vão do nível básico ao avançado, com opções de aulas virtuais, sob demanda e por meio de transmissões ao vivo para que você possa encaixá-las na correria do seu dia a dia. As certificações validam sua experiência e comprovam suas habilidades com as tecnologias do Google Cloud.

Finalize o laboratório

Após concluir o laboratório, clique em Terminar o laboratório. Sua conta e os recursos que você utilizou serão removidos da plataforma do laboratório.

Você poderá classificar sua experiência neste laboratório. Basta selecionar o número de estrelas, digitar um comentário e clicar em Enviar.

O número de estrelas indica o seguinte:

• 1 estrela = muito insatisfeito
• 2 estrelas = insatisfeito
• 3 estrelas = neutro
• 4 estrelas = satisfeito
• 5 estrelas = muito satisfeito

Feche a caixa de diálogo se não quiser enviar feedback.

Para enviar seu feedback, fazer sugestões ou correções, use a guia Suporte.

Manual atualizado em 19 de setembro de 2023

Laboratório testado em 19 de setembro de 2023

Copyright 2024 Google LLC. Todos os direitos reservados. Google e o logotipo do Google são marcas registradas da Google LLC. Todos os outros nomes de produtos e empresas podem ser marcas registradas das respectivas empresas a que estão associados.