Criar uma configuração para um evento de transmissão ao vivo

Para a integração do Ad Manager, é preciso criar uma configuração ao vivo para um determinado evento de transmissão ao vivo. A API Video Stitcher registra essa configuração com o Ad Manager.

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 com multiplexação
  • MPEG-TS não multiplexado
  • FMP4 não multiplexado
• Pelo menos uma execução no manifesto com os seguintes campos (adequadamente preenchidos):
  • codecs
  • bandwidth

MPEG-DASH

• A coluna MPD@type foi definida como dinâmica (@type="dynamic")
• MPD@profiles inclui o perfil ISO ao vivo urn:mpeg:dash:profile:isoff-live:2011
• Um ou mais períodos, cada um 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 verdadeiro para todos os conjuntos de adaptação
• As representações não podem estar em branco

Criar uma barreira

Antes de criar a configuração ativa, é preciso criar um slate. A API Video Stitcher insere um vídeo de barreira padrão quando não é possível inserir anúncios. É necessário registrar o vídeo de barreira com a API Video Stitcher para indicar a barreira a ser usada na ausência de anúncios. O vídeo de barreira pode ser qualquer arquivo MP4 com pelo menos uma faixa de áudio.

Há duas opções para criar esta barreira. É possível criar uma barreira de rede padrão na sua conta do Ad Manager ou usando a API Video Stitcher.

Criar uma barreira no Ad Manager

Para criar uma barreira de rede padrão na conta do Ad Manager, siga as etapas em Criar uma barreira para preencher lacunas de conteúdo e pule para a seção Criar a configuração ativa.

Criar uma barreira usando a API Video Stitcher

Para criar uma barreira usando a API Video Stitcher, use o método projects.locations.slates.create.

Antes de usar os dados da solicitação, faça as substituições a seguir:

• PROJECT_NUMBER: o número do projeto do Google Cloud, localizado no campo Número do projeto na página Configurações do IAM
• LOCATION: o local em que a barreira será criada. Use uma das regiões com suporte.
  Mostrar locais
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• SLATE_ID: um identificador definido pelo usuário para a barreira. Ele só pode ter letras minúsculas, números e hifens. O primeiro caractere precisa ser uma letra, o último precisa ser uma letra ou um número, e o ID todo tem um máximo de 63 caracteres.
• SLATE_URL: o URI público de um vídeo MP4 com pelo menos uma faixa de áudio (vídeo de exemplo).
• NETWORK_CODE: o identificador numérico da sua rede do Ad Manager. Esse nome pode ser encontrado nas configurações globais da conta de editor.
  Importante:é necessário incluir o objeto gamSlate para usar a barreira com o Google Ad Manager (GAM).

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login , ou usando o Cloud Shell, que automaticamente conecta você à CLI gcloud . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo chamado request.json. Execute o comando a seguir no terminal para criar ou substituir esse arquivo no diretório atual:

cat > request.json << 'EOF'
{
  "uri": "SLATE_URL",
  "gamSlate": {
    "networkCode": "NETWORK_CODE"
  }
}
EOF

Depois execute o comando a seguir para enviar a solicitação REST:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/slates?slateId=SLATE_ID"

PowerShell (Windows)

Observação: O comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo chamado request.json. Execute o comando a seguir no terminal para criar ou substituir esse arquivo no diretório atual:

@'
{
  "uri": "SLATE_URL",
  "gamSlate": {
    "networkCode": "NETWORK_CODE"
  }
}
'@  | Out-File -FilePath request.json -Encoding utf8

Depois execute o comando a seguir para enviar a solicitação REST:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/slates?slateId=SLATE_ID" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.common.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
    "verb": "create"
  },
  "done": false
}

Esse comando cria uma operação de longa duração (LRO, na sigla em inglês) que você pode consultar para rastrear o progresso. Copie o OPERATION_ID retornado, que é a última parte do campo name, para usar na próxima seção.

Conferir o resultado

Use o método projects.locations.operations.get para verificar se a barreira foi criada. Se a resposta contiver "done: false", repita o comando até que a resposta contenha "done: true".

Antes de usar os dados da solicitação, faça as substituições a seguir:

• PROJECT_NUMBER: o número do projeto do Google Cloud, localizado no campo Número do projeto na página Configurações do IAM
• LOCATION: o local dos dados. Use uma das regiões com suporte.
  Mostrar locais
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• OPERATION_ID: o identificador da operação.

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login , ou usando o Cloud Shell, que automaticamente conecta você à CLI gcloud . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID"

PowerShell (Windows)

Observação: O comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.common.OperationMetadata",
    "createTime": CREATE_TIME,
    "endTime": END_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
    "verb": "create"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.video.stitcher.v1.Slate",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
    "uri": "SLATE_URL",
    "gamSlate": {
      "networkCode": "NETWORK_CODE"
      "gamSlateId": "GAM_SLATE_ID"
    }
  }
}

Criar a configuração ativa

