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

Para a integração com o Ad Manager, você precisa criar uma configuração ativa para um determinado evento de transmissão ao vivo. A API Video Stitcher registra essa configuração no Ad Manager.

Criar uma placa

Antes de criar a configuração ao vivo, você precisa criar uma placa. A API Video Stitcher insere um vídeo de quadro padrão quando não é possível inserir anúncios. Você precisa registrar o vídeo de sinalização com a API Video Stitcher para indicar o slate a ser usado na ausência de anúncios. O vídeo de ardósia pode ser qualquer arquivo MP4 com pelo menos uma faixa de áudio.

Você tem duas opções para criar essa lista. Você pode criar uma imagem de rede padrão na sua conta do Ad Manager ou criar imagens usando a API Video Stitcher.

Criar uma prancha no Ad Manager

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

Criar uma placa usando a API Video Stitcher

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

Antes de usar os dados da solicitação abaixo, 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 você vai criar a lousa. Use uma das regiões compatíveis.
  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 lousa. O ID só pode conter letras minúsculas, números e hifens. O primeiro caractere precisa ser uma letra, o último caractere precisa ser uma letra ou um número, e o ID inteiro tem no máximo 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. Você pode encontrá-lo nas Configurações globais da conta do editor
  Importante:é necessário incluir o objeto gamSlate para usar a plataforma 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 faz login automaticamente na 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 pode ser consultada para acompanhar o progresso. Copie o OPERATION_ID retornado, que é a última parte do campo name, para usar na próxima seção.

Verificar o resultado

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

Antes de usar os dados da solicitação abaixo, 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 faz login automaticamente na 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 em tempo real

Para criar a configuração, use o método projects.locations.liveConfigs.create. Consulte a documentação de referência da configuração em tempo real para conferir os campos opcionais (como cabeçalhos personalizados).

Antes de usar os dados da solicitação abaixo, 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 você vai criar a configuração em tempo real. Use uma das regiões compatíveis.
  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 em tempo real. O ID só pode conter letras minúsculas, números e hifens. O primeiro caractere precisa ser uma letra, o último caractere precisa ser uma letra ou um número, e o ID inteiro tem no máximo 63 caracteres.
• SOURCE_LIVESTREAM_URI: o URL de origem do manifesto do vídeo da transmissão ao vivo. Ele precisa ser acessível para a API Video Stitcher. O URL precisa ser acessível publicamente ou, se a assinatura de URL estiver ativada para o CDN, uma chave de CDN registrada precisa ter sido 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

  : o URL dos metadados do anúncio extraídos dos servidores de anúncios. Para a integração do Ad Manager, ele precisa ser uma tag de anúncio de 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áfego em tempo real, ative essa opção.
  • Para o tipo de SDK do player, selecione SDK do IMA do Google.
  • Adicione o parâmetro ad_rule=0 à tag. Por exemplo, adicione &ad_rule=0 ao final.
• SLATE_ID: o ID da plataforma a ser usada na ausência de anúncios unidos
  Observação:se você criou uma plataforma de rede padrão usando o Ad Manager, remova o campo defaultSlate da solicitação para usar a plataforma de rede padrão.
• NETWORK_CODE: o identificador numérico da sua rede do Ad Manager. Você pode encontrá-lo nas Configurações globais da conta do editor.
• AD_TRACKING: o comportamento de rastreamento de anúncios para o stream. Para integrações do SDK do IMA, use CLIENT. Para o rastreamento de anúncios do lado do servidor, use SERVER. 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 no 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 no 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 forma 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 pode ser consultada para acompanhar o progresso. Para mais informações, consulte Verificar o resultado.

Acessar a configuração

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

Antes de usar os dados da solicitação abaixo, 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 em tempo real. 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 em tempo real

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 faz login automaticamente na 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ê vai enviar esses valores ao SDK do Interactive Media Ads (IMA) em uma etapa posterior.