Antes de começar

Nesta página, mostramos como configurar um projeto do Google Cloud e definir contas de serviço para acessar o projeto.

Configure um projeto do Google Cloud

Siga estas etapas para configurar um projeto do Google Cloud.

1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

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

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

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

4. Ative a Video Stitcher API.

   Ative a API

5. Create a service account:

   1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
   2. Select your project.

   3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

   4. Click Create and continue.

   5. Grant the Video Stitcher Admin role to the service account.

      To grant the role, find the Select a role list, then select Video Stitcher Admin.

      Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later. In production environments, do not grant the Owner, Editor, or Viewer roles. Instead, grant a predefined role or custom role that meets your needs.
   6. Click Continue.

   7. Click Done to finish creating the service account.

      Do not close your browser window. You will use it in the next step.

6. Create a service account key:

   1. In the Google Cloud console, click the email address for the service account that you created.
   2. Click Keys.
   3. Click Add key, and then click Create new key.
   4. Click Create. A JSON key file is downloaded to your computer.
   5. Click Close.

7. Defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho do arquivo JSON que contém suas credenciais. Essa variável só se aplica à sessão de shell atual. Assim, se você abrir uma nova sessão, precisará definir a variável novamente.

   Exemplo: Linux ou macOS

   export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Substitua KEY_PATH pelo caminho do arquivo JSON que contém suas credenciais.

   Exemplo:

   export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

   Exemplo: Windows

   Para PowerShell:

   $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Substitua KEY_PATH pelo caminho do arquivo JSON que contém suas credenciais.

   Exemplo:

   $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

   Para prompt de comando:

   set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

   Substitua KEY_PATH pelo caminho do arquivo JSON que contém suas credenciais.

8. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

9. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

10. Ative a Video Stitcher API.

    Ative a API

11. Create a service account:

    1. In the Google Cloud console, go to the Create service account page.

       Go to Create service account
    2. Select your project.

    3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

       In the Service account description field, enter a description. For example, Service account for quickstart.

    4. Click Create and continue.

    5. Grant the Video Stitcher Admin role to the service account.

       To grant the role, find the Select a role list, then select Video Stitcher Admin.

       Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later. In production environments, do not grant the Owner, Editor, or Viewer roles. Instead, grant a predefined role or custom role that meets your needs.
    6. Click Continue.

    7. Click Done to finish creating the service account.

       Do not close your browser window. You will use it in the next step.

12. Create a service account key:

    1. In the Google Cloud console, click the email address for the service account that you created.
    2. Click Keys.
    3. Click Add key, and then click Create new key.
    4. Click Create. A JSON key file is downloaded to your computer.
    5. Click Close.

13. Defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho do arquivo JSON que contém suas credenciais. Essa variável só se aplica à sessão de shell atual. Assim, se você abrir uma nova sessão, precisará definir a variável novamente.

    Exemplo: Linux ou macOS

    export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Substitua KEY_PATH pelo caminho do arquivo JSON que contém suas credenciais.

    Exemplo:

    export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

    Exemplo: Windows

    Para PowerShell:

    $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Substitua KEY_PATH pelo caminho do arquivo JSON que contém suas credenciais.

    Exemplo:

    $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

    Para prompt de comando:

    set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

    Substitua KEY_PATH pelo caminho do arquivo JSON que contém suas credenciais.

14. Instale a CLI do Google Cloud.

15. Para inicializar a CLI gcloud, execute o seguinte comando:

    gcloud init

    observação: execute a CLI gcloud no console do Google Cloud sem instalar a Google Cloud CLI. Para executar a gcloud CLI no console do Google Cloud, use o Cloud Shell .
16. Use a CLI gcloud para testar seu ambiente de autenticação. Verifique se o comando a seguir gera uma string de texto sem erros:

    gcloud auth application-default print-access-token

Ative a conta de serviço

1. No seu terminal, defina o projeto ativo para os comandos gcloud. Substitua YOUR_PROJECT_ID pelo ID do projeto.

   gcloud config set project YOUR_PROJECT_ID
   

2. Ative a conta de serviço. Substitua PATH_TO_YOUR_SERVICE_KEY pelo caminho do arquivo JSON que você salvou na máquina local.

   gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY
   

Você usará essa conta de serviço para autorizar o acesso e chamar a API Video Stitcher.

Criar uma conta de serviço apenas com permissões para criar sessões

Como um token OAuth será transmitido para um aplicativo cliente, crie uma conta de serviço separada com apenas permissões para criar uma sessão. Assim, um token OAuth vazado não poderá comprometer seus recursos, como configurações de VOD/ao vivo ou chaves de CDN.

