Detalles de Conexión de YouTube Analytics¶

Introducción¶

Versión del conector

Esta documentación se basa en la versión 22.0.8510 del conector.

Empezando¶

Compatibilidad con la versión de YouTube Analytics

El conector utiliza la versión 2 de la API de YouTube Analytics.

Establecer una Conexión¶

Conexión a YouTube Analytics¶

Proporcione las siguientes propiedades de conexión antes de agregar las propiedades de autenticación.

• ChannelId: Establecido en la ID de un canal de YouTube. Si no se especifica, se devuelven datos para el canal del usuario autenticado.
• ContentOwnerId: establezca si desea generar informes de propietarios de contenido.

Autenticación en YouTube Analytics¶

Todas las conexiones a YouTube Analytics se autentican mediante OAuth. El conector admite el uso de cuentas de usuario, cuentas de servicio y cuentas de instancias de GCP para la autenticación.

Cuentas de Usuario¶

AuthScheme debe establecerse en OAuth en todos los flujos de cuentas de usuario. Para las aplicaciones de escritorio, la aplicación integrada del conector es la forma más sencilla de autenticación. El único requisito adicional es establecer InitiateOAuth a GETANDREFRESH.

Cuando se inicie el controlador, abrirá un navegador y YouTube Analytics solicitará su información de inicio de sesión. El conector utilizará las credenciales que proporcione para acceder a sus datos de YouTube Analytics. Estas credenciales se guardarán y actualizarán automáticamente según sea necesario. Para las aplicaciones de escritorio, la aplicación predeterminada del conector es la forma más sencilla de autenticación. El único requisito adicional es establecer InitiateOAuth a GETANDREFRESH.

Cuando se inicie el controlador, abrirá un navegador y YouTube Analytics solicitará su información de inicio de sesión. El conector utilizará las credenciales que proporcione para acceder a sus datos de YouTube Analytics. Estas credenciales se guardarán y actualizarán automáticamente según sea necesario.

Cuentas de Servicio¶

Para autenticarse usando una cuenta de servicio, debe crear una nueva cuenta de servicio y tener una copia del certificado de la cuenta.

Para un archivo JSON, deberá establecer estas propiedades:

• AuthScheme: Requerido. Establézcalo en OAuthJWT.
• InitiateOAuth: Requerido. Establézcalo en GETANDREFRESH.
• OAuthJWTCertType: Requerido. Establézcalo en GOOGLEJSON.
• OAuthJWTCert: Requerido. Establézcalo en la ruta del archivo .json proporcionado por Google.
• OAuthJWTSubject: Opcional. Establezca este valor solo si la cuenta de servicio es parte de un dominio de GSuite y desea habilitar la delegación. El valor de esta propiedad debe ser la dirección de correo del usuario a cuyos datos desea acceder.

Para un archivo PFX, deberá establecer estas propiedades en su lugar:

• AuthScheme: Requerido. Establézcalo en OAuthJWT.
• InitiateOAuth: Requerido. Establézcalo en GETANDREFRESH.
• OAuthJWTCertType: Requerido. Establézcalo en PFXFILE.
• OAuthJWTCert: Requerido. Establézcalo en la ruta del archivo .pfx proporcionado por Google.
• OAuthJWTCertPassword: Opcional. Establézcalo en la contraseña del archivo .pfx. En la mayoría de los casos, será necesario proporcionarlo, ya que Google cifra los certificados PFX.
• OAuthJWTCertSubject: Opcional. Configure esto solo si está usando un OAuthJWTCertType que almacena múltiples certificados. No debe configurarse para certificados PFX generados por Google.
• OAuthJWTIssuer: Requerido. Establézcalo en la dirección de correo de la cuenta de servicio. Esta dirección generalmente incluirá el dominio iam.gserviceaccount.com.
• OAuthJWTSubject: Opcional. Establezca este valor solo si la cuenta de servicio es parte de un dominio de GSuite y desea habilitar la delegación. El valor de esta propiedad debe ser la dirección de correo del usuario a cuyos datos desea acceder.

Si aún no tiene una cuenta de servicio, puede crear una siguiendo el procedimiento en Creación de una aplicación AzureAD personalizada.

Cuentas de Instancias de GCP¶

Cuando se ejecuta en una máquina virtual de GCP, el conector puede autenticarse mediante una cuenta de servicio vinculada a la máquina virtual. Para usar este modo, establezca AuthScheme a GCPInstanceAccount.

Uso de la Autenticación OAuth¶

Utilice el estándar de autenticación OAuth para conectarse a YouTube Analytics. Puede autenticarse con una cuenta de usuario o una cuenta de servicio. El conector facilita esto como se describe a continuación.

Cuentas de Usuario¶

El flujo de la cuenta de usuario requiere que el usuario que se autentica interactúe con YouTube Analytics a través del navegador.

Credenciales Integradas¶

Consulte Credenciales integradas para conectarse con las credenciales incrustadas del conector y omitir la creación de una aplicación OAuth personalizada.

Credenciales Personalizadas¶

En lugar de conectarse con las credenciales integradas del conector, puede registrar una aplicación para obtener OAuthClientId y OAuthClientSecret.

Cuándo Crear una Aplicación OAuth Personalizada¶

La creación de una aplicación OAuth personalizada es opcional, ya que el conector ya está registrado en YouTube Analytics y puede conectarse con sus credenciales integradas. Es posible que desee crear una aplicación de OAuth personalizada para cambiar la información que se muestra cuando los usuarios inician sesión en el extremo de OAuth de YouTube Analytics para otorgar permisos al conector.

Uso de una Cuenta de Servicio para Conectarse a YouTube Analytics¶

Las cuentas de servicio tienen autenticación silenciosa, sin autenticación de usuario en el navegador. También puede usar una cuenta de servicio para delegar ámbitos de acceso de toda la empresa al conector.

Debe crear una aplicación OAuth en este flujo. Luego puede conectarse a los datos de YouTube Analytics a los que la cuenta de servicio tiene permiso para acceder. Consulte Credenciales personalizadas para obtener una guía de autenticación.

Creación de una Aplicación OAuth Personalizada¶

Consulte Crear una aplicación OAuth personalizada para un procedimiento.

Credenciales Integradas¶

Credenciales de OAuth Integradas¶

Autenticación de Escritorio con la Aplicación OAuth Integrada¶

Puede conectarse sin configurar ninguna propiedad de conexión para sus credenciales de usuario. Después de configurar lo siguiente, está listo para conectarse:

• InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.
• ChannelId: establezca esto en la ID de un canal de YouTube. Si no se especifica, se devuelven datos para el canal del usuario autenticado.
• ContentOwnerId: establezca esto en la ID del propietario del contenido si desea generar informes del propietario del contenido.

Cuando se conecta, el conector abre el extremo de OAuth en su navegador predeterminado. Inicie sesión y otorgue permisos a la aplicación. Luego, el conector completa el proceso de OAuth.

1. Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
2. Obtiene un nuevo token de acceso cuando caduca el anterior.
3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.

Credenciales Personalizadas¶

Puede usar una aplicación OAuth personalizada para autenticarse con una cuenta de servicio o una cuenta de usuario. Consulte Uso de la autenticación OAuth para más información.

Cuentas de Usuario¶

Autenticación de Escritorio con una Aplicación OAuth Personalizada¶

Siga los pasos a continuación para autenticarse con las credenciales de una aplicación OAuth personalizada. Consulte Crear una aplicación OAuth personalizada.

Obtenga y actualice el token de acceso de OAuth

Después de configurar lo siguiente, está listo para conectarse:

• OAuthClientId: Establézcalo en el ID de cliente asignado cuando registró su aplicación.
• OAuthClientSecret: establezca esto en el secreto de cliente asignado cuando registró su aplicación.
• InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.
• ChannelId: establezca esto en la ID de un canal de YouTube. Si no se especifica, se devuelven datos para el canal del usuario autenticado.
• ContentOwnerId: configure esto si desea generar informes de propietarios de contenido.

Cuando se conecta, el conector abre el extremo de OAuth en su navegador predeterminado. Inicie sesión y otorgue permisos a la aplicación. Luego, el conector completa el proceso de OAuth:

1. Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
2. Actualiza el token de acceso cuando caduca.
3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.

Cuentas de Servicio¶

Las cuentas de servicio tienen autenticación silenciosa, sin autenticación de usuario en el navegador. También puede usar una cuenta de servicio para delegar ámbitos de acceso de toda la empresa al conector.

Debe crear una aplicación OAuth en este flujo. Consulte Crear una aplicación OAuth personalizada para crear y autorizar una aplicación. Luego puede conectarse a los datos de YouTube Analytics a los que la cuenta de servicio tiene permiso para acceder.

Después de configurar las siguientes propiedades de conexión, está listo para conectarse:

• InitiateOAuth: Establézcalo en GETANDREFRESH.
• OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del cliente en la configuración de su aplicación.
• OAuthJWTCertType: Establézcalo en "PEMKEY_FILE".
• OAuthJWTCert: Establézcalo en la ruta del archivo .pem que generó.
• OAuthJWTCertPassword: establezca esto en la contraseña del archivo .pem.
• OAuthJWTCertSubject: establezca esto en "*" para elegir el primer certificado en el almacén de certificados.
• OAuthJWTSubject: establezca esto en la dirección de correo del usuario para quien la aplicación solicita acceso de delegado. Tenga en cuenta que el acceso de delegado debe ser otorgado por un administrador.
• ChannelId: establezca esto en la ID de un canal de YouTube. Si no se especifica, se devuelven datos para el canal del usuario autenticado.
• ContentOwnerId: configure esto si desea generar informes de propietarios de contenido.

Cuando se conecta, el conector completa el flujo de OAuth para una cuenta de servicio.

1. Crea y firma el JWT con el conjunto de notificaciones requerido por el conector.
2. Intercambia el JWT por el token de acceso.
3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.
4. Envía el JWT para un nuevo token de acceso cuando el token caduca.

Máquinas Sin Cabeza¶

Uso de OAuth en una Máquina Sin Cabeza¶

Las siguientes secciones muestran cómo autenticar un servidor sin periféricos u otra máquina en la que el conector no puede abrir un navegador. Puede autenticarse con una cuenta de usuario o con una cuenta de servicio.

Cuentas de Usuario¶

Para autenticarse con una cuenta de usuario, debe hacerlo desde otra máquina. La autenticación es un proceso de dos pasos.

1. En lugar de instalar el conector en otra máquina, puede seguir los pasos a continuación para obtener el OAuthVerifier valor. O bien, puede instalar el conector en otra máquina y transferir los valores de autenticación de OAuth, después de autenticarse a través del flujo habitual basado en el navegador.
2. A continuación, puede configurar el conector para actualizar automáticamente el token de acceso desde la máquina sin periféricos.

Puede seguir el flujo de autenticación de OAuth sin cabeza usando las credenciales de OAuth integradas del conector o usando las credenciales de OAuth para su aplicación de OAuth personalizada.

Uso de las Credenciales de OAuth Integradas¶

Obtenga un código verificador

Siga los pasos a continuación para autenticarse desde otra máquina y obtener el OAuthVerifier propiedad de conexión:

1. Haga clic en el siguiente enlace para abrir el extremo de OAuth de YouTube Analytics en su navegador.
2. Inicie sesión y otorgue permisos al conector. A continuación, se le redirige a la URL de devolución de llamada, que contiene el código verificador.
3. Guarde el valor del código verificador. Establecerá esto en el OAuthVerifier propiedad de conexión.

En la máquina sin periféricos, establezca las siguientes propiedades de conexión para obtener los valores de autenticación de OAuth.

