Saltar al contenido

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 Microsoft Entra ID 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

Nombre Descripción
GroupItems Crear, eliminar y consultar Elementos que componen un Grupo.
Groups Crear, actualizar, eliminar y consultar grupos 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
Nombre Tipo Solo lectura Descripción
Id [KEY] String Verdadero El ID que usa YouTube para identificar de forma exclusiva el canal, el video, la lista de reproducción o el recurso que se incluye en el grupo. Tenga en cuenta que esta identificación se refiere específicamente a la inclusión de esa entidad en un grupo en particular y es diferente de la identificación del canal, la identificación del video, la identificación de la lista de reproducción o la identificación del activo que identifica de manera única a la entidad en sí.
Kind String Falso Identifica el tipo del elemento de grupo. El valor será youtube#groupItem.
Etag String Falso El Etag de este artículo.
GroupId String Falso El ID que utiliza YouTube para identificar de forma exclusiva el grupo que contiene el elemento.
Resource_Kind String Falso El tipo del elemento de grupo. Los valores permitidos son youtube#channel, youtube#playlist, youtube#video, youtubePartner#asset.
Resource_Id String Falso El ID de canal, video, lista de reproducción o recurso que usa YouTube para identificar de manera única el elemento del grupo.
OnBehalfOfContentOwner String Falso Este parámetro está destinado exclusivamente a socios de contenido de YouTube que poseen y administran muchos canales de YouTube diferentes. El parámetro OnBehalfOfContentOwner indica que las credenciales de autorización de la solicitud identifican a un usuario de YouTube que actúa en nombre del propietario del contenido especificado en el valor del parámetro.

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
Nombre Tipo Solo lectura Descripción
Id [KEY] String Falso El ID que utiliza YouTube para identificar de forma única al grupo.
Kind String Falso Identifica el tipo de entidad de YouTube Analytics. El valor será youtube#group.
Etag String Falso El Etag de este recurso.
Snippet_PublishedAt DateTime Verdadero La fecha y hora en que se creó el grupo.
Snippet_Title String Falso El nombre del grupo. El valor debe ser una cadena no vacía.
ContentDetails_ItemCount String Falso El número de artículos en el grupo.
ContentDetails_ItemType String Falso El tipo de entidades que contiene el grupo. Los valores permitidos son youtube#channel, youtube#playlist, youtube#video, youtubePartner#asset.
Mine String Falso Establézcalo en verdadero para recuperar todos los grupos propiedad del usuario autenticado.
PageToken String Falso El parámetro PageToken identifica una página específica en el conjunto de resultados que se debe devolver.
OnBehalfOfContentOwner String Falso Este parámetro está destinado exclusivamente a socios de contenido de YouTube que poseen y administran muchos canales de YouTube diferentes. El parámetro OnBehalfOfContentOwner indica que las credenciales de autorización de la solicitud identifican a un usuario de YouTube que actúa en nombre del propietario del contenido especificado en el valor del parámetro.

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

Nombre Descripción
Activities 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.
AdPerformanceReports 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.
Captions Consulta los subtítulos de YouTube. Un recurso Caption representa una pista de subtítulos de YouTube.
Channels Consulta de canales de YouTube.
ChannelSections Consultar secciones de canales de YouTube. Una ChannelSection contiene información sobre un conjunto de videos que un canal ha elegido presentar.
Comments Consulta los comentarios de YouTube.
CommentThreads 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.
Demographics Consulta los datos demográficos de YouTubeAnalytics agrupados por grupos de edad y sexo.
Devices 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.
EngagementReports Consulta la información de los informes de participación. Por ejemplo, cuántas veces un usuario compartió un video.
Languages 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.
PlayListItems 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.
PlayLists 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.
Regions 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.
Subscriptions 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.
TimeBasedReports Consulte información basada en el tiempo sobre vistas, suscriptores, etc. Por ejemplo, cuántos nuevos suscriptores se obtuvieron en un momento específico.
TopVideos 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.
TrafficSources 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.
VideoAbuseReportReasons 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.
VideoCategories 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.
Videos Consulta de vídeos de YouTube.

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-DDThh🇲🇲ss.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.

Nombre Tipo Descripción
Region String Indica a la API que filtre por región. El valor del parámetro es un código de país ISO 3166-1 alfa-2.

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
Nombre Tipo Dimensión Métrica predeterminada Dimensión por defecto Descripción
Video String Verdadero El ID de un video de YouTube.
Group String Verdadero (solo filtro) El ID de un grupo de YouTube Analytics.
Country String El país asociado con las métricas en la fila del informe. El valor de la dimensión es un código de país ISO-3166-1 de dos letras, como EE. UU., CN (China) o FR (Francia). El código de país ZZ se usa para reportar métricas para las cuales YouTube no pudo identificar el país asociado.
Continent String (solo filtro) Un código de región estadística de las Naciones Unidas (U.N.). Los valores permitidos son 002 África, 019 América (América del Norte, América Latina, América del Sur y el Caribe), 142 Asia, 150 Europa, 009 Oceanía. Esta dimensión solo se puede utilizar para filtrar datos.
SubContinent String (solo filtro) Un código de región estadístico de la ONU que identifica una subregión geográfica.
AdType String Verdadero La dimensión AdType se utiliza en los informes de rendimiento de anuncios y agrega las métricas solicitadas en función de los tipos de anuncios que se ejecutaron durante las reproducciones de video: AuctionDisplay, AuctionInstream, AuctionTrueviewInslate, AuctionTrueViewInstream, AuctionUnknown, ReservedClickToPlay, ReservedDisplay, ReservedInstream, ReservedInstreamSelect, ReservedMasthead, ReservedUnknown.
Day String Verdadero Cuando utiliza esta dimensión, los datos del informe se agregan diariamente y cada fila contiene datos de un día.
ClaimedStatus String (solo se usa en los informes de propietarios de contenido) Esta dimensión le permite indicar que un conjunto de resultados solo debe contener métricas para el contenido reclamado. Se reclama el valor permitido.
UploaderType String (solo se usa en los informes de propietarios de contenido) Esta dimensión le permite indicar si un conjunto de resultados debe contener métricas para el contenido subido por el propietario de contenido especificado o el contenido subido por terceros, como videos subidos por usuarios. Los valores permitidos son self y thirdParty.
GrossRevenue Decimal Falso Los ingresos brutos estimados, en USD, de toda la publicidad vendida por Google o por socios de DoubleClick para el intervalo de fechas y la región seleccionados. Los ingresos brutos están sujetos al ajuste de fin de mes y no incluyen la publicidad proporcionada por los socios. Los ingresos brutos no deben confundirse con las ganancias o los ingresos netos, que tienen en cuenta su participación en la propiedad y los acuerdos de participación en los ingresos.
Cpm Decimal Falso Los ingresos brutos estimados por cada mil impresiones de anuncios.
AdImpressions Double Falso El número de impresiones de anuncios verificadas servidas.
StartDate Date Fecha de inicio para obtener datos de Analytics.
EndDate Date Fecha de finalización para obtener datos de Analytics.
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.

Nombre Tipo Descripción
Segments String Segmenta los datos devueltos para su solicitud. Ya sea un SegmentId o un segmento personalizado.

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-DDThh🇲🇲ss.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-DDThh🇲🇲ss.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.

Nombre Tipo Descripción
ForUsername String El nombre de usuario asociado con el canal.
Language String Recupere metadatos de recursos localizados para un idioma de aplicación específico compatible con el sitio web de YouTube.
Language String Recupere metadatos de recursos localizados para un idioma de aplicación específico compatible con el sitio web de YouTube.
ManagedByMe String Este parámetro está destinado exclusivamente a los socios de contenido de YouTube. Establezca el valor de este parámetro en verdadero para indicarle a la API que solo devuelva los canales administrados por el propietario del contenido que especifica el parámetro onBehalfOfContentOwner. El usuario debe autenticarse como una cuenta de CMS vinculada al propietario del contenido especificado y se debe proporcionar onBehalfOfContentOwner.
OnBehalfOfContentOwner String Este parámetro está destinado exclusivamente a los socios de contenido de YouTube. El parámetro onBehalfOfContentOwner indica que las credenciales de autorización de la solicitud identifican a un usuario de YouTube CMS que actúa en nombre del propietario del contenido especificado en el valor del parámetro. Este parámetro está destinado a socios de contenido de YouTube que poseen y administran muchos canales de YouTube diferentes. Permite a los propietarios de contenido autenticarse una vez y obtener acceso a todos sus videos y datos de canales, sin tener que proporcionar credenciales de autenticación para cada canal individual. La cuenta de CMS con la que el usuario se autentica debe estar vinculada al propietario del contenido de YouTube especificado.
ChannelId String El ID que usa YouTube para identificar de forma única un canal.
Region String El país asociado con el canal.
SafeSearch String Indica si los resultados de la búsqueda deben incluir contenido restringido además de contenido estándar. Valores aceptables: moderado, ninguno o estricto.
Rating String Los recursos se ordenan de mayor a menor calificación.
Relevance String Los recursos se ordenan según su relevancia para la consultar de búsqueda. Este es el valor predeterminado para este parámetro.

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
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 sección del canal.
Type String El tipo de la sección del canal.
ChannelId String El ID que utiliza YouTube para identificar de forma exclusiva el canal.
Title String El título de la sección.
Position Integer La posición de la sección en la página del canal.
PlaylistsAggregate String Una lista de uno o más ID de listas de reproducción que aparecen en la sección de un canal. Debe especificar una lista de Id. de lista de reproducción si el tipo de ChannelSection es singlePlaylist o multiplePlaylists, y esta columna no debe especificarse para otros tipos de secciones. Si el tipo es singlePlaylist, esta lista debe especificar exactamente un ID de lista de reproducción.
ChannelsAggregate String Una lista de uno o más ID de canal que aparecen en una sección de canal. Debe especificar una lista de ID de canal si el Tipo de ChannelSection es multipleChannels, y esta columna no debe especificarse para otros tipos de secciones. No puede incluir su propio canal en la lista.
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.

Nombre Tipo Descripción
Language String Recupere metadatos de recursos localizados para un idioma de aplicación específico compatible con el sitio web de YouTube.
OnBehalfOfContentOwner String Este parámetro está destinado exclusivamente a los socios de contenido de YouTube.

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-DDThh🇲🇲ss.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-DDThh🇲🇲ss.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.

Nombre Tipo Descripción
TextFormat String Este parámetro indica si la API debe devolver comentarios con formato HTML o texto sin formato.

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
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 cadena de comentarios.
ChannelId String El canal de YouTube que está asociado con los comentarios en el hilo. La columna VideoId identifica el video. Si los comentarios son sobre un video, entonces el valor identifica el canal que subió el video. Si los comentarios se refieren al propio canal, la columna VideoId no tendrá ningún valor.
VideoId String El ID del video al que se refieren los comentarios, si corresponde. Si esta columna no está presente o no tiene un valor, entonces el hilo se aplica al canal y no a un video específico.
TopCommentId String El ID del comentario de nivel superior del hilo.
PublishedAt Datetime La fecha de publicación del comentario de nivel superior del hilo.
UpdatedAt Datetime La última fecha de actualización del comentario de nivel superior del hilo.
TopCommentChannelId String El ID del canal asociado con el comentario de nivel superior del hilo.
TopCommentVideoId String El ID del video asociado con el comentario de nivel superior del hilo.
TopCommentTextDisplay String El texto para mostrar del comentario de nivel superior del hilo.
TopCommentTextOriginal String El texto original del comentario de nivel superior del hilo.
TopCommentParentId String El ID del padre del comentario de nivel superior del hilo.
TopCommentAuthorDisplayName String El nombre para mostrar del autor del comentario de nivel superior del hilo.
TopCommentAuthorChannelIdValue String El ID del canal del autor del comentario de nivel superior del hilo.
TopCommentCanRate Boolean Si el usuario actual puede calificar el comentario de nivel superior del hilo.
TopCommentViewerRating String La calificación del espectador del comentario de nivel superior del hilo.
TopCommentLikeCount Integer El recuento de Me gusta del comentario de nivel superior del hilo.
TopCommentModerationStatus String El estado de moderación del comentario de nivel superior del hilo.
CanReply Boolean Esta configuración indica si el espectador actual puede responder al hilo.
TotalReplyCount Integer El número total de respuestas que se han enviado en respuesta al comentario de nivel superior.
IsPublic Boolean Esta configuración indica si el hilo, incluidos todos sus comentarios y respuestas a comentarios, es visible para todos los usuarios de YouTube.
CommentsAggregate String Una lista de una o más respuestas al comentario de nivel superior.
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.

