Detalhes da Conexão do YouTube Analytics¶

Introdução¶

Versão do conector

Esta documentação é baseada na versão 22.0.8510 do conector.

Começando¶

Suporte à versão do YouTube Analytics

O conector usa a versão 2 da API do YouTube Analytics.

Estabelecendo uma Conexão¶

Conectando-se ao YouTube Analytics¶

Forneça as seguintes propriedades de conexão antes de adicionar as propriedades de autenticação.

• ChannelId: Definido como o ID de um canal do YouTube. Se não for especificado, os dados serão retornados para o canal do usuário autenticado.
• ContentOwnerId: Defina se você deseja gerar relatórios do proprietário do conteúdo.

Autenticação no YouTube Analytics¶

Todas as conexões com o YouTube Analytics são autenticadas usando OAuth. O conector oferece suporte ao uso de contas de usuário, contas de serviço e contas de instância do GCP para autenticação.

Contas de Usuário¶

AuthScheme deve ser definido como OAuth em todos os fluxos da conta do usuário. Para aplicativos de desktop, o aplicativo incorporado do conector é a maneira mais simples de autenticação. O único requisito adicional é definir InitiateOAuth para GETANDREFRESH.

Quando o driver iniciar, ele abrirá um navegador e o YouTube Analytics solicitará suas informações de login. O conector usará as credenciais que você fornecer para acessar seus dados do YouTube Analytics. Essas credenciais serão salvas e atualizadas automaticamente conforme necessário. Para aplicativos de desktop, o aplicativo padrão do conector é a maneira mais simples de autenticação. O único requisito adicional é definir InitiateOAuth para GETANDREFRESH.

Quando o driver iniciar, ele abrirá um navegador e o YouTube Analytics solicitará suas informações de login. O conector usará as credenciais fornecidas por você para acessar seus dados do YouTube Analytics. Essas credenciais serão salvas e atualizadas automaticamente conforme necessário.

Contas de Serviço¶

Para autenticar usando uma conta de serviço, você deve criar uma nova conta de serviço e ter uma cópia do certificado de contas.

Para um arquivo JSON, você precisará definir estas propriedades:

• AuthScheme: Obrigatório. Defina isso como OAuthJWT.
• InitiateOAuth: Obrigatório. Defina isso como GETANDREFRESH.
• OAuthJWTCertType: Obrigatório. Defina isso como GOOGLEJSON.
• OAuthJWTCert: Obrigatório. Defina isso como o caminho para o arquivo .json fornecido pelo Google.
• OAuthJWTSubject: Opcional. Defina esse valor apenas se a conta de serviço fizer parte de um domínio G Suite e você quiser habilitar a delegação. O valor desta propriedade deve ser o endereço e-mail do usuário cujos dados você deseja acessar.

Para um arquivo PFX, você precisará definir estas propriedades:

• AuthScheme: Obrigatório. Defina isso como OAuthJWT.
• InitiateOAuth: Obrigatório. Defina isso como GETANDREFRESH.
• OAuthJWTCertType: Obrigatório. Defina isso como PFXFILE.
• OAuthJWTCert: Obrigatório. Defina isso como o caminho para o arquivo .pfx fornecido pelo Google.
• OAuthJWTCertPassword: Opcional. Defina isso como a senha do arquivo .pfx. Na maioria dos casos, isso precisará ser fornecido, pois o Google criptografa os certificados PFX.
• OAuthJWTCertSubject: Opcional. Defina isso apenas se você estiver usando um OAuthJWTCertType que armazena vários certificados. Não deve ser definido para certificados PFX gerados pelo Google.
• OAuthJWTIssuer: Obrigatório. Defina isso como o endereço e-mail da conta de serviço. Este endereço geralmente incluirá o domínio iam.gserviceaccount.com.
• OAuthJWTSubject: Opcional. Defina esse valor apenas se a conta de serviço fizer parte de um domínio G Suite e você quiser habilitar a delegação. O valor desta propriedade deve ser o endereço e-mail do usuário cujos dados você deseja acessar.

Se você ainda não tiver uma conta de serviço, poderá criar uma seguindo o procedimento em Criando um aplicativo personalizado do AzureAD.

Contas de Instância do GCP¶

Ao executar em uma máquina virtual GCP, o conector pode autenticar usando uma conta de serviço vinculada à máquina virtual. Para usar este modo, defina AuthScheme para GCPInstanceAccount.

Usando Autenticação OAuth¶

Use o padrão de autenticação OAuth para se conectar ao YouTube Analytics. Você pode autenticar com uma conta de usuário ou uma conta de serviço. O conector facilita isso conforme descrito abaixo.

Contas de Usuário¶

O fluxo da conta do usuário exige que o usuário autenticado interaja com o YouTube Analytics por meio do navegador.

Credenciais Incorporadas¶

Consulte Credenciais incorporadas para se conectar com as credenciais incorporadas do conector e pule a criação de um aplicativo OAuth personalizado.

Credenciais Personalizadas¶

Em vez de se conectar com as credenciais incorporadas do conector, você pode registrar um aplicativo para obter o OAuthClientId e OAuthClientSecret.

Quando Criar um Aplicativo OAuth Personalizado¶

A criação de um aplicativo OAuth personalizado é opcional, pois o conector já está registrado no YouTube Analytics e você pode se conectar com suas credenciais incorporadas. Talvez você queira criar um aplicativo OAuth personalizado para alterar as informações exibidas quando os usuários fazem login no endpoint OAuth do YouTube Analytics para conceder permissões ao conector.

Usando uma Conta de Serviço para Se Conectar ao YouTube Analytics¶

As contas de serviço têm autenticação silenciosa, sem autenticação do usuário no navegador. Você também pode usar uma conta de serviço para delegar escopos de acesso em toda a empresa ao conector.

Você precisa criar um aplicativo OAuth neste fluxo. Você pode se conectar aos dados do YouTube Analytics que a conta de serviço tem permissão para acessar. Consulte Credenciais personalizadas para obter um guia de autenticação.

Criando um Aplicativo OAuth Personalizado¶

Consulte Criando um aplicativo OAuth personalizado para um procedimento.

Credenciais Incorporadas¶

Credenciais OAuth Incorporadas¶

Autenticação de Desktop com o Aplicativo OAuth Incorporado¶

Você pode se conectar sem definir nenhuma propriedade de conexão para suas credenciais de usuário. Depois de definir o seguinte, você está pronto para se conectar:

• InitiateOAuth: Defina como GETANDREFRESH. Você pode usar InitiateOAuth para evitar repetir a troca de OAuth e configurar manualmente o OAuthAccessToken.
• ChannelId: Defina para o ID de um canal do YouTube. Se não for especificado, os dados serão retornados para o canal do usuário autenticado.
• ContentOwnerId: Defina para o ID do proprietário do conteúdo se desejar gerar relatórios do proprietário do conteúdo.

Quando você conecta, o conector abre o endpoint OAuth em seu navegador padrão. Faça login e conceda permissões ao aplicativo. O conector então conclui o processo OAuth.

1. Extrai o token de acesso do URL de retorno de chamada e autentica as solicitações.
2. Obtém um novo token de acesso quando o antigo expira.
3. Salva valores OAuth em OAuthSettingsLocation para ser persistido nas conexões.

Credenciais Personalizadas¶

Você pode usar um aplicativo OAuth personalizado para autenticar com uma conta de serviço ou uma conta de usuário. Consulte Usando autenticação OAuth Para maiores informações.

Contas de Usuário¶

Autenticação de Desktop com um Aplicativo OAuth Personalizado¶

Siga as etapas abaixo para autenticar com as credenciais de um aplicativo OAuth personalizado. Consulte Criando um aplicativo OAuth personalizado.

Obtenha e atualize o token de acesso OAuth

Depois de definir o seguinte, você está pronto para se conectar:

• OAuthClientId: Defina isso para o ID do cliente atribuído quando você registrou seu aplicativo.
• OAuthClientSecret: Defina isso para o segredo do cliente atribuído quando você registrou seu aplicativo.
• InitiateOAuth: Defina como GETANDREFRESH. Você pode usar InitiateOAuth para evitar repetir a troca de OAuth e configurar manualmente o OAuthAccessToken.
• ChannelId: Defina para o ID de um canal do YouTube. Se não for especificado, os dados serão retornados para o canal do usuário autenticado.
• ContentOwnerId: Defina se deseja gerar relatórios de proprietário de conteúdo.

Quando você conecta, o conector abre o endpoint OAuth em seu navegador padrão. Faça login e conceda permissões ao aplicativo. O conector então conclui o processo OAuth:

1. Extrai o token de acesso da URL de retorno de chamada e autentica as solicitações.
2. Atualiza o token de acesso quando ele expira.
3. Salva valores OAuth em OAuthSettingsLocation para ser persistido nas conexões.

Contas de Serviço¶

As contas de serviço têm autenticação silenciosa, sem autenticação do usuário no navegador. Você também pode usar uma conta de serviço para delegar escopos de acesso em toda a empresa ao conector.

Você precisa criar um aplicativo OAuth neste fluxo. Consulte Criando um aplicativo OAuth personalizado para criar e autorizar um aplicativo. Você pode se conectar aos dados do YouTube Analytics que a conta de serviço tem permissão para acessar.

Depois de definir as seguintes propriedades de conexão, você está pronto para se conectar:

• InitiateOAuth: Defina como GETANDREFRESH.
• OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o segredo do cliente nas configurações do aplicativo.
• OAuthJWTCertType: Defina isso como "PEMKEY_FILE".
• OAuthJWTCert: Defina isso como o caminho para o arquivo .pem que você gerou.
• OAuthJWTCertPassword: Defina isso como a senha do arquivo .pem.
• OAuthJWTCertSubject: Defina como "*" para escolher o primeiro certificado no armazenamento de certificados.
• OAuthJWTSubject: Defina como o endereço e-mail do usuário para quem o aplicativo está solicitando acesso delegado. Observe que o acesso delegado deve ser concedido por um administrador.
• ChannelId: Defina para o ID de um canal do YouTube. Se não for especificado, os dados serão retornados para o canal do usuário autenticado.
• ContentOwnerId: Defina se deseja gerar relatórios de proprietário de conteúdo.

Quando você conecta, o conector conclui o fluxo OAuth para uma conta de serviço.

1. Cria e assina o JWT com o conjunto de declarações exigido pelo conector.
2. Troca o JWT pelo token de acesso.
3. Salva valores OAuth em OAuthSettingsLocation para ser persistido nas conexões.
4. Envia o JWT para um novo token de acesso quando o token expira.

Máquinas Sem Cabeça¶

Usando OAuth em uma Máquina Sem Cabeça¶

As seções a seguir mostram como autenticar um servidor headless ou outra máquina na qual o conector não pode abrir um navegador. Você pode autenticar com uma conta de usuário ou com uma conta de serviço.

Contas de Usuário¶

Para autenticar com uma conta de usuário, você precisa autenticar de outra máquina. A autenticação é um processo de duas etapas.

1. Ao invés de instalar o conector em outra máquina, você pode seguir os passos abaixo para obter o OAuthVerifier valor. Ou você pode instalar o conector em outra máquina e transferir os valores de autenticação OAuth, depois de autenticar por meio do fluxo normal baseado em navegador.
2. Em seguida, você pode configurar o conector para atualizar automaticamente o token de acesso da máquina sem periféricos.

Você pode seguir o fluxo de autenticação OAuth headless usando as credenciais OAuth incorporadas do conector ou usando as credenciais OAuth para seu aplicativo OAuth personalizado.

Usando as Credenciais OAuth Incorporadas¶

Obtenha um código verificador

Siga as etapas abaixo para autenticar em outra máquina e obter o OAuthVerifier propriedade da conexão:

1. Clique no link a seguir para abrir o endpoint OAuth do YouTube Analytics em seu navegador.
2. Efetue login e conceda permissões ao conector. Você será redirecionado para o URL de retorno de chamada, que contém o código do verificador.
3. Salve o valor do código do verificador. Você definirá isso no OAuthVerifier propriedade de conexão.

