Transferências do proprietário do conteúdo do YouTube

Com o serviço de transferência de dados do BigQuery para YouTube, você programa e gerencia automaticamente jobs de carga recorrentes para relatórios do proprietário do conteúdo do YouTube.

Relatórios compatíveis

O serviço de transferência de dados do BigQuery para relatórios do proprietário do conteúdo do YouTube é compatível atualmente com as opções de relatório a seguir:

Para informações sobre como os relatórios do proprietário do conteúdo do YouTube são transformados em tabelas e visualizações do BigQuery, consulte Transformações de relatórios do proprietário do conteúdo do YouTube.

Opção de relatório Suporte
Versão da API compatível 18 de junho de 2018
Programação

Diariamente, por volta das 14:45 UTC

Você pode configurar a hora do dia

Atualizar janela

Último dia

Não configurável.

Duração máxima do preenchimento

30 dias

Desde julho de 2018, os relatórios do YouTube que contêm dados históricos ficam disponíveis por 30 dias a partir do momento em que são gerados. (Os relatórios que contêm dados não históricos ficam disponíveis por 60 dias após a alteração da política.) Para mais informações, consulte Dados históricos na documentação da API de relatórios do YouTube.

Antes de começar

Antes de criar uma transferência do proprietário do conteúdo do YouTube:

  • verifique se você realizou todas as ações necessárias para ativar o serviço de transferência de dados do BigQuery;
  • crie um conjunto de dados do BigQuery para armazenar os dados do YouTube;
  • verifique se você tem uma conta de proprietário do conteúdo do YouTube. Um proprietário do conteúdo do YouTube não é o mesmo que um canal do YouTube. Normalmente, você só tem uma conta de proprietário de conteúdo do YouTube se administrar muitos canais diferentes;
  • Para criar transferências usando a IU da web do BigQuery clássica, permita pop-ups de bigquery.cloud.google.com para ver a janela de permissões. Você precisa permitir que o serviço de transferência de dados do BigQuery gerencie seus dados de relatórios do YouTube para que a transferência seja bem-sucedida;
  • as notificações de execução de transferência estão na versão Alfa. Se quiser configurar notificações de execução de transferência do Cloud Pub/Sub, você precisará ter permissões pubsub.topics.setIamPolicy. As permissões do Cloud Pub/Sub não serão necessárias caso você configure notificações por e-mail. Para mais informações, consulte Notificações de execução do serviço de transferência de dados do BigQuery.

Permissões exigidas

Certifique-se de que a pessoa que está criando a transferência tenha as seguintes permissões necessárias:

  • BigQuery:

    • as permissões bigquery.transfers.update para criar a transferência e as permissões bigquery.datasets.update no conjunto de dados de destino.

    O papel predefinido do IAM bigquery.admin para envolvidos no projeto inclui permissões bigquery.transfers.update e bigquery.transfers.update. Para mais informações sobre papéis do IAM no BigQuery, consulte Controle de acesso.

  • YouTube:

    • Gerente de conteúdo do YouTube ou proprietário de conteúdo do YouTube

    Um gerente de conteúdo tem direitos de administrar conteúdo do YouTube para o proprietário. Um proprietário do conteúdo é uma conta abrangente que tem um ou mais canais do YouTube e vídeos existentes neles.

    • Hide revenue data é desmarcada nas configurações do relatório do proprietário do conteúdo do YouTube.

    Para que os relatórios relacionados à receita sejam transferidos, a configuração de permissão de relatórios do YouTube Hide revenue data precisa ser desmarcada para o usuário que criou a transferência.

    youtube-content-owner-reports-uncheck-hide-revenue

Como configurar uma transferência do proprietário do conteúdo do YouTube