Create a service account:

1. In the Google Cloud console, go to the Create service account page.

   Go to Create service account
2. Select your project.

3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

   In the Service account description field, enter a description. For example, Service account for quickstart.

4. Click Create and continue.

5. Grant the Video Stitcher User role to the service account.

   To grant the role, find the Select a role list, then select Video Stitcher User.

   Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later. In production environments, do not grant the Owner, Editor, or Viewer roles. Instead, grant a predefined role or custom role that meets your needs.
6. Click Continue.

7. Click Done to finish creating the service account.

   Do not close your browser window. You will use it in the next step.

Create a service account key:

1. In the Google Cloud console, click the email address for the service account that you created.
2. Click Keys.
3. Click Add key, and then click Create new key.
4. Click Create. A JSON key file is downloaded to your computer.
5. Click Close.

Configuração da transmissão ao vivo

Se você estiver inserindo anúncios em uma transmissão ao vivo, siga as etapas desta seção ou as etapas para VOD.

Vincular a conta de serviço à conta do Ad Manager

Depois que a conta de serviço for criada, vincule-a à sua conta do Ad Manager. Isso permite que a API Video Stitcher crie eventos de transmissão ao vivo em seu nome. Para fazer isso, siga as etapas para conceder acesso à sua conta de serviço:

1. Faça login no Google Ad Manager (GAM).
2. Clique em Administrador > Configurações globais.
3. Verifique se o acesso à API está ativado.
4. Clique em Adicionar um usuário da conta de serviço.
5. Preencha o formulário, incluindo o endereço de e-mail da conta de serviço criada anteriormente.
6. Selecione um papel, que precisa incluir a permissão Gerenciar conteúdo em vídeo com inserção de anúncios dinâmicos do integrador de vídeos do Google Cloud. Crie um papel personalizado chamado Gerenciador de transmissões ao vivo especificamente para o gerenciamento dessa conta de serviço. O papel personalizado precisa ter pelo menos as seguintes permissões:
   • Gerenciar conteúdo de vídeo com a Inserção de anúncios dinâmicos do Google Cloud Video Stitcher
   • Visualizar criativos (exigido pela permissão anterior)
   • Visualizar conteúdo, pacotes e metadados em vídeo
   • Ver as origens do conteúdo
7. Clique em Salvar e confirme a adição da conta de serviço.

Criar uma transmissão ao vivo

Use um dos guias de início rápido da API Live Stream para configurar uma transmissão ao vivo. As transmissões ao vivo HLS e MPEG-DASH são compatíveis. Consulte os requisitos do manifesto da fonte. Esse procedimento é opcional. É possível usar sua própria transmissão ao vivo.

Os guias de início rápido da API Live Stream usam o Application Default Credentials para autenticação, mas você pode usar a conta de serviço já configurada. Para essa opção, verifique se a conta de serviço tem o papel Editor de transmissão ao vivo.

Mantenha a transmissão ao vivo ativa. Não siga as etapas na seção Limpar até terminar a transmissão.

Requisitos do manifesto de origem

A API Video Stitcher registra a configuração no Ad Manager analisando o manifesto de origem. O manifesto de origem precisa ter determinadas características dependendo do formato.

HLS

• O formato do contêiner pode ser:
  • MPEG-TS incorporado
  • MPEG-TS descompactado
  • FMP4 descompactado
• Pelo menos uma versão no manifesto com os seguintes campos (preenchidos corretamente):
  • codecs
  • bandwidth

MPEG-DASH

• MPD@type definido como dinâmico (@type="dynamic")
• MPD@profiles inclui o perfil ISO Live urn:mpeg:dash:profile:isoff-live:2011
• Precisa ser de vários períodos, e cada período contém um ou mais conjuntos de adaptações
• Cada conjunto de adaptações contém uma ou mais representações
• As representações contêm ou herdam um SegmentTemplate com o identificador $Number$ ou $Time$.
• @segmentAlignment definido como verdadeiro para todos os conjuntos de adaptação
• As representações não podem ficar em branco

Configuração do stream de VOD

Se você estiver inserindo anúncios em um stream de VOD, siga as etapas desta seção ou consulte as etapas para uma transmissão ao vivo.

Criar os arquivos de origem de VOD

Esse fluxo de trabalho requer um arquivo de manifesto MPEG-DASH (MPD, na sigla em inglês) ou um arquivo de manifesto HTTP Live Streaming (HLS) (M3U8) e os arquivos de segmento associados. É possível usar seus próprios arquivos VOD ou criar arquivos de origem VOD usando a API Transcoder.