Na máquina sem periféricos, defina as seguintes propriedades de conexão para obter os valores de autenticação OAuth.

• OAuthVerifier: Defina isso para o código do verificador.
• InitiateOAuth: Configure para ATUALIZAR.
• OAuthSettingsLocation: Defina para manter os valores de autenticação OAuth criptografados no arquivo especificado.

Depois que o arquivo de configurações OAuth for gerado, defina as seguintes propriedades para se conectar aos dados:

• OAuthSettingsLocation: Defina isso para o arquivo que contém os valores de autenticação OAuth criptografados. Certifique-se de que este arquivo forneça permissões de leitura e gravação ao conector para habilitar a atualização automática do token de acesso.
• InitiateOAuth: Configure para ATUALIZAR.
• ChannelId: Defina para o ID de um canal do YouTube. Se não for especificado, os dados serão retornados para o canal do usuário autenticado.
• ContentOwnerId: Defina para o ID do proprietário do conteúdo se desejar gerar relatórios do proprietário do conteúdo.

Configurações de transferência OAuth

Siga as etapas abaixo para instalar o conector em outra máquina, autenticar e depois transferir os valores OAuth resultantes.

Em uma segunda máquina, instale o conector e conecte-se com o seguinte conjunto de propriedades:

• OAuthSettingsLocation: Defina isso como um arquivo de texto gravável.
• InitiateOAuth: Defina como GETANDREFRESH.

Teste a conexão para autenticar no navegador. Os valores de autenticação resultantes são gravados, criptografados, no caminho especificado por OAuthSettingsLocation. Depois de testar a conexão com sucesso, copie o arquivo de configurações OAuth para sua máquina sem periféricos. Na máquina sem periféricos, defina as seguintes propriedades de conexão para se conectar aos dados:

• OAuthSettingsLocation: Defina isso como o caminho para o arquivo de configurações OAuth. Certifique-se de que este arquivo forneça permissões de leitura e gravação ao conector para habilitar a atualização automática do token de acesso.
• ChannelId: Defina para o ID de um canal do YouTube. Se não for especificado, os dados serão retornados para o canal do usuário autenticado.
• ContentOwnerId: Defina para o ID do proprietário do conteúdo se desejar gerar relatórios do proprietário do conteúdo.

Usando as Credenciais para um Aplicativo OAuth Personalizado¶

Crie um aplicativo OAuth personalizado

A criação de um aplicativo OAuth customizado é opcional no fluxo OAuth headless; você pode ignorar a criação de um aplicativo conectando-se com as credenciais OAuth incorporadas do conector. Talvez você queira criar um aplicativo OAuth personalizado para alterar as informações exibidas quando os usuários fazem login no YouTube Analytics para conceder permissões ao conector.

Consulte Criando um aplicativo OAuth personalizado para um procedimento. Você pode seguir os procedimentos abaixo para autenticar e conectar-se aos dados.

Obtenha um código verificador

Defina as seguintes propriedades na máquina sem periféricos:

• InitiateOAuth: Defina como DESLIGADO.
• OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o segredo do cliente nas configurações do aplicativo.

Você pode seguir as etapas abaixo para autenticar em outra máquina e obter o OAuthVerifier propriedade de conexão.

1. Chame o GetOAuthAuthorizationURL procedimento armazenado* com o parâmetro de entrada CallbackURL definido para o URI de redirecionamento exato que você especificou nas configurações do aplicativo.
2. Abra o URL retornado em um navegador. Faça login e conceda permissões ao conector. Você será redirecionado para o URL de retorno de chamada, que contém o código do verificador.
3. Salve o valor do código do verificador. Você definirá isso no OAuthVerifier propriedade de conexão.

Na máquina sem periféricos, defina as seguintes propriedades de conexão para obter os valores de autenticação OAuth:

• OAuthClientId: Defina isso como a chave do consumidor nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o segredo do consumidor nas configurações do aplicativo.
• OAuthVerifier: Defina isso para o código do verificador.
• OAuthSettingsLocation: Defina para manter os valores de autenticação OAuth criptografados no arquivo especificado.
• InitiateOAuth: Defina como REFRESH.

Depois que o arquivo de configurações OAuth for gerado, defina as seguintes propriedades para se conectar aos dados:

• OAuthClientId: Defina isso como a chave do consumidor nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o segredo do consumidor nas configurações do aplicativo.
• OAuthSettingsLocation: Defina isso para o arquivo que contém os valores de autenticação OAuth criptografados. Certifique-se de que este arquivo forneça permissões de leitura e gravação ao provedor para ativar a atualização automática do token de acesso.
• InitiateOAuth: Configure para ATUALIZAR.
• ChannelId: Defina para o ID de um canal do YouTube. Se não for especificado, os dados serão retornados para o canal do usuário autenticado.
• ContentOwnerId: Defina para o ID do proprietário do conteúdo se desejar gerar relatórios do proprietário do conteúdo.

Configurações de transferência OAuth

Siga as etapas abaixo para instalar o conector em outra máquina, autenticar e depois transferir os valores OAuth resultantes.

Em uma segunda máquina, instale o conector e conecte-se com o seguinte conjunto de propriedades:

• OAuthSettingsLocation: Defina isso como um arquivo de texto gravável.
• InitiateOAuth: Defina como GETANDREFRESH.
• OAuthClientId: Defina isso para o ID do cliente atribuído quando você registrou seu aplicativo.
• OAuthClientSecret: Defina isso como o segredo do cliente atribuído quando você registrou seu aplicativo.

Teste a conexão para autenticar. Os valores de autenticação resultantes são gravados, criptografados, no caminho especificado por OAuthSettingsLocation. Depois de testar a conexão com sucesso, copie o arquivo de configurações OAuth para sua máquina sem periféricos. Na máquina sem periféricos, defina as seguintes propriedades de conexão para se conectar aos dados:

• InitiateOAuth: Configure para ATUALIZAR.
• OAuthClientId: Defina isso como a chave do consumidor nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o segredo do consumidor nas configurações do aplicativo.
• OAuthSettingsLocation: Defina isso como o caminho para o arquivo de configurações OAuth. Certifique-se de que este arquivo forneça permissões de leitura e gravação ao conector para habilitar a atualização automática do token de acesso.
• ChannelId: Defina para o ID de um canal do YouTube. Se não for especificado, os dados serão retornados para o canal do usuário autenticado.
• ContentOwnerId: Defina para o ID do proprietário do conteúdo se desejar gerar relatórios do proprietário do conteúdo.

Contas de Serviço¶

As contas de serviço têm autenticação silenciosa, sem autenticação do usuário no navegador. Você também pode usar uma conta de serviço para delegar escopos de acesso em toda a empresa ao conector.

Você precisa criar um aplicativo OAuth neste fluxo. Consulte Criando um aplicativo OAuth personalizado para criar e autorizar um aplicativo. Você pode se conectar aos dados do YouTube Analytics que a conta de serviço tem permissão para acessar.

Depois de definir as seguintes propriedades de conexão, você está pronto para se conectar:

• InitiateOAuth: Defina como GETANDREFRESH.
• OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o segredo do cliente nas configurações do aplicativo.
• OAuthJWTCertType: Defina isso como "PEMKEY_FILE".
• OAuthJWTCert: Defina isso como o caminho para o arquivo .pem que você gerou.
• OAuthJWTCertPassword: Defina isso como a senha do arquivo .pem.
• OAuthJWTCertSubject: Defina como "*" para escolher o primeiro certificado no armazenamento de certificados.
• OAuthJWTSubject: Defina isso para sua ID corporativa se seu tipo de entidade estiver definido como "corporativo" ou sua ID de usuário do aplicativo se seu tipo de entidade estiver definido como "usuário".
• ChannelId: Defina para o ID de um canal do YouTube. Se não for especificado, os dados serão retornados para o canal do usuário autenticado.
• ContentOwnerId: Defina para o ID do proprietário do conteúdo se desejar gerar relatórios do proprietário do conteúdo.

Quando você conecta, o conector conclui o fluxo OAuth para uma conta de serviço.

1. Cria e assina o JWT com o conjunto de declarações exigido pelo conector.
2. Troca o JWT pelo token de acesso.
3. Salva valores OAuth em OAuthSettingsLocation para ser persistido nas conexões.
4. Envia o JWT para um novo token de acesso quando o token expira.

Criando um Aplicativo OAuth Personalizado¶

Você pode usar um aplicativo OAuth personalizado para autenticar uma conta de serviço ou uma conta de usuário. Consulte Usando autenticação OAuth Para maiores informações.

Crie um Aplicativo OAuth para Autenticação de Conta de Usuário¶

Siga o procedimento abaixo para registrar um aplicativo e obter o OAuthClientId e OAuthClientSecret.

Crie um Aplicativo OAuth Personalizado: Área de Trabalho¶

1. Faça login no Google API Console e abra um projeto. Selecione o API Manager no menu principal.
2. No fluxo de consentimento do usuário, clique em Credenciais -> Criar credenciais -> ID do cliente OAuth. Clique em Outro. Depois de criar o aplicativo, o OAuthClientId e OAuthClientSecret Estão exibidas.
3. Clique em Biblioteca -> API do YouTube Analytics -> Ativar API.

Crie um Aplicativo OAuth para Autenticação de Conta de Serviço¶

Siga as etapas abaixo para criar um aplicativo OAuth e gerar uma chave privada. Em seguida, você autorizará a conta de serviço.

1. Faça login no Google API Console e abra um projeto. Selecione o API Manager no menu principal.
2. Clique em Criar credenciais -> Chave da conta de serviço.
3. No menu Conta de serviço, selecione Nova conta de serviço ou selecione uma conta de serviço existente.
4. Se estiver criando uma nova conta de serviço, selecione adicionalmente uma ou mais funções. Você pode atribuir funções primitivas no nível do projeto na seção IAM e Admin; outras funções permitem que você personalize ainda mais o acesso às APIs do Google.
5. Na seção Tipo de chave, selecione o tipo de chave P12.
6. Crie o aplicativo para baixar o par de chaves. A senha da chave privada é exibida: Defina isso em OAuthJWTCertPassword.
7. Na seção de contas de serviço, clique em Gerenciar contas de serviço e defina OAuthJWTIssuer para o endereço e-mail exibido no campo ID da conta de serviço.
8. Clique em Biblioteca -> API do YouTube Analytics -> Ativar API.

Recuperando Dados do YouTube Analytics¶

Os dados do YouTube Analytics são organizados em várias métricas (Viewers, ViewerPercentage, AgeGroup etc.), que podem ser consultadas em várias dimensões (Day, DeviceType etc.). Existem muitas combinações válidas de métricas e dimensões. O conector mostra algumas das combinações mais usadas como exibições relacionais para facilidade de uso.

Além disso, o conector permite consultar todas as combinações válidas, mesmo aquelas não incluídas nas visualizações predefinidas. Você pode usar o CreateCustomSchema procedimento armazenado* para criar uma exibição em uma consultar. Consulte Modelo de Dados para saber como combinar métricas e dimensões em consultas e esquemas. Abaixo está um guia para começar com as exibições padrão.

Selecionando Dimensões e Medidas¶

A dimensão e as métricas são claramente definidas para cada tabela e podem ser vistas no Modelo de Dados: Basta selecionar as métricas e as dimensões nas quais você está interessado. Por exemplo, os principais vídeos de um canal por mais minutos assistidos em um país específico podem ser selecionados da seguinte forma:

SELECT Video, Views, EstimatedMinutesWatched, AverageViewDuration, AverageViewPercentage FROM TopVideos WHERE Country='AL'

Executando Consultas SELECT *¶