• OAuthVerifier: Establézcalo en el código del verificador.
• InitiateOAuth: Establézcalo en ACTUALIZAR.
• OAuthSettingsLocation: configure esto para conservar los valores de autenticación OAuth cifrados en el archivo especificado.

Después de generar el archivo de configuración de OAuth, configure las siguientes propiedades para conectarse a los datos:

• OAuthSettingsLocation: Establézcalo en el archivo que contiene los valores de autenticación de OAuth cifrados. Asegúrese de que este archivo otorgue permisos de lectura y escritura al conector para habilitar la actualización automática del token de acceso.
• InitiateOAuth: Establézcalo en ACTUALIZAR.
• ChannelId: establezca esto en la ID de un canal de YouTube. Si no se especifica, se devuelven datos para el canal del usuario autenticado.
• ContentOwnerId: establezca esto en la ID del propietario del contenido si desea generar informes del propietario del contenido.

Transferir configuración de OAuth

Siga los pasos a continuación para instalar el conector en otra máquina, autenticar y luego transferir los valores de OAuth resultantes.

En una segunda máquina, instale el conector y conéctese con el siguiente conjunto de propiedades:

• OAuthSettingsLocation: establezca esto en un archivo de texto grabable.
• InitiateOAuth: Establézcalo en GETANDREFRESH.

Pruebe la conexión para autenticarse en el navegador. Los valores de autenticación resultantes se escriben, se cifran, en la ruta especificada por OAuthSettingsLocation. Una vez que haya probado con éxito la conexión, copie el archivo de configuración de OAuth en su máquina sin periféricos. En la máquina sin periféricos, configure las siguientes propiedades de conexión para conectarse a los datos:

• OAuthSettingsLocation: establezca esto en la ruta a su archivo de configuración de OAuth. Asegúrese de que este archivo otorgue permisos de lectura y escritura al conector para habilitar la actualización automática del token de acceso.
• ChannelId: establezca esto en la ID de un canal de YouTube. Si no se especifica, se devuelven datos para el canal del usuario autenticado.
• ContentOwnerId: establezca esto en la ID del propietario del contenido si desea generar informes del propietario del contenido.

Uso de las Credenciales para una Aplicación OAuth Personalizada¶

Cree una aplicación OAuth personalizada

La creación de una aplicación de OAuth personalizada es opcional en el flujo de OAuth sin interfaz; puede omitir la creación de una aplicación conectándose con las credenciales de OAuth integradas del conector. Es posible que desee crear una aplicación de OAuth personalizada para cambiar la información que se muestra cuando los usuarios inician sesión en YouTube Analytics para otorgar permisos al conector.

Consulte Crear una aplicación OAuth personalizada para un procedimiento. Luego puede seguir los procedimientos a continuación para autenticarse y conectarse a los datos.

Obtenga un código verificador

Establezca las siguientes propiedades en la máquina sin periféricos:

• InitiateOAuth: Ajústelo a APAGADO.
• OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del cliente en la configuración de su aplicación.

Luego puede seguir los pasos a continuación para autenticarse desde otra máquina y obtener el OAuthVerifier propiedad de conexión.

1. Llame a GetOAuthAuthorizationURL procedimiento almacenado* con el parámetro de entrada CallbackURL establecido en el URI de redirección exacto que especificó en la configuración de su aplicación.
2. Abra la URL devuelta en un navegador. Inicie sesión y otorgue permisos al conector. A continuación, se le redirige a la URL de devolución de llamada, que contiene el código verificador.
3. Guarde el valor del código verificador. Establecerá esto en el OAuthVerifier propiedad de conexión.

En la máquina sin periféricos, establezca las siguientes propiedades de conexión para obtener los valores de autenticación de OAuth:

• OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.
• OAuthVerifier: Establézcalo en el código del verificador.
• OAuthSettingsLocation: configure esto para conservar los valores de autenticación OAuth cifrados en el archivo especificado.
• InitiateOAuth: Establézcalo en ACTUALIZAR.

Después de generar el archivo de configuración de OAuth, configure las siguientes propiedades para conectarse a los datos:

• OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.
• OAuthSettingsLocation: Establézcalo en el archivo que contiene los valores de autenticación de OAuth cifrados. Asegúrese de que este archivo otorgue permisos de lectura y escritura al proveedor para habilitar la actualización automática del token de acceso.
• InitiateOAuth: Establézcalo en ACTUALIZAR.
• ChannelId: establezca esto en la ID de un canal de YouTube. Si no se especifica, se devuelven datos para el canal del usuario autenticado.
• ContentOwnerId: establezca esto en la ID del propietario del contenido si desea generar informes del propietario del contenido.

Transferir configuración de OAuth

Siga los pasos a continuación para instalar el conector en otra máquina, autenticar y luego transferir los valores de OAuth resultantes.

En una segunda máquina, instale el conector y conéctese con el siguiente conjunto de propiedades:

• OAuthSettingsLocation: establezca esto en un archivo de texto grabable.
• InitiateOAuth: Establézcalo en GETANDREFRESH.
• OAuthClientId: Establézcalo en el ID de cliente asignado cuando registró su aplicación.
• OAuthClientSecret: establezca esto en el secreto de cliente asignado cuando registró su aplicación.

Pruebe la conexión para autenticarse. Los valores de autenticación resultantes se escriben, se cifran, en la ruta especificada por OAuthSettingsLocation. Una vez que haya probado con éxito la conexión, copie el archivo de configuración de OAuth en su máquina sin periféricos. En la máquina sin periféricos, configure las siguientes propiedades de conexión para conectarse a los datos:

• InitiateOAuth: Establézcalo en ACTUALIZAR.
• OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.
• OAuthSettingsLocation: establezca esto en la ruta a su archivo de configuración de OAuth. Asegúrese de que este archivo otorgue permisos de lectura y escritura al conector para habilitar la actualización automática del token de acceso.
• ChannelId: establezca esto en la ID de un canal de YouTube. Si no se especifica, se devuelven datos para el canal del usuario autenticado.
• ContentOwnerId: establezca esto en la ID del propietario del contenido si desea generar informes del propietario del contenido.

Cuentas de Servicio¶

Las cuentas de servicio tienen autenticación silenciosa, sin autenticación de usuario en el navegador. También puede usar una cuenta de servicio para delegar ámbitos de acceso de toda la empresa al conector.

Debe crear una aplicación OAuth en este flujo. Consulte Crear una aplicación OAuth personalizada para crear y autorizar una aplicación. Luego puede conectarse a los datos de YouTube Analytics a los que la cuenta de servicio tiene permiso para acceder.

Después de configurar las siguientes propiedades de conexión, está listo para conectarse:

• InitiateOAuth: Establézcalo en GETANDREFRESH.
• OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del cliente en la configuración de su aplicación.
• OAuthJWTCertType: Establézcalo en "PEMKEY_FILE".
• OAuthJWTCert: Establézcalo en la ruta del archivo .pem que generó.
• OAuthJWTCertPassword: establezca esto en la contraseña del archivo .pem.
• OAuthJWTCertSubject: establezca esto en "*" para elegir el primer certificado en el almacén de certificados.
• OAuthJWTSubject: establezca esto en su ID de empresa si su tipo de asunto está configurado en "empresa" o su ID de usuario de la aplicación si su tipo de asunto está configurado en "usuario".
• ChannelId: establezca esto en la ID de un canal de YouTube. Si no se especifica, se devuelven datos para el canal del usuario autenticado.
• ContentOwnerId: establezca esto en la ID del propietario del contenido si desea generar informes del propietario del contenido.

Cuando se conecta, el conector completa el flujo de OAuth para una cuenta de servicio.

1. Crea y firma el JWT con el conjunto de notificaciones requerido por el conector.
2. Intercambia el JWT por el token de acceso.
3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.
4. Envía el JWT para un nuevo token de acceso cuando el token caduca.

Creación de una Aplicación OAuth Personalizada¶

Puede usar una aplicación OAuth personalizada para autenticar una cuenta de servicio o una cuenta de usuario. Consulte Uso de la autenticación OAuth para más información.

Cree una Aplicación OAuth para la Autenticación de Cuentas de Usuario¶

Siga el procedimiento a continuación para registrar una aplicación y obtener el OAuthClientId y OAuthClientSecret.

Crear una Aplicación OAuth Personalizada: Escritorio¶

1. Inicie sesión en la Consola API de Google y abra un proyecto. Seleccione el API Manager en el menú principal.
2. En el flujo de consentimiento del usuario, haga clic en Credenciales -> Crear credenciales -> ID de cliente de OAuth. Haz clic en Otro. Después de crear la aplicación, OAuthClientId y OAuthClientSecret son mostrados.
3. Haga clic en Biblioteca -> API de YouTube Analytics -> Habilitar API.

Cree una Aplicación OAuth para la Autenticación de Cuentas de Servicio¶

Siga los pasos a continuación para crear una aplicación OAuth y generar una clave privada. A continuación, autorizará la cuenta de servicio.

1. Inicie sesión en la Consola API de Google y abra un proyecto. Seleccione el API Manager en el menú principal.
2. Haga clic en Crear credenciales -> Clave de cuenta de servicio.
3. En el menú Cuenta de servicio, seleccione Nueva cuenta de servicio o seleccione una cuenta de servicio existente.
4. Si está creando una nueva cuenta de servicio, seleccione además uno o más roles. Puede asignar roles primitivos a nivel de proyecto en la sección IAM y Admin; otras funciones le permiten personalizar aún más el acceso a las APIs de Google.
5. En la sección Tipo de clave, seleccione el tipo de clave P12.
6. Cree la aplicación para descargar el par de claves. Se muestra la contraseña de la clave privada: Configure esto en OAuthJWTCertPassword.
7. En la sección de cuentas de servicio, haga clic en Administrar cuentas de servicio y configure OAuthJWTIssuer a la dirección de correo que se muestra en el campo ID de la cuenta de servicio.
8. Haga clic en Biblioteca -> API de YouTube Analytics -> Habilitar API.

Recuperación de Datos de YouTube Analytics¶

Los datos de YouTube Analytics se organizan en varias métricas (Espectadores, Porcentaje de espectadores, Grupo de edad, etc.), que se pueden consultar en varias dimensiones (Día, Tipo de dispositivo, etc.). Hay muchas combinaciones válidas de métricas y dimensiones. El conector muestra algunas de las combinaciones más utilizadas como vistas relacionales para facilitar su uso.

Además, el conector le permite consultar todas las combinaciones válidas, incluso aquellas que no están incluidas en las vistas predefinidas. Puede usar Crear esquema personalizado procedimiento almacenado* para crear una vista en una consultar. Consulte Modelo de datos para saber cómo combinar métricas y dimensiones en consultas y esquemas. A continuación se muestra una guía para comenzar con las vistas predeterminadas.

Selección de Dimensiones y Medidas¶

La dimensión y las métricas están claramente definidas para cada tabla y se pueden ver en el Modelo de datos: simplemente seleccione las métricas y las dimensiones que le interesen. Por ejemplo, los mejores videos de un canal por más minutos vistos en un país específico se pueden seleccionar de esta manera:

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

Ejecutando SELECT * Consultas¶

A diferencia de la mayoría de las tablas de bases de datos, no es muy útil seleccionar todas las métricas y dimensiones en una tabla determinada. Por lo tanto, el conector interpreta la consultar SELECT * para indicar que se solicita un conjunto predeterminado de métricas y dimensiones. Esto incluye consultas que seleccionan explícitamente todas las columnas. Consulte la documentación de la vista individual en Modelo de datos para ver qué campos son los predeterminados para cada esquema.

Funciones avanzadas¶

Esta sección detalla una selección de funciones avanzadas del conector de YouTube Analytics.