Para criar a configuração, use o método projects.locations.liveConfigs.create.

Antes de usar os dados da solicitação, faça as substituições a seguir:

• PROJECT_NUMBER: o número do projeto do Google Cloud, localizado no campo Número do projeto na página Configurações do IAM
• LOCATION: o local em que a configuração ativa será criada. Use uma das regiões com suporte.
  Mostrar locais
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• LIVE_CONFIG_ID: um identificador definido pelo usuário para a configuração ativa. Ele só pode ter letras minúsculas, números e hifens. O primeiro caractere precisa ser uma letra, o último precisa ser uma letra ou um número, e o ID todo tem um máximo de 63 caracteres.
• SOURCE_LIVESTREAM_URI: o URL de origem do manifesto de vídeo de transmissão ao vivo. Ele precisa ser acessível para a API Video Stitcher. O URL precisa estar acessível publicamente ou, se a assinatura de URL estiver ativada para a CDN, uma chave de CDN registrada foi fornecida à API Video Stitcher. Se você criou uma transmissão ao vivo de teste usando a API Live Stream, esse é o URI do arquivo main.m3u8 ou main.mpd no bucket do Cloud Storage.
• AD_TAG_URI: cole esse valor no bloco de código JSON da solicitação abaixo. É o URL dos metadados de anúncios recuperados dos servidores de anúncios. Para integração com o Ad Manager, precisa ser uma tag de anúncio em vídeo ao vivo válida do Ad Manager. Para receber uma tag de anúncio válida, siga as etapas em Gerar tags de anúncio em vídeo e áudio com estas modificações:
  • Para Trânsito em tempo real, ative o recurso.
  • Para o Tipo de SDK do player, selecione SDK do IMA do Google.
  • Adicione o parâmetro ad_rule=0 à tag (por exemplo, inclua &ad_rule=0 no final).
• SLATE_ID: o ID da barreira a ser usada na ausência de anúncios integrados
  Observação:se você criou uma barreira de rede padrão usando o Ad Manager, remova o campo defaultSlate da solicitação para usar a barreira de rede padrão.
• NETWORK_CODE: é o identificador numérico da sua rede do Ad Manager, disponível nas configurações globais da conta do editor.
• AD_TRACKING: o comportamento de rastreamento de anúncios para seu stream. Para integrações com o SDK do IMA, use CLIENT. Também é possível substituir esse valor por sessão mais tarde.

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: verifique se você definiu a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho do arquivo de chave privada da conta de serviço.

Salve o corpo da solicitação em um arquivo chamado request.json. Execute o comando a seguir no terminal para criar ou substituir esse arquivo no diretório atual:

cat > request.json << 'EOF'
{
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
  },
  "adTracking": "AD_TRACKING"
}
EOF

Depois execute o comando a seguir para enviar a solicitação REST:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "x-goog-user-project: PROJECT_NUMBER" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs?liveConfigId=LIVE_CONFIG_ID"

PowerShell (Windows)

Observação: verifique se você definiu a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho do arquivo de chave privada da conta de serviço.

Salve o corpo da solicitação em um arquivo chamado request.json. Execute o comando a seguir no terminal para criar ou substituir esse arquivo no diretório atual:

@'
{
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
  },
  "adTracking": "AD_TRACKING"
}
'@  | Out-File -FilePath request.json -Encoding utf8

Depois execute o comando a seguir para enviar a solicitação REST:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs?liveConfigId=LIVE_CONFIG_ID" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.common.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID",
    "verb": "create"
  },
  "done": false
}

A API Video Stitcher registra de maneira assíncrona a configuração na sua conta do Ad Manager. Esse processo poderá levar alguns minutos.

Esse comando cria uma operação de longa duração (LRO, na sigla em inglês) que você pode consultar para rastrear o progresso. Para mais informações, consulte Verificar o resultado.

Acessar a configuração

Para ver a configuração, use o método projects.locations.liveConfigs.get.

Antes de usar os dados da solicitação, faça as substituições a seguir:

• PROJECT_NUMBER: o número do projeto do Google Cloud, localizado no campo Número do projeto na página Configurações do IAM
• LOCATION: o local da configuração ativa. Use uma das regiões com suporte.
  Mostrar locais
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• LIVE_CONFIG_ID: o identificador definido pelo usuário para a configuração ativa

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login , ou usando o Cloud Shell, que automaticamente conecta você à CLI gcloud . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID"

PowerShell (Windows)

Observação: O comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID",
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
    "assetKey": "ASSET_KEY",
    "customAssetKey": "PROJECT_NUMBER-LOCATION-LIVE_CONFIG_ID"
  },
  "state": "READY",
  "adTracking": "CLIENT",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "stitchingPolicy": "CUT_CURRENT"
}

Encontre o campo customAssetKey e copie o CUSTOM_ASSET_KEY retornado. Você envia esses valores para o SDK do Interactive Media Ads (IMA) em uma etapa subsequente.