Antes de começar

Esta página mostra como configurar um projeto do Google Cloud e configurar contas de serviço para acessar o projeto.

Configurar 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.

    Go to project selector

  3. Verify 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.

    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.

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

    Go to project selector

  9. Verify 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.

    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.

  14. Install the Google Cloud CLI.

  15. Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

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

    gcloud init
  17. 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

    18. Ativar a conta de serviço

    1. No terminal, defina o projeto ativo para 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 para o arquivo JSON que você baixou na sua 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 permissões apenas para criar sessões

    Como um token OAuth será transmitido para um aplicativo cliente, crie uma conta de serviço separada com permissões apenas 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.

    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).

    Depois de criar a conta de serviço, 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 e insira o endereço de e-mail da conta de serviço criada anteriormente.
    6. Selecione uma função que inclua 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. É recomendável criar uma função personalizada chamada Gerente 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 integrador de vídeos do Google Cloud
      • Ver criativos (exigido pela permissão anterior)
      • Ver conteúdo, pacotes e metadados de vídeo
      • Ver fontes de conteúdo
    7. Se a rede do Ad Manager usar equipes, atribua 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 inícios rápidos 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 codelabs de início rápido 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é concluir 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 multiplexado
      • MPEG-TS sem multiplexagem
      • FMP4 sem multiplexagem
    • 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 Live urn:mpeg:dash:profile:isoff-live:2011
    • Precisa ser de vários períodos, com cada período 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 de stream de VOD

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