Preparar o aplicativo cliente para funcionar com o Google Ad Manager
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Coletar as informações necessárias para seus aplicativos de cliente
Você precisa ter as seguintes informações para que o Google Ad Manager crie uma sessão de transmissão ao vivo:
Campo
Descrição
projectNumber
O número do projeto Google Cloud (PROJECT_NUMBER) usado para criar sessões ativadas pelo Ad Manager. Também é possível usar o ID do projeto.
region
O
local
(LOCATION)
em que a configuração ativa é registrada.
liveConfigId
O
ID de configuração ao vivo usado para
registrar o evento de transmissão ao vivo com a API Video Stitcher. Confira a seguir o formato do nome completo do recurso de configuração:
O ID de configuração é a última parte do nome completo
(LIVE_CONFIG_ID). O local da configuração precisa ser o mesmo em que você cria a sessão.
customAssetKey
A chave de recurso personalizada
(CUSTOM_ASSET_KEY)
criada durante o registro de configuração ao vivo. O
SDK do IMA precisa desse valor para criar a transmissão.
networkCode
O identificador numérico
(NETWORK_CODE) da
sua rede do Ad Manager.
oAuthToken
Um token OAuth de curta duração para a
conta de serviço com o papel Usuário do Video Stitcher. Consulte
Gerar tokens OAuth de curta duração.
Tabela 1. Informações obrigatórias para sessões de transmissão ao vivo ativadas pelo Ad Manager
Extraia o token do portador OAuth 2.0 da conta de serviço:
gcloudauthprint-access-token
Como esse é um token de curta duração, é necessário gerá-lo novamente
periodicamente com o comando gcloud auth print-access-token e enviar os novos
tokens aos aplicativos cliente. Consulte a seção a seguir para mais
informações sobre como criar um serviço de produção para fornecer tokens de curta duração.
Criar um serviço para fornecer informações aos aplicativos cliente
Crie um serviço que possa fornecer as informações necessárias para serem transmitidas ao
cliente. Quando o aplicativo solicitar informações do seu serviço sobre como
reproduzir uma transmissão ao vivo, o serviço precisará retornar as informações descritas na
Tabela 1.
Em particular, o serviço precisa ser capaz de fornecer tokens OAuth a
aplicativos clientes de maneira segura. Configure esse serviço usando duas contas de serviço, uma
imitando a outra.
Uma conta de serviço tem o papel de Criador de token de serviço e cria um token OAuth
para a conta de serviço que tem o papel de Usuário do Video Stitcher. Exemplo:
Conta de serviço 1: é a conta de serviço do autor da chamada. Essa conta tem a permissão de criador de token do serviço na conta de serviço 2 e representa a conta de serviço 2 para aplicativos clientes.
Conta de serviço 2: é a conta de serviço com privilégios que tem o papel de
usuário do Video Stitcher para criar sessões.
Para informações sobre como fornecer um token OAuth do seu serviço, incluindo exemplos de código da
biblioteca de cliente, consulte
Criar um token de acesso de curta duração.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[],[],null,["# Prepare for your client application to work with Google Ad Manager\n\nCollect the required information for your client applications\n-------------------------------------------------------------\n\nYou should have the following information that is required for\nGoogle Ad Manager to create a live stream session:\n\n**Table 1.** Required information for Ad Manager-enabled live stream sessions\n\nGenerate short-lived OAuth tokens for testing\n---------------------------------------------\n\nTo generate a\n[short-lived OAuth token](/iam/docs/creating-short-lived-service-account-credentials)\nassociated with the\n[service account](/video-stitcher/docs/how-to/gam/before-you-begin#create-service-account-to-create-sessions) with the **Video Stitcher User** role, follow\nthese steps:\n\n1. Replace \u003cvar translate=\"no\"\u003ePATH_TO_YOUR_SERVICE_KEY\u003c/var\u003e with the path to the JSON file you downloaded to your local machine. \n\n ```bash\n gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY\n ```\n2. Retrieve the OAuth 2.0 bearer token from the service account: \n\n ```bash\n gcloud auth print-access-token\n ```\n\nBecause this is a short-lived token, you need to generate it again\nperiodically with the `gcloud auth print-access-token` command and send the new\ntokens to your client applications. See the following section for more\ninformation on building a production service to provide short-lived tokens.\n| **Important:** Regenerating an OAuth token is a time-consuming operation. Try to reuse an OAuth token as much as possible when creating sessions. You can extend the lifetime of a token using the [`--lifetime` flag](/sdk/gcloud/reference/auth/application-default/print-access-token).\n\nCreate a service to provide information to your client applications\n-------------------------------------------------------------------\n\nCreate a service that can provide the required information to be passed to the\nclient. When the application requests information from your service on how to\nplay a live stream, the service should return the information described in\n[Table 1](#collect-info).\n\nIn particular, the service must be able to provide OAuth tokens to\nclient applications in a secure manner. Configure this service using two service\naccounts, one\n[impersonating the other](/docs/authentication/use-service-account-impersonation).\nOne service account has the **Service Token Creator** role and creates an OAuth\ntoken for the service account that has the **Video Stitcher User** role. For\nexample:\n\n- Service account 1: This is the caller service account. This account has the **Service Token Creator** permission on service account 2 and impersonates service account 2 to client applications.\n- Service account 2: This is the privilege-bearing service account that has the **Video Stitcher User** role to create sessions.\n\nFor information on providing an OAuth token from your service, including client\nlibrary code samples, see\n[Create a short-lived access token](/iam/docs/create-short-lived-credentials-direct#sa-credentials-oauth)."]]
