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 theresourcemanager.projects.create
permission. Learn how to grant roles.
-
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 theserviceusage.services.enable
permission. Learn how to grant roles. -
Create a service account:
-
Ensure that you have the Create Service Accounts IAM role
(
roles/iam.serviceAccountCreator
). Learn how to grant roles. -
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
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
. - Click Create and continue.
-
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.
- Click Continue.
-
Click Done to finish creating the service account.
Do not close your browser window. You will use it in the next step.
-
Ensure that you have the Create Service Accounts IAM role
(
-
Create a service account key:
- In the Google Cloud console, click the email address for the service account that you created.
- Click Keys.
- Click Add key, and then click Create new key.
- Click Create. A JSON key file is downloaded to your computer.
- 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. -
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 theresourcemanager.projects.create
permission. Learn how to grant roles.
-
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 theserviceusage.services.enable
permission. Learn how to grant roles. -
Create a service account:
-
Ensure that you have the Create Service Accounts IAM role
(
roles/iam.serviceAccountCreator
). Learn how to grant roles. -
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
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
. - Click Create and continue.
-
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.
- Click Continue.
-
Click Done to finish creating the service account.
Do not close your browser window. You will use it in the next step.
-
Ensure that you have the Create Service Accounts IAM role
(
-
Create a service account key:
- In the Google Cloud console, click the email address for the service account that you created.
- Click Keys.
- Click Add key, and then click Create new key.
- Click Create. A JSON key file is downloaded to your computer.
- 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. -
Install the Google Cloud CLI.
-
Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.
-
Para inicializar a CLI gcloud, execute o seguinte comando:
gcloud init
- 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
- 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
- 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
-
Ensure that you have the Create Service Accounts IAM role
(
roles/iam.serviceAccountCreator
). Learn how to grant roles. -
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
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
. - Click Create and continue.
-
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.
- Click Continue.
-
Click Done to finish creating the service account.
Do not close your browser window. You will use it in the next step.
- In the Google Cloud console, click the email address for the service account that you created.
- Click Keys.
- Click Add key, and then click Create new key.
- Click Create. A JSON key file is downloaded to your computer.
- Click Close.
- Inicie sessão no Google Ad Manager (GAM).
- Clique em Admin > Definições globais.
- Certifique-se de que o acesso à API está ativado.
- Clique em Adicionar um utilizador da conta de serviço.
- Preencha o formulário, incluindo o endereço de email da conta de serviço criada anteriormente.
- 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
- Se a sua rede do Ad Manager usar equipas, tem de atribuir a equipa "Todas as entidades" ao utilizador da conta de serviço.
- Clique em Guardar e confirme a adição da conta de serviço.
- 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
MPD@type
definido como dinâmico (@type="dynamic"
)MPD@profiles
inclui o perfil em direto ISOurn: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
Ative a conta de serviço
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:
Create a service account key:
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:
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
MPEG-DASH
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.