GSP154

Visão geral

A API Cloud Video Intelligence permite pesquisar e descobrir vídeos por meio da extração de metadados com uma API REST fácil de usar. Agora é possível pesquisar os momentos de cada arquivo de vídeo disponível no seu catálogo. A API faz anotações rapidamente em vídeos armazenados no Cloud Storage, além de identificar as entidades (substantivos) mais importantes e o momento em que aparecem no conteúdo. Para separar o sinal do ruído, recupere as informações relevantes do vídeo, em cada cena ou quadro.

Atividades

Neste curso, você vai aprender a:

• Configurar a autorização para uma conta de serviço personalizada
• Anotar e enviar solicitações de vídeo à API Video Intelligence

Configuração e requisitos

Antes de clicar no botão Começar o Laboratório

Leia estas instruções. Os laboratórios são cronometrados e não podem ser pausados. O timer é ativado quando você clica em Iniciar 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, e 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 (recomendado) ou uma janela anônima do navegador. Isso evita conflitos entre sua conta pessoal e de estudante, o que poderia causar cobranças extras na sua conta pessoal.

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

Observação: use apenas a conta de estudante neste laboratório. Se usar outra conta do Google Cloud, você poderá receber cobranças nela.

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 por ele, uma caixa de diálogo vai aparecer para você selecionar a forma de pagamento. No painel Detalhes do Laboratório, à esquerda, você vai encontrar o seguinte:

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

2. Se você estiver usando o navegador Chrome, clique em Abrir console do Google Cloud ou clique com o botão direito do mouse e selecione Abrir link em uma janela anônima.

   O laboratório ativa os recursos e depois abre a página Fazer Login em outra guia.

   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. Se necessário, copie o Nome de usuário abaixo e cole na caixa de diálogo Fazer login.

   {{{user_0.username | "Username"}}}

   Você também encontra o nome de usuário no painel Detalhes do Laboratório.

4. Clique em Próxima.

5. Copie a Senha abaixo e cole na caixa de diálogo de Olá.

   {{{user_0.password | "Password"}}}

   Você também encontra a senha no painel Detalhes do Laboratório.

6. Clique em Próxima.

   Importante: você precisa usar as credenciais fornecidas no laboratório, e não as da sua conta do Google Cloud. Observação: se você usar sua própria conta do Google Cloud neste laboratório, é possível que receba cobranças adicionais.

7. 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 Google Cloud será aberto nesta guia.

Observação: para acessar os produtos e serviços do Google Cloud, clique no Menu de navegação ou digite o nome do serviço ou produto no campo Pesquisar.

Ativar o Cloud Shell

O Cloud Shell é uma máquina virtual com várias ferramentas de desenvolvimento. Ele tem um diretório principal permanente de 5 GB e é executado no Google Cloud. O Cloud Shell oferece acesso de linha de comando aos recursos do Google Cloud.

1. Clique em Ativar o Cloud Shell na parte de cima do console do Google Cloud.

2. Clique nas seguintes janelas:

   • Continue na janela de informações do Cloud Shell.
   • Autorize o Cloud Shell a usar suas credenciais para fazer chamadas de APIs do Google Cloud.

Depois de se conectar, você verá que sua conta já está autenticada e que o projeto está configurado com seu Project_ID, . A saída contém uma linha que declara o projeto PROJECT_ID para esta sessão:

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

A gcloud é a ferramenta de linha de comando do Google Cloud. Ela vem pré-instalada no Cloud Shell e aceita preenchimento com tabulação.

3. (Opcional) É possível listar o nome da conta ativa usando este comando:

gcloud auth list

4. Clique em Autorizar.

