Antes de começar

Nesta página, mostramos como configurar um projeto do Google Cloud e configurar 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. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Video Stitcher API.

   Enable the 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.
   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. Set the environment variable GOOGLE_APPLICATION_CREDENTIALS to the path of the JSON file that contains your credentials. This variable applies only to your current shell session, so if you open a new session, set the variable again.

   Example: Linux or macOS

   export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Replace KEY_PATH with the path of the JSON file that contains your credentials.

   For example:

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

   Example: Windows

   For PowerShell:

   $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Replace KEY_PATH with the path of the JSON file that contains your credentials.

   For example:

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

   For command prompt:

   set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

   Replace KEY_PATH with the path of the JSON file that contains your credentials.

8. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

9. Make sure that billing is enabled for your Google Cloud project.

10. Enable the Video Stitcher API.

    Enable the 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.
    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. Set the environment variable GOOGLE_APPLICATION_CREDENTIALS to the path of the JSON file that contains your credentials. This variable applies only to your current shell session, so if you open a new session, set the variable again.

    Example: Linux or macOS

    export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Replace KEY_PATH with the path of the JSON file that contains your credentials.

    For example:

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

    Example: Windows

    For PowerShell:

    $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Replace KEY_PATH with the path of the JSON file that contains your credentials.

    For example:

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

    For command prompt:

    set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

    Replace KEY_PATH with the path of the JSON file that contains your credentials.

14. Install the Google Cloud CLI.

15. To initialize the gcloud CLI, run the following command:

    gcloud init

    Note: You can run the gcloud CLI in the Google Cloud console without installing the Google Cloud CLI. To run the gcloud CLI in the Google Cloud console, use Cloud Shell.
16. Use a CLI gcloud para testar o ambiente de autenticação. Verifique se o comando a seguir gera uma string de texto sem erros:

    gcloud auth application-default print-access-token

Ativar a conta de serviço

1. No 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ê fez o download para a máquina local.

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

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

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

Como um token OAuth será transmitido a um aplicativo cliente, crie uma conta de serviço separada com apenas permissões para criar uma sessão. Dessa forma, um token OAuth vazado não pode comprometer seus recursos, como configurações de VOD/ao vivo ou chaves 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.
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 consulte as etapas para VOD.

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

Depois de criar a conta de serviço, você precisa vinculá-la à 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 e insira o endereço de e-mail da conta de serviço criada anteriormente.
6. Selecione uma função, que precisa incluir a permissão Gerenciar conteúdo de vídeo com a inserção de anúncios dinâmicos do integrador de vídeos do Google Cloud. É necessário criar uma função personalizada chamada Administrador de transmissão 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 integrador de vídeos do Google Cloud
   • Acessar criativos (exigida pela permissão anterior)
   • Acessar conteúdo de vídeo, pacotes e metadados
   • Conferir as origens de conteúdo
7. Se a rede do Ad Manager usar equipes, você vai precisar atribuir a equipe "Todas as entidades" ao usuário da conta de serviço.
8. 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 de origem). Esse procedimento é opcional. Você pode usar sua própria transmissão ao vivo.

Os tutoriais iniciais da API Live Stream usam Application Default Credentials para autenticação, mas você pode usar a conta de serviço que já configurou. Para essa opção, verifique se a conta de serviço tem o papel de Editor de transmissão ao vivo.

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

Requisitos do manifesto de origem

A API Video Stitcher registra a configuração com o 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 mixado
  • MPEG-TS não multiplexado
  • FMP4 não multiplexado
• Pelo menos uma renderizaçã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 ao vivo urn:mpeg:dash:profile:isoff-live:2011
• Precisa ter vários períodos, com cada um deles contendo um ou mais conjuntos de adaptação.
• Cada conjunto de adaptação 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 "true" para todos os conjuntos de adaptação
• As representações não podem estar vazias

Configuração do stream de VOD

Se você estiver inserindo anúncios em uma transmissão 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) ou um arquivo de manifesto HTTP Live Streaming (HLS) (M3U8) e os arquivos de segmento associados. Você pode usar seus próprios arquivos VOD ou criar arquivos de origem VOD usando a API Transcoder.