Antes de começar

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

Configure um Google Cloud projeto

Seguir estes passos para configurar um Google Cloud projeto.

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.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Video Stitcher API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Create a service account:

1. Ensure that you have the Create Service Accounts IAM role (roles/iam.serviceAccountCreator). Learn how to grant roles.

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

   Go to Create service account
3. Select your project.

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

5. Click Create and continue.

6. 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.
7. Click Continue.

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

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.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Video Stitcher API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Create a service account:

1. Ensure that you have the Create Service Accounts IAM role (roles/iam.serviceAccountCreator). Learn how to grant roles.

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

   Go to Create service account
3. Select your project.

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

5. Click Create and continue.

6. 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.
7. Click Continue.

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

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.

1. Install the Google Cloud CLI.

2. Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.

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

   gcloud init

   Nota: pode executar a CLI gcloud na Google Cloud consola sem instalar a CLI do Google Cloud. Para executar a CLI gcloud na Google Cloud consola, use o Cloud Shell.
4. Use a CLI gcloud para testar o seu ambiente de autenticação. Verifique se o seguinte comando produz uma string de texto sem erros:

   gcloud auth application-default print-access-token

Ative a conta de serviço

1. No terminal, defina o projeto ativo para os comandos gcloud. Substitua YOUR_PROJECT_ID pelo ID do seu 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 ficheiro JSON que transferiu para a sua máquina local.

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

Vai usar esta conta de serviço para autorizar o acesso e chamar a API Video Stitcher.

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

Uma vez que um token OAuth é transmitido a uma aplicação cliente, crie uma conta de serviço separada com apenas autorizações para criar uma sessão. Deste modo, um token OAuth roubado não pode comprometer os seus recursos, como as configurações de VOD/transmissão em direto ou as chaves de CDN.

Create a service account:

1. Ensure that you have the Create Service Accounts IAM role (roles/iam.serviceAccountCreator). Learn how to grant roles.

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

   Go to Create service account
3. Select your project.

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

5. Click Create and continue.

6. 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.
7. Click Continue.

8. 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 stream em direto

Se estiver a inserir anúncios numa stream em direto, siga os passos nesta secção (ou consulte os passos para VOD).

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

Depois de criar a conta de serviço, tem de associá-la à sua conta do Ad Manager. Isto permite que a API Video Stitcher crie eventos de stream em direto em seu nome. Para o fazer, siga os passos para conceder acesso à sua conta de serviço:

1. Inicie sessão no Google Ad Manager (GAM).
2. Clique em Admin > Definições globais.
3. Certifique-se de que o acesso à API está ativado.
4. Clique em Adicionar um utilizador da conta de serviço.
5. Preencha o formulário, incluindo o endereço de email da conta de serviço criada anteriormente.
6. Selecione uma função que tenha a autorização Gerir conteúdo de vídeo com Inserção de anúncios dinâmicos do Editor de vídeo do Google Cloud. Deve criar uma função personalizada denominada Gestor de streams em direto especificamente para a gestão desta conta de serviço. A função personalizada deve ter, pelo menos, as seguintes autorizações:
   • Gerir conteúdo de vídeo com Inserção de anúncios dinâmicos do Editor de vídeo do Google Cloud
   • Ver criativos (necessário para a autorização anterior)
   • Veja conteúdo, pacotes e metadados de vídeo
   • Veja origens de conteúdo
7. Se a sua rede do Ad Manager usar equipas, tem de atribuir a equipa "Todas as entidades" ao utilizador da conta de serviço.
8. Clique em Guardar e confirme a adição da conta de serviço.

Crie uma stream em direto

Pode usar um dos inícios rápidos da API Live Stream para configurar uma stream em direto. As streams em direto HLS e MPEG-DASH são suportadas (consulte os requisitos do manifesto de origem). Este procedimento é opcional. Pode usar a sua própria stream em direto existente.

Os inícios rápidos da API Live Stream usam as Credenciais padrão da aplicação para autenticação, mas pode usar a conta de serviço que já configurou. Para esta opção, certifique-se de que a conta de serviço tem a função de editor de streams em direto.

Certifique-se de que mantém a stream em direto ativa. Não siga os passos na secção Limpar até terminar a stream em direto.

Requisitos do manifesto de origem

A API Video Stitcher regista a configuração no Ad Manager ao analisar o manifesto de origem. O manifesto de origem tem de ter determinadas características consoante o formato.

HLS

• O formato do contentor pode ser:
  • MPEG-TS multiplexado
  • MPEG-TS não multiplexado
  • FMP4 não multiplexado
• Pelo menos, uma representação no manifesto com os seguintes campos (corretamente preenchidos):
  • codecs
  • bandwidth

MPEG-DASH

• MPD@type definido como dinâmico (@type="dynamic")
• MPD@profiles inclui o perfil em direto ISO urn:mpeg:dash:profile:isoff-live:2011
• Deve ter vários períodos, com cada período a conter um ou mais conjuntos de adaptação
• 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 estar vazias

Configuração da stream VOD

Se estiver a inserir anúncios numa stream de VOD, siga os passos nesta secção (ou consulte os passos para uma stream em direto).

Crie os ficheiros de origem de VOD

Este fluxo de trabalho requer um ficheiro de manifesto MPEG-DASH (MPD) ou um ficheiro de manifesto HTTP Live Streaming (HLS) (M3U8) e os ficheiros de segmentos associados. Pode usar os seus próprios ficheiros VOD existentes ou pode criar ficheiros de origem VOD através da API Transcoder.