Configurar uma transferência do proprietário do conteúdo do YouTube exige um:

  • Código do proprietário do conteúdo: fornecido pelo YouTube. Seu código é exibido no URL após o= quando você faz login no YouTube como proprietário ou gerenciador do conteúdo. Por exemplo, se o URL for https://youtube.com/dashboard?0=AbCDE_8FghIjK, o ID do proprietário do conteúdo será AbCDE_8FghIjK. Consulte Definir configurações de conta do Gerenciador de conteúdo para mais informações sobre esse assunto.
  • Sufixo de tabela: um nome fácil de usar para o canal, fornecido por você ao configurar a transferência. O sufixo é anexado ao código do job para criar o nome da tabela, por exemplo [reportTypeId]_[suffix]. O sufixo é usado para evitar transferências separadas da gravação nas mesmas tabelas. O sufixo da tabela tem que ser único em todas as transferências que carregam dados para o mesmo conjunto de dados, e o sufixo tem que ser curto para reduzir o comprimento do nome de tabela resultante.

Se você estiver usando a API YouTube Reporting no momento e tiver jobs de relatórios atuais, o serviço de transferência de dados do BigQuery carregará os dados de relatório. Se você não tiver jobs de relatórios existentes, configurar a transferência ativará automaticamente a geração de relatórios do YouTube.

Para configurar uma transferência do proprietário do conteúdo do YouTube:

Console

  1. Acesse a IU da Web do BigQuery.

    Acessar a IU da Web do BigQuery

  2. Clique em Transferências.

  3. Clique em + CRIAR.

  4. Na página Criar transferência, siga estas etapas:

    • Na seção Tipo de origem, em Origem, escolha Proprietário de conteúdo do YouTube.

      Origem da transferência

    • Na seção Nome da configuração de transferência, em Nome de exibição, insira um nome para a transferência, como My Transfer. Esse nome pode ter qualquer valor que identifique facilmente a transferência, caso seja necessário modificá-la futuramente.

      Nome da transferência

    • Na seção Opções de agendamento, para Agendamento, deixe o valor padrão (Iniciar agora) ou clique em Iniciar em um horário definido.

      • Para Repetições, escolha uma opção para a frequência de execução da transferência.
        • Diariamente (padrão)
        • Semanalmente
        • Mensalmente
        • Personalizada
        • Sob demanda
      • Para Data e hora de início, insira a data e a hora para iniciar a transferência. Se você escolher Iniciar agora, essa opção ficará desativada.

        Programação de transferência

    • Na seção Configurações de destino, para o Conjunto de dados de destino, escolha o conjunto de dados criado para armazenar seus dados.

      Conjunto de dados da transferência

    • Na seção Detalhes da origem dos dados, siga estas etapas:

      • Insira o código respectivo em Código de proprietário do conteúdo.
      • Em Sufixo de tabela, insira um sufixo como MT.

        Detalhes da origem do proprietário do conteúdo do YouTube

    • (Opcional) Na seção Opções de notificação, siga estas etapas:

      • Clique no botão para ativar as notificações por e-mail. Quando você ativa essa opção, o administrador de transferência recebe uma notificação por e-mail quando uma execução de transferência falha.
      • Em Selecionar um tópico do Cloud Pub/Sub, escolha o nome do seu tópico ou clique em Criar um tópico. Essa opção configura notificações de execução do Cloud Pub/Sub para sua transferência. As notificações de execução de transferência estão em Alfa.
  5. Clique em Salvar.