Vistas definidas por el usuario

El conector le permite definir tablas virtuales, llamadas vistas definidas por el usuario, cuyo contenido se decide mediante una consultar preconfigurada. Estas vistas son útiles cuando no puede controlar directamente las consultas que se envían a los controladores. Consulte Vistas definidas por el usuario para obtener una descripción general de la creación y configuración de vistas personalizadas.

Apoderado

Para configurar el conector mediante Configuración de proxy de Agente Privado, Selecciona el Use Proxy Settings casilla de verificación en la pantalla de configuración de la conexión.

Procesamiento de consultas

El conector descarga la mayor parte posible del procesamiento de la declaración SELECT en YouTube Analytics y luego procesa el resto de la consultar en la memoria (del lado del cliente).

Consulte Procesamiento de consultas para más información.

Vistas definidas por el usuario¶

El Jitterbit Connector para YouTube Analytics te permite definir una tabla virtual cuyos contenidos se deciden mediante una consultar preconfigurada. Estas se denominan Vistas definidas por el usuario, que son útiles en situaciones en las que no puede controlar directamente la consultar que se envía al controlador, por ejemplo, cuando se utiliza el controlador de Jitterbit. Las vistas definidas por el usuario se pueden utilizar para definir predicados que siempre se aplican. Si especifica predicados adicionales en la consultar a la vista, se combinan con la consultar ya definida como parte de la vista.

Hay dos formas de crear vistas definidas por el usuario:

• Cree un archivo de configuración con formato JSON que defina las vistas que desea.
• Declaraciones DDL.

Definición de vistas mediante un archivo de configuración¶

Las vistas definidas por el usuario se definen en un archivo de configuración con formato JSON llamado UserDefinedViews.json. El conector detecta automáticamente las vistas especificadas en este archivo.

También puede tener múltiples definiciones de vista y controlarlas usando UserDefinedViews propiedad de conexión. Cuando utiliza esta propiedad, el conector solo ve las vistas especificadas.

Este archivo de configuración de vista definida por el usuario tiene el siguiente formato:

• Cada elemento raíz define el nombre de una vista.
• Cada elemento raíz contiene un elemento hijo, llamado query, que contiene la consultar SQL personalizada para la vista.

Por ejemplo:

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

Utilizar el UserDefinedViews propiedad de conexión para especificar la ubicación de su archivo de configuración JSON. Por ejemplo:

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

Definición de vistas usando sentencias DDL¶

El conector también es capaz de crear y modificar el esquema a través de instrucciones DDL como CREATE LOCAL VIEW, ALTER LOCAL VIEW y DROP LOCAL VIEW.

Crear una vista¶

Para crear una nueva vista usando declaraciones DDL, proporcione el nombre de la vista y la consultar de la siguiente manera:

CREATE LOCAL VIEW [MiNombre de vista] AS SELECT * FROM Customers LIMIT 20;

Si no existe ningún archivo JSON, el código anterior crea uno. Luego, la vista se crea en el archivo de configuración JSON y ahora se puede detectar. La ubicación del archivo JSON se especifica mediante UserDefinedViews propiedad de conexión.

Modificar una vista¶

Para modificar una vista existente, proporcione el nombre de una vista existente junto con la nueva consultar que le gustaría usar en su lugar:

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

Luego, la vista se actualiza en el archivo de configuración JSON.

Soltar una vista¶

Para descartar una vista existente, proporcione el nombre de un esquema existente junto con la nueva consultar que le gustaría usar en su lugar.

DROP LOCAL VIEW [MyViewName]

Esto elimina la vista del archivo de configuración JSON. Ya no se puede consultar.

Esquema para vistas definidas por el usuario¶

Las vistas definidas por el usuario se exponen en UserViews esquema por defecto. Esto se hace para evitar que el nombre de la vista entre en conflicto con una entidad real en el modelo de datos. Puede cambiar el nombre del esquema utilizado para UserViews configurando UserViewsSchemaName propiedad.

Trabajar con vistas definidas por el usuario¶

Por ejemplo, una instrucción SQL con una vista definida por el usuario llamada UserViews.RCustomers solo enumera clientes en Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Un ejemplo de una consultar al controlador:

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

Dando como resultado la consultar efectiva a la fuente:

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

Ese es un ejemplo muy simple de una consultar a una vista definida por el usuario que es efectivamente una combinación de la consultar de vista y la definición de vista. Es posible componer estas consultas en patrones mucho más complejos. Todas las operaciones de SQL están permitidas en ambas consultas y se combinan cuando corresponde.

Modelo de datos¶

Jitterbit Connector para YouTube Analytics modela entidades de YouTube Analytics en tablas relacionales, vistas y procedimientos almacenados. YouTube Analytics permite consultar Dimensiones y Métricas en una gran cantidad de arreglos. Se proporcionan algunas vistas de muestra basadas en informes comunes de YouTube Analytics. Sin embargo, también puede crear sus propias vistas personalizadas basadas en cualquier combinación de dimensiones y métricas que necesite.

En esta sección se documentan la creación de esquemas de vista, así como las limitaciones y los requisitos de la API.

Mesas

Puede acceder a Grupos y Elementos de grupo como Tablas.

Procedimientos almacenados

NOTE: Los procedimientos almacenados no se admiten actualmente. Consulte la nota anterior para detalles.

Procedimientos almacenados son interfaces similares a funciones para la fuente de datos. Se pueden usar para acceder a funciones adicionales de la API de YouTube Analytics.

Puntos de vista

Los informes se muestran como vistas, tablas que no se pueden modificar. Sin embargo, a diferencia de las vistas de base de datos tradicionales, no es muy útil seleccionar todas las métricas y dimensiones en una tabla determinada. Por lo tanto, el proveedor interpreta la consultar SELECT * en el sentido de que se solicita un conjunto predeterminado de métricas y dimensiones. Esto incluye consultas que seleccionan explícitamente todas las columnas.

Además, la API de YouTube Analytics limita el número y las combinaciones de columnas que pueden proyectarse sobre los datos o usarse para restringir los resultados devueltos. Puede encontrar estas limitaciones y los campos predeterminados para cada esquema en Vistas. Consulte estas secciones también cuando defina su propia vista.

Definición de vistas personalizadas¶

Para crear una vista en una consultar, puede usar CreateCustomSchema procedimiento almacenado. El CrearEsquemaPersonalizado procedimiento almacenado* proporciona una manera fácil de generar nuevas definiciones de vista con una combinación personalizada de dimensiones y métricas. Llamarlo creará un nuevo archivo de esquema que puede consultar como cualquier otra vista.

El procedimiento almacenado* toma un nombre de vista, una lista de métricas separadas por comas, una lista de dimensiones separadas por comas y una carpeta de salida como entradas. Deberá configurar Location propiedad de conexión a la carpeta que contiene los nuevos archivos de secuencia de comandos para poder acceder a ellos; el Location se puede configurar en lugar de la carpeta de salida.

Por ejemplo, para usar un nuevo esquema junto con los esquemas predeterminados, configure Location propiedad a la subcarpeta db en la carpeta de instalación y realice la siguiente llamada:

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

Tablas¶

El conector modela los datos en YouTube Analytics en una lista de tablas que se pueden consultar mediante instrucciones SQL estándar.

Por lo general, consultar las tablas de YouTube Analytics es lo mismo que consultar una tabla en una base de datos relacional. A veces hay casos especiales, por ejemplo, incluir una determinada columna en la cláusula WHERE puede ser necesario para obtener datos para ciertas columnas de la tabla. Esto suele ser necesario para situaciones en las que se debe realizar una solicitud separada para cada fila para obtener ciertas columnas. Estos tipos de situaciones están claramente documentados en la parte superior de la página de la tabla vinculada a continuación.

Conector Jitterbit para tablas de YouTube Analytics¶

Elementos de grupo¶

Crear, eliminar y consultar Elementos que componen un Grupo.

Información específica de la tabla¶

Seleccionar¶

La siguiente consultar devuelve los elementos que componen los grupos de YouTube Analytics:

SELECT * FROM GroupItems

La siguiente consultar devuelve los elementos que componen un grupo específico de YouTube Analytics:

SELECT * FROM GroupItems WHERE GroupId='239_65GrkKS6kRL'

Además, OnBehalfOfContentOwner se puede usar opcionalmente en la cláusula WHERE.

Insertar¶

GroupId y Resource_Id son necesarios para insertar un elemento en un grupo.

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

Columnas¶

Grupos¶

Crear, actualizar, eliminar y consultar grupos de YouTube Analytics.

Información específica de la tabla¶

Un grupo es una colección personalizada de hasta 200 canales, videos, listas de reproducción o recursos. Todos los elementos de un grupo deben representar el mismo tipo de entidad. Por ejemplo, no puede crear un grupo que contenga 100 videos y 100 listas de reproducción. Un grupo de análisis solo puede contener entidades que haya cargado o reclamado o que estén vinculadas a un canal que administre. Como resultado, los propietarios de contenido pueden crear grupos de videos, listas de reproducción, canales o activos. Los propietarios de los canales pueden crear grupos de videos y listas de reproducción.

Seleccionar¶

Las siguientes columnas se pueden usar en la cláusula WHERE: OnBehalfOfContentOwner y Mine.

Insertar¶

Se requiere ContentDetails_ItemType para insertar un grupo.

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

Columnas¶

Vistas¶

Las vistas se componen de columnas y pseudocolumnas. Las vistas son similares a las tablas en la forma en que se representan los datos; sin embargo, las vistas no admiten actualizaciones. Las entidades que se representan como vistas suelen ser entidades de solo lectura. A menudo, un procedimiento almacenado* está disponible para actualizar los datos si dicha funcionalidad es aplicable a la fuente de datos.

Las consultas se pueden ejecutar contra una vista como si fuera una tabla normal, y los datos que regresan son similares en ese sentido.

Se admiten las vistas dinámicas, como las consultas expuestas como vistas y las vistas para buscar combinaciones específicas de elementos de trabajo project_team.

Conector Jitterbit para vistas de YouTube Analytics¶

Actividades¶

Consulta las actividades de YouTube. Un recurso de actividad contiene información sobre una acción que un canal o usuario en particular ha realizado en YouTube.

Información específica de la tabla¶

Seleccionar¶

YouTube Analytics permite que solo se utilice un subconjunto de columnas como criterio de filtro. Puede especificar exactamente una de las siguientes columnas: ChannelId o Home. Además, las columnas opcionales adicionales admitidas son PublishedAt y Region.

Todas las columnas admiten el operador '='. PublishedAt también admite '>', '>=', '<' y '<='.

De forma predeterminada, si no se especifican filtros, el controlador devolverá las actividades generadas por el usuario autenticado.

SELECT * FROM Activities WHERE Home = true LIMIT 2

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

Columnas¶