Saída:

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`

5. (Opcional) É possível listar o ID do projeto usando este comando:

gcloud config list project

Saída:

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} Observação: consulte a documentação completa da gcloud no Google Cloud no guia de visão geral da gcloud CLI.

Tarefa 1: configurar a autorização

Neste laboratório, você vai criar e usar uma conta de serviço que está vinculada ao seu projeto do Google Cloud para ter autorização.

1. No Cloud Shell, execute o comando abaixo para criar uma nova conta de serviço chamada quickstart:

gcloud iam service-accounts create quickstart

2. Crie um arquivo de chave da conta de serviço, substituindo <your-project-123> pelo ID do projeto:

gcloud iam service-accounts keys create key.json --iam-account quickstart@<your-project-123>.iam.gserviceaccount.com

3. Autentique sua conta de serviço, indicando o local do arquivo de chave da conta de serviço:

gcloud auth activate-service-account --key-file key.json

4. Consiga um token de autorização usando a conta de serviço:

gcloud auth print-access-token

O token será exibido na resposta, e você vai precisar dele em uma etapa futura.

Clique em Verificar meu progresso para ver o objetivo. Configurar a autorização

Tarefa 2: criar uma solicitação de anotação de vídeo

Observação: a API Cloud Video Intelligence já foi ativada neste laboratório.

1. Execute este comando para criar um arquivo de solicitação JSON com o texto a seguir, e salvar como request.json:

cat > request.json <<EOF { "inputUri":"gs://spls/gsp154/video/train.mp4", "features": [ "LABEL_DETECTION" ] } EOF Observação: para simplificar o processo, vamos usar como valor de inputUri um vídeo público de um trem disponível para o projeto. Se você preferir usar um projeto pessoal, envie seu vídeo para o Cloud Storage e insira o URI dele (no formato "gs://bucket/object") como o valor de inputUri.

2. Use curl para fazer a solicitação videos:annotate e transmitir o nome do arquivo da solicitação de entidade:

curl -s -H 'Content-Type: application/json' \ -H 'Authorization: Bearer '$(gcloud auth print-access-token)'' \ 'https://videointelligence.googleapis.com/v1/videos:annotate' \ -d @request.json

A API Video Intelligence cria uma operação para processar a solicitação. Agora vai aparecer uma resposta com o nome da operação, como a seguinte:

{ "name": "projects/474887704060/locations/asia-east1/operations/16366331060670521152" }

Você usará esse nome de operação, locais e projetos na próxima etapa.

3. Para usar este script e solicitar informações sobre a operação, chame o endpoint v1.operations. Substitua PROJECTS, LOCATIONS e OPERATION_NAME pelo valor que você recebeu no comando anterior:

curl -s -H 'Content-Type: application/json' \ -H 'Authorization: Bearer '$(gcloud auth print-access-token)'' \ 'https://videointelligence.googleapis.com/v1/projects/PROJECTS/locations/LOCATIONS/operations/OPERATION_NAME'

Agora as informações relacionadas à operação serão exibidas. Quando a operação terminar, o campo done será incluído e definido como true:

{ "name": "projects/425437283751/locations/asia-east1/operations/17938636079131796601", "metadata": { "@type": "type.googleapis.com/google.cloud.videointelligence.v1.Annota tionProgressMetadata", "progressMetadata": [ { "inputUri": "gs://spls/gsp154/video/train.mp4", "startTime": "2016-09-22T21:41:56.766091Z", "lastUpdateTime": "2016-09-22T21:42:03.889743Z" } ] }, ... }

4. Depois de aproximadamente um minuto, execute novamente o comando. A mesma solicitação retornará os seguintes resultados da anotação:

{ "name": "projects/425437283751/locations/asia-east1/operations/17938636079131796601", "metadata": { "@type": "type.googleapis.com/google.cloud.videointelligence.v1.AnnotateVideoProgress", "annotationProgress": [ { "inputUri": "/spls/gsp154/video/train.mp4", "progressPercent": 100, "startTime": "2017-02-17T22:39:00.333942Z", "updateTime": "2017-02-17T22:39:11.414399Z" } ] }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.videointelligence.v1.AnnotateVideoResponse", "annotationResults": [ { "inputUri": "/spls/gsp154/video/train.mp4", "segmentLabelAnnotations": [ { "entity": { "entityId": "/m/01yrx", "languageCode": "en-US" }, "segments": [ { "segment": { "startTimeOffset": "0s", "endTimeOffset": "14.833664s" }, "confidence": 0.98509187 } ] }, ...

Você enviou sua primeira solicitação para a API Cloud Video Intelligence.

Clique em Verificar meu progresso para ver o objetivo. Crie uma solicitação de anotação de vídeo

Parabéns!

Você anotou e enviou sua primeira solicitação de vídeo para a API Video Intelligence e recebeu os resultados.

Próximas etapas / Saiba mais

Este laboratório também faz parte de uma série chamada Qwik Starts. Ela foi desenvolvida para apresentar a você alguns dos recursos disponíveis no Google Cloud. Pesquise "Qwik Starts" no catálogo do Google Cloud Ensina para encontrar algum laboratório que seja do seu interesse.

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.

Manual atualizado em 4 de fevereiro de 2024

Laboratório testado em 22 de dezembro de 2023

Copyright 2025 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.