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 Reporting do YouTube.

Antes de começar

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

Permissões exigidas

A pessoa que está criando a transferência precisa ter as seguintes permissões necessárias:

  • BigQuery:

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

    O papel bigquery.admin predefinido do IAM para envolvidos no projeto inclui as permissões bigquery.transfers.update e bigquery.datasets.update. Para mais informações sobre os papéis do IAM no serviço de transferência de dados do BigQuery, consulte a Referência de 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 está desmarcado nas configurações do relatório de Proprietário do conteúdo do YouTube.

    Para que os relatórios relacionados à receita sejam transferidos, o YouTube informa que a configuração de permissão Hide revenue data deve ser desmarcada para o usuário que está criando 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:

  • ID do proprietário do conteúdo: fornecido pelo YouTube. Quando você faz login no YouTube como um Proprietário ou Gerenciador de conteúdo, seu ID aparece no URL após o=. Por exemplo, se o URL for https://youtube.com/dashboard?0=AbCDE_8FghIjK, o ID do proprietário do conteúdo é AbCDE_8FghIjK. Para mais informações sobre sua conta do Gerenciador de conteúdo, consulte: Configurações da conta do Gerenciador de conteúdo.
  • Sufixo de tabela: um nome fácil de usar para o canal, que você especifica ao configurar a transferência. O sufixo é anexado ao ID do job para criar o nome da tabela, por exemplo, reportTypeId_suffix. O sufixo é usado para evitar que transferências separadas gravem nas mesmas tabelas. O sufixo da tabela precisa ser único em todas as transferências que carregam dados no mesmo conjunto de dados. Além disso, o sufixo precisa ser curto para reduzir o comprimento do nome da tabela resultante.

Se você usa a API Reporting do YouTube no momento e tem 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ório existentes, configurar a transferência ativará automaticamente os jobs de relatório do YouTube.

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

Console

  1. Acesse a página do BigQuery no Console do Cloud.

    Acessar a página do BigQuery

  2. Clique em Transferências.

  3. Clique em Criar transferência.

  4. Na página Criar transferência, siga estas instruções:

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

      Origem da transferência

    • No campo Nome da configuração de transferência da seção 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 programação, não altere o valor padrão de Programação (Começar agora). Se preferir, clique em Começar no horário definido.

      • Em Repetições, escolha uma opção para a frequência de execução da transferência:
        • Diário (padrão)
        • Semanal
        • Mensal
        • Personalizada
        • Sob demanda
      • Em 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 da transferência

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

      Conjunto de dados da transferência

    • Na seção Detalhes da origem de dados:

      • Insira o ID respectivo em ID 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:

      • 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 se uma execução de transferência falhar.
      • Em Selecionar um tópico do Pub/Sub, escolha o nome do tópico ou clique em Criar um tópico. Essa opção configura notificações de execução do Pub/Sub da sua transferência.
  5. Clique em Salvar.

bq

Insira o comando bq mk e forneça a sinalização de execução da transferência --transfer_config. As sinalizações a seguir 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 ID do projeto.
  • dataset é o conjunto de dados de destino na configuração da transferência.
  • name é o nome de exibição da configuração de transferência. Esse nome pode ser qualquer valor que identifique facilmente a transferência, caso seja necessário modificá-la futuramente.
  • parameters contém os parâmetros da configuração da transferência criada no formato JSON. Por exemplo: --params='{"param":"param_value"}'. Para transferências do proprietário do conteúdo do YouTube, você precisa fornecer os parâmetros content_owner_id e table_suffix. Opcionalmente, defina o parâmetro configure_jobs como true para permitir que o BigQuery Transfer Service gerencie os jobs de relatórios do YouTube para você. Se houver relatórios do YouTube que atualmente não existam na sua conta, novos jobs de relatório serão criados para ativá-los;
  • data_source é a fonte de dados: youtube_content_owner.

Também é possível fornecer a sinalização --project_id para especificar um projeto específico. Se --project_id não for especificado, o projeto padrão será usado.

Por exemplo, o comando a seguir cria uma transferência do proprietário do conteúdo do YouTube chamada My Transfer usando o ID do proprietário do conteúdo AbCDE_8FghIjK, o sufixo MT da tabela e o conjunto de dados 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, veja Como consultar tabelas particionadas.

Como solucionar 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 na transferência do YouTube, em Solução de problemas de configuração do serviço de transferência de dados do BigQuery.