Nombre	Tipo	Dimensión	Métrica predeterminada	Dimensión por defecto	Descripción
Id [KEY]	String				El ID que usa YouTube para identificar de forma única la actividad.
PublishedAt	Datetime				La fecha y hora en que ocurrió la actividad. El valor está en formato ISO 8601 (YYYY-MM-DDThhss.sZ).
ChannelId	String				El ID que utiliza YouTube para identificar de forma exclusiva el canal asociado con la actividad.
Title	String				El título del recurso asociado principalmente con la actividad.
Description	String				La descripción del recurso asociado principalmente con la actividad.
ChannelTitle	String				Título del canal para el canal responsable de esta actividad.
Type	String				El tipo de actividad que describe el recurso. Valores válidos: channelItem, comentario (no devuelto actualmente), favorito, me gusta, playlistItem, recomendación, redes sociales, suscripción y carga.
GroupId	String				El ID de grupo asociado con la actividad.
ThumbnailsDefaultUrl	String				La URL de la miniatura de la imagen predeterminada.
UploadVideoId	String				El ID que usa YouTube para identificar de manera única el video subido.
LikeResourceIdKind	String				El tipo de recurso que recibió una calificación positiva (me gusta).
LikeResourceIdVideoId	String				El ID que usa YouTube para identificar de forma exclusiva el video, si el recurso calificado es un video. Esta columna solo está presente si ResourceIdKind es youtube#video.
FavoriteResourceIdKind	String				El tipo de entidad de YouTube marcada como favorita.
FavoriteResourceIdVideoId	String				El ID que usa YouTube para identificar de forma única el video favorito.
CommentResourceIdKind	String				El comentario sobre el recurso API.
CommentResourceIdVideoId	String				El ID que usa YouTube para identificar de forma única el video asociado con un comentario.
CommentResourceIdChannelId	String				El ID que usa YouTube para identificar de forma única el canal asociado con un comentario.
SubscriptionResourceIdKind	String				El tipo de suscripción. Una suscripción es un canal al que se suscribió un usuario.
SubscriptionResourceIdChannelId	String				El ID que utiliza YouTube para identificar de forma exclusiva el canal al que se suscribió el usuario.
PlaylistItemResourceIdKind	String				El tipo del elemento de la lista de reproducción.
PlaylistItemResourceIdVideoId	String				El ID que usa YouTube para identificar de forma exclusiva el video que se agregó a la lista de reproducción.
PlaylistItemPlaylistId	String				El valor que utiliza YouTube para identificar de forma única la lista de reproducción.
PlaylistItemPlaylistItemId	String				El valor que utiliza YouTube para identificar de forma exclusiva el elemento en la lista de reproducción.
RecommendationResourceIdKind	String				El tipo de recomendación.
RecommendationResourceIdVideoId	String				El ID que usa YouTube para identificar de forma exclusiva el video, si el recurso recomendado es un video.
RecommendationResourceIdChannelId	String				El ID que utiliza YouTube para identificar de forma exclusiva el canal, si el recurso recomendado es un canal.
RecommendationReason	String				El motivo por el que se recomendó la entidad de YouTube al usuario. Valores válidos para esta columna: sin especificar, videoFavorited, videoLiked y videoWatched.
RecommendationSeedResourceIdKind	String				El tipo de entidad de YouTube que generó la recomendación.
RecommendationSeedResourceIdVideoId	String				El ID que usa YouTube para identificar de forma única el video, si la recomendación fue causada por un video en particular.
RecommendationSeedResourceIdChannelId	String				El ID que usa YouTube para identificar de forma única el canal, si la recomendación fue causada por un canal en particular.
RecommendationSeedResourceIdPlaylistId	String				El ID que usa YouTube para identificar de forma única la lista de reproducción, si la recomendación fue causada por una lista de reproducción en particular.
SocialType	String				El nombre de la publicación en la red social. Valores válidos para esta columna: facebook, googlePlus, twitter y sin especificar.
SocialResourceIdKind	String				El tipo de publicación en la red social.
SocialResourceIdVideoId	String				El ID que usa YouTube para identificar de manera única el video que aparece en una publicación de una red social, si la publicación hace referencia a un video.
SocialResourceIdChannelId	String				El ID que utiliza YouTube para identificar de forma exclusiva el canal que aparece en una publicación de una red social, si la publicación hace referencia a un canal.
SocialResourceIdPlaylistId	String				El ID que usa YouTube para identificar de forma única la lista de reproducción que aparece en una publicación en una red social.
SocialAuthor	String				El autor de la publicación en la red social.
SocialReferenceUrl	String				La URL de la publicación en la red social.
SocialImageUrl	String				Una imagen del autor del post.
ChannelItemResourceId	String				El ID de la entidad de YouTube que se agregó al canal.

Pseudocolumnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Informes de rendimiento de anuncios¶

Informes de rendimiento de anuncios de consulta. Los informes de rendimiento de anuncios proporcionan métricas basadas en impresiones para los anuncios que se ejecutaron durante la reproducción de videos. Estas métricas dan cuenta de cada impresión de anuncio, y cada reproducción de video puede producir múltiples impresiones.

Información específica de la tabla¶

Seleccionar¶

Obtén los ingresos brutos de un video en un país específico agrupado por tipo de anuncio y día:

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

Seleccionar reglas¶

Informes de rendimiento de anuncios para propietarios de contenido:

| Dimensiones | Obligatorio | Tipo de anuncio | | -------------- | -------------------------------- | | Optional | día | | Métricas | Utilice 1 o más | ingresos brutos, impresiones publicitarias, cpm | | Filtro | Utilice exactamente uno | video, grupo o una combinación admitida de uploaderType y ClaimStatus | | Use 0 or one | país, continente, subcontinente |

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Títulos¶

Consulta los subtítulos de YouTube. Un recurso Caption representa una pista de subtítulos de YouTube.

Información específica de la tabla¶

Seleccionar¶

YouTube Analytics permite que solo se utilice un subconjunto de columnas como criterio de filtro. Se debe especificar la columna VideoId. Las columnas opcionales adicionales admitidas son ID y OnBehalfOfContentOwner.

Todas las columnas admiten el operador '='.

SELECT * FROM Captions WHERE VideoId = '123456789'

Columnas¶

Nombre	Tipo	Dimensión	Métrica predeterminada	Dimensión por defecto	Descripción
Id [KEY]	String				El ID que utiliza YouTube para identificar de forma exclusiva la pista de subtítulos.
VideoId	String				El ID que usa YouTube para identificar de forma exclusiva el video asociado con la pista de subtítulos.
LastUpdated	Datetime				La fecha y la hora en que se actualizó por última vez la pista de subtítulos. El valor se especifica en formato ISO 8601 (YYYY-MM-DDThhss.sZ).
TrackKind	String				El tipo de la pista de subtítulos. Valores válidos para esta columna: ASR (una pista de subtítulos generada mediante el reconocimiento de voz automático); Forzado (una pista de subtítulos que se reproduce cuando no se selecciona ninguna otra pista en el reproductor. Por ejemplo, un video que muestra extraterrestres hablando en un idioma extranjero puede tener una pista de subtítulos forzados para mostrar solo subtítulos para el idioma extranjero); estándar (una pista de subtítulos regular. Este es el valor predeterminado).
Language	String				El idioma de la pista de subtítulos. El valor de la columna es una etiqueta de idioma BCP-47.
Name	String				El nombre de la pista de subtítulos. El nombre está destinado a ser visible para el usuario como una opción durante la reproducción.
AudioTrackType	String				El tipo de pista de audio asociada con la pista de subtítulos. Valores válidos para esta columna: comentario (la pista de subtítulos corresponde a una pista de audio alternativa que incluye comentarios, como los comentarios del director); descriptivo (la pista de subtítulos corresponde a una pista de audio alternativa que incluye audio descriptivo adicional); principal (la pista de subtítulos corresponde a la pista de audio principal del video, que es la pista de audio normalmente asociada con el video); desconocido (este es el valor predeterminado).
IsCC	Boolean				Indica si la pista contiene subtítulos para personas sordas o con dificultades auditivas. El valor predeterminado es falso.
IsLarge	Boolean				Indica si la pista de subtítulos utiliza texto grande para personas con problemas de visión. El valor predeterminado es falso.
IsEasyReader	Boolean				Indica si la pista de subtítulos está formateada para facilitar la lectura, lo que significa que está en un nivel de tercer grado para estudiantes de idiomas. El valor predeterminado es falso.
IsDraft	Boolean				Indica si la pista de subtítulos es un borrador. Si el valor es verdadero, la pista no es públicamente visible. El valor predeterminado es falso.
IsAutoSynced	Boolean				Indica si YouTube sincronizó la pista de subtítulos con la pista de audio del video. El valor será verdadero si se solicitó explícitamente una sincronización cuando se cargó la pista de subtítulos. Si el valor es falso, YouTube usa los códigos de tiempo en la pista de subtítulos cargada para determinar cuándo mostrar los subtítulos.
Status	String				El estado de la pista de subtítulos. Valores válidos para esta columna: fallado, sirviendo, sincronizando.
FailureReason	String				La razón por la que YouTube no pudo procesar la pista de subtítulos. Valores válidos: processingFailed (YouTube no pudo procesar la pista de subtítulos cargada); unknownFormat (no se reconoció el formato de la pista de subtítulos); unsupportedFormat (el formato de la pista de subtítulos no es compatible).

Canales¶

Consulta de canales de YouTube.

Información específica de la tabla¶

Seleccionar¶

Por defecto, SupportEnhancedSQL se establece en verdadero y lo siguiente se pasará a YouTube Analytics, si está presente. Otros filtros se ejecutarán del lado del cliente. Si SupportEnhancedSQL se establece en falso, solo se respetarán los siguientes filtros.

De manera predeterminada, si no se especifican filtros, el controlador devolverá todos los canales que pertenecen al usuario autenticado.

YouTube Analytics permite que solo se utilice un subconjunto de columnas como criterio de filtro. Los canales se pueden filtrar por el Id. Las columnas opcionales adicionales admitidas son Language y ChannelId.

Se puede activar una búsqueda en todos los canales en YouTube Analytics especificando uno o más términos de búsqueda, ID de canal, región, SafeSearch, calificación o relevancia para buscar en todos los canales.

Todas las columnas admiten el operador '='. 'PublishedAt' también admite '>', '>=', '<' y '<='.

Ordenar por es compatible con las columnas Calificación, Relevancia y Título.

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

Nota: No se admite la ordenación cuando se especifica una de las columnas utilizadas para buscar canales como SearchTerms.

Columnas¶

Nombre	Tipo	Dimensión	Métrica predeterminada	Dimensión por defecto	Descripción
Id [KEY]	String				El ID que utiliza YouTube para identificar de forma exclusiva el canal.
Title	String				El título del canal.
Description	String				La descripción del canal. El valor de la columna tiene una longitud máxima de 1000 caracteres.
CustomUrl	String				La URL personalizada del canal.
PublishedAt	Datetime				La fecha y hora en que se creó el canal. El valor se especifica en formato ISO 8601 (YYYY-MM-DDThhss.sZ).
ThumbnailsDefaultUrl	String				La URL de la miniatura de la imagen predeterminada.
DefaultLanguage	String				Esta columna es confidencial para evaluadores de confianza.
LiveBroadcastContent	String				Una indicación de si un recurso de video o canal tiene contenido de transmisión en vivo.
LocalizedTitle	String				Esta columna es confidencial para evaluadores de confianza. El título del video localizado.
LocalizedDescription	String				Esta columna es confidencial para evaluadores de confianza. La descripción del video localizado.
Country	String				El país con el que está asociado el canal.
ViewCount	Long				El número de veces que se ha visto el canal.
SubscriberCount	Long				El número de suscriptores que tiene el canal. Este valor se redondea a tres cifras significativas.
HiddenSubscriberCount	Boolean				Indica si el recuento de suscriptores del canal es visible públicamente.
VideoCount	Long				El número de videos subidos al canal.
RelatedPlaylistsLikes	String				El ID de la lista de reproducción que contiene los videos que te gustan del canal.
RelatedPlaylistsUploads	String				El ID de la lista de reproducción que contiene los videos subidos del canal.
PrivacyStatus	String				Estado de privacidad del canal. Valores válidos para esta columna: privado, público, no listado.
IsLinked	Boolean				Indica si los datos del canal identifican a un usuario que ya está vinculado a un nombre de usuario de YouTube o a una cuenta de Google+. Un usuario que tiene uno de estos enlaces ya tiene una identidad pública de YouTube, lo cual es un prerrequisito para varias acciones, como subir videos.
LongUploadsStatus	String				Indica si el canal es elegible para subir videos de más de 15 minutos de duración. Esta columna solo se devuelve si el propietario del canal autorizó la solicitud de API. Consulte el Centro de ayuda de YouTube para obtener más información sobre esta función.
MadeForKids	Boolean				Este valor indica si el canal está designado como dirigido a niños y contiene el estado actual del canal "creado para niños".
Keywords	String				Palabras clave asociadas a tu canal. El valor es una lista de cadenas separadas por espacios.
TrackingAnalyticsAccountId	String				El ID de una cuenta de Google Analytics que desea utilizar para realizar un seguimiento y medir el tráfico de su canal.
ModerateComments	Boolean				Esta configuración determina si los comentarios enviados por el usuario que quedan en la página del canal deben ser aprobados por el propietario del canal para que sean visibles públicamente. El valor predeterminado es falso.
SearchTerms	String				El parámetro SearchTerms especifica el término de consultar para buscar.

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Secciones de canales¶