Nombre Tipo Descripción
AllThreadsRelatedToChannelId String Indica a la API que devuelva todos los hilos de comentarios asociados con el canal especificado.
ModerationStatus String Establezca este parámetro para limitar los hilos de comentarios devueltos a un estado de moderación particular.
TextFormat String Establezca el valor de este parámetro en HTML o texto sin formato.

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
Nombre Tipo Dimensión Métrica predeterminada Dimensión por defecto Descripción
Video String Verdadero Falso El ID de un video de YouTube.
Playlist String Verdadero El ID de una lista de reproducción de YouTube.
Group String Verdadero (solo filtro) El ID de un grupo de YouTube Analytics.
Country String Verdadero El país asociado con las métricas en la fila del informe. El valor de la dimensión es un código de país ISO-3166-1 de dos letras, como EE. UU., CN (China) o FR (Francia). El código de país ZZ se usa para reportar métricas para las cuales YouTube no pudo identificar el país asociado.
Province String Verdadero El estado o territorio de EE. UU. asociado con las métricas en la fila del informe. El valor de la dimensión es un código ISO 3166-2 que identifica un estado de EE. UU. o el Distrito de Columbia, como US-MI (Michigan) o US-TX (Texas). El código de provincia US-ZZ se usa para informar métricas para las que YouTube no pudo identificar el estado de EE. UU. asociado. Si se especifica la columna Provincia, el país debe establecerse en EE. UU. en la cláusula WHERE.
Continent String Verdadero (solo filtro) Un código de región estadística de las Naciones Unidas (ONU). La API admite los siguientes valores: 002 África, 019 América (América del Norte, América Latina, América del Sur y el Caribe), 142 Asia, 150 Europa, 009 Oceanía.
SubContinent String Verdadero (solo filtro) Un código de región estadístico de la ONU que identifica una subregión geográfica.
LiveOrOnDemand String Verdadero Esta dimensión indica si las métricas de actividad del usuario en la fila de datos están asociadas con vistas de una transmisión en vivo. Los datos de esta dimensión están disponibles para las fechas que comienzan el 1 de abril de 2014. Los valores permitidos son LIVE, ON_DEMAND.
SubscribedStatus String Verdadero Esta dimensión indica si las métricas de actividad del usuario en la fila de datos están asociadas con espectadores que estaban suscritos al canal de video o lista de reproducción. Los valores permitidos son SUBSCRIBED y UNSUBSCRIBED. Tenga en cuenta que el valor de la dimensión es preciso en el momento en que se produce la actividad del usuario.
YouTubeProduct String Verdadero Esta dimensión identifica el servicio de YouTube en el que se produjo la actividad del usuario. Los datos de esta dimensión están disponibles desde el 18 de julio de 2015. Los valores permitidos son BÁSICO, JUEGO, NIÑOS, DESCONOCIDO.
IsCurated Boolean Verdadero Este filtro indica que la solicitud está recuperando datos sobre vistas de video que ocurrieron en el contexto de una lista de reproducción. Este filtro es necesario para cualquier informe de lista de reproducción y su valor debe establecerse en 1.
ClaimedStatus String Verdadero (solo se usa en los informes de propietarios de contenido) Esta dimensión le permite indicar que un conjunto de resultados solo contendrá métricas para el contenido reclamado. Se reclama el valor permitido.
UploaderType String Verdadero (solo se usa en los informes de propietarios de contenido) Esta dimensión le permite indicar si un conjunto de resultados contendrá métricas para el contenido subido por el propietario de contenido especificado o el contenido subido por terceros, como videos subidos por usuarios. Los valores permitidos son self y thirdParty.
AgeGroup String Verdadero Verdadero Esta dimensión identifica el grupo de edad de los usuarios registrados asociados con los datos del informe. Los valores permitidos son age13-17, age18-24, age25-34, age35-44, age45-54, age55-64, age65-
Gender String Verdadero Falso Esta dimensión identifica el sexo de los usuarios registrados asociados con la consultar. Los valores permitidos son femenino, masculino y especificado por el usuario.
ViewerPercentage Double Falso Verdadero El porcentaje de espectadores que iniciaron sesión cuando vieron el video o la lista de reproducción. Los valores de ViewPercentage en este informe no están normalizados para diferentes valores o combinaciones de valores para las dimensiones de detalles de reproducción (subscribedStatus y youtubeProduct). Por ejemplo, un informe que utiliza la dimensión SubscribedStatus devuelve datos de ViewPercentage que suman el 100 % para las vistas suscritas y datos de ViewerPercentage que suman el 100 % para las vistas no suscritas. (El valor total de todos los campos de porcentaje de visor en el informe es 200 por ciento). Puede usar filtros para asegurarse de que el informe solo contenga datos de porcentaje de visor para un valor (o combinación de valores) para las dimensiones de detalles de reproducción.
StartDate Date Fecha de inicio para obtener datos de Analytics.
EndDate Date Fecha de finalización para obtener datos de Analytics.
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.

Nombre Tipo Descripción
Segments String Segmenta los datos devueltos para su solicitud. Ya sea un SegmentId o un segmento personalizado.

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
Nombre Tipo Dimensión Métrica predeterminada Dimensión por defecto Descripción
Video String Verdadero El ID de un video de YouTube.
Group String Verdadero (solo filtro) El ID de un grupo de YouTube Analytics.
Channel String Verdadero (solo se usa en los informes de propietarios de contenido) El ID de un canal de YouTube. La dimensión del canal se usa con frecuencia en los informes de propietarios de contenido porque esos informes generalmente agregan datos para múltiples canales.
Playlist String Verdadero El ID de una lista de reproducción de YouTube.
Country String Verdadero El país asociado con las métricas en la fila del informe. El valor de la dimensión es un código de país ISO-3166-1 de dos letras, como EE. UU., CN (China) o FR (Francia). El código de país ZZ se usa para reportar métricas para las cuales YouTube no pudo identificar el país asociado.
Province String Verdadero El estado o territorio de EE. UU. asociado con las métricas en la fila del informe. El valor de la dimensión es un código ISO 3166-2 que identifica un estado de EE. UU. o el Distrito de Columbia, como US-MI (Michigan) o US-TX (Texas). El código de provincia US-ZZ se usa para informar métricas para las que YouTube no pudo identificar el estado de EE. UU. asociado. Si se especifica la columna Provincia, el país debe establecerse en EE. UU. en la cláusula WHERE.
Continent String Verdadero (solo filtro) Un código de región estadística de las Naciones Unidas (ONU): 002 África, 019 América (América del Norte, América Latina, América del Sur y el Caribe), 142 Asia, 150 Europa, 009 Oceanía. Esta dimensión solo se puede utilizar para filtrar datos.
SubContinent String Verdadero (solo filtro) Un código de región estadístico de la ONU que identifica una subregión geográfica.
Day String Verdadero Cuando utiliza esta dimensión, los datos del informe se agregan diariamente y cada fila contiene datos de un día.
LiveOrOnDemand String Verdadero Esta dimensión indica si las métricas de actividad del usuario en la fila de datos están asociadas con vistas de una transmisión en vivo. Los datos de esta dimensión están disponibles para las fechas que comienzan el 1 de abril de 2014. Los valores permitidos son LIVE, ON_DEMAND.
SubscribedStatus String Verdadero Esta dimensión indica si las métricas de actividad del usuario en la fila de datos están asociadas con espectadores que estaban suscritos al canal de video o lista de reproducción. Los valores permitidos son SUBSCRIBED, UNSUBSCRIBED. Tenga en cuenta que el valor de la dimensión es preciso en el momento en que se produce la actividad del usuario.
YouTubeProduct String Verdadero Esta dimensión identifica el servicio de YouTube en el que se produjo la actividad del usuario. Los datos de esta dimensión están disponibles desde el 18 de julio de 2015. Los valores permitidos son BÁSICO, JUEGO, NIÑOS, DESCONOCIDO.
DeviceType String Verdadero Verdadero Esta dimensión identifica el factor de forma físico del dispositivo en el que se produjo la vista. Los valores permitidos son DESKTOP, GAME_CONSOLE, MOBILE, TABLET, TV, UNKNOWN_PLATFORM.
OperatingSystem String Verdadero Falso Esta dimensión identifica el sistema de software del dispositivo en el que se produjo la vista. Los valores permitidos son ANDROID, BADA, BLACKBERRY, DOCOMO, HIPTOP, IOS, LINUX, MACINTOSH, MEEGO, NINTENDO_3DS, OTROS, PLAYSTATION, PLAYSTATION_VITA, SMART_TV, SYMBIAN, WEBOS.
IsCurated Boolean Verdadero Este filtro indica que la solicitud está recuperando datos sobre vistas de video que ocurrieron en el contexto de una lista de reproducción. Este filtro es necesario para cualquier informe de lista de reproducción y su valor debe establecerse en 1.
ClaimedStatus String Verdadero (solo se usa en los informes de propietarios de contenido) Esta dimensión le permite indicar que el conjunto de resultados solo contendrá métricas para el contenido reclamado. Se reclama el valor permitido.
UploaderType String Verdadero (solo se usa en los informes de propietarios de contenido) Esta dimensión le permite indicar si el conjunto de resultados incluirá métricas para el contenido subido por el propietario de contenido especificado o contenido subido por terceros, como videos subidos por usuarios. Los valores permitidos son self y thirdParty.
Views Double Falso Verdadero La cantidad de veces que se vio un video.
EstimatedMinutesWatched Double Falso Verdadero La cantidad de minutos que los usuarios miraron videos para el canal, el propietario del contenido, el video o la lista de reproducción especificados.
PlaylistStarts Double Falso Falso La cantidad de veces que los espectadores iniciaron la reproducción de una lista de reproducción.
ViewsPerPlaylistStart Double Falso Falso La cantidad promedio de vistas de video que ocurrieron cada vez que se inició una lista de reproducción.
AverageTimeInPlaylist Double Falso Falso La cantidad de tiempo promedio estimada, en minutos, que un espectador vio videos en una lista de reproducción después de que se inició la lista de reproducción.
StartDate Date Fecha de inicio para obtener datos de Analytics.
EndDate Date Fecha de finalización para obtener datos de Analytics.
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.

Nombre Tipo Descripción
Segments String Segmenta los datos devueltos para su solicitud. Ya sea un SegmentId o un segmento personalizado.

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
Nombre Tipo Dimensión Métrica predeterminada Dimensión por defecto Descripción
SharingService String Verdadero Esta dimensión identifica el servicio que se utilizó para compartir videos. Los videos se pueden compartir en YouTube (o a través del reproductor de YouTube) usando el botón Compartir.
Channel String Verdadero (solo se usa en los informes de propietarios de contenido) El ID de un canal de YouTube. La dimensión del canal se usa con frecuencia en los informes de propietarios de contenido porque esos informes generalmente agregan datos para múltiples canales.
Video String Verdadero El ID de un video de YouTube.
Group String Verdadero (solo filtro) El ID de un grupo de YouTube Analytics.
Country String Verdadero El país asociado con las métricas en la fila del informe. El valor de la dimensión es un código de país ISO-3166-1 de dos letras, como EE. UU., CN (China) o FR (Francia). El código de país ZZ se usa para reportar métricas para las cuales YouTube no pudo identificar el país asociado.
Continent String Verdadero (solo filtro) Un código de región estadística de las Naciones Unidas (ONU): 002 África, 019 América (América del Norte, América Latina, América del Sur y el Caribe), 142 Asia, 150 Europa, 009 Oceanía. Esta dimensión solo se puede utilizar para filtrar datos.
SubContinent String Verdadero (solo filtro) Un código de región estadístico de la ONU que identifica una subregión geográfica.
SubscribedStatus String Verdadero Esta dimensión indica si las métricas de actividad del usuario en la fila de datos están asociadas con espectadores que estaban suscritos al canal de video o lista de reproducción. Los valores posibles son SUBSCRIBED y UNSUBSCRIBED. Tenga en cuenta que el valor de la dimensión es preciso en el momento en que se produce la actividad del usuario.
ClaimedStatus String Verdadero (solo se usa en los informes de propietarios de contenido) Esta dimensión le permite indicar que un conjunto de resultados solo contendrá métricas para el contenido reclamado. Se reclama el valor permitido.
UploaderType String Verdadero (solo se usa en los informes de propietarios de contenido) Esta dimensión le permite indicar si un conjunto de resultados contendrá métricas para el contenido subido por el propietario de contenido especificado o el contenido subido por terceros, como videos subidos por usuarios. Los valores permitidos son self y thirdParty.
Shares Double Falso Verdadero La cantidad de veces que los usuarios compartieron un video a través del botón Compartir.
StartDate Date Fecha de inicio para obtener datos de Analytics.
EndDate Date Fecha de finalización para obtener datos de Analytics.
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.

