Como usar o APIs Explorer

Neste guia de início rápido, detalhamos os seguintes processos:

  • criação de um intervalo do Cloud Storage
  • upload da imagem para o Cloud Storage e como torná-la pública
  • solicitação para a API Vision com essa imagem

Essas etapas levam cerca de cinco minutos para serem concluídas. É possível armazenar gratuitamente até 5 GB de dados no Cloud Storage e fazer até 1.000 solicitações de recursos para a API Vision por mês, sem custo nenhum.

Antes de começar

Se você ainda não tiver feito isso, configure seu projeto e crie um intervalo do Google Cloud Storage, conforme explicado abaixo.

Criar o projeto

  1. Faça login na sua conta do Google.

    Se você ainda não tiver uma, inscreva-se.

  2. No Console do Cloud, na página de seletor de projetos, selecione ou crie um projeto do Cloud.

    Acessar a página do seletor de projetos

  3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud. Saiba como confirmar se a cobrança está ativada para o seu projeto.

  4. Ative a API Cloud Vision.

    Ative a API

Criar um intervalo do Cloud Storage

  1. No Console do Cloud, acesse a página Navegador do Cloud Storage.

    Acessar a página "Navegador do Cloud Storage"

  2. Clique em Criar bucket.
  3. Na caixa de diálogo Criar bucket, especifique os seguintes atributos.
    • Nome: um nome de bucket exclusivo. Não inclua informações confidenciais no nome do bucket: o namespace é global e visível ao público.
    • Classe de armazenamento padrão: Standard
    • Um local onde os dados do bucket serão armazenados.
  4. Clique em Criar

Fazer uma solicitação ao serviço da API Cloud Vision

  1. Download demo-img.jpg. Talvez seja necessário clicar com o botão direito do mouse no link.

  2. Abra o navegador do Console do Cloud Storage.

  3. Selecione o intervalo que você criou na seção anterior.

  4. Clique em Enviar arquivos e selecione o arquivo demo-img.jpg para fazer upload da sua máquina local ao bucket do Cloud Storage.

    Este é o arquivo de imagem que você acabou de enviar:
    mulheres andando de bicicleta na imagem de Jacarta
    Crédito da imagem: Rohiim Ariful em Unsplash.

  5. Depois que o arquivo for carregado e listado no Cloud Storage Browser, compartilhe a imagem publicamente.

  6. Preencha o modelo interativo do API Explorer, abaixo, substituindo cloud-samples-data/vision no campo image.source.imageUri pelo nome do bucket do Cloud Storage em que você fez upload do arquivo demo-img.jpg.

  7. Clique em Executar para enviar a solicitação ao serviço. A resposta JSON é mostrada acima.

Parabéns! Você fez sua primeira solicitação images.annotate ao serviço da API Cloud Vision.

Limpar

Para evitar cobranças desnecessárias do Google Cloud Platform, use o Console do Cloud para excluir seu bucket do Cloud Storage (e seu projeto) se você não precisar deles.

A seguir