Consultar secciones de canales de YouTube. Una ChannelSection contiene información sobre un conjunto de videos que un canal ha elegido presentar.

Información específica de la tabla¶

Seleccionar¶

YouTube Analytics permite que solo se utilice un subconjunto de columnas como criterio de filtro. Puede especificar exactamente una de las siguientes columnas: ChannelId o Id. Las columnas opcionales adicionales admitidas son Language y OnBehalfOfContentOwner.

Todas las columnas admiten el operador '='.

De manera predeterminada, si no se especifica una ID de canal, el controlador devolverá secciones de canal para el canal propiedad del usuario autenticado.

SELECT * FROM ChannelSections WHERE ChannelId = '123456789'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Comentarios¶

Consulta los comentarios de YouTube.

Información específica de la tabla¶

Seleccionar¶

YouTube Analytics permite que solo se utilice un subconjunto de columnas como criterio de filtro. Debe especificar exactamente una de las siguientes columnas: ID o ParentId. Las columnas opcionales adicionales admitidas son TextFormat.

Todas las columnas admiten el operador '='.

SELECT * FROM Comments WHERE ID = '123456789'

Columnas¶

Nombre	Tipo	Dimensión	Métrica predeterminada	Dimensión por defecto	Descripción
Id [KEY]	String				El ID que usa YouTube para identificar de forma única el comentario.
ChannelId	String				El ID del canal de YouTube asociado con el comentario. Si el comentario es un comentario de video, esta columna identifica el canal del video y la columna VideoId identifica el video. Si el comentario es un comentario de canal, esta columna identifica el canal sobre el que se trata el comentario.
VideoId	String				El ID del video al que se refiere el comentario.
TextDisplay	String				El texto del comentario. El texto se puede recuperar en texto sin formato o HTML. La pseudocolumna TextFormat especifica el formato de texto deseado.
TextOriginal	String				El texto original sin procesar del comentario tal como se publicó inicialmente o se actualizó por última vez. El texto original solo se devuelve si es accesible para el usuario autenticado, lo que solo está garantizado si el usuario es el autor del comentario.
ParentId	String				El ID único del comentario principal. El valor de esta columna solo se establece si el comentario se envió como respuesta a otro comentario.
AuthorDisplayName	String				El nombre para mostrar del usuario que publicó el comentario.
AuthorProfileImageUrl	String				La URL del avatar del usuario que publicó el comentario.
AuthorChannelUrl	String				La URL del canal de YouTube del autor del comentario, si está disponible.
AuthorChannelIdValue	String				El ID del canal de YouTube del autor del comentario, si está disponible.
AuthorGoogleplusProfileUrl	String				La URL del perfil de Google+ del autor del comentario, si está disponible.
CanRate	Boolean				Esta configuración indica si el espectador actual puede calificar el comentario.
ViewerRating	String				La calificación que el espectador le ha dado a este comentario. Valores válidos para esta columna: like, none. Tenga en cuenta que esta columna actualmente no identifica calificaciones de aversión. El valor de la columna es como si el espectador calificara el comentario positivamente. El valor es ninguno en todos los demás casos, incluido que el usuario le haya dado al comentario una calificación negativa o que no haya calificado el comentario.
LikeCount	Integer				El número total de me gusta (calificaciones positivas) que ha recibido el comentario.
ModerationStatus	String				El estado de moderación del comentario. Este valor solo se devuelve si la solicitud de API fue autorizada por el propietario del canal o el video en el que se realizaron los comentarios solicitados. Además, tenga en cuenta que este valor no se establece si la consultar se filtró en la columna ID. Valores válidos: retenido para revisión, probable spam, publicado, rechazado.
PublishedAt	Datetime				La fecha y hora en que se publicó originalmente el comentario. El valor se especifica en formato ISO 8601 (YYYY-MM-DDThhss.sZ).
UpdatedAt	Datetime				La fecha y hora en que se actualizó por última vez el comentario. El valor se especifica en formato ISO 8601 (YYYY-MM-DDThhss.sZ).

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Hilos de comentarios¶

Consulta los subprocesos de comentarios de YouTube. Un registro de CommentThread contiene información sobre un hilo de comentarios de YouTube, un comentario de nivel superior y respuestas, si existen, a ese comentario.

Información específica de la tabla¶

Seleccionar¶

YouTube Analytics permite que solo se utilice un subconjunto de columnas como criterio de filtro. Debe especificar exactamente una de las siguientes columnas: AllThreadsRelatedToChannelId, ChannelId, Id o VideoId.

Las columnas opcionales adicionales admitidas son ModerationStatus, SearchTerms y TextFormat. Todas las columnas admiten el operador '='.

El pedido es compatible con los subprocesos de comentarios. La relevancia son las columnas de orden admitidas.

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

Nota: No se admite el uso de pedidos junto con el parámetro ID.

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Datos demográficos¶

Consulta los datos demográficos de YouTubeAnalytics agrupados por grupos de edad y sexo.

Información específica de la tabla¶

Seleccionar¶

Estadísticas de visualización agregadas para videos según el grupo de edad y el género de los espectadores:

SELECT * FROM Demographics

Recorte los datos demográficos para un solo video:

SELECT * FROM Demographics WHERE Video = 'video_Id'

Estadísticas de visualización agregadas para listas de reproducción según el grupo de edad y el sexo de los espectadores:

SELECT * FROM Demographics WHERE IsCurated=true

Seleccionar reglas¶

Puede usar las siguientes tablas para crear otras consultas a los mejores videos.

Datos demográficos de los vídeos:

| Dimensiones | Utilice 1 o más | Grupo de edad, género, video | | --------------- | ------------------------------------------------ | | Use 0 or more | liveOrOnDemand, estado de suscripción, producto de youtube | | Métricas | Utilice 1 o más | espectadorPorcentaje | | Filtro | Utilice 0 o uno | país, provincia, continente, subcontinente | | Use 0 or one | vídeo, grupo | | Use 0 or more | liveOrOnDemand, estado de suscripción, producto de youtube |

Datos demográficos de las listas de reproducción:

| Dimensiones | Utilice 1 o más | Grupo de edad, sexo | | --------------- | --------------------------------------------------------- | | Use 0 or more | suscritoEstado, youtubeProducto | | Métricas | Requerido | espectadorPorcentaje | | Filtro | Requerido | esCurado=verdadero | | Use 0 or one | país, provincia, continente, subcontinente | | Use 0 or one | vídeo, grupo | | Use 0 or more | suscritoEstado, youtubeProducto |

Datos demográficos de los propietarios de contenido:

| Dimensiones | Utilice 1 o más | Grupo de edad, sexo | | --------------- | ------------------------------------------------ | | Use 0 or more | liveOrOnDemand, estado de suscripción, producto de youtube | | Métricas | Utilice 1 o más | espectadorPorcentaje | | Filtro | Utilice exactamente uno | video, canal, grupo | | Use 0 or one | país, provincia, continente, subcontinente | | Use 0 or more | liveOrOnDemand, estado de suscripción, producto de youtube |

Datos demográficos de las listas de reproducción de propietarios de contenido:

| Dimensiones | Utilice 1 o más | Grupo de edad, sexo | | --------------- | --------------------------------------------------------- | | Use 0 or more | suscritoEstado, youtubeProducto | | Métricas | Requerido | espectadorPorcentaje | | Filtro | Requerido | esCurado=verdadero | | Use 0 or one | país, provincia, continente, subcontinente | | Use 0 or one | lista de reproducción, canal, grupo | | Use 0 or more | suscritoEstado, youtubeProducto |

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Dispositivos¶

Consulta las estadísticas de los dispositivos o del sistema operativo de YouTubeAnalytics. Esta tabla le permite agregar estadísticas de visualización en función de la forma en que los espectadores llegaron a su contenido de video. Por ejemplo, puede identificar la cantidad de vistas que se produjeron en dispositivos móviles o consolas de juegos.

Información específica de la tabla¶

Seleccionar¶

De forma predeterminada, la agrupación se realiza por tipo de dispositivo:

SELECT * FROM Devices

Sin embargo, puede agrupar las vistas por otras dimensiones, como el sistema operativo:

SELECT OperatingSystem, Views, EstimatedMinutesWatched FROM Devices

Tenga en cuenta que no puede combinar el tipo de dispositivo y el sistema operativo en la misma consultar debido a las limitaciones de la API de YouTube Analytics.

Seleccionar reglas¶

Puede usar las siguientes tablas para crear otras consultas a Dispositivos:

Dispositivos para vídeos:

| Dimensiones | Utiliza exactamente uno | tipo de dispositivo, sistema operativo | | --------------- | -------------------------------------------------- --------------- | | Use 0 or more | día, liveOrOnDemand, subscribedStatus, youtubeProduct | | Métricas | Utilice 1 o más | reproducciones, minutos estimados observados | | Filtro | Utilice 0 o uno | país, provincia, continente, subcontinente | | Use 0 or one | vídeo, grupo | | Use 0 or more | sistema operativo, liveOrOnDemand, estado suscrito, producto de youtube |

Datos del dispositivo para listas de reproducción:

| Dimensiones | Utiliza exactamente uno | tipo de dispositivo, sistema operativo | | --------------- | ------------------------------------------------- | | Use 0 or more | día, estado suscrito, producto de youtube | | Métricas | Utilice 1 o más | visualizaciones, minutos estimados observados, inicios de lista de reproducción, visualizaciones por inicio de lista de reproducción, tiempo medio en lista de reproducción | | Filtro | Requerido | esCurado=verdadero | | Use 0 or one | país, provincia, continente, subcontinente | | Use 0 or one | lista de reproducción, canal, grupo | | Use 0 or more | sistema operativo, estado suscrito, producto de youtube |

Datos del dispositivo para propietarios de contenido:

| Dimensiones | Obligatorio | tipo de dispositivo | | --------------- | -------------------------------------------------- --------------- | | Use 0 or more | día, liveOrOnDemand, subscribedStatus, youtubeProduct | | Métricas | Utilice 1 o más | reproducciones, minutos estimados observados | | Filtro | Utilice exactamente uno | video, canal, grupo | | Use 0 or one | país, provincia, continente, subcontinente | | Use 0 or more | sistema operativo, liveOrOnDemand, estado suscrito, producto de youtube |

Datos del dispositivo para listas de reproducción de propietarios de contenido:

| Dimensiones | Obligatorio | tipo de dispositivo | | --------------- | ------------------------------------------------- | | Use 0 or more | día, estado suscrito, producto de youtube | | Métricas | Utilice 1 o más | visualizaciones, minutos estimados observados, inicios de lista de reproducción, visualizaciones por inicio de lista de reproducción, tiempo medio en lista de reproducción | | Filtros | Requerido | esCurado=verdadero | | Use 0 or one | país, provincia, continente, subcontinente | | Use 0 or one | lista de reproducción, canal, grupo | | Use 0 or more | sistema operativo, estado suscrito, producto de youtube |

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Informes de compromiso¶

Consulta la información de los informes de participación. Por ejemplo, cuántas veces un usuario compartió un video.

Información específica de la tabla¶

Seleccionar¶

De forma predeterminada, los resultados se agrupan por día. La siguiente consultar devuelve Comentarios, Me gusta, No me gusta, etc., agrupados por Día:

SELECT * FROM EngagementReports

Seleccionar reglas¶

La siguiente consultar devuelve la frecuencia con la que se compartieron los videos del canal en diferentes plataformas sociales:

SELECT SharingService, Shares FROM EngagementReports

Puede usar las siguientes tablas para crear otras consultas a los informes de interacción:

Informes de participación para videos:

| Dimensiones | Obligatorio | servicio compartido | | -------------- | ---------------- | | Optional | suscritoEstado | | Métricas | Utilice 1 o más | acciones | | Filtro | Utilice 0 o uno | país, continente, subcontinente | | Use 0 or one | vídeo, grupo | | Optional | suscritoEstado |

Informes de participación para propietarios de contenido:

| Dimensiones | Obligatorio | servicio compartido | | -------------- | -------------------------------- | | Optional | suscritoEstado | | Métricas | Utilice 1 o más | acciones | | Filtro | Utilice exactamente uno | video, canal, grupo | | Use 0 or one | país, continente, subcontinente | | Optional | suscritoEstado |

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Idiomas¶

Consulta YouTube i18nLanguages. Un recurso i18nLanguage identifica un idioma de aplicación compatible con el sitio web de YouTube. El idioma de la aplicación también puede denominarse idioma de la interfaz de usuario.

Información específica de la tabla¶

Seleccionar¶

No hay filtros requeridos para esta tabla. Una columna opcional admitida es Idioma.

Todas las columnas admiten el operador '='.

Columnas¶

Elementos de lista de reproducción¶

Consulta los elementos de la lista de reproducción de YouTube. Un recurso PlayListItem identifica otra entidad de YouTube, como un video, que está incluido en una lista de reproducción. Además, el registro PlayListItem contiene detalles sobre cómo se usa esa entidad en esa PlayList.

Información específica de la tabla¶

Seleccionar¶

Debe especificar exactamente una de las siguientes columnas en la cláusula WHERE: ID o PlayListId. Las columnas opcionales adicionales admitidas son OnBehalfOfContentOwner y VideoId.

Todas las columnas admiten el operador '='.

SELECT * FROM PlaylistItems WHERE PlaylistId = 'abcdef123456'

Columnas¶

Nombre	Tipo	Dimensión	Métrica predeterminada	Dimensión por defecto	Descripción
Id [KEY]	String				El ID que utiliza YouTube para identificar de forma exclusiva el elemento de la lista de reproducción.
PublishedAt	Datetime				La fecha y la hora en que se agregó el elemento a la lista de reproducción. El valor se especifica en formato ISO 8601 (YYYY-MM-DDThhss.sZ).
ChannelId	String				El ID que utiliza YouTube para identificar de forma exclusiva al usuario que agregó el elemento a la lista de reproducción.
Title	String				El título del elemento.
Description	String				La descripción del artículo.
ThumbnailsDefaultUrl	String				La URL del elemento.
ChannelTitle	String				El título del canal al que pertenece el elemento de la lista de reproducción.
VideoOwnerChannelTitle	String				El título del canal del canal que subió este video.
VideoOwnerChannelId	String				El ID de canal del canal que subió este video.
PlaylistId	String				El ID que utiliza YouTube para identificar de forma exclusiva la lista de reproducción en la que se encuentra el elemento de la lista de reproducción.
Position	String				El orden en que aparece el elemento en la lista de reproducción. El valor utiliza un índice basado en cero, por lo que el primer elemento tiene una posición de 0, el segundo elemento tiene una posición de 1 y así sucesivamente.
ResourceIdKind	String				El tipo, o tipo, del recurso referido.
ResourceIdVideoId	String				Si el valor de ResourceIdKind de la columna es youtube#video, entonces esta columna estará presente y su valor contendrá el ID que utiliza YouTube para identificar de manera única el video en la lista de reproducción.
VideoId	String				El ID que usa YouTube para identificar un video de manera única. Para recuperar el recurso de video, establezca la columna ID en este valor.
Note	String				Una nota generada por el usuario para este elemento.
VideoOwnerPublishedAt	Datetime				La fecha y la hora en que se publicó el video en YouTube. El valor se especifica en formato ISO 8601 (YYYY-MM-DDThhss.sZ).
PrivacyStatus	String				El estado de privacidad del elemento de la lista de reproducción.

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Listas de reproducción¶

Consulta las listas de reproducción de YouTube. Una lista de reproducción es una colección de videos que se pueden ver secuencialmente y compartir con otros usuarios.

Información específica de la tabla¶

Seleccionar¶

Por defecto, SupportEnhancedSQL se establece en verdadero y lo siguiente se pasará a YouTube Analytics, si está presente. Otros filtros se ejecutarán del lado del cliente. Si SupportEnhancedSQL se establece en falso, solo se respetarán los siguientes filtros.

De manera predeterminada, si no se especifican filtros, Jitterbit Connector para YouTube Analytics devolverá todas las listas de reproducción del canal propiedad del usuario autenticado.

YouTube Analytics permite que solo se utilice un subconjunto de columnas como criterio de filtro. Puede especificar exactamente una de las siguientes columnas: ChannelId o Id. Las columnas opcionales adicionales admitidas son PublishedAt, Language, OnBehalfOfContentOwner y OnBehalfOfContentOwnerChannel.

Se puede activar una búsqueda en todos los canales en YouTube Analytics especificando uno o más de SearchTerms, ForContentOwner, Region, SafeSearch, Rating y Rating para buscar en todas las listas de reproducción.

Todas las columnas admiten el operador '='. PublishedAt también admite estos operadores adicionales: '>', '>=', '<' y '<='.

Ordenar por es compatible con las columnas Calificación, Relevancia y Título.

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

Nota: No se admiten los pedidos cuando se especifica una de las columnas utilizadas para buscar listas de reproducción, como términos de búsqueda.

Columnas¶

Nombre	Tipo	Dimensión	Métrica predeterminada	Dimensión por defecto	Descripción
Id [KEY]	String				El ID que utiliza YouTube para identificar de forma exclusiva la lista de reproducción.
PublishedAt	Datetime				La fecha y la hora en que se creó la lista de reproducción. El valor se especifica en formato ISO 8601 (YYYY-MM-DDThhss.sZ).
ChannelId	String				El ID que utiliza YouTube para identificar de forma exclusiva el canal que publicó la lista de reproducción.
Title	String				El título de la lista de reproducción.
Description	String				La descripción de la lista de reproducción.
ThumbnailsDefaultUrl	String				La URL de la imagen.
ChannelTitle	String				Título del canal del canal al que pertenece el video.
DefaultLanguage	String				Esta columna es confidencial para evaluadores de confianza. El idioma del texto en las columnas Título y Descripción.
LocalizedTitle	String				Esta columna es confidencial para evaluadores de confianza. El título de la lista de reproducción localizada.
LocalizedDescription	String				Esta columna es confidencial para evaluadores de confianza. La descripción de la lista de reproducción localizada.
PrivacyStatus	String				El estado de privacidad de la lista de reproducción. Valores válidos para esta columna: privado, público, no listado.
VideoCount	Integer				El número de videos en la lista de reproducción.
EmbedHtml	String				Una etiqueta iframe que incrusta un reproductor que reproducirá la lista de reproducción.
SearchTerms	String				El parámetro SearchTerms especifica el término de consultar para buscar.

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Regiones¶

Consulta YouTube i18nRegions. Un recurso i18nRegion identifica un área geográfica que un usuario de YouTube puede seleccionar como la región de contenido preferida. La región de contenido también se puede denominar configuración regional de contenido.

Información específica de la tabla¶

Seleccionar¶

No hay filtros requeridos para esta tabla. Una columna opcional admitida es Idioma.

Todas las columnas admiten el operador '='.

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Suscripciones¶

Consultar suscripciones de usuarios de YouTube. Una suscripción notifica a un usuario cuando se agregan nuevos videos a un canal, o cuando otro usuario realiza una de varias acciones en YouTube, como cargar un video, calificar un video o comentar un video.

Información específica de la tabla¶

Seleccionar¶

Puede especificar exactamente una de las siguientes columnas: ChannelId, Id, MyRecentSubscribers o MySubscribers.

Las columnas opcionales adicionales admitidas son ForChannelId, OnBehalfOfContentOwner y OnBehalfOfContentOwnerChannel. Todas las columnas admiten el operador '='.

El pedido es compatible con las suscripciones. 'Alfabético', 'Relevancia' y 'No leído' son las columnas de orden admitidas.

De forma predeterminada, si no se especifican filtros, el controlador devolverá una lista de canales suscritos por el usuario autenticado.

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

El valor predeterminado es SUBSCRIPTION_ORDER_RELEVANCE.

Columnas¶

Nombre	Tipo	Dimensión	Métrica predeterminada	Dimensión por defecto	Descripción
Id [KEY]	String				El ID que utiliza YouTube para identificar de forma exclusiva la suscripción.
PublishedAt	Datetime				La fecha y hora en que se creó la suscripción. El valor se especifica en formato ISO 8601 (YYYY-MM-DDThhss.sZ).
ChannelTitle	String				El título del canal al que pertenece la suscripción.
Title	String				El título de la suscripción.
Description	String				Los detalles de la suscripción.
ResourceIdKind	String				El tipo del recurso API.
ResourceIdChannelId	String				El valor que utiliza YouTube para identificar de forma exclusiva el canal al que se suscribió el usuario.
ChannelId	String				El ID que utiliza YouTube para identificar de forma exclusiva el canal del suscriptor.
ThumbnailsDefaultUrl	String				La URL de la imagen predeterminada.
TotalItemCount	Integer				El número aproximado de elementos a los que apunta la suscripción.
NewItemCount	Integer				El número de elementos nuevos en la suscripción desde que se leyó su contenido por última vez.
ActivityType	String				El tipo de actividad para la que es esta suscripción. Valores válidos: todos, subidas.
SubscriberTitle	String				El título del canal del suscriptor.
SubscriberDescription	String				La descripción del canal del suscriptor.
SubscriberChannelId	String				El ID que asigna YouTube para identificar de forma única el canal del suscriptor.
SubscriberThumbnailsDefaultUrl	String				La URL de la imagen predeterminada.

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Informes basados en el tiempo¶

Consulte información basada en el tiempo sobre vistas, suscriptores, etc. Por ejemplo, cuántos nuevos suscriptores se obtuvieron en un momento específico.

Información específica de la tabla¶

Seleccionar reglas¶

Puede usar las siguientes tablas para generar consultas a los informes basados en el tiempo: Informes basados en el tiempo para videos:

| Dimensiones | Utilice 0 o más | día, mes, vídeo | | -------------- | ----------------- | | Métricas | Utilice 1 o más | visualizaciones, comentarios, Me gusta, No me gusta, vídeos añadidos a las listas de reproducción, vídeos eliminados de las listas de reproducción, recursos compartidos, minutos vistos estimados, duración media de visualización, porcentaje de visualización medio, anotación Tasa de clics, anotación Tasa de cierre, anotación Impresiones, anotación Impresiones en las que se puede hacer clic, anotación Impresiones cerrables, anotación Clics, anotación Cierres, Suscriptores obtenidos, Suscriptores perdidos, Únicos, Ganancias, AdEarning s, ingresos brutos, ingresos de socios rojos, reproducciones monetizadas, reproducciónBasedCpm, impresiones, impresiónBasedCpm | | Filtro | Utilice 0 o uno | país, continente, subcontinente | | Use 0 or one | vídeo, grupo |