Ao contrário da maioria das tabelas de banco de dados, não é muito útil selecionar todas as métricas e dimensões em uma determinada tabela. O conector, portanto, interpreta a consultar SELECT * para significar que um conjunto padrão de métricas e dimensões é solicitado. Isso inclui consultas que selecionam explicitamente todas as colunas. Consulte a documentação da exibição individual em Modelo de dados para ver quais campos são o padrão para cada esquema.

Recursos avançados¶

Esta seção detalha uma seleção de recursos avançados do conector do YouTube Analytics.

Visualizações definidas pelo usuário

O conector permite definir tabelas virtuais, denominadas visualizações definidas pelo usuário, cujo conteúdo é decidido por uma consultar pré-configurada. Essas exibições são úteis quando você não pode controlar diretamente as consultas enviadas aos drivers. Consulte Visualizações definidas pelo usuário para obter uma visão geral da criação e configuração de exibições personalizadas.

Procurador

Para configurar o conector usando configurações de proxy do Agente Privado, selecione os Use Proxy Settings caixa de seleção na tela de configuração da conexão.

Processamento de consulta

O conector transfere o máximo possível do processamento da instrução SELECT para o YouTube Analytics e, em seguida, processa o restante da consultar na memória (do lado do cliente).

Consulte Processamento de consultas Para maiores informações.

Exibições definidas pelo usuário¶

O Jitterbit Connector for YouTube Analytics permite definir uma tabela virtual cujo conteúdo é decidido por uma consultar pré-configurada. Elas são chamadas de Visualizações Definidas pelo Usuário, que são úteis em situações onde você não pode controlar diretamente a consultar que está sendo emitida para o driver, por exemplo, ao usar o driver do Jitterbit. As Visualizações Definidas pelo Usuário podem ser usadas para definir predicados que são sempre aplicados. Se você especificar predicados adicionais na consultar para a visualização, eles serão combinados com a consultar já definida como parte da visualização.

Há duas maneiras de criar exibições definidas pelo usuário:

• Crie um arquivo de configuração em formato JSON definindo as visualizações desejadas.
• declarações DDL.

Definindo visualizações usando um arquivo de configuração¶

As visualizações definidas pelo usuário são definidas em um arquivo de configuração formatado em JSON chamado UserDefinedViews.json. O conector detecta automaticamente as visualizações especificadas neste arquivo.

Você também pode ter várias definições de exibição e controlá-las usando o UserDefinedViews propriedade de conexão. Quando você usa essa propriedade, apenas as exibições especificadas são vistas pelo conector.

Este arquivo de configuração de exibição definida pelo usuário é formatado da seguinte forma:

• Cada elemento raiz define o nome de uma exibição.
• Cada elemento raiz contém um elemento filho, chamado query, que contém a consultar SQL personalizada para a exibição.

Por exemplo:

{
    "MyView": {
        "query": "SELECT * FROM Groups WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Use o UserDefinedViews propriedade de conexão para especificar a localização do seu arquivo de configuração JSON. Por exemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Definindo exibições usando instruções DDL¶

O conector também é capaz de criar e alterar o esquema por meio de instruções DDL, como CREATE LOCAL VIEW, ALTER LOCAL VIEW e DROP LOCAL VIEW.

Crie uma visualização¶

Para criar uma nova visualização usando instruções DDL, forneça o nome da visualização e a consultar da seguinte forma:

CREATE LOCAL VIEW [MyViewName] AS SELECT * FROM Customers LIMIT 20;

Se não existir nenhum arquivo JSON, o código acima criará um. A exibição é então criada no arquivo de configuração JSON e agora pode ser descoberta. O local do arquivo JSON é especificado pelo UserDefinedViews propriedade de conexão.

Alterar uma visualização¶

Para alterar uma exibição existente, forneça o nome de uma exibição existente ao lado da nova consultar que você gostaria de usar:

ALTER LOCAL VIEW [MyViewName] AS SELECT * FROM Customers WHERE TimeModified > '3/1/2020';

A exibição é atualizada no arquivo de configuração JSON.

Solte uma visualização¶

Para descartar uma exibição existente, forneça o nome de um esquema existente ao lado da nova consultar que você gostaria de usar.

DROP LOCAL VIEW [MyViewName]

Isso remove a visualização do arquivo de configuração JSON. Não pode mais ser consultado.

Esquema para exibições definidas pelo usuário¶

As visualizações definidas pelo usuário são expostas no UserViews esquema por padrão. Isso é feito para evitar que o nome da exibição entre em conflito com uma entidade real no modelo de dados. Você pode alterar o nome do esquema usado para UserViews definindo o UserViewsSchemaName propriedade.

Trabalhando com visualizações definidas pelo usuário¶

Por exemplo, uma instrução SQL com uma Visualização Definida pelo Usuário chamada UserViews.RCustomers lista apenas clientes em Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Exemplo de consultar ao driver:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Resultando na consultar efetiva à fonte:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Esse é um exemplo muito simples de uma consultar a uma exibição definida pelo usuário que é efetivamente uma combinação da consultar de exibição e da definição de exibição. É possível compor essas consultas em padrões bem mais complexos. Todas as operações SQL são permitidas em ambas as consultas e são combinadas quando apropriado.

Modelo de Dados¶

O conector Jitterbit para YouTube Analytics modela entidades do YouTube Analytics em tabelas relacionais, exibições e procedimentos armazenados. O YouTube Analytics permite que dimensões e métricas sejam consultadas em um grande número de arranjos. Algumas exibições de amostra são fornecidas com base em relatórios comuns do YouTube Analytics. No entanto, você também pode criar suas próprias exibições personalizadas com base em qualquer combinação de dimensões e métricas necessárias.

A criação de esquemas de exibição, bem como as limitações e os requisitos da API, estão documentados nesta seção.

Mesas

Você pode acessar Grupos e Itens de Grupo como Tabelas.

Procedimentos armazenados

NOTE: Procedimentos armazenados não são suportados atualmente. Veja a nota para detalhes.

Procedimentos armazenados são interfaces semelhantes a funções para a fonte de dados. Eles podem ser usados para acessar recursos adicionais da API do YouTube Analytics.

Visualizações

Os relatórios são mostrados como visualizações, tabelas que não podem ser modificadas. Ao contrário das exibições de banco de dados tradicionais, no entanto, não é muito útil selecionar todas as métricas e dimensões em uma determinada tabela. O provedor, portanto, interpreta a consultar SELECT * para significar que um conjunto padrão de métricas e dimensões é solicitado. Isso inclui consultas que selecionam explicitamente todas as colunas.

Além disso, a API do YouTube Analytics limita o número e as combinações de colunas que podem ser projetadas sobre os dados ou usadas para restringir os resultados retornados. Você pode encontrar essas limitações e os campos padrão para cada esquema em Visualizações. Consulte também essas seções ao definir sua própria exibição.

Definindo exibições personalizadas¶

Para criar uma exibição em uma consultar, você pode usar o CreateCustomSchema procedimento armazenado. O CreateCustomSchema procedimento armazenado* fornece uma maneira fácil de gerar novas definições de exibição com uma combinação personalizada de Dimensões e Métricas. Chamá-lo criará um novo arquivo de esquema que você pode consultar como qualquer outra exibição.

O procedimento armazenado* usa um nome de exibição, uma lista separada por vírgulas de métricas, uma lista separada por vírgulas de dimensões e uma pasta de saída como entradas. Você precisará definir o Location propriedade de conexão com a pasta que contém os novos arquivos de script para acessá-los; o Location pode ser definido em vez da pasta de saída.

Por exemplo, para usar um novo esquema junto com os esquemas padrão, defina o Location para a subpasta db na pasta de instalação e faça a seguinte chamada:

EXEC CreateCustomSchema Dimensions='Day,DeviceType', Metrics='Views,EstimatedMinutesWatched', TableName='DailyDeviceReports'

Tabelas¶

O conector modela os dados no YouTube Analytics em uma lista de tabelas que podem ser consultadas usando instruções SQL padrão.

Geralmente, consultar tabelas do YouTube Analytics é o mesmo que consultar uma tabela em um banco de dados relacional. Às vezes, há casos especiais, por exemplo, incluir uma determinada coluna na cláusula WHERE pode ser necessário para obter dados para determinadas colunas na tabela. Isso geralmente é necessário para situações em que uma solicitação separada deve ser feita para cada linha para obter determinadas colunas. Esses tipos de situações estão claramente documentados na parte superior da página da tabela vinculada abaixo.

Conector Jitterbit para tabelas do YouTube Analytics¶

GroupItems¶

Crie, exclua e consultar Itens que compõem um Grupo.

Informações específicas da tabela¶

Selecione¶

A consultar a seguir retorna os itens que compõem os grupos do YouTube Analytics:

SELECT * FROM GroupItems

A consultar a seguir retorna os itens que compõem um grupo específico do YouTube Analytics:

SELECT * FROM GroupItems WHERE GroupId='239_65GrkKS6kRL'

Além disso, OnBehalfOfContentOwner pode opcionalmente ser usado na cláusula WHERE.

Inserir¶

GroupId e Resource_Id são necessários para inserir um Item em um Grupo.

INSERT INTO GroupItems (GroupId, Resource_Id) VALUES ('fjgeeljgio54','dkhgjio5sfff')

Colunas¶

Grupos¶

Crie, atualize, exclua e consultar grupos do YouTube Analytics.

Informações específicas da tabela¶

Um grupo é uma coleção personalizada de até 200 canais, vídeos, listas de reprodução ou ativos. Todos os Itens em um Grupo devem representar o mesmo tipo de entidade. Por exemplo, você não pode criar um grupo que contenha 100 vídeos e 100 listas de reprodução. Um grupo analítico pode conter apenas entidades que você carregou ou reivindicou ou que estão vinculadas a um canal que você administra. Como resultado, os proprietários de conteúdo podem criar grupos de vídeos, listas de reprodução, canais ou ativos. Os proprietários de canais podem criar grupos de vídeos e listas de reprodução.

Selecione¶

As seguintes colunas podem ser usadas na cláusula WHERE: OnBehalfOfContentOwner e Mine.

Inserir¶

ContentDetails_ItemType é necessário para inserir um grupo.

INSERT INTO Groups (Snippet_Title, ContentDetails_ItemType) VALUES ('test2', 'youtube#channel')

Colunas¶

Visualizações¶

As exibições são compostas por colunas e pseudocolunas. As exibições são semelhantes às tabelas na forma como os dados são representados; no entanto, as exibições não oferecem suporte a atualizações. Entidades que são representadas como exibições são normalmente entidades somente leitura. Frequentemente, um procedimento armazenado* está disponível para atualizar os dados se tal funcionalidade for aplicável à fonte de dados.

As consultas podem ser executadas em uma exibição como se fosse uma tabela normal, e os dados retornados são semelhantes nesse aspecto.

Visualizações dinâmicas, como consultas expostas como visualizações e visualizações para procurar combinações específicas de itens de trabalho project_team são suportadas.

Conector Jitterbit para visualizações do YouTube Analytics¶

Atividades¶

Consultar atividades do YouTube. Um recurso de atividade contém informações sobre uma ação que um determinado canal ou usuário realizou no YouTube.

Informações específicas da tabela¶

Selecione¶

O YouTube Analytics permite que apenas um subconjunto de colunas seja usado como critério de filtro. Você pode especificar exatamente uma das seguintes colunas: ChannelId ou Home. Além disso, as colunas extras opcionais com suporte são PublishedAt e Region.

Todas as colunas suportam o operador '='. PublishedAt também suporta '>', '>=', '<' e '<='.

Por padrão, se nenhum filtro for especificado, o driver retornará as atividades geradas pelo usuário autenticado.

SELECT * FROM Activities WHERE Home = true LIMIT 2

SELECT * FROM Activities WHERE ChannelId = "abc123" AND PublishedAt < '2016-01-01T10:00:00Z'

Colunas¶

Nome	Tipo	Dimensão	Métrica Padrão	Dimensão padrão	Descrição
Id [KEY]	String				O ID que o YouTube usa para identificar exclusivamente a atividade.
PublishedAt	Datetime				A data e a hora em que a atividade ocorreu. O valor está no formato ISO 8601 (AAAA-MM-DDThhss.sZ).
ChannelId	String				O ID que o YouTube usa para identificar exclusivamente o canal associado à atividade.
Title	String				O título do recurso associado principalmente à atividade.
Description	String				A descrição do recurso associado principalmente à atividade.
ChannelTitle	String				Título do canal para o canal responsável por esta atividade.
Type	String				O tipo de atividade que o recurso descreve. Valores válidos: channelItem, comment (não retornado no momento), favorito, like, playlistItem, recomendação, social, assinatura e upload.
GroupId	String				O ID do grupo associado à atividade.
ThumbnailsDefaultUrl	String				A URL da miniatura da imagem padrão.
UploadVideoId	String				O ID que o YouTube usa para identificar exclusivamente o vídeo enviado.
LikeResourceIdKind	String				O tipo de recurso que recebeu uma avaliação positiva (curtir).
LikeResourceIdVideoId	String				O ID que o YouTube usa para identificar exclusivamente o vídeo, se o recurso avaliado for um vídeo. Esta coluna só estará presente se ResourceIdKind for youtube#video.
FavoriteResourceIdKind	String				O tipo de entidade do YouTube marcada como favorita.
FavoriteResourceIdVideoId	String				O ID que o YouTube usa para identificar exclusivamente o vídeo favorito.
CommentResourceIdKind	String				O comentário sobre o recurso da API.
CommentResourceIdVideoId	String				O ID que o YouTube usa para identificar exclusivamente o vídeo associado a um comentário.
CommentResourceIdChannelId	String				O ID que o YouTube usa para identificar exclusivamente o canal associado a um comentário.
SubscriptionResourceIdKind	String				O tipo da assinatura. Uma assinatura é um canal no qual um usuário se inscreveu.
SubscriptionResourceIdChannelId	String				O ID que o YouTube usa para identificar exclusivamente o canal no qual o usuário se inscreveu.
PlaylistItemResourceIdKind	String				O tipo do item da lista de reprodução.
PlaylistItemResourceIdVideoId	String				O ID que o YouTube usa para identificar exclusivamente o vídeo que foi adicionado à lista de reprodução.
PlaylistItemPlaylistId	String				O valor que o YouTube usa para identificar exclusivamente a lista de reprodução.
PlaylistItemPlaylistItemId	String				O valor que o YouTube usa para identificar exclusivamente o item na lista de reprodução.
RecommendationResourceIdKind	String				O tipo da recomendação.
RecommendationResourceIdVideoId	String				O ID que o YouTube usa para identificar exclusivamente o vídeo, se o recurso recomendado for um vídeo.
RecommendationResourceIdChannelId	String				O ID que o YouTube usa para identificar exclusivamente o canal, se o recurso recomendado for um canal.
RecommendationReason	String				O motivo pelo qual a entidade do YouTube foi recomendada ao usuário. Valores válidos para esta coluna: não especificado, videoFavorited, videoLiked e videoWatched.
RecommendationSeedResourceIdKind	String				O tipo de entidade do YouTube que causou a recomendação.
RecommendationSeedResourceIdVideoId	String				O ID que o YouTube usa para identificar exclusivamente o vídeo, caso a recomendação tenha sido causada por um determinado vídeo.
RecommendationSeedResourceIdChannelId	String				O ID que o YouTube usa para identificar exclusivamente o canal, caso a recomendação tenha sido causada por um canal específico.
RecommendationSeedResourceIdPlaylistId	String				O ID que o YouTube usa para identificar exclusivamente a lista de reprodução, se a recomendação for causada por uma lista de reprodução específica.
SocialType	String				O nome da postagem na rede social. Valores válidos para esta coluna: facebook, googlePlus, twitter e não especificado.
SocialResourceIdKind	String				O tipo de postagem na rede social.
SocialResourceIdVideoId	String				O ID que o YouTube usa para identificar exclusivamente o vídeo apresentado em uma postagem de rede social, se a postagem se referir a um vídeo.
SocialResourceIdChannelId	String				O ID que o YouTube usa para identificar exclusivamente o canal apresentado em uma postagem de rede social, se a postagem se referir a um canal.
SocialResourceIdPlaylistId	String				O ID que o YouTube usa para identificar exclusivamente a lista de reprodução apresentada em uma postagem na rede social.
SocialAuthor	String				O autor da postagem na rede social.
SocialReferenceUrl	String				A URL da postagem na rede social.
SocialImageUrl	String				Uma imagem do autor do post.
ChannelItemResourceId	String				O ID da entidade do YouTube que foi adicionada ao canal.

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

AdPerformanceReports¶

Consultar relatórios de desempenho de anúncios. Os Relatórios de desempenho de anúncios fornecem métricas baseadas em impressões para anúncios executados durante reproduções de vídeo. Essas métricas representam cada impressão de anúncio e cada reprodução de vídeo pode render várias impressões.

Informações específicas da tabela¶

Selecione¶

Obtenha receita bruta para um vídeo em um país específico agrupado por tipo de anúncio e dia:

SELECT Country, AdType, Day, GrossRevenue, StartDate, EndDate FROM AdPerformanceReports WHERE video='vid123' AND continent = '019'

Selecionar Regras¶

Relatórios de desempenho de anúncios para proprietários de conteúdo:

| Dimensões | Obrigatório | adType | | -------------- | -------------------------------- | | Optional | dia | | Métricas | Use 1 ou mais | receita bruta, impressões de anúncios, cpm | | Filtro | Use exatamente um | vídeo, grupo ou uma combinação suportada de uploaderType e ClaimStatus | | Use 0 or one | país, continente, subcontinente |

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Legendas¶

Consultar legendas do YouTube. Um recurso Caption representa uma faixa de legenda do YouTube.

Informações específicas da tabela¶

Selecione¶

O YouTube Analytics permite que apenas um subconjunto de colunas seja usado como critério de filtro. A coluna VideoId deve ser especificada. Colunas extras opcionais suportadas são ID e OnBehalfOfContentOwner.

Todas as colunas suportam o operador '='.

SELECT * FROM Captions WHERE VideoId = '123456789'

Colunas¶

Nome	Tipo	Dimensão	Métrica Padrão	Dimensão padrão	Descrição
Id [KEY]	String				O ID que o YouTube usa para identificar exclusivamente a faixa de legenda.
VideoId	String				O ID que o YouTube usa para identificar exclusivamente o vídeo associado à faixa de legenda.
LastUpdated	Datetime				A data e a hora em que a faixa de legenda foi atualizada pela última vez. O valor é especificado no formato ISO 8601 (AAAA-MM-DDThhss.sZ).
TrackKind	String				O tipo da faixa de legenda. Valores válidos para esta coluna: ASR (uma faixa de legenda gerada usando o reconhecimento automático de fala); Forçado (uma faixa de legenda que é reproduzida quando nenhuma outra faixa é selecionada no player. Por exemplo, um vídeo que mostra alienígenas falando em um idioma estrangeiro pode ter uma faixa de legenda forçada para mostrar apenas legendas para o idioma estrangeiro); standard (uma faixa de legenda regular. Este é o valor padrão).
Language	String				O idioma da faixa de legenda. O valor da coluna é uma tag de idioma BCP-47.
Name	String				O nome da faixa de legenda. O nome deve ficar visível para o usuário como uma opção durante a reprodução.
AudioTrackType	String				O tipo de faixa de áudio associada à faixa de legenda. Valores válidos para esta coluna: comentário (a faixa de legenda corresponde a uma faixa de áudio alternativa que inclui comentários, como comentários do diretor); descritivo (a faixa de legenda corresponde a uma faixa de áudio alternativa que inclui áudio descritivo adicional); primário (a trilha de legenda corresponde à trilha de áudio primária do vídeo, que é a trilha de áudio normalmente associada ao vídeo); desconhecido (este é o valor padrão).
IsCC	Boolean				Indica se a faixa contém legendas ocultas para surdos e deficientes auditivos. O valor padrão é falso.
IsLarge	Boolean				Indica se a faixa de legenda usa texto grande para deficientes visuais. O valor padrão é falso.
IsEasyReader	Boolean				Indica se a faixa de legenda está formatada para facilitar a leitura, o que significa que está no nível da terceira série para alunos de idiomas. O valor padrão é falso.
IsDraft	Boolean				Indica se a faixa de legenda é um rascunho. Se o valor for true, a trilha não estará visível publicamente. O valor padrão é falso.
IsAutoSynced	Boolean				Indica se o YouTube sincronizou a faixa de legenda com a faixa de áudio do vídeo. O valor será true se uma sincronização tiver sido solicitada explicitamente quando a faixa de legenda for carregada. Se o valor for falso, o YouTube usará os códigos de tempo na faixa de legenda carregada para determinar quando exibir as legendas.
Status	String				O status da faixa de legenda. Valores válidos para esta coluna: falha, veiculação, sincronização.
FailureReason	String				O motivo pelo qual o YouTube não conseguiu processar a faixa de legenda. Valores válidos: processingFailed (o YouTube falhou ao processar a faixa de legenda carregada); unknownFormat (o formato da faixa de legenda não foi reconhecido); unsupportedFormat (o formato da faixa de legenda não é suportado).

Canais¶

Consultar canais do YouTube.

Informações específicas da tabela¶

Selecione¶

Por padrão, SupportEnhancedSQL é definido como verdadeiro e o seguinte será transmitido ao YouTube Analytics, se presente. Outros filtros serão executados no lado do cliente. Se SupportEnhancedSQL for definido como falso, apenas os seguintes filtros serão respeitados.

Por padrão, se nenhum filtro for especificado, o driver retornará todos os canais pertencentes ao usuário autenticado.

O YouTube Analytics permite que apenas um subconjunto de colunas seja usado como critério de filtro. Os canais podem ser filtrados pelo Id. Colunas extras opcionais suportadas são Language e ChannelId.

Uma pesquisa em todos os canais no YouTube Analytics pode ser acionada especificando um ou mais SearchTerms, ChannelId, Region, SafeSearch, Rating ou Relevance para pesquisar todos os canais.

Todas as colunas suportam o operador '='. 'PublishedAt' também suporta '>', '>=', '<' e '<='.

Ordenar por é compatível com as colunas Classificação, Relevância e Título.

SELECT * FROM Channels WHERE Id = 'abc123'
SELECT * FROM Channels WHERE ChannelId = 'abc123' AND SearchTerms = 'music|movies-horror' ORDER BY Rating LIMIT 10

Observação: A ordem não é suportada ao especificar uma das colunas usadas para pesquisar canais, como SearchTerms.

Colunas¶

Nome	Tipo	Dimensão	Métrica Padrão	Dimensão padrão	Descrição
Id [KEY]	String				O ID que o YouTube usa para identificar exclusivamente o canal.
Title	String				O título do canal.
Description	String				A descrição do canal. O valor da coluna tem um comprimento máximo de 1000 caracteres.
CustomUrl	String				O URL personalizado do canal.
PublishedAt	Datetime				A data e a hora em que o canal foi criado. O valor é especificado no formato ISO 8601 (AAAA-MM-DDThhss.sZ).
ThumbnailsDefaultUrl	String				A URL da miniatura da imagem padrão.
DefaultLanguage	String				Esta coluna é confidencial para testadores confiáveis.
LiveBroadcastContent	String				Uma indicação se um recurso de vídeo ou canal tem conteúdo de transmissão ao vivo.
LocalizedTitle	String				Esta coluna é confidencial para testadores confiáveis. O título do vídeo localizado.
LocalizedDescription	String				Esta coluna é confidencial para testadores confiáveis. A descrição do vídeo localizada.
Country	String				O país ao qual o canal está associado.
ViewCount	Long				O número de vezes que o canal foi visualizado.
SubscriberCount	Long				O número de inscritos que o canal possui. Este valor é arredondado para três algarismos significativos.
HiddenSubscriberCount	Boolean				Indica se a contagem de inscritos do canal é visível publicamente.
VideoCount	Long				O número de vídeos enviados para o canal.
RelatedPlaylistsLikes	String				O ID da lista de reprodução que contém os vídeos curtidos do canal.
RelatedPlaylistsUploads	String				O ID da lista de reprodução que contém os vídeos enviados do canal.
PrivacyStatus	String				Status de privacidade do canal. Valores válidos para esta coluna: privado, público, não listado.
IsLinked	Boolean				Indica se os dados do canal identificam um usuário que já está vinculado a um nome de usuário do YouTube ou a uma conta do Google+. Um usuário que possui um desses links já possui uma identidade pública do YouTube, o que é pré-requisito para várias ações, como o upload de vídeos.
LongUploadsStatus	String				Indica se o canal está qualificado para enviar vídeos com mais de 15 minutos de duração. Esta coluna só é retornada se o proprietário do canal autorizou a solicitação da API. Consulte a Central de Ajuda do YouTube para obter mais informações sobre esse recurso.
MadeForKids	Boolean				Esse valor indica se o canal é designado como direcionado para crianças e contém o status atual de 'criado para crianças' do canal.
Keywords	String				Palavras-chave associadas ao seu canal. O valor é uma lista de strings separadas por espaços.
TrackingAnalyticsAccountId	String				O ID de uma conta do Google Analytics que você deseja usar para rastrear e medir o tráfego para seu canal.
ModerateComments	Boolean				Esta configuração determina se os comentários enviados pelo usuário deixados na página do canal precisam ser aprovados pelo proprietário do canal para serem visíveis publicamente. O valor padrão é falso.
SearchTerms	String				O parâmetro SearchTerms especifica o termo de consultar a ser pesquisado.

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

ChannelSections¶

Consulte as seções do canal do YouTube. Uma ChannelSection contém informações sobre um conjunto de vídeos que um canal escolheu apresentar.

Informações específicas da tabela¶

Selecione¶

O YouTube Analytics permite que apenas um subconjunto de colunas seja usado como critério de filtro. Você pode especificar exatamente uma das seguintes colunas: ChannelId ou Id. Colunas extras opcionais com suporte são Language e OnBehalfOfContentOwner.

Todas as colunas suportam o operador '='.

Por padrão, se nenhum ID de canal for especificado, o driver retornará as seções de canal para o canal pertencente ao usuário autenticado.

SELECT * FROM ChannelSections WHERE ChannelId = '123456789'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Comentários¶

Consultar comentários do YouTube.

Informações específicas da tabela¶

Selecione¶

O YouTube Analytics permite que apenas um subconjunto de colunas seja usado como critério de filtro. Você deve especificar exatamente uma das seguintes colunas: ID ou ParentId. Colunas extras opcionais suportadas são TextFormat.

Todas as colunas suportam o operador '='.

SELECT * FROM Comments WHERE ID = '123456789'

Colunas¶

Nome	Tipo	Dimensão	Métrica Padrão	Dimensão padrão	Descrição
Id [KEY]	String				O ID que o YouTube usa para identificar exclusivamente o comentário.
ChannelId	String				O ID do canal do YouTube associado ao comentário. Se o comentário for um comentário de vídeo, essa coluna identifica o canal do vídeo e a coluna VideoId identifica o vídeo. Se o comentário for um comentário de canal, essa coluna identificará o canal sobre o qual o comentário é.
VideoId	String				O ID do vídeo ao qual o comentário se refere.
TextDisplay	String				O texto do comentário. O texto pode ser recuperado em texto simples ou HTML. A pseudocoluna TextFormat especifica o formato de texto desejado.
TextOriginal	String				O texto bruto original do comentário conforme foi publicado inicialmente ou atualizado pela última vez. O texto original só é devolvido se estiver acessível ao usuário autenticado, o que só é garantido se o usuário for o autor do comentário.
ParentId	String				A ID exclusiva do comentário pai. Este valor de coluna só é definido se o comentário foi enviado como uma resposta a outro comentário.
AuthorDisplayName	String				O nome de exibição do usuário que postou o comentário.
AuthorProfileImageUrl	String				A URL do avatar do usuário que postou o comentário.
AuthorChannelUrl	String				A URL do canal do YouTube do autor do comentário, se disponível.
AuthorChannelIdValue	String				O ID do canal do YouTube do autor do comentário, se disponível.
AuthorGoogleplusProfileUrl	String				O URL do perfil do Google+ do autor do comentário, se disponível.
CanRate	Boolean				Essa configuração indica se o visualizador atual pode avaliar o comentário.
ViewerRating	String				A classificação que o visualizador deu a este comentário. Valores válidos para esta coluna: como, nenhum. Observe que esta coluna atualmente não identifica classificações de antipatia. O valor da coluna é como se o visualizador tivesse avaliado o comentário positivamente. O valor é nenhum em todos os outros casos, incluindo o usuário que deu ao comentário uma classificação negativa ou não avaliou o comentário.
LikeCount	Integer				O número total de curtidas (avaliações positivas) que o comentário recebeu.
ModerationStatus	String				O status de moderação do comentário. Esse valor só é retornado se a solicitação da API for autorizada pelo proprietário do canal ou do vídeo em que foram feitos os comentários solicitados. Além disso, observe que esse valor não é definido se a consultar for filtrada na coluna ID. Valores válidos: holdForReview, provávelSpam, publicado, rejeitado.
PublishedAt	Datetime				A data e a hora em que o comentário foi originalmente publicado. O valor é especificado no formato ISO 8601 (AAAA-MM-DDThhss.sZ).
UpdatedAt	Datetime				A data e a hora em que o comentário foi atualizado pela última vez. O valor é especificado no formato ISO 8601 (AAAA-MM-DDThhss.sZ).

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Threads de comentários¶

Consulte tópicos de comentários do YouTube. Um registro CommentThread contém informações sobre um tópico de comentários do YouTube, um comentário de nível superior e respostas, se houver, a esse comentário.

Informações específicas da tabela¶

Selecione¶

O YouTube Analytics permite que apenas um subconjunto de colunas seja usado como critério de filtro. Você deve especificar exatamente uma das seguintes colunas: AllThreadsRelatedToChannelId, ChannelId, Id ou VideoId.

Colunas extras opcionais suportadas são ModerationStatus, SearchTerms e TextFormat. Todas as colunas suportam o operador '='.

Order é compatível com CommentThreads. Relevância são as colunas de pedidos com suporte.

SELECT * FROM CommentThreads WHERE VideoId = 'abcdef123456' ORDER BY Relevance DESC LIMIT 10

Observação: A ordem não é suportada para uso em conjunto com o parâmetro ID.

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Dados demográficos¶

Consulte os dados demográficos do YouTubeAnalytics agrupados por faixa etária e sexo.

Informações específicas da tabela¶

Selecione¶

Estatísticas agregadas de exibição de vídeos com base na faixa etária e sexo dos espectadores:

SELECT * FROM Demographics

Reduza os dados demográficos para apenas um vídeo:

SELECT * FROM Demographics WHERE Video = 'video_Id'

Estatísticas de visualização agregadas para listas de reprodução com base na faixa etária e sexo dos espectadores:

SELECT * FROM Demographics WHERE IsCurated=true

Selecionar Regras¶

Você pode usar as tabelas a seguir para criar outras consultas aos vídeos principais.

Dados demográficos para vídeos:

| Dimensões | Use 1 ou mais | faixa etária, gênero, vídeo | | --------------- | ------------------------------------------------ | | Use 0 or more | liveOrOnDemand, subscritoStatus, youtubeProduct | | Métricas | Use 1 ou mais | visualizadorPorcentagem | | Filtro | Use 0 ou um | país, província, continente, subcontinente | | Use 0 or one | vídeo, grupo | | Use 0 or more | liveOrOnDemand, subscritoStatus, youtubeProduct |

Dados demográficos para listas de reprodução:

| Dimensões | Use 1 ou mais | Grupo etário, sexo | | --------------- | ------------------------------------------ | | Use 0 or more | subscritoStatus, youtubeProduct | | Métricas | Obrigatório | visualizadorPorcentagem | | Filtro | Obrigatório | isCurated=true | | Use 0 or one | país, província, continente, subcontinente | | Use 0 or one | vídeo, grupo | | Use 0 or more | subscritoStatus, youtubeProduct |

Dados demográficos para proprietários de conteúdo:

| Dimensões | Use 1 ou mais | Grupo etário, sexo | | --------------- | ------------------------------------------------ | | Use 0 or more | liveOrOnDemand, subscritoStatus, youtubeProduct | | Métricas | Use 1 ou mais | visualizadorPorcentagem | | Filtro | Use exatamente um | vídeo, canal, grupo | | Use 0 or one | país, província, continente, subcontinente | | Use 0 or more | liveOrOnDemand, subscritoStatus, youtubeProduct |

Dados demográficos para listas de reprodução de proprietários de conteúdo:

| Dimensões | Use 1 ou mais | Grupo etário, sexo | | --------------- | ------------------------------------------ | | Use 0 or more | subscritoStatus, youtubeProduct | | Métricas | Obrigatório | visualizadorPorcentagem | | Filtro | Obrigatório | isCurated=true | | Use 0 or one | país, província, continente, subcontinente | | Use 0 or one | playlist, canal, grupo | | Use 0 or more | subscritoStatus, youtubeProduct |

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Dispositivos¶

Consulte estatísticas de dispositivos ou sistemas operacionais do YouTubeAnalytics. Essa tabela permite agregar estatísticas de exibição com base na maneira como os espectadores acessaram o conteúdo do seu vídeo. Por exemplo, você pode identificar o número de visualizações que ocorreram em dispositivos móveis ou consoles de jogos.

Informações específicas da tabela¶

Selecione¶

Por padrão, o agrupamento é feito por tipo de dispositivo:

SELECT * FROM Devices

No entanto, você pode agrupar exibições por outras dimensões, como Sistema operacional:

SELECT OperatingSystem, Views, EstimatedMinutesWatched FROM Devices

Observe que você não pode misturar o tipo de dispositivo e o sistema operacional na mesma consultar devido a limitações na API do YouTube Analytics.

Selecionar Regras¶

Você pode usar as tabelas a seguir para criar outras consultas para dispositivos:

Dispositivos para vídeos:

| Dimensões | Use exatamente um | tipo de dispositivo, sistema operacional | | --------------- | -------------------------------------------------- --------------- | | Use 0 or more | dia, liveOrOnDemand, subscritoStatus, youtubeProduct | | Métricas | Use 1 ou mais | visualizações, estimadasMinutosAssistidos | | Filtro | Use 0 ou um | país, província, continente, subcontinente | | Use 0 or one | vídeo, grupo | | Use 0 or more | operatingSystem, liveOrOnDemand, SubscribedStatus, youtubeProduct |

Dados do dispositivo para listas de reprodução:

| Dimensões | Use exatamente um | tipo de dispositivo, sistema operacional | | --------------- | ------------------------------------------------- | | Use 0 or more | dia, subscritoStatus, youtubeProduct | | Métricas | Use 1 ou mais | visualizações, minutos estimados assistidos, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist | | Filtro | Obrigatório | isCurated=true | | Use 0 or one | país, província, continente, subcontinente | | Use 0 or one | playlist, canal, grupo | | Use 0 or more | OperatingSystem, SubscribedStatus, youtubeProduct |

Dados do dispositivo para proprietários de conteúdo:

| Dimensões | Obrigatório | tipo de dispositivo | | --------------- | -------------------------------------------------- --------------- | | Use 0 or more | dia, liveOrOnDemand, subscritoStatus, youtubeProduct | | Métricas | Use 1 ou mais | visualizações, estimadasMinutosAssistidos | | Filtro | Use exatamente um | vídeo, canal, grupo | | Use 0 or one | país, província, continente, subcontinente | | Use 0 or more | operatingSystem, liveOrOnDemand, SubscribedStatus, youtubeProduct |

Dados do dispositivo para listas de reprodução do proprietário do conteúdo:

| Dimensões | Obrigatório | tipo de dispositivo | | --------------- | ------------------------------------------------- | | Use 0 or more | dia, subscritoStatus, youtubeProduct | | Métricas | Use 1 ou mais | visualizações, minutos estimados assistidos, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist | | Filtros | Obrigatório | isCurated=true | | Use 0 or one | país, província, continente, subcontinente | | Use 0 or one | playlist, canal, grupo | | Use 0 or more | OperatingSystem, SubscribedStatus, youtubeProduct |

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

EngagementReports¶

Consulte as informações dos Relatórios de engajamento. Por exemplo, quantas vezes um usuário compartilhou um vídeo.

Informações específicas da tabela¶

Selecione¶

Por padrão, os resultados são agrupados por Dia. A consultar a seguir retorna comentários, curtidas, não curtidas, etc., agrupados por dia:

SELECT * FROM EngagementReports

Selecionar Regras¶

A consultar a seguir retorna a frequência com que os vídeos do canal foram compartilhados em diferentes plataformas sociais:

SELECT SharingService, Shares FROM EngagementReports

Você pode usar as tabelas a seguir para criar outras consultas aos relatórios de engajamento:

Relatórios de engajamento para vídeos:

| Dimensões | Obrigatório | sharingService | | -------------- | ---------------- | | Optional | subscritoEstado | | Métricas | Use 1 ou mais | ações | | Filtro | Use 0 ou um | país, continente, subcontinente | | Use 0 or one | vídeo, grupo | | Optional | subscritoEstado |

Relatórios de engajamento para proprietários de conteúdo:

| Dimensões | Obrigatório | sharingService | | -------------- | -------------------------------- | | Optional | subscritoEstado | | Métricas | Use 1 ou mais | ações | | Filtro | Use exatamente um | vídeo, canal, grupo | | Use 0 or one | país, continente, subcontinente | | Optional | subscritoEstado |

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Idiomas¶

Consulta YouTube i18nLanguages. Um recurso i18nLanguage identifica um idioma de aplicativo compatível com o site do YouTube. O idioma do aplicativo também pode ser chamado de idioma da interface do usuário.

Informações específicas da tabela¶

Selecione¶

Não há filtros obrigatórios para esta tabela. Uma coluna opcional suportada é Language.

Todas as colunas suportam o operador '='.

Colunas¶

PlayListItems¶

Consulta YouTube PlayListItems. Um recurso PlayListItem identifica outra entidade do YouTube, como um vídeo, incluído em uma PlayList. Além disso, o registro PlayListItem contém detalhes sobre como essa entidade é usada nessa PlayList.

Informações específicas da tabela¶

Selecione¶

Você deve especificar exatamente uma das seguintes colunas na cláusula WHERE: ID ou PlayListId. Colunas extras opcionais suportadas são OnBehalfOfContentOwner e VideoId.

Todas as colunas suportam o operador '='.

SELECT * FROM PlaylistItems WHERE PlaylistId = 'abcdef123456'

Colunas¶

Nome	Tipo	Dimensão	Métrica Padrão	Dimensão padrão	Descrição
Id [KEY]	String				O ID que o YouTube usa para identificar exclusivamente o item da lista de reprodução.
PublishedAt	Datetime				A data e a hora em que o item foi adicionado à lista de reprodução. O valor é especificado no formato ISO 8601 (AAAA-MM-DDThhss.sZ).
ChannelId	String				O ID que o YouTube usa para identificar exclusivamente o usuário que adicionou o item à lista de reprodução.
Title	String				O título do item.
Description	String				A descrição do item.
ThumbnailsDefaultUrl	String				A URL do item.
ChannelTitle	String				O título do canal ao qual o item da lista de reprodução pertence.
VideoOwnerChannelTitle	String				O título do canal que carregou este vídeo.
VideoOwnerChannelId	String				O ID do canal que carregou este vídeo.
PlaylistId	String				A ID que o YouTube usa para identificar exclusivamente a lista de reprodução na qual o item da lista de reprodução está.
Position	String				A ordem em que o item aparece na lista de reprodução. O valor usa um índice baseado em zero, portanto, o primeiro item tem uma posição de 0, o segundo item tem uma posição de 1 e assim por diante.
ResourceIdKind	String				O tipo, ou tipo, do recurso referido.
ResourceIdVideoId	String				Se o valor ResourceIdKind da coluna for youtube#video, essa coluna estará presente e seu valor conterá o ID que o YouTube usa para identificar exclusivamente o vídeo na lista de reprodução.
VideoId	String				O ID que o YouTube usa para identificar exclusivamente um vídeo. Para recuperar o recurso de vídeo, defina a coluna ID com esse valor.
Note	String				Uma nota gerada pelo usuário para este item.
VideoOwnerPublishedAt	Datetime				A data e a hora em que o vídeo foi publicado no YouTube. O valor é especificado no formato ISO 8601 (AAAA-MM-DDThhss.sZ).
PrivacyStatus	String				O status de privacidade do item da lista de reprodução.

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

PlayLists¶

Consulte listas de reprodução do YouTube. Uma PlayList é uma coleção de vídeos que podem ser visualizados sequencialmente e compartilhados com outros usuários.

Informações específicas da tabela¶

Selecione¶

Por padrão, SupportEnhancedSQL é definido como verdadeiro e o seguinte será transmitido ao YouTube Analytics, se presente. Outros filtros serão executados no lado do cliente. Se SupportEnhancedSQL for definido como falso, apenas os seguintes filtros serão respeitados.

Por padrão, se nenhum filtro for especificado, o Jitterbit Connector for YouTube Analytics retornará todas as listas de reprodução do canal de propriedade do usuário autenticado.

O YouTube Analytics permite que apenas um subconjunto de colunas seja usado como critério de filtro. Você pode especificar exatamente uma das seguintes colunas: ChannelId ou Id. Colunas extras opcionais com suporte são PublishedAt, Language, OnBehalfOfContentOwner e OnBehalfOfContentOwnerChannel.

Uma pesquisa em todos os canais no YouTube Analytics pode ser acionada especificando um ou mais SearchTerms, ForContentOwner, Region, SafeSearch, Rating e Rating para pesquisar todas as listas de reprodução.

Todas as colunas suportam o operador '='. PublishedAt também suporta estes operadores adicionais: '>', '>=', '<' e '<='.

Ordenar por é compatível com as colunas Classificação, Relevância e Título.

SELECT * FROM PlayLists WHERE Id = 'abcdef123456'
SELECT title FROM PlayLists WHERE PublishedAt >= '2016-01-01' ORDER BY Title LIMIT 10

Observação: a ordem não é suportada ao especificar uma das colunas usadas para pesquisar listas de reprodução, como SearchTerms.

Colunas¶

Nome	Tipo	Dimensão	Métrica Padrão	Dimensão padrão	Descrição
Id [KEY]	String				O ID que o YouTube usa para identificar exclusivamente a lista de reprodução.
PublishedAt	Datetime				A data e a hora em que a lista de reprodução foi criada. O valor é especificado no formato ISO 8601 (AAAA-MM-DDThhss.sZ).
ChannelId	String				O ID que o YouTube usa para identificar exclusivamente o canal que publicou a lista de reprodução.
Title	String				O título da lista de reprodução.
Description	String				A descrição da lista de reprodução.
ThumbnailsDefaultUrl	String				A URL da imagem.
ChannelTitle	String				Título do canal ao qual o vídeo pertence.
DefaultLanguage	String				Esta coluna é confidencial para testadores confiáveis. O idioma do texto nas colunas Título e Descrição.
LocalizedTitle	String				Esta coluna é confidencial para testadores confiáveis. O título da lista de reprodução localizada.
LocalizedDescription	String				Esta coluna é confidencial para testadores confiáveis. A descrição da lista de reprodução localizada.
PrivacyStatus	String				O status de privacidade da lista de reprodução. Valores válidos para esta coluna: privado, público, não listado.
VideoCount	Integer				O número de vídeos na lista de reprodução.
EmbedHtml	String				Uma tag iframe que incorpora um player que reproduzirá a lista de reprodução.
SearchTerms	String				O parâmetro SearchTerms especifica o termo de consultar a ser pesquisado.

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Regiões¶

Consulta YouTube i18nRegions. Um recurso i18nRegion identifica uma área geográfica que um usuário do YouTube pode selecionar como a região de conteúdo preferencial. A região de conteúdo também pode ser chamada de localidade de conteúdo.

Informações específicas da tabela¶

Selecione¶

Não há filtros obrigatórios para esta tabela. Uma coluna opcional suportada é Idioma.

Todas as colunas suportam o operador '='.

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Assinaturas¶

Consultar assinaturas de usuários do YouTube. Uma assinatura notifica um usuário quando novos vídeos são adicionados a um canal ou quando outro usuário executa uma das várias ações no YouTube, como enviar um vídeo, avaliar um vídeo ou comentar um vídeo.

Informações específicas da tabela¶

Selecione¶

Você pode especificar exatamente uma das seguintes colunas: ChannelId, Id, MyRecentSubscribers ou MySubscribers.

As colunas extras opcionais com suporte são ForChannelId, OnBehalfOfContentOwner e OnBehalfOfContentOwnerChannel. Todas as colunas suportam o operador '='.

O pedido é compatível com Assinaturas. 'Alfabético', 'Relevância' e 'Não Lido' são as colunas de ordem com suporte.

Por padrão, se nenhum filtro for especificado, o driver retornará uma lista de canais assinados pelo usuário autenticado.

SELECT Title FROM Subscriptions WHERE ChannelId = 'abc123' ORDER BY Unread DESC

O valor padrão é SUBSCRIPTION_ORDER_RELEVANCE.

Colunas¶

Nome	Tipo	Dimensão	Métrica Padrão	Dimensão padrão	Descrição
Id [KEY]	String				O ID que o YouTube usa para identificar exclusivamente a assinatura.
PublishedAt	Datetime				A data e a hora em que a assinatura foi criada. O valor é especificado no formato ISO 8601 (AAAA-MM-DDThhss.sZ).
ChannelTitle	String				O título do canal ao qual a assinatura pertence.
Title	String				O título da assinatura.
Description	String				Os detalhes da assinatura.
ResourceIdKind	String				O tipo do recurso da API.
ResourceIdChannelId	String				O valor que o YouTube usa para identificar exclusivamente o canal no qual o usuário se inscreveu.
ChannelId	String				O ID que o YouTube usa para identificar exclusivamente o canal do assinante.
ThumbnailsDefaultUrl	String				A URL da imagem padrão.
TotalItemCount	Integer				O número aproximado de itens para os quais a assinatura aponta.
NewItemCount	Integer				O número de novos itens na assinatura desde a última leitura de seu conteúdo.
ActivityType	String				O tipo de atividade para a qual esta assinatura se destina. Valores válidos: todos, uploads.
SubscriberTitle	String				O título do canal do assinante.
SubscriberDescription	String				A descrição do canal do assinante.
SubscriberChannelId	String				O ID que o YouTube atribui para identificar exclusivamente o canal do assinante.
SubscriberThumbnailsDefaultUrl	String				A URL da imagem padrão.

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

TimeBasedReports¶

Consulte informações baseadas em tempo sobre visualizações, inscritos, etc. Por exemplo, quantos novos inscritos foram obtidos em um horário específico.

Informações específicas da tabela¶

Selecionar Regras¶

Você pode usar as tabelas a seguir para criar consultas a relatórios baseados em tempo: Relatórios baseados em tempo para vídeos:

| Dimensões | Use 0 ou mais | dia, mês, vídeo | | -------------- | ----------------- | | Métricas | Use 1 ou mais | visualizações, comentários, curtidas, desgostos, videosAddedToPlaylists, videosRemovedFromPlaylists, compartilhamentos,ratedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, assinantesGanhos, assinantesPerdidos, únicos, ganhos, adEarnings, grossRevenue, redPartnerRevenue, monetizedPlaybacks, playbackBasedCpm, impressões, impressionBasedCpm | | Filtro | Use 0 ou um | país, continente, subcontinente | | Use 0 or one | vídeo, grupo |

Relatórios baseados em tempo para regras de lista de reprodução:

| Dimensões | Use exatamente um | dia, mês | | --------------- | ------------------------------------------ | | Use 0 or more | subscritoStatus, youtubeProduct | | Métricas | Use 1 ou mais | visualizações, minutos estimados assistidos, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist | | Filtro | Obrigatório | isCurated=true | | Use 0 or one | país, província, continente, subcontinente | | Use 0 or one | playlist, canal, grupo | | Use 0 or more | subscritoStatus, youtubeProduto |

Relatórios baseados em tempo para regras de proprietário de conteúdo:

| Dimensões | Use exatamente um | dia, mês | | -------------- | -------------------------------- | | Métricas | Use 1 ou mais | visualizações, comentários, curtidas, desgostos, videosAddedToPlaylists, videosRemovedFromPlaylists, compartilhamentos,ratedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, assinantesGanhos, assinantesPerdidos, únicos, ganhos, adEarnings, grossRevenue, redPartnerRevenue, monetizedPlaybacks, playbackBasedCpm, impressões, impressionBasedCpm | | Filtro | Use exatamente um | vídeo, canal, grupo | | Use 0 or one | país, continente, subcontinente |

Relatórios baseados em tempo para regras de lista de reprodução do proprietário do conteúdo:

| Dimensões | Use exatamente um | dia, mês | | --------------- | ------------------------------------------ | | Use 0 or more | subscritoStatus, youtubeProduto | | Métricas | Use 1 ou mais | visualizações, minutos estimados assistidos, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylis | | Filtro | Obrigatório | isCurated=true | | Use 0 or one | país, província, continente, subcontinente | | Use 0 or one | playlist, canal, grupo | | Use 0 or more | subscritoStatus, youtubeProduct |

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Principais vídeos¶

Consulte os TopVideos de um canal ou as TopPlaylists se você for um proprietário de conteúdo. Você também pode usar esta exibição para consultar detalhes de reprodução e filtros geográficos.

Informações específicas da tabela¶

Selecione¶

A consultar a seguir retorna os principais vídeos de um canal por mais minutos assistidos:

SELECT * FROM TopVideos

A consultar a seguir retorna os principais vídeos de um canal por mais minutos assistidos em um país específico:

SELECT Video, Views, EstimatedMinutesWatched, AverageViewDuration, AverageViewPercentage FROM TopVideos WHERE Country = 'US'

A consultar a seguir retorna as principais playlists de um canal por mais minutos assistidos:

SELECT Playlist, Views, EstimatedMinutesWatched, PlaylistStarts, AverageViewDuration FROM TopVideos WHERE IsCurated=true

Selecionar Regras¶

Você pode usar as tabelas a seguir para criar outras consultas aos principais vídeos:

Principais vídeos para vídeos:

Principais vídeos para listas de reprodução:

| Dimensões | Obrigatório | lista de reprodução | | --------------- | ------------------------------------------ | | Métricas | Use 1 ou mais | visualizações, minutos estimados assistidos, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist | | Filtro | Obrigatório | isCurated=true | | Use 0 or one | país, província, continente, subcontinente | | Use 0 or more | lista de reprodução, subscritoStatus, youtubeProduct | | Ordenar | Use 0 ou mais (somente ordem decrescente) | visualizações, minutos estimados assistidos, lista de reproduçãoInícios |

Principais vídeos para proprietários de conteúdo:

| Dimensões | Obrigatório | vídeo | | -------------- | ------------------------------------- | | Métricas | Use 1 ou mais | visualizações, comentários, curtidas, não curtidas, videosAddedToPlaylists, videosRemovedFromPlaylists, compartilhamentos,ratedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, assinantesGanhos, assinantesPerdidos, ganhos, adEarnings, grossRevenue, redPartnerRevenue, monetizedPlaybacks, playbackBasedCpm, impressões, impressionBasedCpm | | Filtro | Use exatamente um | canal | | Use 0 or one | país, continente, subcontinente | | Ordenar | Use 0 ou mais (somente ordem decrescente) | visualizações, ganhos, redPartnerRevenue, estimadoMinutesAssistido, assinantesGanhos, assinantesPerdidos |

Principais vídeos para listas de reprodução de proprietários de conteúdo:

| Dimensões | Obrigatório | lista de reprodução | | --------------- | ------------------------------------------ | | Métricas | Use 1 ou mais | visualizações, minutos estimados assistidos, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist | | Filtro | Obrigatório | isCurated=true | | Use 0 or one | lista de reprodução, canal | | Use 0 or one | país, província, continente, subcontinente | | Use 0 or more | subscritoStatus, youtubeProduto | | Ordenar | Use 0 ou mais (somente ordem decrescente) | visualizações, minutos estimados assistidos, lista de reproduçãoInícios |

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

TrafficSources¶

Consulta TrafficSources. As estatísticas são baseadas na maneira como os espectadores acessaram seu conteúdo de vídeo e lista de reprodução.

Informações específicas da tabela¶

Selecione¶

A consultar a seguir agrega estatísticas de exibição com base na maneira como os espectadores acessaram o conteúdo do seu vídeo; por exemplo, para identificar o número de visualizações provenientes de uma pesquisa no Google ou de um link para um vídeo relacionado.

SELECT * FROM TrafficSources

A consultar a seguir exibe as métricas Views e EstimatedMinutesWatched agrupadas pelas dimensões Day e InsightTrafficSourceType:

SELECT Day, InsightTrafficSourceType, Views, EstimatedMinutesWatched FROM TrafficSources

A consultar a seguir filtra as estatísticas a serem compiladas para um vídeo e país específicos:

SELECT Day, InsightTrafficSourceType, Views, EstimatedMinutesWatched FROM TrafficSources WHERE Video = 'video_id' AND Country = 'US'

A consultar a seguir agrega estatísticas de exibição com base na maneira como os espectadores acessaram o conteúdo da sua lista de reprodução; por exemplo, para identificar o número de visualizações provenientes de uma pesquisa no Google.

SELECT InsightTrafficSourceType, Views, EstimatedMinutesWatched, PlaylistStarts, ViewsPerPlaylistStart, AverageTimeInPlaylist FROM TrafficSources WHERE IsCurated=true

A consultar a seguir retorna os termos de pesquisa que geraram mais visualizações nos resultados de pesquisa do YouTube para vídeos localizados em listas de reprodução. Observe que a ordem e a limitação são necessárias para essa consultar devido a restrições na API do YouTube Analytics.

SELECT InsightTrafficSourceDetail, Views, EstimatedMinutesWatched, PlaylistStarts, ViewsPerPlaylistStart, AverageTimeInPlaylist FROM TrafficSources WHERE IsCurated=true AND InsightTrafficSourceType='YT_SEARCH' ORDER BY Views DESC LIMIT 25

Selecionar Regras¶

Você pode usar as tabelas a seguir para criar outras consultas às origens de tráfego:

Fontes de tráfego para vídeos:

| Dimensões | Use exatamente um | insightTrafficSourceType, insightTrafficSourceDetail | | --------------- | ------------------------------------- | | Use 0 or more | dia, liveOrOnDemand, subscritoStatus | | Métricas | Use 1 ou mais | visualizações, estimadasMinutosAssistidos | | Filtro | Use 0 ou um | país, província, continente, subcontinente | | Use 0 or one | vídeo, grupo | | Use 0 or more | liveOrOnDemand, subscritoStatus | | Ordenar | Use 0 ou mais (somente ordem decrescente) | visualizações, estimadasMinutosAssistidos |

Fontes de tráfego para listas de reprodução:

| Dimensões | Use exatamente um | insightTrafficSourceType, insightTrafficSourceDetail | | --------------- | ------------------------------------------ | | Use 0 or more | dia, inscritoStatus | | Métricas | Use 1 ou mais | visualizações, minutos estimados assistidos, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist | | Filtro | Obrigatório | isCurated=true | | Use 0 or one | país, província, continente, subcontinente | | Use 0 or one | playlist, canal, grupo | | Optional | subscritoEstado | | Ordenar | Use 0 ou mais (somente ordem decrescente) | visualizações, minutos estimados assistidos, lista de reproduçãoInícios |

Fontes de tráfego para proprietários de conteúdo:

| Dimensões | Obrigatório | insightTrafficSourceType | | --------------- | ------------------------------------------ | | Use 0 or more | dia, liveOrOnDemand, subscritoStatus | | Métricas | Use 1 ou mais | visualizações, estimadasMinutosAssistidos | | Filtro | Use exatamente um | vídeo, canal, grupo | | Use 0 or one | país, província, continente, subcontinente | | Use 0 or more | liveOrOnDemand, subscritoStatus |

Fontes de tráfego para listas de reprodução de proprietários de conteúdo:

| Dimensões | Obrigatório | insightTrafficSourceType | | --------------- | ------------------------------------------ | | Use 0 or more | dia, inscritoStatus | | Métricas | Use 1 ou mais | visualizações, minutos estimados assistidos, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist | | Filtro | Obrigatório | isCurated=true | | Use 0 or one | país, província, continente, subcontinente | | Use 0 or one | playlist, canal, grupo | | Optional | subscritoEstado |

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

VideoAbuseReportReasons¶

Consulte YouTube VideoAbuseReportReasons. Um recurso VideoAbuseReportReason contém informações sobre o motivo pelo qual um vídeo seria sinalizado por conter conteúdo abusivo.

Informações específicas da tabela¶

Selecione¶

Não há filtros obrigatórios para esta tabela. Uma coluna opcional é Idioma.

O operador '=' é compatível com esta coluna.

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Categorias de vídeo¶

Consultar categorias de vídeo do YouTube. Um recurso VideoCategory identifica uma categoria que foi ou pode ser associada a vídeos enviados.

Informações específicas da tabela¶

Selecione¶

Você pode especificar exatamente uma das seguintes colunas: ID ou Região. Se você não especificar nenhum critério de filtragem, por padrão, obterá resultados para a região dos EUA. Um parâmetro opcional extra é o Idioma.

SELECT * FROM VideoCategories WHERE Region = 'JP'

O operador IN pode ser usado para filtrar vários IDs:

SELECT Id, Kind, Etag, ChannelId, Title, Assignable
FROM   VideoCategories
WHERE  (ID IN ('1', '2', '10'))

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Vídeos¶

Consultar vídeos do YouTube.

Informações específicas da tabela¶

Selecione¶

Por padrão, SupportEnhancedSQL é definido como verdadeiro e o seguinte será transmitido ao YouTube Analytics, se presente. Outros filtros serão executados no lado do cliente. Se SupportEnhancedSQL for definido como falso, apenas os seguintes filtros serão respeitados.

Por padrão, se nenhum filtro for especificado, o driver retornará todos os vídeos pertencentes ao usuário autenticado.

Apenas uma das seguintes colunas pode ser filtrada por vez: Id, MyRating, ChannelId ou Chart. As colunas extras suportadas são ForMine, Language, ForContentOwner, OnBehalfOfContentOwner.

Uma pesquisa em todos os vídeos no YouTube pode ser executada especificando SearchTerms, RelatedToVideoId, VideoDuration, VideoCategoryId ou Region.

Todas as colunas suportam o operador '='. PublishedAt também suporta estes operadores adicionais: '>', '>=', '<' e '<='. ID e ChannelId suportam IN.

Ordenar por é compatível com as colunas Data, Classificação, Relevância e Título.

SELECT * FROM Videos WHERE Id = '12345679'

SELECT * FROM Videos WHERE PublishedAt >= '2016-01-01T20:30:00Z' LIMIT 10
SELECT Description FROM Videos WHERE ForMine = True ORDER BY Date

Observação: A ordem não é suportada ao especificar uma das colunas usadas para pesquisar canais, como SearchTerms.

O operador IN pode ser usado para especificar uma lista de canais. Esta chamada retorna uma lista de vídeos para cada canal especificado.

SELECT * FROM Videos WHERE ChannelId IN (a, b, c)
SELECT * FROM Videos WHERE ChannelId IN (SELECT ID FROM Channels)

O operador IN também pode ser usado para obter dados de vários vídeos.

SELECT * FROM Videos WHERE ID IN (a, b, c)

Colunas¶

Nome	Tipo	Dimensão	Métrica Padrão	Dimensão padrão	Descrição
Id [KEY]	String				O ID que o YouTube usa para identificar exclusivamente o vídeo.
ChannelId	String				O ID que o YouTube usa para identificar exclusivamente o canal para o qual o vídeo foi enviado.
CategoryId	String				A categoria de vídeo do YouTube associada ao vídeo.
Title	String				O título do vídeo.
ChannelTitle	String				Título do canal ao qual o vídeo pertence.
PublishedAt	Datetime				A data e a hora em que o vídeo foi publicado. Observe que esse horário pode ser diferente do horário em que o vídeo foi carregado. O valor é especificado no formato ISO 8601 (AAAA-MM-DDThhss.sZ).
Description	String				A descrição do vídeo.
Duration	String				A duração do vídeo. O valor da propriedade é uma duração ISO 8601.
ViewCount	Long				O número de vezes que o vídeo foi visualizado.
LikeCount	Long				O número de usuários que indicaram que gostaram do vídeo.
DislikeCount	Long				O número de usuários que indicaram que não gostaram do vídeo. Em conjunto com as alterações para tornar a contagem de vídeos não favoritos privada em toda a plataforma do YouTube, esse campo é retornado apenas se a solicitação de API tiver sido autenticada pelo proprietário do vídeo.
CommentCount	Long				O número de comentários para o vídeo.
EmbedHtml	String				Uma tag iframe que incorpora um player que reproduzirá o vídeo.
PublicStatsViewable	Boolean				Esse valor indica se as estatísticas de vídeo estendidas na página de exibição podem ser visualizadas publicamente. Por padrão, essas estatísticas podem ser visualizadas, e estatísticas como contagem de visualizações e avaliações ainda serão visíveis publicamente, mesmo que esse valor seja definido como falso.
TagsAggregate	String				Uma lista de marcas de palavras-chave associadas ao vídeo.
LiveBroadcastContent	String				Indica se o vídeo é uma transmissão ao vivo futura/ativa. Um valor de nenhum indica que o vídeo não é uma transmissão ao vivo futura/ativa. Valores válidos para esta coluna: ao vivo, nenhum, próximo.
Dimension	String				Indica se o vídeo está disponível em 3D ou 2D.
Definition	String				Indica se o vídeo está disponível em HD de alta definição ou apenas em definição padrão. Valores válidos para esta coluna: hd, sd.
Caption	String				Indica se as legendas estão disponíveis para o vídeo. Valores válidos para esta coluna: false, true.
LicensedContent	Boolean				Indica se o vídeo representa conteúdo licenciado, o que significa que o conteúdo foi enviado para um canal vinculado a um parceiro de conteúdo do YouTube e reivindicado por esse parceiro.
AllowedAggregate	String				Uma lista de códigos de região que identificam os países onde o vídeo pode ser visualizado.
BlockedAggregate	String				Uma lista de códigos de região que identificam os países onde o vídeo está bloqueado.
Projection	String				Especifica o formato de projeção do vídeo. Valores válidos: 360, retangular.
PrivacyStatus	String				O status de privacidade da lista de reprodução. Valores válidos: privado, público, não listado.
MadeForKids	Boolean				Esse valor indica se o vídeo é feito para crianças.
License	String				A licença. Valores válidos: creativeCommon, youtube.
Embeddable	Boolean				Este valor indica se o vídeo pode ser incorporado em outro site.
ThumbnailsDefaultUrl	String				A URL da imagem padrão.
DefaultLanguage	String				Esta coluna é confidencial para testadores confiáveis. O idioma do texto nas colunas Título e Descrição.
DefaultAudioLanguage	String				A coluna default_audio_language especifica o idioma falado na faixa de áudio padrão do vídeo.
UploadStatus	String				O status do vídeo enviado. Valores válidos para esta coluna: excluído, com falha, processado, rejeitado, carregado.
FailureReason	String				Este valor explica por que um vídeo não foi carregado. Esta coluna só tem um valor se a coluna UploadStatus indicar que o upload falhou. Valores válidos para esta coluna: codec, conversão, emptyFile, invalidFile, tooSmall, uploadAborted.
RejectionReason	String				Esse valor explica por que o YouTube rejeitou um vídeo enviado. Esta coluna só tem um valor se a coluna UploadStatus indicar que o upload foi rejeitado. Valores válidos para esta coluna: reivindicação, direitos autorais, duplicado, inapropriado, comprimento, TermsOfUse, marca comercial, uploaderAccountClosed, uploaderAccountSuspended.
RecordingDate	Datetime				A data e a hora em que o vídeo foi gravado. O valor é especificado no formato ISO 8601 (AAAA-MM-DDThhss.sssZ).
SearchTerms	String				O termo de consultar a ser pesquisado.

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Procedimentos armazenados¶

Procedimentos armazenados* são interfaces semelhantes a funções que estendem a funcionalidade do conector além das simples operações SELECT/INSERT/UPDATE/DELETE com o YouTube Analytics.

Procedimentos armazenados* aceitar uma lista de parâmetros, executar a função pretendida e, em seguida, retornar, se aplicável, quaisquer dados de resposta relevantes do YouTube Analytics, junto com uma indicação de se o procedimento foi bem-sucedido ou não.

Conector Jitterbit para procedimentos armazenados do YouTube Analytics¶

CreateCustomSchema¶

Cria um arquivo de esquema personalizado com base nas dimensões e métricas especificadas.

CreateCustomSchema¶

Cria um arquivo de esquema personalizado com base nas dimensões e métricas especificadas.

Um esquema personalizado pode ser usado para uma abordagem mais personalizada para seus dados. As opções personalizadas podem incluir listas separadas por vírgulas para dados específicos.

Entrada¶

Colunas do conjunto de resultados¶

GetOAuthAccessToken¶

Obtém o token de acesso OAuth para ser usado para autenticação com vários serviços do Google.

Entrada¶

Colunas do conjunto de resultados¶

GetOAuthAuthorizationURL¶

Obtém o URL de autorização OAuth usado para autenticação com vários serviços do Google.

Entrada¶

Colunas do conjunto de resultados¶

RefreshOAuthAccessToken¶

Obtém o token de acesso OAuth para ser usado para autenticação com vários serviços do Google.

Entrada¶

Colunas do conjunto de resultados¶

Tabelas do sistema¶

Você pode consultar as tabelas do sistema descritas nesta seção para acessar informações de esquema, informações sobre a funcionalidade da fonte de dados e estatísticas de operação em lote.

Tabelas de esquema¶

As tabelas a seguir retornam metadados do banco de dados para o YouTube Analytics:

• sys_catalogs: Lista os bancos de dados disponíveis.
• sys_schemas: Lista os esquemas disponíveis.
• sys_tables: Lista as tabelas e exibições disponíveis.
• sys_tablecolumns: Descreve as colunas das tabelas e exibições disponíveis.
• sys_procedures: Descreve os procedimentos armazenados disponíveis.
• sys_procedureparameters: Descreve procedimento armazenado* parâmetros.
• sys_keycolumns: Descreve as chaves primárias e estrangeiras.
• sys_indexes: Descreve os índices disponíveis.

Tabelas de fonte de dados¶

As tabelas a seguir retornam informações sobre como se conectar e consultar a fonte de dados:

• sys_connection_props: Retorna informações sobre as propriedades de conexão disponíveis.
• sys_sqlinfo: Descreve as consultas SELECT que o conector pode descarregar para a fonte de dados.

Consultar tabelas de informações¶

A tabela a seguir retorna estatísticas de consultar para consultas de modificação de dados:

• sys_identity: Retorna informações sobre operações em lote ou atualizações únicas.

sys_catalogs¶

Lista os bancos de dados disponíveis.

A consultar a seguir recupera todos os bancos de dados determinados pela string de conexão:

SELECT * FROM sys_catalogs

Colunas¶

sys_schemas¶

Lista os esquemas disponíveis.

A consultar a seguir recupera todos os esquemas disponíveis:

SELECT * FROM sys_schemas

Colunas¶

sys_tables¶

Lista as tabelas disponíveis.

A consultar a seguir recupera as tabelas e exibições disponíveis:

SELECT * FROM sys_tables

Colunas¶

sys_tablecolumns¶

Descreve as colunas das tabelas e exibições disponíveis.

A consultar a seguir retorna as colunas e os tipos de dados da tabela Grupos:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Groups' 

Colunas¶

sys_procedures¶

Lista os procedimentos armazenados disponíveis.

A consultar a seguir recupera os procedimentos armazenados disponíveis:

SELECT * FROM sys_procedures

Colunas¶

sys_procedureparameters¶

Descreve procedimento armazenado* parâmetros.

A consultar a seguir retorna informações sobre todos os parâmetros de entrada para o procedimento armazenado RefreshOAuthAccessToken:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='RefreshOAuthAccessToken' AND Direction=1 OR Direction=2

Colunas¶

sys_keycolumns¶

Descreve as chaves primárias e estrangeiras. A consultar a seguir recupera a chave primária da tabela Grupos:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Groups'

Colunas¶

sys_foreignkeys¶

Descreve as chaves estrangeiras. A consultar a seguir recupera todas as chaves estrangeiras que se referem a outras tabelas:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Colunas¶

sys_primarykeys¶

Descreve as chaves primárias. A consultar a seguir recupera as chaves primárias de todas as tabelas e exibições:

SELECT * FROM sys_primarykeys

Colunas¶

sys_indexes¶

Descreve os índices disponíveis. Ao filtrar por índices, você pode escrever consultas mais seletivas com tempos de resposta de consultar mais rápidos.

A consultar a seguir recupera todos os índices que não são chaves primárias:

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Colunas¶

sys_connection_props¶

Retorna informações sobre as propriedades de conexão disponíveis e as definidas na string de conexão.

Ao consultar esta tabela, a string de conexão de configuração deve ser usada:

jdbc:cdata:youtubeanalytics:config:

Esta string de conexão permite que você consultar esta tabela sem uma conexão válida.

A consultar a seguir recupera todas as propriedades de conexão que foram definidas na string de conexão ou definidas por meio de um valor padrão:

SELECT * FROM sys_connection_props WHERE Value <> ''

Colunas¶

sys_sqlinfo¶

Descreve o processamento da consultar SELECT que o conector pode transferir para a fonte de dados.

Descobrindo os recursos SELECT da fonte de dados¶

Abaixo está um exemplo de conjunto de dados de recursos SQL. O conjunto de resultados a seguir indica a funcionalidade SELECT que o conector pode descarregar para a fonte de dados ou processar o lado do cliente. Sua fonte de dados pode suportar sintaxe SQL adicional. Alguns aspectos da funcionalidade SELECT são retornados em uma lista separada por vírgulas, se suportados; caso contrário, a coluna contém NO.

A consultar a seguir recupera os operadores que podem ser usados na cláusula WHERE:

SELECT * FROM sys_sqlinfo WHERE Name='SUPPORTED_OPERATORS'

Observe que tabelas individuais podem ter diferentes limitações ou requisitos na cláusula WHERE; consulte o Modelo de Dados para obter mais informações.

Colunas¶

sys_identity¶

Retorna informações sobre tentativas de modificação.

A consultar a seguir recupera os IDs das linhas modificadas em uma operação em lote:

SELECT * FROM sys_identity

Colunas¶