Crie uma configuração para um evento de stream em direto

Para a integração do Ad Manager, tem de criar uma configuração em direto para um determinado evento de stream em direto. A API Video Stitcher regista esta configuração no Ad Manager.

Crie uma faixa

Antes de criar a configuração em direto, tem de criar uma faixa. A API Video Stitcher insere um vídeo de faixa predefinido quando não é possível inserir anúncios. Tem de registar o vídeo de faixa com a API Video Stitcher para indicar a faixa a usar na ausência de anúncios. O vídeo de indicação pode ser qualquer ficheiro MP4 com, pelo menos, uma faixa de áudio.

Tem duas opções para criar esta indicação. Pode criar uma lista de conteúdos padrão na sua conta do Ad Manager ou criar listas de conteúdos através da API Video Stitcher.

Crie uma lista de reprodução no Ad Manager

Para criar uma faixa de rede predefinida na sua conta do Ad Manager, siga os passos em Criar uma faixa para preencher lacunas de conteúdo e, em seguida, avance para a secção Criar a configuração em direto.

Crie uma indicação de conteúdo usando a API Video Stitcher

Para criar uma lista de reprodução com a API Video Stitcher, use o método projects.locations.slates.create.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_NUMBER: o seu Google Cloud número do projeto; este encontra-se no campo Número do projeto na página Definições de IAM
• LOCATION: a localização na qual criar a sua lista; use uma das regiões suportadas
  Mostrar localizações
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• SLATE_ID: um identificador definido pelo utilizador para a lista de programas. Este ID só pode conter letras minúsculas, números e hífenes. O primeiro caráter tem de ser uma letra, o último caráter tem de ser uma letra ou um número, e o ID completo tem um máximo de 63 carateres.
• 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. Pode encontrá-lo nas Definições globais da conta de publicador
  Importante: tem de incluir o objeto gamSlate para usar a lista de programas com o Google Ad Manager (GAM).

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro denominado request.json. Execute o seguinte comando no terminal para criar ou substituir este ficheiro no diretório atual:

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

Em seguida, execute o seguinte comando para enviar o seu pedido 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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro denominado request.json. Execute o seguinte comando no terminal para criar ou substituir este ficheiro no diretório atual:

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

Em seguida, execute o seguinte comando para enviar o seu pedido 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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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
}

Este comando cria uma operação de longa duração (LRO) que pode consultar para acompanhar o progresso. Copie o valor devolvido OPERATION_ID, que é a última parte do campo name, para usar na secção seguinte.

Verifique o resultado

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

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_NUMBER: o número do seu Google Cloud projeto; encontra-se no campo Número do projeto na página Definições de IAM
• LOCATION: a localização dos dados; use uma das regiões suportadas
  Mostrar localizações
  • 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 o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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"
    }
  }
}

Crie a configuração em direto

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

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_NUMBER: o seu Google Cloud número do projeto; este encontra-se no campo Número do projeto na página Definições de IAM
• LOCATION: a localização na qual criar a configuração em direto; use uma das regiões suportadas
  Mostrar localizações
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• LIVE_CONFIG_ID: um identificador definido pelo utilizador para a configuração em direto. Este ID só pode conter letras minúsculas, números e hífenes. O primeiro caráter tem de ser uma letra, o último caráter tem de ser uma letra ou um número, e o ID completo tem um máximo de 63 carateres.
• SOURCE_LIVESTREAM_URI: o URL de origem do manifesto do vídeo da stream em direto. Tem de estar acessível à API Video Stitcher. O URL tem de ser acessível publicamente ou, se a assinatura de URLs estiver ativada para a RFC, ter sido fornecida uma chave registada da RFC à API Video Stitcher. Se criou uma stream em direto de teste através da API Live Stream, este é o URI do ficheiro main.m3u8 ou main.mpd no contentor do Cloud Storage.
• AD_TAG_URI

  o URL dos metadados dos anúncios obtidos a partir de servidores de anúncios; para a integração do Ad Manager, tem de ser uma etiqueta do anúncio de vídeo em direto do Ad Manager válida. Para obter uma etiqueta do anúncio válida, siga os passos em Gere etiquetas de anúncios de vídeo e áudio com estas modificações:
  • Para Tráfego em direto, ative o tráfego em direto.
  • Para o Tipo de SDK do leitor, selecione SDK para IMA da Google.
  • Adicione o parâmetro ad_rule=0 à etiqueta (por exemplo, adicione &ad_rule=0 ao final).
• SLATE_ID: o ID da apresentação rápida a usar na ausência de anúncios incorporados.
  Nota: se criou uma apresentação rápida de rede predefinida através do Ad Manager, remova o campo defaultSlate do pedido para usar a apresentação rápida de rede predefinida.
• NETWORK_CODE: o identificador numérico da sua rede do Ad Manager. Pode encontrá-lo nas Definições globais da conta de publicador.
• AD_TRACKING: o comportamento de acompanhamento de anúncios para a sua stream. Para integrações do SDK para IMA, use CLIENT. Para o acompanhamento de anúncios do lado do servidor, use SERVER. Também pode substituir este valor por sessão mais tarde.

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: Certifique-se de que definiu a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS para o caminho do ficheiro de chave privada da sua conta de serviço.

Guarde o corpo do pedido num ficheiro denominado request.json. Execute o seguinte comando no terminal para criar ou substituir este ficheiro 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

Em seguida, execute o seguinte comando para enviar o seu pedido 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)

Nota: Certifique-se de que definiu a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS para o caminho do ficheiro de chave privada da sua conta de serviço.

Guarde o corpo do pedido num ficheiro denominado request.json. Execute o seguinte comando no terminal para criar ou substituir este ficheiro 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

Em seguida, execute o seguinte comando para enviar o seu pedido 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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 regista de forma assíncrona a configuração na sua conta do Ad Manager. Este processo pode demorar alguns minutos.

Este comando cria uma operação de longa duração (LRO) que pode consultar para acompanhar o progresso. Para mais informações, consulte a secção Verifique o resultado.

Obtenha a configuração

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

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_NUMBER: o seu Google Cloud número do projeto; este encontra-se no campo Número do projeto na página Definições de IAM
• LOCATION: a localização da configuração em direto; use uma das regiões suportadas
  Mostrar localizações
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• LIVE_CONFIG_ID: o identificador definido pelo utilizador para a configuração em direto

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 valor devolvido CUSTOM_ASSET_KEY. Envia estes valores para o SDK para Anúncios Multimédia Interativos (IMA) num passo subsequente.