Informes basados en el tiempo para las reglas de la lista de reproducción:

| Dimensiones | Utiliza exactamente uno | día, mes | | --------------- | --------------------------------------------------------- | | Use 0 or more | suscritoEstado, youtubeProducto | | Métricas | Utilice 1 o más | vistas, minutos vistos estimados, duración de vista promedio, inicios de lista de reproducción, vistas por inicio de lista de reproducción, tiempo promedio en lista de reproducción | | Filtro | Requerido | esCurado=verdadero | | Use 0 or one | país, provincia, continente, subcontinente | | Use 0 or one | lista de reproducción, canal, grupo | | Use 0 or more | suscritoEstado, youtubeProducto |

Informes basados en tiempo para reglas de propietario de contenido:

| Dimensiones | Utiliza exactamente uno | día, mes | | -------------- | -------------------------------- | | Métricas | Utilice 1 o más | visualizaciones, comentarios, Me gusta, No me gusta, vídeos añadidos a las listas de reproducción, vídeos eliminados de las listas de reproducción, recursos compartidos, minutos vistos estimados, duración media de visualización, porcentaje de visualización medio, anotación Tasa de clics, anotación Tasa de cierre, anotación Impresiones, anotación Impresiones en las que se puede hacer clic, anotación Impresiones cerrables, anotación Clics, anotación Cierres, Suscriptores obtenidos, Suscriptores perdidos, Únicos, Ganancias, AdEarning s, ingresos brutos, ingresos de socios rojos, reproducciones monetizadas, reproducciónBasedCpm, impresiones, impresiónBasedCpm | | Filtro | Utilice exactamente uno | video, canal, grupo | | Use 0 or one | país, continente, subcontinente |

Informes basados en el tiempo para las reglas de la lista de reproducción del propietario del contenido:

| Dimensiones | Utiliza exactamente uno | día, mes | | --------------- | --------------------------------------------------------- | | Use 0 or more | suscritoEstado, youtubeProducto | | Métricas | Utilice 1 o más | reproducciones, minutos estimados observados, duración de vista promedio, inicio de lista de reproducción, vistas por inicio de lista de reproducción, tiempo promedio en reproducción | | Filtro | Requerido | esCurado=verdadero | | Use 0 or one | país, provincia, continente, subcontinente | | Use 0 or one | lista de reproducción, canal, grupo | | Use 0 or more | suscritoEstado, youtubeProducto |

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Mejores videos¶

Consulte TopVideos para un canal o TopPlaylists si es propietario de contenido. También puede usar esta vista para consultar los detalles de reproducción y los filtros geográficos.

Información específica de la tabla¶

Seleccionar¶

La siguiente consultar devuelve los mejores videos de un canal por más minutos vistos:

SELECT * FROM TopVideos

La siguiente consultar devuelve los mejores videos de un canal por más minutos vistos en un país específico:

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

La siguiente consultar devuelve las principales listas de reproducción de un canal por más minutos vistos:

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

Seleccionar reglas¶

Puede usar las siguientes tablas para crear otras consultas a los mejores videos:

Mejores videos para videos:

Videos principales para listas de reproducción:

| Dimensiones | Obligatorio | lista de reproducción | | --------------- | --------------------------------------------------------- | | Métricas | Utilice 1 o más | vistas, minutos vistos estimados, duración de vista promedio, inicios de lista de reproducción, vistas por inicio de lista de reproducción, tiempo promedio en lista de reproducción | | Filtro | Requerido | esCurado=verdadero | | Use 0 or one | país, provincia, continente, subcontinente | | Use 0 or more | lista de reproducción, estado suscrito, producto de youtube | | Ordenar | Use 0 o más (solo en orden descendente) | reproducciones, minutos estimados vistos, lista de reproducción Inicios |

Videos principales para propietarios de contenido:

| Dimensiones | Obligatorio | vídeo | | -------------- | ------------------------------------- | | Métricas | Utilice 1 o más | visualizaciones, comentarios, Me gusta, No me gusta, vídeos añadidos a las listas de reproducción, vídeos eliminados de las listas de reproducción, recursos compartidos, minutos vistos estimados, duración media de visualización, porcentaje de visualización medio, anotación Tasa de clics, anotación Tasa de cierre, anotación Impresiones, anotación Impresiones en las que se puede hacer clic, anotación Impresiones cerrables, anotación Clics, anotación Cierres, suscriptores obtenidos, suscriptores perdidos, ganancias, ganancias de anuncios, bruto Ingresos, redPartnerRevenue, monetizedPlaybacks, playbackBasedCpm, impresiones,impresionBasedCpm | | Filtro | Utilice exactamente uno | canal | | Use 0 or one | país, continente, subcontinente | | Ordenar | Use 0 o más (solo en orden descendente) | reproducciones, ganancias, redPartnerRevenue, minutos estimados vistos, suscriptores ganados, suscriptores perdidos |

Videos principales para listas de reproducción de propietarios de contenido:

| Dimensiones | Obligatorio | lista de reproducción | | --------------- | --------------------------------------------------------- | | Métricas | Utilice 1 o más | vistas, minutos vistos estimados, duración de vista promedio, inicios de lista de reproducción, vistas por inicio de lista de reproducción, tiempo promedio en lista de reproducción | | Filtro | Requerido | esCurado=verdadero | | Use 0 or one | lista de reproducción, canal | | Use 0 or one | país, provincia, continente, subcontinente | | Use 0 or more | suscritoEstado, youtubeProducto | | Ordenar | Use 0 o más (solo en orden descendente) | reproducciones, minutos estimados vistos, lista de reproducción Inicios |

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Fuentes de tráfico¶

Consulta TrafficSources. Las estadísticas se basan en la forma en que los espectadores llegaron a su video y al contenido de su lista de reproducción.

Información específica de la tabla¶

Seleccionar¶

La siguiente consultar agrega estadísticas de visualización en función de la forma en que los espectadores llegaron a su contenido de video; por ejemplo, para identificar la cantidad de vistas que surgieron de una búsqueda en Google o de un enlace a un video relacionado.

SELECT * FROM TrafficSources

La siguiente consultar muestra las métricas Vistas y Minutos estimados observados agrupadas por las dimensiones Día e InsightTrafficSourceType:

SELECT Day, InsightTrafficSourceType, Views, EstimatedMinutesWatched FROM TrafficSources

La siguiente consultar filtra las estadísticas que se compilarán para un video y un país específicos:

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

La siguiente consultar agrega estadísticas de visualización en función de la forma en que los espectadores llegaron al contenido de su lista de reproducción; por ejemplo, para identificar la cantidad de vistas que surgieron de una búsqueda en Google.

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

La siguiente consultar devuelve los términos de búsqueda que generaron la mayor cantidad de vistas de los resultados de búsqueda de YouTube para videos ubicados en listas de reproducción. Tenga en cuenta que se requiere ordenar y limitar para dicha consultar debido a las restricciones en la API de YouTube Analytics.

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

Seleccionar reglas¶

Puede usar las siguientes tablas para crear otras consultas a las fuentes de tráfico:

Fuentes de tráfico para videos:

| Dimensiones | Utiliza exactamente uno | insightTrafficSourceType, insightTrafficSourceDetail | | --------------- | ------------------------------------- | | Use 0 or more | día, liveOrOnDemand, subscribedStatus | | Métricas | Utilice 1 o más | reproducciones, minutos estimados observados | | Filtro | Utilice 0 o uno | país, provincia, continente, subcontinente | | Use 0 or one | vídeo, grupo | | Use 0 or more | liveOrOnDemand, estado de suscripción | | Ordenar | Use 0 o más (solo en orden descendente) | reproducciones, minutos estimados observados |

Fuentes de tráfico para listas de reproducción:

| Dimensiones | Utiliza exactamente uno | insightTrafficSourceType, insightTrafficSourceDetail | | --------------- | --------------------------------------------------------- | | Use 0 or more | día, estado suscrito | | Métricas | Utilice 1 o más | visualizaciones, minutos estimados observados, inicios de lista de reproducción, visualizaciones por inicio de lista de reproducción, tiempo medio en lista de reproducción | | Filtro | Requerido | esCurado=verdadero | | Use 0 or one | país, provincia, continente, subcontinente | | Use 0 or one | lista de reproducción, canal, grupo | | Optional | suscritoEstado | | Ordenar | Use 0 o más (solo en orden descendente) | reproducciones, minutos estimados vistos, lista de reproducción Inicios |

Fuentes de tráfico para propietarios de contenido:

| Dimensiones | Obligatorio | InsightTrafficSourceType | | --------------- | --------------------------------------------------------- | | Use 0 or more | día, liveOrOnDemand, subscribedStatus | | Métricas | Utilice 1 o más | reproducciones, minutos estimados observados | | Filtro | Utilice exactamente uno | video, canal, grupo | | Use 0 or one | país, provincia, continente, subcontinente | | Use 0 or more | liveOrOnDemand, estado de suscripción |

Fuentes de tráfico para listas de reproducción de propietarios de contenido:

| Dimensiones | Obligatorio | InsightTrafficSourceType | | --------------- | --------------------------------------------------------- | | Use 0 or more | día, estado suscrito | | Métricas | Utilice 1 o más | visualizaciones, minutos estimados observados, inicios de lista de reproducción, visualizaciones por inicio de lista de reproducción, tiempo medio en lista de reproducción | | Filtro | Requerido | esCurado=verdadero | | Use 0 or one | país, provincia, continente, subcontinente | | Use 0 or one | lista de reproducción, canal, grupo | | Optional | suscritoEstado |

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Motivos del informe de abuso de video¶

Consulta los motivos del informe de abuso de video de YouTube. Un recurso VideoAbuseReportReason contiene información sobre un motivo por el cual un video se marcaría por contener contenido abusivo.

Información específica de la tabla¶

Seleccionar¶

No hay filtros requeridos para esta tabla. Una columna opcional es Idioma.

El operador '=' es compatible con esta columna.

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Categorías de video¶

Consulta las categorías de videos de YouTube. Un recurso VideoCategory identifica una categoría que se ha asociado o podría estar asociada con los videos subidos.

Información específica de la tabla¶

Seleccionar¶

Puede especificar exactamente una de las siguientes columnas: ID o Región. Si no especifica ningún criterio de filtrado, de forma predeterminada obtendrá resultados para la región de EE. UU. Un parámetro adicional opcional es Idioma.

SELECT * FROM VideoCategories WHERE Region = 'JP'

El operador IN se puede usar para filtrar en múltiples ID:

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Vídeos¶

Consulta de vídeos de YouTube.

Información específica de la tabla¶

Seleccionar¶

Por defecto, SupportEnhancedSQL se establece en verdadero y lo siguiente se pasará a YouTube Analytics, si está presente. Otros filtros se ejecutarán del lado del cliente. Si SupportEnhancedSQL se establece en falso, solo se respetarán los siguientes filtros.

De manera predeterminada, si no se especifican filtros, el controlador devolverá todos los videos que pertenecen al usuario autenticado.

Solo se puede filtrar una de las siguientes columnas a la vez: Id, MyRating, ChannelId o Chart. Las columnas adicionales admitidas son ForMine, Language, ForContentOwner, OnBehalfOfContentOwner.