IU clássica

  1. Acesse a IU da Web do BigQuery.

    Acessar a IU da Web do BigQuery

  2. Clique em Transferências.

  3. Clique em Adicionar transferência.

  4. Na página Nova transferência:

    • Em Origem, escolha Proprietário do conteúdo do YouTube.
    • Em Nome de exibição, insira um nome para a transferência, por exemplo, My Transfer. Esse nome pode ter qualquer valor que identifique facilmente a transferência, caso seja necessário modificá-la futuramente.
    • Em Programação, mantenha o valor padrão ou clique em Editar e altere a hora.

      Programação personalizada de transferência do proprietário do conteúdo

    • Em Conjunto de dados de destino, escolha o conjunto de dados apropriado.

    • Insira o código respectivo em Código de proprietário do conteúdo.

    • Em Sufixo de tabela, insira um sufixo como MT.

    • Marque Configurar jobs para permitir que o serviço de transferência do BigQuery gerencie jobs de relatórios do YouTube para você. Se houver relatórios do YouTube que atualmente não existam em sua conta, novos jobs de relatório são criados para ativá-los.

      Programação padrão de transferência do proprietário do conteúdo

    • (Opcional) Expanda a seção Avançado e configure as notificações de execução da transferência. As notificações de execução de transferência estão em Alfa.

      • No tópico do Cloud Pub/Sub, insira o nome do tópico, como projects/myproject/topics/mytopic.
      • Marque Enviar notificações por e-mail para permitir notificações por e-mail sobre falhas na execução da transferência.
      • Não selecione a opção Desativada ao configurar uma transferência. Consulte Como trabalhar com transferências para desativar transferências existentes.

        Tópico do Cloud Pub/Sub

  5. Clique em Adicionar.

  6. Quando solicitado, clique em Permitir para conceder ao serviço de transferência de dados do BigQuery a permissão para visualizar os dados de relatórios do YouTube e acessar e gerenciar os dados no BigQuery. É necessário permitir pop-ups de bigquery.cloud.google.com para ver a janela de permissões.

    Permitir transferência

Linha de comando

Digite o comando bq mk e forneça a sinalização de criação da transferência --transfer_config. As sinalizações abaixo também são obrigatórias:

  • --data_source
  • --target_dataset
  • --display_name
  • --params

    bq mk --transfer_config --project_id=[PROJECT_ID] --target_dataset=[DATASET] --display_name=[NAME] --params='[PARAMETERS]' --data_source=[DATA_SOURCE]
    

Em que:

  • --project_id é o código do seu projeto;
  • --target_dataset é o conjunto de dados de destino para a configuração de transferência;
  • --display_name é o nome de exibição para a configuração de transferência. Esse nome pode ter qualquer valor que identifique facilmente a transferência, caso seja necessário modificá-la futuramente.
  • --params contém os parâmetros para a configuração da transferência criada no formato JSON. Por exemplo: --params='{"param":"param_value"}'. Para as transferências do proprietário do conteúdo do YouTube, você precisa fornecer os parâmetros content_owner_id e table_suffix. Você pode, opcionalmente, configurar o parâmetro configure_jobs como true para permitir que o BigQuery Transfer Service gerencie jobs de relatórios do YouTube para você. Se houver relatórios do YouTube que atualmente não existem para sua conta, novos jobs de relatório são criados para ativá-los.
  • --data_source é a fonte de dados: youtube_content_owner.

É possível também fornecer a sinalização --project_id para especificar um determinado projeto. Caso o --project_id não seja especificado, será usado o projeto padrão.

Por exemplo, o comando a seguir cria uma transferência do proprietário do conteúdo do YouTube denominada My Transfer usando o código do proprietário do conteúdo AbCDE_8FghIjK, o sufixo de tabela MT e o conjunto de dados de destino mydataset. A transferência é criada no projeto padrão:

bq mk --transfer_config --target_dataset=mydataset --display_name='My Transfer' --params='{"content_owner_id":"abCDE_8FghIjK","table_suffix":"MT","configure_jobs":"true"}' --data_source=youtube_content_owner

API

Use o método projects.locations.transferConfigs.create e forneça uma instância do recurso TransferConfig.

Como consultar seus dados

Quando os dados são transferidos para o BigQuery, eles são gravados em tabelas particionadas por tempo de processamento. Para mais informações, consulte Tabelas particionadas.

Use a pseudocoluna _PARTITIONTIME para consultar suas tabelas diretamente em vez de usar visualizações geradas automaticamente. Para mais informações, consulte Como consultar tabelas particionadas.

Solução de problemas da configuração de transferência do proprietário do conteúdo do YouTube

Em caso de problemas ao configurar a transferência, consulte Problemas de transferência no YouTube em Solução de problemas da configuração de transferência do serviço de transferência de dados do BigQuery.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.