Nombre Tipo Descripción
Segments String Segmenta los datos devueltos para su solicitud. Ya sea un SegmentId o un segmento personalizado.

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
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 idioma i18n.
Language String Un código BCP-47 que identifica de forma única un idioma.
Name String El nombre del idioma tal como está escrito en ese idioma.

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-DDThh🇲🇲ss.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-DDThh🇲🇲ss.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.

Nombre Tipo Descripción
OnBehalfOfContentOwner String Este parámetro está destinado exclusivamente a los socios de contenido de YouTube.

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-DDThh🇲🇲ss.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.

Nombre Tipo Descripción
Language String Un valor de hl indica a la API que recupere los metadatos de recursos localizados para un idioma de aplicación específico compatible con YouTube.
OnBehalfOfContentOwner String Este parámetro está destinado exclusivamente a los socios de contenido de YouTube.
OnBehalfOfContentOwnerChannel String Especifica el ID del canal de YouTube del canal al que se agrega un video.
ForContentOwner String Restringe la búsqueda para recuperar solo las listas de reproducción que pertenecen al propietario del contenido especificado en la columna OnBehalfOfContentOwner.
Region String Indica a la API que devuelva resultados de búsqueda para el país especificado.
SafeSearch String Indica si los resultados de la búsqueda deben incluir contenido restringido además de contenido estándar. Valores válidos: moderado, ninguno o estricto.
Rating String Especifica que las listas de reproducción se ordenan de mayor a menor calificación.

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
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 región i18n.
Country String El código de país ISO de dos letras que identifica la región.
Name String El nombre de la regió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.

Nombre Tipo Descripción
Language String El parámetro hl especifica el idioma que debe usarse para los valores de texto en la respuesta de la API. El valor predeterminado es en_US.

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-DDThh🇲🇲ss.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.

Nombre Tipo Descripción
MySubscribers String Establezca el valor de este parámetro en verdadero para recuperar una fuente de los suscriptores del usuario autenticado.
ForChannelId String La columna ForChannelId especifica una lista separada por comas de Id. de canal.
OnBehalfOfContentOwner String Esta columna está destinada exclusivamente a los socios de contenido de YouTube.
OnBehalfOfContentOwnerChannel String Especifica el ID de canal de YouTube del canal al que se agrega un video.
Alphabetical String Ordenar alfabéticamente
Relevance String Ordenar por relevancia.
Unread String Ordenar por orden de actividad.

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
Nombre Tipo Dimensión Métrica predeterminada Dimensión por defecto Descripción
Channel String Verdadero (solo se usa en los informes de propietarios de contenido) El ID de un canal de YouTube. La dimensión del canal se usa con frecuencia en los informes de propietarios de contenido porque esos informes generalmente agregan datos para múltiples canales.
Video String Verdadero El ID de un video de YouTube.
Group String Verdadero (solo filtro) El ID de un grupo de YouTube Analytics.
Playlist String Verdadero El ID de una lista de reproducción de YouTube.
Country String Verdadero El país asociado con las métricas en la fila del informe. El valor de la dimensión es un código de país ISO-3166-1 de dos letras, como EE. UU., CN (China) o FR (Francia). El código de país ZZ se usa para reportar métricas para las cuales YouTube no pudo identificar el país asociado.
Province String Verdadero El estado o territorio de EE. UU. asociado con las métricas en la fila del informe. El valor de la dimensión es un código ISO 3166-2 que identifica un estado de EE. UU. o el Distrito de Columbia, como US-MI (Michigan) o US-TX (Texas). El código de provincia US-ZZ se usa para informar métricas para las que YouTube no pudo identificar el estado de EE. UU. asociado. Si se especifica la columna Provincia, el país debe establecerse en EE. UU. en la cláusula WHERE.
Continent String Verdadero (solo filtro) Un código de región estadística de las Naciones Unidas (ONU). La API admite los siguientes valores: 002 África, 019 América (América del Norte, América Latina, América del Sur y el Caribe), 142 Asia, 150 Europa, 009 Oceanía. Esta dimensión solo se puede utilizar para filtrar datos.
SubContinent String Verdadero (solo filtro) Un código de región estadístico de la ONU que identifica una subregión geográfica.
Day String Verdadero Verdadero Cuando utiliza esta dimensión, los datos del informe se agregan diariamente y cada fila contiene datos de un día.
Month String Verdadero Los datos del informe se agregan por mes calendario. En el informe, las fechas se enumeran en formato AAAA-MM. Nota: Si su consultar SQL usa la dimensión Mes, entonces los parámetros StartDate y EndDate deben establecerse en el primer día del mes.
IsCurated Boolean Verdadero Este filtro indica que la solicitud está recuperando datos sobre vistas de video que ocurrieron en el contexto de una lista de reproducción. Este filtro es necesario para cualquier informe de lista de reproducción y su valor debe establecerse en 1.
ClaimedStatus String Verdadero (solo se usa en los informes de propietarios de contenido) Esta dimensión le permite indicar que un conjunto de resultados solo contendrá métricas para el contenido reclamado. Se reclama el valor permitido.
UploaderType String Verdadero (solo se usa en los informes de propietarios de contenido) Esta dimensión le permite indicar si un conjunto de resultados contendrá métricas para el contenido subido por el propietario de contenido especificado o el contenido subido por terceros, como videos subidos por usuarios. Los valores permitidos son self y thirdParty.
SubscribedStatus String Verdadero Esta dimensión indica si las métricas de actividad del usuario en la fila de datos están asociadas con espectadores que estaban suscritos al canal de video o lista de reproducción. Los valores posibles son SUBSCRIBED y UNSUBSCRIBED. Tenga en cuenta que el valor de la dimensión es preciso en el momento en que se produce la actividad del usuario.
YouTubeProduct String Verdadero Esta dimensión identifica el servicio de YouTube en el que se produjo la actividad del usuario. Los datos de esta dimensión están disponibles desde el 18 de julio de 2015. Los valores permitidos son BÁSICO, JUEGO, NIÑOS, DESCONOCIDO.
Views Double Falso Verdadero La cantidad de veces que se vio un video. En un informe de lista de reproducción, la métrica indica la cantidad de veces que se vio un video en el contexto de una lista de reproducción.
ViewerPercentage Double Falso Falso El porcentaje de espectadores que iniciaron sesión cuando vieron el video o la lista de reproducción.
EstimatedMinutesWatched Double Falso Verdadero La cantidad de minutos que los usuarios miraron videos para el canal, el propietario del contenido, el video o la lista de reproducción especificados.
AverageViewDuration Double Falso Verdadero La duración promedio, en segundos, de las reproducciones de video. En un informe de lista de reproducción, la métrica indica la duración promedio, en segundos, de las reproducciones de video que ocurrieron en el contexto de una lista de reproducción.
AverageViewPercentage Double Falso Verdadero El porcentaje promedio de un video visto durante una reproducción de video.
Comments Double Falso Verdadero La cantidad de veces que los usuarios comentaron un video.
Likes Double Falso Verdadero La cantidad de veces que los usuarios indicaron que les gustó un video dándole una calificación positiva.
Dislikes Double Falso Verdadero La cantidad de veces que los usuarios indicaron que no les gustó un video dándole una calificación negativa. Esta es una métrica central y está sujeta a la política de obsolescencia.
Shares Double Falso Verdadero La cantidad de veces que los usuarios compartieron un video a través del botón Compartir.
SubscribersGained Double Falso Verdadero La cantidad de veces que los usuarios se suscribieron a un canal o video.
SubscribersLost Double Falso Verdadero La cantidad de veces que los usuarios cancelaron la suscripción a un canal o video.
VideosAddedToPlaylists Double Falso Verdadero La cantidad de veces que se agregaron videos a la lista de reproducción del propietario del video o a otras listas de reproducción del canal, como la lista de reproducción Ver más tarde. No se informan las listas de reproducción de subidas de canales ni el historial de visualización del usuario. Esta métrica devuelve un número absoluto, lo que significa que si un usuario agrega un video a una lista de reproducción, lo elimina y luego lo vuelve a agregar, el valor de la métrica refleja que el video se agregó a una lista de reproducción dos veces. Los datos de esta métrica no están disponibles para fechas anteriores al 1 de octubre de 2014.
VideosRemovedFromPlaylists Double Falso Verdadero La cantidad de veces que los videos se eliminaron de la lista de reproducción del propietario del video y de otras listas de reproducción de YouTube, como la lista de reproducción Ver más tarde. Esta métrica devuelve un número absoluto, lo que significa que si un usuario agrega un video a una lista de reproducción, lo elimina, lo vuelve a agregar y luego lo vuelve a eliminar, el valor de la métrica refleja que el video se eliminó de una lista de reproducción dos veces. Los datos de esta métrica no están disponibles para fechas anteriores al 1 de octubre de 2014.
PlaylistStarts Double Falso Falso La cantidad de veces que los espectadores iniciaron la reproducción de una lista de reproducción.
ViewsPerPlaylistStart Double Falso Falso La cantidad promedio de vistas de video que ocurrieron cada vez que se inició una lista de reproducción.
AverageTimeInPlaylist Double Falso Falso La cantidad de tiempo promedio estimada, en minutos, que un espectador vio videos en una lista de reproducción después de que se inició la lista de reproducción.
AnnotationImpressions Double Falso Verdadero El número total de impresiones de anotaciones.
AnnotationClickableImpressions Double Falso Verdadero El número de anotaciones que aparecieron y en las que se pudo hacer clic.
AnnotationClicks Double Falso Verdadero El número de anotaciones en las que se hizo clic.
AnnotationClickThroughRate Double Falso Verdadero La proporción de anotaciones en las que los espectadores hicieron clic con respecto al número total de impresiones de anotaciones en las que se puede hacer clic.
AnnotationClosableImpressions Double Falso Verdadero El número de anotaciones que aparecieron y se pudieron cerrar.
AnnotationCloses Double Falso Verdadero El número de anotaciones cerradas.
AnnotationCloseRate Double Falso Verdadero La proporción de anotaciones que los espectadores cerraron con respecto al número total de impresiones de anotaciones.
EstimatedRevenue Decimal Falso Falso Los ingresos totales estimados (ingresos netos) de todas las fuentes publicitarias vendidas por Google, así como de fuentes no publicitarias para el intervalo de fechas y la región seleccionados. Los ingresos estimados están sujetos a ajustes de fin de mes y no incluyen la publicidad proporcionada y vendida por socios.
EstimatedAdRevenue Decimal Falso Falso Los ingresos totales estimados (ingresos netos) de todas las fuentes de publicidad vendidas por Google para el intervalo de fechas y la región seleccionados. Los ingresos estimados están sujetos a ajustes de fin de mes y no incluyen la publicidad proporcionada y vendida por socios.
EstimatedRedPartnerRevenue Decimal Falso Falso Los ingresos totales estimados obtenidos de las suscripciones a YouTube Red para las dimensiones de informe seleccionadas. El valor de la métrica refleja las ganancias del contenido musical y no musical y está sujeto a ajustes de fin de mes.
GrossRevenue Decimal Falso Falso Los ingresos brutos estimados, en USD, de toda la publicidad vendida por Google o por socios de DoubleClick para el intervalo de fechas y la región seleccionados. Los ingresos brutos están sujetos al ajuste de fin de mes y no incluyen la publicidad proporcionada por los socios. Los ingresos brutos no deben confundirse con las ganancias o los ingresos netos, que tienen en cuenta su participación en la propiedad y los acuerdos de participación en los ingresos.
Cpm Decimal Falso Falso Los ingresos brutos estimados por cada mil impresiones de anuncios.
AdImpressions Double Falso Falso El número de impresiones de anuncios verificadas servidas.
MonetizedPlaybacks Double Falso Falso La cantidad de instancias en las que un espectador reprodujo su video y se le mostró al menos una impresión de anuncio. Se cuenta una reproducción monetizada si a un espectador se le muestra un anuncio pre-roll pero deja de mirar el anuncio antes de que comience el video. El error estimado esperado para esta cifra es de ±2,0%.
PlaybackBasedCpm Decimal Falso Falso Los ingresos brutos estimados por mil reproducciones.
StartDate Date Fecha de inicio para obtener datos de Analytics.
EndDate Date Fecha de finalización para obtener datos de Analytics.
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.

Nombre Tipo Descripción
Segments String Segmenta los datos devueltos para su solicitud. Ya sea un SegmentId o un segmento personalizado.

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:

Dimensiones Obligatorio vídeo
Métricas Utilice 1 o más visualizaciones, comentarios, me gusta, no me gusta, videos agregados a las listas de reproducción, videos eliminados de las listas de reproducción, recursos compartidos, minutos vistos estimados, duración promedio de vista, porcentaje de vista promedio, tasa de clics de anotación, tasa de cierre de anotación, impresiones de anotación, impresiones de anotación que se pueden hacer clic, impresiones de cierre de anotación, clics de anotación, cierres de anotación, suscriptores ganados, suscriptores perdidos
Filtro Utilice 0 o uno país, continente, subcontinente
Ordenar Use 0 o más (solo en orden descendente) reproducciones, minutos estimados observados, suscriptores ganados, suscriptores perdidos

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
Nombre Tipo Dimensión Métrica predeterminada Dimensión por defecto Descripción
Channel String Verdadero (solo se usa en los informes de propietarios de contenido) El ID de un canal de YouTube. La dimensión del canal se usa con frecuencia en los informes de propietarios de contenido porque esos informes generalmente agregan datos para múltiples canales.
Video String Verdadero Verdadero El ID de un video de YouTube.
Playlist String Verdadero El ID de una lista de reproducción de YouTube.
Group String Verdadero (solo filtro) El ID de un grupo de YouTube Analytics.
Country String Verdadero El país asociado con las métricas en la fila del informe. El valor de la dimensión es un código de país ISO-3166-1 de dos letras, como EE. UU., CN (China) o FR (Francia). El código de país ZZ se usa para reportar métricas para las cuales YouTube no pudo identificar el país asociado.
Province String Verdadero El estado o territorio de EE. UU. asociado con las métricas en la fila del informe. El valor de la dimensión es un código ISO 3166-2 que identifica un estado de EE. UU. o el Distrito de Columbia, como US-MI (Michigan) o US-TX (Texas). El código de provincia US-ZZ se usa para informar métricas para las que YouTube no pudo identificar el estado de EE. UU. asociado. Si se especifica la columna Provincia, el país debe establecerse en EE. UU. en la cláusula WHERE.
Continent String Verdadero (solo filtro) Un código de región estadística de las Naciones Unidas (ONU). La API admite los siguientes valores: 002 África, 019 América (América del Norte, América Latina, América del Sur y el Caribe), 142 Asia, 150 Europa, 009 Oceanía. Esta dimensión solo se puede utilizar para filtrar datos.
SubContinent String Verdadero (solo filtro) Un código de región estadístico de la ONU que identifica una subregión geográfica.
IsCurated Boolean Verdadero Este filtro indica que la solicitud está recuperando datos sobre vistas de video que ocurrieron en el contexto de una lista de reproducción. Este filtro es necesario para cualquier informe de lista de reproducción y su valor debe establecerse en 1.
ClaimedStatus String Verdadero (solo se usa en los informes de propietarios de contenido) Esta dimensión le permite indicar que un conjunto de resultados solo contendrá métricas para el contenido reclamado. Se reclama el valor permitido.
UploaderType String Verdadero (solo se usa en los informes de propietarios de contenido) Esta dimensión le permite indicar si un conjunto de resultados contendrá métricas para el contenido subido por el propietario de contenido especificado o el contenido subido por terceros, como videos subidos por usuarios. Los valores permitidos son self y thirdParty.
SubscribedStatus String Verdadero Esta dimensión indica si las métricas de actividad del usuario en la fila de datos están asociadas con espectadores que estaban suscritos al canal de video o lista de reproducción. Los valores posibles son SUBSCRIBED y UNSUBSCRIBED. Tenga en cuenta que el valor de la dimensión es preciso en el momento en que se produce la actividad del usuario.
YouTubeProduct String Verdadero Esta dimensión identifica el servicio de YouTube en el que se produjo la actividad del usuario. Los datos de esta dimensión están disponibles desde el 18 de julio de 2015. Los valores permitidos son BÁSICO, JUEGO, NIÑOS, DESCONOCIDO.
Views Double Falso Verdadero La cantidad de veces que se vio un video. En un informe de lista de reproducción, la métrica indica la cantidad de veces que se vio un video en el contexto de una lista de reproducción.
EstimatedMinutesWatched Double Falso Verdadero La cantidad de minutos que los usuarios miraron videos para el canal, el propietario del contenido, el video o la lista de reproducción especificados.
AverageViewDuration Double Falso Verdadero La duración promedio, en segundos, de las reproducciones de video. En un informe de lista de reproducción, la métrica indica la duración promedio, en segundos, de las reproducciones de video que ocurrieron en el contexto de una lista de reproducción.
AverageViewPercentage Double Falso Falso El porcentaje promedio de un video visto durante una reproducción de video.
PlaylistStarts Double Falso Falso La cantidad de veces que los espectadores iniciaron la reproducción de una lista de reproducción.
Likes Double Falso Falso La cantidad de veces que los usuarios indicaron que les gustó un video dándole una calificación positiva.
ViewerPercentage Double Falso Falso El porcentaje de espectadores que iniciaron sesión cuando vieron el video o la lista de reproducción.
Comments Double Falso Verdadero La cantidad de veces que los usuarios comentaron un video.
Dislikes Double Falso Verdadero La cantidad de veces que los usuarios indicaron que no les gustó un video dándole una calificación negativa. Esta es una métrica central y está sujeta a la política de obsolescencia.
Shares Double Falso Verdadero La cantidad de veces que los usuarios compartieron un video a través del botón Compartir.
SubscribersGained Double Falso Verdadero La cantidad de veces que los usuarios se suscribieron a un canal o video.
SubscribersLost Double Falso Verdadero La cantidad de veces que los usuarios cancelaron la suscripción a un canal o video.
VideosAddedToPlaylists Double Falso Verdadero La cantidad de veces que se agregaron videos a la lista de reproducción del propietario del video o a otras listas de reproducción del canal, como la lista de reproducción Ver más tarde. No se informan las listas de reproducción de subidas de canales ni el historial de visualización del usuario. Esta métrica devuelve un número absoluto, lo que significa que si un usuario agrega un video a una lista de reproducción, lo elimina y luego lo vuelve a agregar, el valor de la métrica refleja que el video se agregó a una lista de reproducción dos veces. Los datos de esta métrica no están disponibles para fechas anteriores al 1 de octubre de 2014.
VideosRemovedFromPlaylists Double Falso Verdadero La cantidad de veces que los videos se eliminaron de la lista de reproducción del propietario del video y de otras listas de reproducción de YouTube, como la lista de reproducción Ver más tarde. Esta métrica devuelve un número absoluto, lo que significa que si un usuario agrega un video a una lista de reproducción, lo elimina, lo vuelve a agregar y luego lo vuelve a eliminar, el valor de la métrica refleja que el video se eliminó de una lista de reproducción dos veces. Los datos de esta métrica no están disponibles para fechas anteriores al 1 de octubre de 2014.
ViewsPerPlaylistStart Double Falso Falso La cantidad promedio de vistas de video que ocurrieron cada vez que se inició una lista de reproducción.
AverageTimeInPlaylist Double Falso Falso La cantidad de tiempo promedio estimada, en minutos, que un espectador vio videos en una lista de reproducción después de que se inició la lista de reproducción.
AnnotationImpressions Double Falso Verdadero El número total de impresiones de anotaciones.
AnnotationClickableImpressions Double Falso Verdadero El número de anotaciones que aparecieron y en las que se pudo hacer clic.
AnnotationClicks Double Falso Verdadero El número de anotaciones en las que se hizo clic.
AnnotationClickThroughRate Double Falso Verdadero La proporción de anotaciones en las que los espectadores hicieron clic con respecto al número total de impresiones de anotaciones en las que se puede hacer clic.
AnnotationClosableImpressions Double Falso Verdadero El número de anotaciones que aparecieron y se pudieron cerrar.
AnnotationCloses Double Falso Verdadero El número de anotaciones cerradas.
AnnotationCloseRate Double Falso Verdadero La proporción de anotaciones que los espectadores cerraron con respecto al número total de impresiones de anotaciones.
EstimatedRevenue Decimal Falso Falso Los ingresos totales estimados (ingresos netos) de todas las fuentes publicitarias vendidas por Google, así como de fuentes no publicitarias para el intervalo de fechas y la región seleccionados. Los ingresos estimados están sujetos a ajustes de fin de mes y no incluyen la publicidad proporcionada y vendida por socios.
EstimatedAdRevenue Decimal Falso Falso Los ingresos totales estimados (ingresos netos) de todas las fuentes de publicidad vendidas por Google para el intervalo de fechas y la región seleccionados. Los ingresos estimados están sujetos a ajustes de fin de mes y no incluyen la publicidad proporcionada y vendida por socios.
EstimatedRedPartnerRevenue Decimal Falso Falso Los ingresos totales estimados obtenidos de las suscripciones a YouTube Red para las dimensiones de informe seleccionadas. El valor de la métrica refleja las ganancias del contenido musical y no musical y está sujeto a ajustes de fin de mes.
GrossRevenue Decimal Falso Falso Los ingresos brutos estimados, en USD, de toda la publicidad vendida por Google o por socios de DoubleClick para el intervalo de fechas y la región seleccionados. Los ingresos brutos están sujetos al ajuste de fin de mes y no incluyen la publicidad proporcionada por los socios. Los ingresos brutos no deben confundirse con las ganancias o los ingresos netos, que tienen en cuenta su participación en la propiedad y los acuerdos de participación en los ingresos.
Cpm Decimal Falso Falso Los ingresos brutos estimados por cada mil impresiones de anuncios.
AdImpressions Double Falso Falso El número de impresiones de anuncios verificadas servidas.
MonetizedPlaybacks Double Falso Falso La cantidad de instancias en las que un espectador reprodujo su video y se le mostró al menos una impresión de anuncio. Se cuenta una reproducción monetizada si a un espectador se le muestra un anuncio pre-roll pero deja de mirar el anuncio antes de que comience el video. El error estimado esperado para esta cifra es de ±2,0%.
PlaybackBasedCpm Decimal Falso Falso Los ingresos brutos estimados por mil reproducciones.
StartDate Date Fecha de inicio para obtener datos de Analytics. Una cadena de fecha o una fecha relativa (por ejemplo, hoy, ayer o #hacedías).
EndDate Date Fecha de finalización para obtener datos de Analytics. Una cadena de fecha o una fecha relativa (por ejemplo, hoy, ayer o #hacedías).
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.

Nombre Tipo Descripción
Segments String Segmenta los datos devueltos para su solicitud. Ya sea un SegmentId o un segmento personalizado.

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
Nombre Tipo Dimensión Métrica predeterminada Dimensión por defecto Descripción
Channel String Verdadero (solo se usa en los informes de propietarios de contenido) El ID de un canal de YouTube. La dimensión del canal se usa con frecuencia en los informes de propietarios de contenido porque esos informes generalmente agregan datos para múltiples canales.
Video String Verdadero El ID de un video de YouTube.
Playlist String Verdadero El ID de una lista de reproducción de YouTube.
Group String Verdadero (solo filtro) El ID de un grupo de YouTube Analytics.
Country String Verdadero El país asociado con las métricas en la fila del informe. El valor de la dimensión es un código de país ISO-3166-1 de dos letras, como EE. UU., CN (China) o FR (Francia). El código de país ZZ se usa para reportar métricas para las cuales YouTube no pudo identificar el país asociado.
Province String Verdadero El estado o territorio de EE. UU. asociado con las métricas en la fila del informe. El valor de la dimensión es un código ISO 3166-2 que identifica un estado de EE. UU. o el Distrito de Columbia, como US-MI (Michigan) o US-TX (Texas). El código de provincia US-ZZ se usa para informar métricas para las que YouTube no pudo identificar el estado de EE. UU. asociado. Si se especifica la columna Provincia, el país debe establecerse en EE. UU. en la cláusula WHERE.
Continent String Verdadero (solo filtro) Un código de región estadística de las Naciones Unidas (U.N.). Los valores permitidos son 002 África, 019 América (América del Norte, América Latina, América del Sur y el Caribe), 142 Asia, 150 Europa, 009 Oceanía. Esta dimensión solo se puede utilizar para filtrar datos.
SubContinent String Verdadero (solo filtro) Un código de región estadístico de la ONU que identifica una subregión geográfica.
Day String Verdadero Cuando utiliza esta dimensión, los datos del informe se agregan diariamente y cada fila contiene datos de un día.
LiveOrOnDemand String Verdadero Esta dimensión indica si las métricas de actividad del usuario en la fila de datos están asociadas con vistas de una transmisión en vivo. Los datos de esta dimensión están disponibles para las fechas que comienzan el 1 de abril de 2014. Los valores permitidos son LIVE, ONDEMAND.
SubscribedStatus String Verdadero Esta dimensión indica si las métricas de actividad del usuario en la fila de datos están asociadas con espectadores que estaban suscritos al canal de video o lista de reproducción. Los valores permitidos son SUBSCRIBED, UNSUBSCRIBED. Tenga en cuenta que el valor de la dimensión es preciso en el momento en que se produce la actividad del usuario.
InsightTrafficSourceType String Verdadero Verdadero Los datos del informe se agregan según el tipo de referencia, que describe la forma en que los usuarios llegaron al video. Los valores permitidos son PUBLICIDAD, ANOTACIÓN, EXT_URL, NO_LINK_EMBEDDED, NO_LINK_OTHER, NOTIFICATION, PLAYLIST, PROMOTED, RELATED_VIDEO, SUBSCRIBER, YT_CHANNEL, YT_OTHER_PAGE, YT_SEARCH.
InsightTrafficSourceDetail String Verdadero Detalles sobre InsightTrafficSourceType.
IsCurated Boolean Verdadero Este filtro indica que la solicitud está recuperando datos sobre vistas de video que ocurrieron en el contexto de una lista de reproducción. Este filtro es necesario para cualquier informe de lista de reproducción y su valor debe establecerse en 1.
ClaimedStatus String Verdadero (solo se usa en los informes de propietarios de contenido) Esta dimensión le permite indicar que un conjunto de resultados solo contendrá métricas para el contenido reclamado. Se reclama el valor permitido.
UploaderType String Verdadero (solo se usa en los informes de propietarios de contenido) Esta dimensión le permite indicar si un conjunto de resultados contendrá métricas para el contenido subido por el propietario de contenido especificado o el contenido subido por terceros, como videos subidos por usuarios. Los valores permitidos son self y thirdParty.
Views Double Falso Verdadero La cantidad de veces que se vio un video. En un informe de lista de reproducción, la métrica indica la cantidad de veces que se vio un video en el contexto de una lista de reproducción.
EstimatedMinutesWatched Double Falso Verdadero La cantidad de minutos que los usuarios miraron videos para el canal, el propietario del contenido, el video o la lista de reproducción especificados.
PlaylistStarts Double Falso Falso La cantidad de veces que los espectadores iniciaron la reproducción de una lista de reproducción.
ViewsPerPlaylistStart Double Falso Falso La cantidad promedio de vistas de video que ocurrieron cada vez que se inició una lista de reproducción.
AverageTimeInPlaylist Double Falso Falso La cantidad de tiempo promedio estimada, en minutos, que un espectador vio videos en una lista de reproducción después de que se inició la lista de reproducción.
StartDate Date Fecha de inicio para obtener datos de Analytics.
EndDate Date Fecha de finalización para obtener datos de Analytics.
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.

Nombre Tipo Descripción
Segments String Segmenta los datos devueltos para su solicitud. Ya sea un SegmentId o un segmento personalizado.

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
Nombre Tipo Dimensión Métrica predeterminada Dimensión por defecto Descripción
Id [KEY] String El ID que utiliza YouTube para identificar el motivo.
Label String El texto de la etiqueta por el motivo.
SecondaryReasonsAggregate String Una lista de razones secundarias asociadas con la razón, si hay alguna disponible. Puede haber 0 o más.
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.

Nombre Tipo Descripción
Language String El parámetro hl especifica el idioma que debe usarse para los valores de texto en la respuesta de la API. El valor predeterminado es en_US.

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
Nombre Tipo Dimensión Métrica predeterminada Dimensión por defecto Descripción
Id [KEY] String El identificador único para la categoría de video.
ChannelId String El canal de YouTube que creó la categoría de video.
Title String El título de la categoría de video.
Assignable Boolean Indica si los videos se pueden asociar con la categoría.
Region String El país desde el que se recuperan las categorías de video.
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.

Nombre Tipo Descripción
Language String Especifica el idioma que debe usarse para los valores de texto en la respuesta de la API. El valor predeterminado es en_US.

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-DDThh🇲🇲ss.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-DDThh🇲🇲ss.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.

Nombre Tipo Descripción
SafeSearch String Indica si los resultados de la búsqueda deben incluir contenido restringido además de contenido estándar. Valores aceptables: moderado, ninguno o estricto.
EventType String El parámetro eventType restringe una búsqueda a eventos de transmisión. Los valores aceptables son: COMPLETADO, EN VIVO, PRÓXIMO. Los valores permitidos son COMPLETADO, EN VIVO, PRÓXIMO.
RelatedToVideoId String Recupera una lista de videos relacionados con el video que identifica el valor de la columna.
VideoDuration String Filtra los resultados de la búsqueda de videos según su duración. Valores aceptables: cualquiera, largo, medio o corto.
VideoCategoryId String El parámetro videoCategoryId identifica la categoría de video para la cual se debe recuperar el gráfico.
Region String Indica a la API que seleccione un gráfico de video disponible en la región especificada. Esta columna solo se puede utilizar junto con la columna del gráfico. El valor del parámetro es un código de país ISO 3166-1 alfa-2.
ForMine String Restringe la búsqueda para recuperar solo videos propiedad del usuario autenticado. Es falso por defecto.
Chart String El parámetro de gráfico identifica el gráfico que desea recuperar. Los valores aceptables son: mostPopular: devuelve los videos más populares para la región de contenido y la categoría de video especificados. Los valores permitidos son mostPopular.
MyRating String La calificación del usuario autenticado. Valores aceptables: me gusta o no me gusta. Los valores permitidos son me gusta, no me gusta.
Language String Recupere metadatos de recursos localizados para un idioma de aplicación específico compatible con el sitio web de YouTube.
ForContentOwner String Restringe la búsqueda para recuperar solo videos propiedad del propietario del contenido especificado por el parámetro OnBehalfOfContentOwner.
OnBehalfOfContentOwner String Este parámetro está destinado exclusivamente a los socios de contenido de YouTube.

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

Nombre Descripción
CreateCustomSchema Crea un archivo de esquema personalizado basado en las dimensiones y métricas especificadas.
GetOAuthAccessToken Obtiene el token de acceso de OAuth que se utilizará para la autenticación con varios servicios de Google.
GetOAuthAuthorizationURL Obtiene la URL de autorización de OAuth utilizada para la autenticación con varios servicios de Google.
RefreshOAuthAccessToken Obtiene el token de acceso de OAuth que se utilizará para la autenticación con varios servicios de Google.

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
Nombre Tipo Obligatorio Acepta flujos de salida Descripción
TableName String Cierto Falso El nombre de la nueva tabla.
FileName String Falso Falso La ruta completa del archivo y el nombre del esquema a generar. Ejemplo: 'C:\Users\User\Desktop\JiraSD\DataSetTest.rsd'
Description String Falso Falso Una descripción opcional para la tabla.
Dimensions String Falso Falso Una lista de dimensiones separadas por comas para incluir en el archivo de esquema.
Metrics String Cierto Falso Una lista separada por comas de métricas para incluir en el archivo de esquema.
FileStream String Falso Cierto Secuencia que contiene el esquema descargado si no se especifica FileName
Columnas del conjunto de resultados
Nombre Tipo Descripción
Success String Si el esquema se creó correctamente o no.
SchemaFile String El archivo de esquema generado.
FileData String El esquema generado codificado en Base64. Solo se devuelve si FileName o FileStream no están configurados.

GetOAuthAccessToken

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

Entrada
Nombre Tipo Obligatorio Descripción
AuthMode String Cierto El tipo de modo de autenticación a utilizar. Los valores permitidos son APP, WEB. El valor predeterminado es WEB.
Verifier String Falso El código verificador devuelto por Google después de que se haya otorgado el permiso para que la aplicación se conecte. Modo de autenticación WEB únicamente.
Scope String Cierto El alcance del acceso a las APIs de Google. De forma predeterminada, se especificará el acceso a todas las APIs utilizadas por este proveedor de datos. El valor predeterminado es *https://www.googleapis.com/auth/youtube https://www.googleapis.com/auth/youtube.readonly https://www.googleapis.com/auth/youtubepartner https://www.googleapis.com/auth/yt-analytics-monetary.readonly https://www.googleapis.com/auth/yt-analytics.readonly https://www.googleapis.com/auth/youtube.force-ssl*.
CallbackURL String Falso Este campo determina dónde se envía la respuesta. El valor de este parámetro debe coincidir exactamente con uno de los valores registrados en la consola de APIs, incluidos los esquemas HTTP o HTTPS, las mayúsculas y la barra diagonal final ('/').
Prompt String Cierto Este campo indica el aviso para presentar al usuario. Acepta uno de los siguientes valores: NINGUNO, CONSENTIMIENTO, SELECCIONAR CUENTA. El valor predeterminado es SELECT_ACCOUNT, por lo que se le pedirá a un usuario determinado que seleccione la cuenta a la que conectarse. Si se establece en CONSENTIMIENTO, el usuario verá una página de consentimiento cada vez, incluso si previamente ha dado su consentimiento a la aplicación para un conjunto determinado de ámbitos. Por último, si se establece en NINGUNO, no se mostrarán pantallas de autenticación o consentimiento al usuario. El valor predeterminado es SELECT_ACCOUNT.
AccessType String Cierto Este campo indica si su aplicación necesita acceder a una API de Google cuando el usuario no está presente en el navegador. Este parámetro está predeterminado en LÍNEA. Si su aplicación necesita actualizar los tokens de acceso cuando el usuario no está presente en el navegador, use OFFLINE. Esto hará que su aplicación obtenga un token de actualización la primera vez que intercambie un código de autorización para un usuario. Los valores permitidos son ONLINE, OFFLINE. El valor predeterminado es FUERA DE LÍNEA.
State String Falso Este campo indica cualquier estado que pueda ser de utilidad para su solicitud al recibir la respuesta. Su aplicación recibe el mismo valor que envió, ya que este parámetro realiza un viaje de ida y vuelta al servidor de autorización de Google y viceversa. Los usos incluyen redirigir al usuario al recurso correcto en su sitio, usar nonces y mitigar la falsificación de solicitudes entre sitios.
Columnas del conjunto de resultados
Nombre Tipo Descripción
OAuthAccessToken String El token de autenticación devuelto por Google. Esto se puede usar en llamadas posteriores a otras operaciones para este servicio en particular.
OAuthRefreshToken String Un token que puede usarse para obtener un nuevo token de acceso.
ExpiresIn String El tiempo de vida restante en el token de acceso.

GetOAuthAuthorizationURL

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

Entrada
Nombre Tipo Obligatorio Descripción
Scope String Cierto El alcance del acceso a las APIs de Google. De forma predeterminada, se especificará el acceso a todas las APIs utilizadas por este proveedor de datos. El valor predeterminado es *https://www.googleapis.com/auth/youtube https://www.googleapis.com/auth/youtube.readonly https://www.googleapis.com/auth/youtubepartner https://www.googleapis.com/auth/yt-analytics-monetary.readonly https://www.googleapis.com/auth/yt-analytics.readonly https://www.googleapis.com/auth/youtube.force-ssl*.
CallbackURL String Falso Este campo determina dónde se envía la respuesta. El valor de este parámetro debe coincidir exactamente con uno de los valores registrados en la consola de APIs, incluidos los esquemas HTTP o HTTPS, mayúsculas y minúsculas y barra diagonal final ('/').
Prompt String Cierto Este campo indica el aviso para presentar al usuario. Acepta uno de los siguientes valores: NINGUNO, CONSENTIMIENTO, SELECCIONAR CUENTA. El valor predeterminado es SELECT_ACCOUNT, por lo que se le pedirá a un usuario determinado que seleccione la cuenta a la que conectarse. Si se establece en CONSENTIMIENTO, el usuario verá una página de consentimiento cada vez, incluso si previamente ha dado su consentimiento a la aplicación para un conjunto determinado de ámbitos. Por último, si se establece en NINGUNO, no se mostrarán pantallas de autenticación o consentimiento al usuario. El valor predeterminado es SELECT_ACCOUNT.
AccessType String Cierto Este campo indica si su aplicación necesita acceder a una API de Google cuando el usuario no está presente en el navegador. Este parámetro está predeterminado en LÍNEA. Si su aplicación necesita actualizar los tokens de acceso cuando el usuario no está presente en el navegador, use OFFLINE. Esto hará que su aplicación obtenga un token de actualización la primera vez que intercambie un código de autorización para un usuario. Los valores permitidos son ONLINE, OFFLINE. El valor predeterminado es FUERA DE LÍNEA.
State String Falso Este campo indica cualquier estado que pueda ser de utilidad para su solicitud al recibir la respuesta. Su aplicación recibe el mismo valor que envió, ya que este parámetro realiza un viaje de ida y vuelta al servidor de autorización de Google y viceversa. Los usos posibles incluyen redirigir al usuario al recurso correcto en su sitio, usar nonces y mitigar la falsificación de solicitudes entre sitios.
Columnas del conjunto de resultados
Nombre Tipo Descripción
URL String La URL para completar la autenticación del usuario.

RefreshOAuthAccessToken

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

Entrada
Nombre Tipo Obligatorio Descripción
OAuthRefreshToken String Cierto El token de actualización devuelto del intercambio de código de autorización original.
Columnas del conjunto de resultados
Nombre Tipo Descripción
OAuthAccessToken String El token de autenticación devuelto por Google. Esto se puede usar en llamadas posteriores a otras operaciones para este servicio en particular.
OAuthRefreshToken String El token de autenticación devuelto por Google. Esto se puede usar en llamadas posteriores a otras operaciones para este servicio en particular.
ExpiresIn String El tiempo de vida restante en el token de acceso.

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:

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
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos.

sys_schemas

Enumera los esquemas disponibles.

La siguiente consultar recupera todos los esquemas disponibles:

SELECT * FROM sys_schemas
Columnas
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos.
SchemaName String El nombre del esquema.

sys_tables

Enumera las tablas disponibles.

La siguiente consultar recupera las tablas y vistas disponibles:

SELECT * FROM sys_tables
Columnas
Nombre Tipo Descripción
CatalogName String La base de datos que contiene la tabla o vista.
SchemaName String El esquema que contiene la tabla o vista.
TableName String El nombre de la tabla o vista.
TableType String El tipo de tabla (tabla o vista).
Description String Una descripción de la tabla o vista.
IsUpdateable Boolean Si la tabla se puede actualizar.

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
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos que contiene la tabla o vista.
SchemaName String El esquema que contiene la tabla o vista.
TableName String El nombre de la tabla o vista que contiene la columna.
ColumnName String El nombre de la columna.
DataTypeName String El nombre del tipo de datos.
DataType Int32 Un número entero que indica el tipo de datos. Este valor se determina en tiempo de ejecución en función del ambiente.
Length Int32 El tamaño de almacenamiento de la columna.
DisplaySize Int32 El ancho máximo normal de la columna designada en caracteres.
NumericPrecision Int32 El número máximo de dígitos en datos numéricos. La longitud de la columna en caracteres para datos de carácter y fecha y hora.
NumericScale Int32 La escala de columna o número de dígitos a la derecha del punto decimal.
IsNullable Boolean Si la columna puede contener nulo.
Description String Una breve descripción de la columna.
Ordinal Int32 El número de secuencia de la columna.
IsAutoIncrement String Si el valor de la columna se asigna en incrementos fijos.
IsGeneratedColumn String Si se genera la columna.
IsHidden Boolean Si la columna está oculta.
IsArray Boolean Si la columna es una matriz.

sys_procedures

Enumera los procedimientos almacenados disponibles.

La siguiente consultar recupera los procedimientos almacenados disponibles:

SELECT * FROM sys_procedures
Columnas
Nombre Tipo Descripción
CatalogName String La base de datos que contiene el procedimiento almacenado.
SchemaName String El esquema que contiene el procedimiento almacenado.
ProcedureName String El nombre del procedimiento almacenado.
Description String Una descripción del procedimiento almacenado.
ProcedureType String El tipo de procedimiento, como PROCEDIMIENTO o FUNCIÓN.

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
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos que contiene el procedimiento almacenado.
SchemaName String El nombre del esquema que contiene el procedimiento almacenado.
ProcedureName String El nombre del procedimiento almacenado* que contiene el parámetro.
ColumnName String El nombre del procedimiento almacenado* parámetro.
Direction Int32 Un número entero correspondiente al tipo de parámetro: entrada (1), entrada/salida (2) o salida (4). Los parámetros de tipo de entrada/salida pueden ser tanto parámetros de entrada como de salida.
DataTypeName String El nombre del tipo de datos.
DataType Int32 Un número entero que indica el tipo de datos. Este valor se determina en tiempo de ejecución en función del ambiente.
Length Int32 El número de caracteres permitidos para los datos de caracteres. El número de dígitos permitidos para datos numéricos.
NumericPrecision Int32 La máxima precisión para datos numéricos. La longitud de la columna en caracteres para datos de carácter y fecha y hora.
NumericScale Int32 El número de dígitos a la derecha del punto decimal en datos numéricos.
IsNullable Boolean Si el parámetro puede contener nulo.
IsRequired Boolean Si el parámetro es necesario para la ejecución del procedimiento.
IsArray Boolean Si el parámetro es una matriz.
Description String La descripción del parámetro.
Ordinal Int32 El índice del parámetro.

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
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos que contiene la clave.
SchemaName String El nombre del esquema que contiene la clave.
TableName String El nombre de la tabla que contiene la clave.
ColumnName String El nombre de la columna clave.
IsKey Boolean Si la columna es una clave principal en la tabla a la que se hace referencia en el campo TableName.
IsForeignKey Boolean Si la columna es una clave externa a la que se hace referencia en el campo TableName.
PrimaryKeyName String El nombre de la clave principal.
ForeignKeyName String El nombre de la clave foránea.
ReferencedCatalogName String La base de datos que contiene la clave principal.
ReferencedSchemaName String El esquema que contiene la clave principal.
ReferencedTableName String La tabla que contiene la clave principal.
ReferencedColumnName String El nombre de la columna de la clave principal.

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
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos que contiene la clave.
SchemaName String El nombre del esquema que contiene la clave.
TableName String El nombre de la tabla que contiene la clave.
ColumnName String El nombre de la columna clave.
PrimaryKeyName String El nombre de la clave principal.
ForeignKeyName String El nombre de la clave foránea.
ReferencedCatalogName String La base de datos que contiene la clave principal.
ReferencedSchemaName String El esquema que contiene la clave principal.
ReferencedTableName String La tabla que contiene la clave principal.
ReferencedColumnName String El nombre de la columna de la clave principal.
ForeignKeyType String Designa si la clave externa es una clave de importación (apunta a otras tablas) o de exportación (hace referencia desde otras tablas).

sys_primarykeys

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

SELECT * FROM sys_primarykeys
Columnas
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos que contiene la clave.
SchemaName String El nombre del esquema que contiene la clave.
TableName String El nombre de la tabla que contiene la clave.
ColumnName String El nombre de la columna clave.
KeySeq String El número de secuencia de la clave principal.
KeyName String El nombre de la clave principal.

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
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos que contiene el índice.
SchemaName String El nombre del esquema que contiene el índice.
TableName String El nombre de la tabla que contiene el índice.
IndexName String El nombre del índice.
ColumnName String El nombre de la columna asociada con el índice.
IsUnique Boolean True si el índice es único. Falso en caso contrario.
IsPrimary Boolean True si el índice es una clave principal. Falso en caso contrario.
Type Int16 Un valor entero correspondiente al tipo de índice: estadística (0), agrupado (1), hash (2) u otro (3).
SortOrder String El orden de clasificación: A para ascender o D para descender.
OrdinalPosition Int16 El número de secuencia de la columna en el índice.

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
Nombre Tipo Descripción
Name String El nombre de la propiedad de conexión.
ShortDescription String Una breve descripción.
Type String El tipo de datos de la propiedad de conexión.
Default String El valor predeterminado si no se establece uno explícitamente.
Values String Una lista separada por comas de valores posibles. Se lanza un error de validación si se especifica otro valor.
Value String El valor que establezca o un valor predeterminado preconfigurado.
Required Boolean Si la propiedad es necesaria para conectarse.
Category String La categoría de la propiedad de conexión.
IsSessionProperty String Si la propiedad es una propiedad de sesión, utilizada para guardar información sobre la conexión actual.
Sensitivity String El nivel de sensibilidad de la propiedad. Esto informa si la propiedad está ofuscada en los formularios de registro y autenticación.
PropertyName String Una forma truncada en mayúsculas y minúsculas del nombre de la propiedad de conexión.
Ordinal Int32 El índice del parámetro.
CatOrdinal Int32 El índice de la categoría de parámetro.
Hierarchy String Muestra las propiedades dependientes asociadas que deben configurarse junto con esta.
Visible Boolean Informa si la propiedad está visible en la interfaz de usuario de la conexión.
ETC String Diversa información miscelánea sobre la propiedad.

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.

Nombre Descripción Valores posibles
AGGREGATE_FUNCTIONS Funciones de agregación admitidas. AVG, COUNT, MAX, MIN, SUM, DISTINCT
COUNT Si se admite la función COUNT. YES, NO
IDENTIFIER_QUOTE_OPEN_CHAR El carácter de apertura utilizado para escapar de un identificador. [
IDENTIFIER_QUOTE_CLOSE_CHAR El carácter de cierre utilizado para escapar de un identificador. ]
SUPPORTED_OPERATORS Una lista de operadores de SQL admitidos. =, >, <, >=, <=, <>, !=, LIKE, NOT LIKE, IN, NOT IN, IS NULL, IS NOT NULL, AND, OR
GROUP_BY Si se admite GROUP BY y, de ser así, el grado de compatibilidad. NO, NO_RELATION, EQUALS_SELECT, SQL_GB_COLLATE
STRING_FUNCTIONS Funciones de cadena admitidas. LENGTH, CHAR, LOCATE, REPLACE, SUBSTRING, RTRIM, LTRIM, RIGHT, LEFT, UCASE, SPACE, SOUNDEX, LCASE, CONCAT, ASCII, REPEAT, OCTET, BIT, POSITION, INSERT, TRIM, UPPER, REGEXP, LOWER, DIFFERENCE, CHARACTER, SUBSTR, STR, REVERSE, PLAN, UUIDTOSTR, TRANSLATE, TRAILING, TO, STUFF, STRTOUUID, STRING, SPLIT, SORTKEY, SIMILAR, REPLICATE, PATINDEX, LPAD, LEN, LEADING, KEY, INSTR, INSERTSTR, HTML, GRAPHICAL, CONVERT, COLLATION, CHARINDEX, BYTE
NUMERIC_FUNCTIONS Funciones numéricas compatibles. ABS, ACOS, ASIN, ATAN, ATAN2, CEILING, COS, COT, EXP, FLOOR, LOG, MOD, SIGN, SIN, SQRT, TAN, PI, RAND, DEGREES, LOG10, POWER, RADIANS, ROUND, TRUNCATE
TIMEDATE_FUNCTIONS Funciones de fecha/hora admitidas. NOW, CURDATE, DAYOFMONTH, DAYOFWEEK, DAYOFYEAR, MONTH, QUARTER, WEEK, YEAR, CURTIME, HOUR, MINUTE, SECOND, TIMESTAMPADD, TIMESTAMPDIFF, DAYNAME, MONTHNAME, CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP, EXTRACT
REPLICATION_SKIP_TABLES Indica tablas omitidas durante la replicación.
REPLICATION_TIMECHECK_COLUMNS Una matriz de cadenas que contiene una lista de columnas que se usarán para verificar (en el orden dado) para usar como una columna modificada durante la replicación.
IDENTIFIER_PATTERN Valor de cadena que indica qué cadena es válida para un identificador.
SUPPORT_TRANSACTION Indica si el proveedor admite transacciones como compromiso y reversión. YES, NO
DIALECT Indica el dialecto SQL a usar.
KEY_PROPERTIES Indica las propiedades que identifican la base de datos uniforme.
SUPPORTS_MULTIPLE_SCHEMAS Indica si pueden existir varios esquemas para el proveedor. YES, NO
SUPPORTS_MULTIPLE_CATALOGS Indica si pueden existir varios catálogos para el proveedor. YES, NO
DATASYNCVERSION La versión de sincronización de datos necesaria para acceder a este controlador. Standard, Starter, Professional, Enterprise
DATASYNCCATEGORY La categoría Sincronización de datos de este controlador. Source, Destination, Cloud Destination
SUPPORTSENHANCEDSQL Si se admite la funcionalidad de SQL mejorada más allá de lo que ofrece la API. TRUE, FALSE
SUPPORTS_BATCH_OPERATIONS Si se admiten las operaciones lote. YES, NO
SQL_CAP Todas las funciones de SQL admitidas para este controlador. SELECT, INSERT, DELETE, UPDATE, TRANSACTIONS, ORDERBY, OAUTH, ASSIGNEDID, LIMIT, LIKE, BULKINSERT, COUNT, BULKDELETE, BULKUPDATE, GROUPBY, HAVING, AGGS, OFFSET, REPLICATE, COUNTDISTINCT, JOINS, DROP, CREATE, DISTINCT, INNERJOINS, SUBQUERIES, ALTER, MULTIPLESCHEMAS, GROUPBYNORELATION, OUTERJOINS, UNIONALL, UNION, UPSERT, GETDELETED, CROSSJOINS, GROUPBYCOLLATE, MULTIPLECATS, FULLOUTERJOIN, MERGE, JSONEXTRACT, BULKUPSERT, SUM, SUBQUERIESFULL, MIN, MAX, JOINSFULL, XMLEXTRACT, AVG, MULTISTATEMENTS, FOREIGNKEYS, CASE, LEFTJOINS, COMMAJOINS, WITH, LITERALS, RENAME, NESTEDTABLES, EXECUTE, BATCH, BASIC, INDEX
PREFERRED_CACHE_OPTIONS Un valor de cadena especifica las cacheOptions preferidas.
ENABLE_EF_ADVANCED_QUERY Indica si el controlador admite directamente consultas avanzadas provenientes de Entity Framework. De lo contrario, las consultas se manejarán del lado del cliente. YES, NO
PSEUDO_COLUMNS Una matriz de cadenas que indica las pseudocolumnas disponibles.
MERGE_ALWAYS Si el valor es verdadero, el modo de combinación se ejecuta a la fuerza en la sincronización de datos. TRUE, FALSE
REPLICATION_MIN_DATE_QUERY Una consultar de selección para devolver la fecha y hora de inicio de la réplica.
REPLICATION_MIN_FUNCTION Permite que un proveedor especifique el nombre de la fórmula que se usará para ejecutar un min del lado del servidor.
REPLICATION_START_DATE Permite que un proveedor especifique una fecha de inicio de réplica.
REPLICATION_MAX_DATE_QUERY Una consultar de selección para devolver la fecha y hora de finalización de la réplica.
REPLICATION_MAX_FUNCTION Permite que un proveedor especifique el nombre de la fórmula que se usará para ejecutar un máx. del lado del servidor.
IGNORE_INTERVALS_ON_INITIAL_REPLICATE Una lista de tablas que omitirán dividir la réplica en fragmentos en la réplica inicial.
CHECKCACHE_USE_PARENTID Indica si la instrucción CheckCache debe realizarse en la columna de clave principal. TRUE, FALSE
CREATE_SCHEMA_PROCEDURES Indica procedimientos almacenados* que se puede utilizar para generar archivos de esquema.

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
Nombre Tipo Descripción
NAME String Un componente de la sintaxis SQL o una capacidad que se puede procesar en el servidor.
VALUE String Detalles sobre el SQL o la sintaxis de SQL admitidos.

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
Nombre Tipo Descripción
Id String El ID generado por la base de datos devuelto de una operación de modificación de datos.
Batch String Un identificador para el lote. 1 para una sola operación.
Operation String El resultado de la operación en el lote: INSERTADO, ACTUALIZADO o ELIMINADO.
Message String ÉXITO o un mensaje de error si falla la actualización en el lote.

Propiedades de configuraciones avanzadas

Las propiedades de configuraciones avanzadas son las diversas opciones que se pueden utilizar para establecer una conexión. Esta sección proporciona una lista completa de las opciones que puede configurar. Haga clic en los enlaces para obtener más detalles.

Autenticación

Propiedad Descripción
AuthScheme El tipo de autenticación que se utilizará al conectarse a YouTube Analytics.
ChannelId El ID de un canal que pertenece al usuario autenticado.
ContentOwnerId El ID del titular de los derechos de autor del contenido del sistema de gestión de derechos de YouTube.

OAuth

Propiedad Descripción
InitiateOAuth Establezca esta propiedad para iniciar el proceso para obtener o actualizar el token de acceso de OAuth cuando se conecte.
OAuthClientId El ID de cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.
OAuthClientSecret El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.
OAuthAccessToken El token de acceso para conectarse mediante OAuth.
OAuthVerifier El código verificador devuelto desde la URL de autorización de OAuth.
OAuthRefreshToken El token de actualización de OAuth para el token de acceso de OAuth correspondiente.
OAuthExpiresIn La vida útil en segundos del AccessToken de OAuth.
OAuthTokenTimestamp La marca de tiempo de la época de Unix en milisegundos cuando se creó el token de acceso actual.

JWT OAuth

Propiedad Descripción
OAuthJWTCert El almacén de certificados JWT.
OAuthJWTCertType El tipo de almacén de claves que contiene el certificado JWT.
OAuthJWTCertPassword La contraseña para el certificado OAuth JWT.
OAuthJWTCertSubject El asunto del certificado OAuth JWT.
OAuthJWTIssuer El emisor del token web de Java.
OAuthJWTSubject El sujeto de usuario para el que la aplicación solicita acceso delegado.

Esquema

Propiedad Descripción
Location Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados.
BrowsableSchemas Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA, SchemaB, SchemaC.
Tables Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA, TablaB, TablaC.
Views Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA, VistaB, VistaC.

Misceláneas

Propiedad Descripción
DefaultFilter Un filtro predeterminado que se aplicará a todas las consultas.
MaxRows Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.
Other Estas propiedades ocultas se usan solo en casos de uso específicos.
PseudoColumns Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.
Timeout El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.
UserDefinedViews Una ruta de archivo que apunta al archivo de configuración JSON que contiene sus vistas personalizadas.

Autenticación

Esta sección proporciona una lista completa de las propiedades de autenticación que puede configurar.

Propiedad Descripción
AuthScheme El tipo de autenticación que se utilizará al conectarse a YouTube Analytics.
ChannelId El ID de un canal que pertenece al usuario autenticado.
ContentOwnerId El ID del titular de los derechos de autor del contenido del sistema de gestión de derechos de YouTube.

Esquema de autenticación

El tipo de autenticación que se utilizará al conectarse a YouTube Analytics.

Valores posibles

Auto, OAuth, OAuthJWT

Tipo de datos

string

Valor predeterminado

"Auto"

Observaciones
  • Automático: permite que el controlador decida automáticamente según las otras propiedades de conexión que haya establecido.
  • OAuth: Configure esto para realizar la autenticación OAuth usando una cuenta de usuario estándar.
  • OAuthJWT: Configure esto para realizar la autenticación OAuth usando una cuenta de servicio OAuth.

ID de canal

El ID de un canal que pertenece al usuario autenticado.

Tipo de datos

string

Valor predeterminado

""

Observaciones

El ID de un canal que pertenece al usuario autenticado. Puede encontrar esto en la página de configuración avanzada de la cuenta para su canal. Si no se especifica, se utilizará MINE; esto devuelve datos para el canal de YouTube del usuario autenticado.

ContentOwnerId

El ID del titular de los derechos de autor del contenido del sistema de gestión de derechos de YouTube.

Tipo de datos

string

Valor predeterminado

""

Observaciones

El ID del titular de los derechos de autor del contenido del sistema de gestión de derechos de YouTube. El propietario del contenido es la persona u organización que reclama videos y establece su política de monetización.

OAuth

Esta sección proporciona una lista completa de las propiedades de OAuth que puede configurar.

Propiedad Descripción
InitiateOAuth Establezca esta propiedad para iniciar el proceso para obtener o actualizar el token de acceso de OAuth cuando se conecte.
OAuthClientId El ID de cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.
OAuthClientSecret El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.
OAuthAccessToken El token de acceso para conectarse mediante OAuth.
OAuthVerifier El código verificador devuelto desde la URL de autorización de OAuth.
OAuthRefreshToken El token de actualización de OAuth para el token de acceso de OAuth correspondiente.
OAuthExpiresIn La vida útil en segundos del AccessToken de OAuth.
OAuthTokenTimestamp La marca de tiempo de la época de Unix en milisegundos cuando se creó el token de acceso actual.

Iniciar OAuth

Establezca esta propiedad para iniciar el proceso para obtener o actualizar el token de acceso de OAuth cuando se conecte.

Valores posibles

OFF, GETANDREFRESH, REFRESH

Tipo de datos

string

Valor predeterminado

"OFF"

Observaciones

Las siguientes opciones están disponibles:

  1. OFF: Indica que el flujo de OAuth será manejado en su totalidad por el usuario. Se requerirá un OAuthAccessToken para la autenticación.
  2. GETANDREFRESH: indica que el conector manejará todo el flujo de OAuth. Si actualmente no existe ningún token, se obtendrá solicitándolo al usuario a través del navegador. Si existe un token, se actualizará cuando corresponda.
  3. REFRESH: indica que el conector solo manejará la actualización de OAuthAccessToken. El conector nunca le pedirá al usuario que se autentique a través del navegador. El usuario debe manejar la obtención de OAuthAccessToken y OAuthRefreshToken inicialmente.

OAuthClientId

El ID de cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.

Tipo de datos

string

Valor predeterminado

""

Observaciones

Como parte del registro de una aplicación OAuth, recibirá el OAuthClientId valor, a veces también llamado clave de consumidor, y un secreto de cliente, el OAuthClientSecret.

OAuthClientSecret

El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.

Tipo de datos

string

Valor predeterminado

""

Observaciones

Como parte del registro de una aplicación OAuth, recibirá el OAuthClientId, también denominada clave de consumidor. También recibirá un secreto de cliente, también llamado secreto de consumidor. Establezca el secreto del cliente en OAuthClientSecret propiedad.

Token de acceso de OAuth

El token de acceso para conectarse mediante OAuth.

Tipo de datos

string

Valor predeterminado

""

Observaciones

El OAuthAccessToken la propiedad se usa para conectarse usando OAuth. El OAuthAccessToken se recupera del servidor OAuth como parte del proceso de autenticación. Tiene un tiempo de espera dependiente del servidor y se puede reutilizar entre solicitudes.

El token de acceso se utiliza en lugar de su nombre de usuario y contraseña. El token de acceso protege sus credenciales manteniéndolas en el servidor.

OAuthVerifier

El código verificador devuelto desde la URL de autorización de OAuth.

Tipo de datos

string

Valor predeterminado

""

Observaciones

El código verificador devuelto desde la URL de autorización de OAuth. Esto se puede usar en sistemas en los que no se puede iniciar un navegador, como los sistemas sin cabeza.

Autenticación en máquinas sin cabeza

Ver para obtener el OAuthVerifier valor.

Establezca OAuthSettingsLocation junto con OAuthVerifier. Cuando se conecta, el conector intercambia el OAuthVerifier para los tokens de autenticación de OAuth y los guarda, encriptados, en el archivo especificado. Establecer Iniciar OAuth a GETANDREFRESH para automatizar el intercambio.

Una vez que se haya generado el archivo de configuración de OAuth, puede eliminar OAuthVerifier desde las propiedades de conexión y conéctese con OAuthSettingsLocation colocar.

Para actualizar automáticamente los valores del token de OAuth, establezca OAuthSettingsLocation y además configure InitiateOAuth refrescar.

OAuthRefreshToken

El token de actualización de OAuth para el token de acceso de OAuth correspondiente.

Tipo de datos

string

Valor predeterminado

""

Observaciones

El OAuthRefreshToken la propiedad se usa para actualizar el OAuthAccessToken al usar la autenticación OAuth.

OAuthExpiresIn

La vida útil en segundos del AccessToken de OAuth.

Tipo de datos

string

Valor predeterminado

""

Observaciones

Empareje con OAuthTokenTimestamp para determinar cuándo caducará el AccessToken.

OAuthTokenTimestamp

La marca de tiempo de la época de Unix en milisegundos cuando se creó el token de acceso actual.

Tipo de datos

string

Valor predeterminado

""

Observaciones

Emparéjese con OAuthExpiresIn para determinar cuándo expirará AccessToken.

JWT OAuth

Esta sección proporciona una lista completa de las propiedades de JWT OAuth que puede configurar.

Propiedad Descripción
OAuthJWTCert El almacén de certificados JWT.
OAuthJWTCertType El tipo de almacén de claves que contiene el certificado JWT.
OAuthJWTCertPassword La contraseña para el certificado OAuth JWT.
OAuthJWTCertSubject El asunto del certificado OAuth JWT.
OAuthJWTIssuer El emisor del token web de Java.
OAuthJWTSubject El sujeto de usuario para el que la aplicación solicita acceso delegado.

OAuthJWTCert

El almacén de certificados JWT.

Tipo de datos

string

Valor predeterminado

""

Observaciones

El nombre del almacén de certificados para el certificado de cliente.

El OAuthJWTCertType especifica el tipo de almacén de certificados especificado por OAuthJWTCert. Si la tienda está protegida con contraseña, especifique la contraseña en OAuthJWTCertPassword.

OAuthJWTCert se usa junto con OAuthJWTCertSubject para especificar certificados de cliente. Si OAuthJWTCert tiene un valor y OAuthJWTCertSubject, se inicia una búsqueda de un certificado. Consulte OAuthJWTCertSubject campo para más detalles.

Las designaciones de los almacenes de certificados dependen de la plataforma.

Las siguientes son designaciones de los almacenes de certificados de usuario y máquina más comunes en Windows:

Propiedad Descripción
MY Un almacén de certificados que contiene certificados personales con sus claves privadas asociadas.
CA Certificados de la autoridad certificadora.
ROOT Certificados raíz.
SPC Certificados de editor de software.

En Java, el almacén de certificados normalmente es un archivo que contiene certificados y claves privadas opcionales.

Cuando el tipo de almacén de certificados es PFXFile, esta propiedad debe establecerse en el nombre del archivo. Cuando el tipo es PFXBlob, la propiedad debe establecerse en el contenido binario de un archivo PFX (es decir, almacén de certificados PKCS12).

OAuthJWTCertType

El tipo de almacén de claves que contiene el certificado JWT.

Valores posibles

GOOGLEJSONBLOB, USER, MACHINE, PFXFILE, PFXBLOB, JKSFILE, JKSBLOB, PEMKEY_FILE, PEMKEY_BLOB, PUBLIC_KEY_FILE, PUBLIC_KEY_BLOB, SSHPUBLIC_KEY_FILE, SSHPUBLIC_KEY_BLOB, P7BFILE, PPKFILE, XMLFILE, XMLBLOB, GOOGLEJSON

Tipo de datos

string

Valor predeterminado

"USER"

Observaciones

Esta propiedad puede tomar uno de los siguientes valores:

Propiedad Descripción
USER Para Windows, esto especifica que el almacén de certificados es un almacén de certificados propiedad del usuario actual. Nota: Este tipo de tienda no está disponible en Java.
MACHINE Para Windows, esto especifica que el almacén de certificados es un almacén de máquinas. Nota: este tipo de tienda no está disponible en Java.
PFXFILE El almacén de certificados es el nombre de un archivo PFX (PKCS12) que contiene certificados.
PFXBLOB El almacén de certificados es una cadena (codificada en base 64) que representa un almacén de certificados en formato PFX (PKCS12).
JKSFILE El almacén de certificados es el nombre de un archivo de almacén de claves Java (JKS) que contiene certificados. Nota: este tipo de tienda solo está disponible en Java.
JKSBLOB El almacén de certificados es una cadena (codificada en base 64) que representa un almacén de certificados en formato de almacén de claves Java (JKS). Nota: este tipo de tienda solo está disponible en Java.
PEMKEY_FILE El almacén de certificados es el nombre de un archivo con codificación PEM que contiene una clave privada y un certificado opcional.
PEMKEY_BLOB El almacén de certificados es una cadena (codificada en base64) que contiene una clave privada y un certificado opcional.
PUBLIC_KEY_FILE El almacén de certificados es el nombre de un archivo que contiene un certificado de clave pública con codificación PEM o DER.
PUBLIC_KEY_BLOB El almacén de certificados es una cadena (codificada en base 64) que contiene un certificado de clave pública con codificación PEM o DER.
SSHPUBLIC_KEY_FILE El almacén de certificados es el nombre de un archivo que contiene una clave pública de estilo SSH.
SSHPUBLIC_KEY_BLOB El almacén de certificados es una cadena (codificada en base 64) que contiene una clave pública de estilo SSH.
P7BFILE El almacén de certificados es el nombre de un archivo PKCS7 que contiene certificados.
PPKFILE El almacén de certificados es el nombre de un archivo que contiene una PPK (clave privada PuTTY).
XMLFILE El almacén de certificados es el nombre de un archivo que contiene un certificado en formato XML.
XMLBLOB El almacén de certificados es una cadena que contiene un certificado en formato XML.
GOOGLEJSON El almacén de certificados es el nombre de un archivo JSON que contiene la información de la cuenta de servicio. Solo válido cuando se conecta a un servicio de Google.
GOOGLEJSONBLOB El almacén de certificados es una cadena que contiene la cuenta de servicio JSON. Solo válido cuando se conecta a un servicio de Google.

OAuthJWTCertPassword

La contraseña para el certificado OAuth JWT.

Tipo de datos

string

Valor predeterminado

""

Observaciones

Si el almacén de certificados es de un tipo que requiere una contraseña, esta propiedad se usa para especificar esa contraseña para abrir el almacén de certificados.

Esto no es necesario cuando se usa GOOGLEJSON OAuthJWTCertType. Las claves JSON de Google no están cifradas.

OAuthJWTCertSubject

El asunto del certificado OAuth JWT.

Tipo de datos

string

Valor predeterminado

"\*"

Observaciones

Al cargar un certificado, el asunto se utiliza para ubicar el certificado en el almacén.

Si no se encuentra una coincidencia exacta, se busca en la tienda temas que contengan el valor de la propiedad.

Si aún no se encuentra una coincidencia, la propiedad se establece en una cadena vacía y no se selecciona ningún certificado.

El valor especial "*" selecciona el primer certificado en el almacén de certificados.

El asunto del certificado es una lista separada por comas de valores y campos de nombre distinguido. Por ejemplo, "CN=www.server.com, OU=test, C=US, E=support@cdata.com". Los campos comunes y sus significados se muestran a continuación.

Campo Significado
CN Nombre común. Este es comúnmente un nombre de alojar como www.server.com.
O Organización
OU Unidad organizativa
L localidad
S Estado
C País
E Dirección de Correo

Si un valor de campo contiene una coma, debe estar entre comillas.

OAuthJWTIssuer

El emisor del token web de Java.

Tipo de datos

string

Valor predeterminado

""

Observaciones

El emisor del token web de Java. Suele ser el ID del cliente o la dirección de Correo de la aplicación OAuth.

Esto no es necesario cuando se usa GOOGLEJSON OAuthJWTCertType. Las claves JSON de Google contienen una copia de la cuenta del emisor.

OAuthJWTSubject

El sujeto de usuario para el que la aplicación solicita acceso delegado.

Tipo de datos

string

Valor predeterminado

""

Observaciones

El sujeto de usuario para el que la aplicación solicita acceso delegado. Por lo general, el nombre de la cuenta de usuario o la dirección de correo.

Esquema

Esta sección proporciona una lista completa de propiedades de esquema que puede configurar.

Propiedad Descripción
Location Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados.
BrowsableSchemas Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA, SchemaB, SchemaC.
Tables Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA, TablaB, TablaC.
Views Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA, VistaB, VistaC.

Ubicación

Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados.

Tipo de datos

string

Valor predeterminado

"%APPDATA%\\\YouTubeAnalytics Data Provider\\Schema"

Observaciones

La ruta a un directorio que contiene los archivos de esquema para el conector (archivos .rsd para tablas y vistas, archivos .rsb para procedimientos almacenados). La ubicación de la carpeta puede ser una ruta relativa desde la ubicación del ejecutable. El Location La propiedad solo es necesaria si desea personalizar las definiciones (por ejemplo, cambiar el nombre de una columna, ignorar una columna, etc.) o ampliar el modelo de datos con nuevas tablas, vistas o procedimientos almacenados.

Si no se especifica, la ubicación predeterminada es "%APPDATA%\\YouTubeAnalytics Data Provider\Schema" con %APPDATA% estando configurado en el directorio de configuración del usuario:

Plataforma %APPDATA%
Windows El valor de la variable de ambiente APPDATA
Mac ~/Biblioteca/Soporte de aplicaciones
Linux ~/.config

Esquemas navegables

Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA,SchemaB,SchemaC.

Tipo de datos

string

Valor predeterminado

""

Observaciones

Enumerar los esquemas de las bases de datos puede resultar costoso. Proporcionar una lista de esquemas en la cadena de conexión mejora el rendimiento.

Tablas

Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA,TablaB,TablaC.

Tipo de datos

string

Valor predeterminado

""

Comentarios

Listar las tablas de algunas bases de datos puede resultar costoso. Proporcionar una lista de tablas en la cadena de conexión mejora el rendimiento del conector.

Esta propiedad también se puede utilizar como una alternativa a la lista automática de vistas si ya sabe con cuáles quiere trabajar y, de lo contrario, habría demasiadas para trabajar.

Especifique las tablas que desea en una lista separada por comas. Cada tabla debe ser un identificador SQL válido con cualquier carácter especial escapado usando corchetes, comillas dobles o acentos graves. Por ejemplo, Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.

Tenga en cuenta que al conectarse a una fuente de datos con varios esquemas o catálogos, deberá proporcionar el nombre completo de la tabla en esta propiedad, como en el último ejemplo aquí, para evitar la ambigüedad entre las tablas que existen en varios catálogos o esquemas.

Vistas

Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA,VistaB,VistaC.

Tipo de datos

string

Valor predeterminado

""

Observaciones

Listar las vistas de algunas bases de datos puede ser costoso. Proporcionar una lista de vistas en la cadena de conexión mejora el rendimiento del conector.

Esta propiedad también se puede utilizar como una alternativa a la lista automática de vistas si ya sabe con cuáles quiere trabajar y, de lo contrario, habría demasiadas para trabajar.

Especifique las vistas que desee en una lista separada por comas. Cada vista debe ser un identificador SQL válido con cualquier carácter especial escapado usando corchetes, comillas dobles o acentos graves. Por ejemplo, Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.

Tenga en cuenta que al conectarse a una fuente de datos con varios esquemas o catálogos, deberá proporcionar el nombre completo de la tabla en esta propiedad, como en el último ejemplo aquí, para evitar la ambigüedad entre las tablas que existen en varios catálogos o esquemas.

Varios

Esta sección proporciona una lista completa de propiedades misceláneas que puede configurar.

Propiedad Descripción
DefaultFilter Un filtro predeterminado que se aplicará a todas las consultas.
MaxRows Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.
Other Estas propiedades ocultas se usan solo en casos de uso específicos.
PseudoColumns Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.
Timeout El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.
UserDefinedViews Una ruta de archivo que apunta al archivo de configuración JSON que contiene sus vistas personalizadas.

Filtro predeterminado

Un filtro predeterminado que se aplicará a todas las consultas.

Tipo de datos

string

Valor predeterminado

"EndDate=Today"

Observaciones

Un filtro predeterminado que se aplicará a todas las consultas. Conveniente para configurar Dimensiones, Fecha de inicio, Fecha de finalización y Segmentos predeterminados para todas las consultas. Estos valores se anularán si se establecen en la consultar. Valor de ejemplo: Dimensiones = Año Y Fecha de finalización = Hoy

filas máximas

Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.

Tipo de datos

int

Valor predeterminado

-1

Observaciones

Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.

Otro

Estas propiedades ocultas se usan solo en casos de uso específicos.

Tipo de datos

string

Valor predeterminado

""

Observaciones

Las propiedades enumeradas a continuación están disponibles para casos de uso específicos. Los casos de uso y la funcionalidad normales del controlador no deberían requerir estas propiedades.

Especifique varias propiedades en una lista separada por punto y coma.

Integración y formato
Propiedad Descripción
DefaultColumnSize Establece la longitud predeterminada de los campos de cadena cuando la fuente de datos no proporciona la longitud de columna en los metadatos. El valor predeterminado es 2000.
ConvertDateTimeToGMT Determina si se convierten los valores de fecha y hora a GMT, en lugar de la hora local de la máquina.
RecordToFile=filename Registra la transferencia de datos del socket subyacente al archivo especificado.

PseudoColumnas

Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.

Tipo de datos

string

Valor predeterminado

""

Observaciones

Esta configuración es particularmente útil en Entity Framework, que no le permite establecer un valor para una pseudocolumna a menos que sea una columna de tabla. El valor de esta configuración de conexión tiene el formato "Tabla1=Columna1, Tabla1=Columna2, Tabla2=Columna3". Puede usar el carácter "*" para incluir todas las tablas y todas las columnas; por ejemplo, "*=*".

Tiempo de espera

El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.

Tipo de datos

int

Valor predeterminado

60

Observaciones

Si Timeout = 0, las operaciones no expiran. Las operaciones se ejecutan hasta que se completan correctamente o hasta que encuentran una condición de error.

Si Timeout caduca y la operación aún no se ha completado, el conector genera una excepción.

Vistas definidas por el usuario

Una ruta de archivo que apunta al archivo de configuración JSON que contiene sus vistas personalizadas.

Tipo de datos

string

Valor predeterminado

""

Observaciones

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"