Se puede ejecutar una búsqueda en todos los videos de YouTube especificando SearchTerms, RelatedToVideoId, VideoDuration, VideoCategoryId o Region.

Todas las columnas admiten el operador '='. PublishedAt también admite estos operadores adicionales: '>', '>=', '<' y '<='. ID y ChannelId admiten IN.

Ordenar por es compatible con las columnas Fecha, Calificación, Relevancia y 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

Nota: No se admite la ordenación cuando se especifica una de las columnas utilizadas para buscar canales como SearchTerms.

El operador IN se puede utilizar para especificar una lista de canales. Esta llamada devuelve una lista de videos para cada canal especificado.

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

El operador IN también se puede usar para obtener datos para múltiples videos.

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

Columnas¶

Nombre	Tipo	Dimensión	Métrica predeterminada	Dimensión por defecto	Descripción
Id [KEY]	String				El ID que usa YouTube para identificar de forma única el video.
ChannelId	String				El ID que utiliza YouTube para identificar de forma exclusiva el canal en el que se subió el vídeo.
CategoryId	String				La categoría de video de YouTube asociada con el video.
Title	String				El título del vídeo.
ChannelTitle	String				Título del canal para el canal al que pertenece el video.
PublishedAt	Datetime				La fecha y hora en que se publicó el video. Tenga en cuenta que esta hora puede ser diferente a la hora en que se cargó el video. El valor se especifica en formato ISO 8601 (YYYY-MM-DDThhss.sZ).
Description	String				La descripción del vídeo.
Duration	String				La duración del vídeo. El valor de la propiedad es una duración ISO 8601.
ViewCount	Long				La cantidad de veces que se ha visto el video.
LikeCount	Long				El número de usuarios que han indicado que les gustó el video.
DislikeCount	Long				El número de usuarios que indicaron que no les gustó el video. Junto con los cambios para hacer privados los recuentos de No me gusta de los videos en toda la plataforma de YouTube, este campo se devuelve solo si el propietario del video autenticó la solicitud de API.
CommentCount	Long				El número de comentarios para el video.
EmbedHtml	String				Una etiqueta iframe que incrusta un reproductor que reproducirá el video.
PublicStatsViewable	Boolean				Este valor indica si las estadísticas de video extendidas en la página de reproducción se pueden ver públicamente. De forma predeterminada, esas estadísticas se pueden ver, y las estadísticas como el número de vistas y las calificaciones seguirán siendo visibles públicamente incluso si este valor se establece en falso.
TagsAggregate	String				Una lista de etiquetas de palabras clave asociadas con el video.
LiveBroadcastContent	String				Indica si el video es una transmisión en vivo próxima/activa. Un valor de ninguno indica que el video no es una transmisión en vivo próxima/activa. Valores válidos para esta columna: en vivo, ninguno, próximo.
Dimension	String				Indica si el video está disponible en 3D o en 2D.
Definition	String				Indica si el video está disponible en alta definición HD o solo en definición estándar. Valores válidos para esta columna: hd, sd.
Caption	String				Indica si los subtítulos están disponibles para el video. Valores válidos para esta columna: falso, verdadero.
LicensedContent	Boolean				Indica si el video representa contenido con licencia, lo que significa que el contenido se subió a un canal vinculado a un socio de contenido de YouTube y luego fue reclamado por ese socio.
AllowedAggregate	String				Una lista de códigos de región que identifican los países donde se puede ver el video.
BlockedAggregate	String				Una lista de códigos de región que identifican los países donde el video está bloqueado.
Projection	String				Especifica el formato de proyección del video. Valores válidos: 360, rectangular.
PrivacyStatus	String				El estado de privacidad de la lista de reproducción. Valores válidos: privado, público, no listado.
MadeForKids	Boolean				Este valor indica si el video está hecho para niños.
License	String				La licencia. Valores válidos: creativeCommon, youtube.
Embeddable	Boolean				Este valor indica si el video se puede incrustar en otro sitio web.
ThumbnailsDefaultUrl	String				La URL de la imagen predeterminada.
DefaultLanguage	String				Esta columna es confidencial para evaluadores de confianza. El idioma del texto en las columnas Título y Descripción.
DefaultAudioLanguage	String				La columna default_audio_language especifica el idioma que se habla en la pista de audio predeterminada del video.
UploadStatus	String				El estado del video subido. Valores válidos para esta columna: eliminado, fallido, procesado, rechazado, cargado.
FailureReason	String				Este valor explica por qué no se pudo cargar un video. Esta columna solo tiene un valor si la columna UploadStatus indica que la carga falló. Valores válidos para esta columna: códec, conversión, archivo vacío, archivo no válido, demasiado pequeño, carga anulada.
RejectionReason	String				Este valor explica por qué YouTube rechazó un video subido. Esta columna solo tiene un valor si la columna UploadStatus indica que se rechazó la carga. Valores válidos para esta columna: reclamo, derechos de autor, duplicado, inapropiado, longitud, términos de uso, marca comercial, cuenta de carga cerrada, cuenta de carga suspendida.
RecordingDate	Datetime				La fecha y hora en que se grabó el video. El valor se especifica en formato ISO 8601 (YYYY-MM-DDThhss.sssZ).
SearchTerms	String				El término de consultar a buscar.

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Procedimientos almacenados¶

Procedimientos almacenados* son interfaces similares a funciones que amplían la funcionalidad del conector más allá de las simples operaciones SELECCIONAR/INSERTAR/ACTUALIZAR/ELIMINAR con YouTube Analytics.

Procedimientos almacenados* aceptan una lista de parámetros, realizan la función prevista y luego devuelven, si corresponde, cualquier dato de respuesta relevante de YouTube Analytics, junto con una indicación de si el procedimiento tuvo éxito o no.

Conector Jitterbit para procedimientos almacenados de YouTube Analytics¶

CreateCustomSchema¶

Crea un archivo de esquema personalizado basado en las dimensiones y métricas especificadas.

CreateCustomSchema¶

Crea un archivo de esquema personalizado basado en las dimensiones y métricas especificadas.

Se puede utilizar un esquema personalizado para un enfoque más personalizado de sus datos. Las opciones personalizadas pueden incluir listas separadas por comas para datos específicos.

Entrada¶

Columnas del conjunto de resultados¶

GetOAuthAccessToken¶

Obtiene el token de acceso de OAuth que se utilizará para la autenticación con varios servicios de Google.

Entrada¶

Columnas del conjunto de resultados¶

GetOAuthAuthorizationURL¶

Obtiene la URL de autorización de OAuth utilizada para la autenticación con varios servicios de Google.

Entrada¶

Columnas del conjunto de resultados¶

RefreshOAuthAccessToken¶

Obtiene el token de acceso de OAuth que se utilizará para la autenticación con varios servicios de Google.

Entrada¶

Columnas del conjunto de resultados¶

Tablas del sistema¶

Puede consultar las tablas del sistema que se describen en esta sección para acceder a la información del esquema, la información sobre la funcionalidad del origen de datos y las estadísticas de operación lote.

Tablas de esquemas¶

Las siguientes tablas devuelven metadatos de la base de datos para YouTube Analytics:

• sys_catalogs: enumera las bases de datos disponibles.
• sys_schemas: enumera los esquemas disponibles.
• sys_tablas: enumera las tablas y vistas disponibles.
• sys_tablecolumns: Describe las columnas de las tablas y vistas disponibles.
• procedimientos_sys: describe los procedimientos almacenados disponibles.
• parámetros_procedimiento_sys: Describe procedimiento almacenado* parámetros.
• sys_keycolumns: describe las claves principal y externa.
• índices_sys: Describe los índices disponibles.

Tablas de origen de datos¶

Las siguientes tablas devuelven información sobre cómo conectarse y consultar la fuente de datos:

• sys_connection_props: Devuelve información sobre las propiedades de conexión disponibles.
• sys_sqlinfo: describe las consultas SELECT que el conector puede descargar al origen de datos.

Consultar tablas de información¶

La siguiente tabla devuelve estadísticas de consultar para consultas de modificación de datos:

• identidad_sys: devuelve información sobre operaciones lote o actualizaciones individuales.

sys_catalogs¶

Enumera las bases de datos disponibles.

La siguiente consultar recupera todas las bases de datos determinadas por la cadena de conexión:

SELECT * FROM sys_catalogs

Columnas¶

sys_schemas¶

Enumera los esquemas disponibles.

La siguiente consultar recupera todos los esquemas disponibles:

SELECT * FROM sys_schemas

Columnas¶

sys_tables¶

Enumera las tablas disponibles.

La siguiente consultar recupera las tablas y vistas disponibles:

SELECT * FROM sys_tables

Columnas¶

sys_tablecolumns¶

Describe las columnas de las tablas y vistas disponibles.

La siguiente consultar devuelve las columnas y los tipos de datos de la tabla Grupos:

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

Columnas¶

sys_procedures¶

Enumera los procedimientos almacenados disponibles.

La siguiente consultar recupera los procedimientos almacenados disponibles:

SELECT * FROM sys_procedures

Columnas¶

sys_procedureparameters¶

Describe procedimiento almacenado* parámetros.

La siguiente consultar devuelve información sobre todos los parámetros de entrada para el procedimiento almacenado RefreshOAuthAccessToken:

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

Columnas¶

sys_keycolumns¶

Describe las claves primarias y foráneas. La siguiente consultar recupera la clave principal de la tabla Grupos:

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

Columnas¶

sys_foreignkeys¶

Describe las claves foráneas. La siguiente consultar recupera todas las claves foráneas que hacen referencia a otras tablas:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Columnas¶

sys_primarykeys¶

Describe las claves primarias. La siguiente consultar recupera las claves principales de todas las tablas y vistas:

SELECT * FROM sys_primarykeys

Columnas¶

sys_indexes¶

Describe los índices disponibles. Al filtrar en los índices, puede escribir consultas más selectivas con tiempos de respuesta de consultar más rápidos.

La siguiente consultar recupera todos los índices que no son claves principales:

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Columnas¶

sys_connection_props¶

Devuelve información sobre las propiedades de conexión disponibles y las establecidas en la cadena de conexión.

Al consultar esta tabla, se debe usar la cadena de conexión de configuración:

jdbc:cdata:youtubeanalytics:config:

Esta cadena de conexión le permite consultar esta tabla sin una conexión válida.

La siguiente consultar recupera todas las propiedades de conexión que se han establecido en la cadena de conexión o se han establecido a través de un valor predeterminado:

SELECT * FROM sys_connection_props WHERE Value <> ''

Columnas¶

sys_sqlinfo¶

Describe el procesamiento de consultar SELECT que el conector puede descargar al origen de datos.

Descubrimiento de las capacidades SELECT de la fuente de datos¶

A continuación se muestra un conjunto de datos de ejemplo de las capacidades de SQL. El siguiente conjunto de resultados indica la funcionalidad SELECT que el conector puede descargar en el origen de datos o en el lado del cliente del proceso. Su fuente de datos puede admitir sintaxis SQL adicional. Algunos aspectos de la funcionalidad SELECT se devuelven en una lista separada por comas si es compatible; de lo contrario, la columna contiene NO.

La siguiente consultar recupera los operadores que se pueden usar en la cláusula WHERE:

SELECT * FROM sys_sqlinfo WHERE Name='SUPPORTED_OPERATORS'

Tenga en cuenta que las tablas individuales pueden tener diferentes limitaciones o requisitos en la cláusula WHERE; consulte el Modelo de datos para obtener más información.

Columnas¶

sys_identidad¶

Devuelve información sobre los intentos de modificación.

La siguiente consultar recupera los Id. de las filas modificadas en una operación lote:

SELECT * FROM sys_identity

Columnas¶