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 enOAuthJWT
.InitiateOAuth
: Requerido. Establézcalo enGETANDREFRESH
.OAuthJWTCertType
: Requerido. Establézcalo enGOOGLEJSON
.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 enOAuthJWT
.InitiateOAuth
: Requerido. Establézcalo enGETANDREFRESH
.OAuthJWTCertType
: Requerido. Establézcalo enPFXFILE
.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 unOAuthJWTCertType
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 dominioiam.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 manualmenteOAuthAccessToken
.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.
- Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
- Obtiene un nuevo token de acceso cuando caduca el anterior.
- 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 manualmenteOAuthAccessToken
.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:
- Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
- Actualiza el token de acceso cuando caduca.
- 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.
- Crea y firma el JWT con el conjunto de notificaciones requerido por el conector.
- Intercambia el JWT por el token de acceso.
- Guarda los valores de OAuth en
OAuthSettingsLocation
para persistir a través de las conexiones. - 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.
- 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. - 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:
- Haga clic en el siguiente enlace para abrir el extremo de OAuth de YouTube Analytics en su 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.
- 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.
- 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.
- 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.
- 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.
- Crea y firma el JWT con el conjunto de notificaciones requerido por el conector.
- Intercambia el JWT por el token de acceso.
- Guarda los valores de OAuth en
OAuthSettingsLocation
para persistir a través de las conexiones. - 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
- Inicie sesión en la Consola API de Google y abra un proyecto. Seleccione el API Manager en el menú principal.
- 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
yOAuthClientSecret
son mostrados. - 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.
- Inicie sesión en la Consola API de Google y abra un proyecto. Seleccione el API Manager en el menú principal.
- Haga clic en Crear credenciales -> Clave de cuenta de servicio.
- En el menú Cuenta de servicio, seleccione Nueva cuenta de servicio o seleccione una cuenta de servicio existente.
- 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.
- En la sección Tipo de clave, seleccione el tipo de clave P12.
- Cree la aplicación para descargar el par de claves. Se muestra la contraseña de la clave privada: Configure esto en
OAuthJWTCertPassword
. - 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. - 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-DDThhss.sZ). | |||
ChannelId | String | El ID que utiliza YouTube para identificar de forma exclusiva el canal asociado con la actividad. | |||
Title | String | El título del recurso asociado principalmente con la actividad. | |||
Description | String | La descripción del recurso asociado principalmente con la actividad. | |||
ChannelTitle | String | Título del canal para el canal responsable de esta actividad. | |||
Type | String | El tipo de actividad que describe el recurso. Valores válidos: channelItem, comentario (no devuelto actualmente), favorito, me gusta, playlistItem, recomendación, redes sociales, suscripción y carga. | |||
GroupId | String | El ID de grupo asociado con la actividad. | |||
ThumbnailsDefaultUrl | String | La URL de la miniatura de la imagen predeterminada. | |||
UploadVideoId | String | El ID que usa YouTube para identificar de manera única el video subido. | |||
LikeResourceIdKind | String | El tipo de recurso que recibió una calificación positiva (me gusta). | |||
LikeResourceIdVideoId | String | El ID que usa YouTube para identificar de forma exclusiva el video, si el recurso calificado es un video. Esta columna solo está presente si ResourceIdKind es youtube#video. | |||
FavoriteResourceIdKind | String | El tipo de entidad de YouTube marcada como favorita. | |||
FavoriteResourceIdVideoId | String | El ID que usa YouTube para identificar de forma única el video favorito. | |||
CommentResourceIdKind | String | El comentario sobre el recurso API. | |||
CommentResourceIdVideoId | String | El ID que usa YouTube para identificar de forma única el video asociado con un comentario. | |||
CommentResourceIdChannelId | String | El ID que usa YouTube para identificar de forma única el canal asociado con un comentario. | |||
SubscriptionResourceIdKind | String | El tipo de suscripción. Una suscripción es un canal al que se suscribió un usuario. | |||
SubscriptionResourceIdChannelId | String | El ID que utiliza YouTube para identificar de forma exclusiva el canal al que se suscribió el usuario. | |||
PlaylistItemResourceIdKind | String | El tipo del elemento de la lista de reproducción. | |||
PlaylistItemResourceIdVideoId | String | El ID que usa YouTube para identificar de forma exclusiva el video que se agregó a la lista de reproducción. | |||
PlaylistItemPlaylistId | String | El valor que utiliza YouTube para identificar de forma única la lista de reproducción. | |||
PlaylistItemPlaylistItemId | String | El valor que utiliza YouTube para identificar de forma exclusiva el elemento en la lista de reproducción. | |||
RecommendationResourceIdKind | String | El tipo de recomendación. | |||
RecommendationResourceIdVideoId | String | El ID que usa YouTube para identificar de forma exclusiva el video, si el recurso recomendado es un video. | |||
RecommendationResourceIdChannelId | String | El ID que utiliza YouTube para identificar de forma exclusiva el canal, si el recurso recomendado es un canal. | |||
RecommendationReason | String | El motivo por el que se recomendó la entidad de YouTube al usuario. Valores válidos para esta columna: sin especificar, videoFavorited, videoLiked y videoWatched. | |||
RecommendationSeedResourceIdKind | String | El tipo de entidad de YouTube que generó la recomendación. | |||
RecommendationSeedResourceIdVideoId | String | El ID que usa YouTube para identificar de forma única el video, si la recomendación fue causada por un video en particular. | |||
RecommendationSeedResourceIdChannelId | String | El ID que usa YouTube para identificar de forma única el canal, si la recomendación fue causada por un canal en particular. | |||
RecommendationSeedResourceIdPlaylistId | String | El ID que usa YouTube para identificar de forma única la lista de reproducción, si la recomendación fue causada por una lista de reproducción en particular. | |||
SocialType | String | El nombre de la publicación en la red social. Valores válidos para esta columna: facebook, googlePlus, twitter y sin especificar. | |||
SocialResourceIdKind | String | El tipo de publicación en la red social. | |||
SocialResourceIdVideoId | String | El ID que usa YouTube para identificar de manera única el video que aparece en una publicación de una red social, si la publicación hace referencia a un video. | |||
SocialResourceIdChannelId | String | El ID que utiliza YouTube para identificar de forma exclusiva el canal que aparece en una publicación de una red social, si la publicación hace referencia a un canal. | |||
SocialResourceIdPlaylistId | String | El ID que usa YouTube para identificar de forma única la lista de reproducción que aparece en una publicación en una red social. | |||
SocialAuthor | String | El autor de la publicación en la red social. | |||
SocialReferenceUrl | String | La URL de la publicación en la red social. | |||
SocialImageUrl | String | Una imagen del autor del post. | |||
ChannelItemResourceId | String | El ID de la entidad de YouTube que se agregó al canal. |
Pseudocolumnas
Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.
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-DDThhss.sZ). | |||
TrackKind | String | El tipo de la pista de subtítulos. Valores válidos para esta columna: ASR (una pista de subtítulos generada mediante el reconocimiento de voz automático); Forzado (una pista de subtítulos que se reproduce cuando no se selecciona ninguna otra pista en el reproductor. Por ejemplo, un video que muestra extraterrestres hablando en un idioma extranjero puede tener una pista de subtítulos forzados para mostrar solo subtítulos para el idioma extranjero); estándar (una pista de subtítulos regular. Este es el valor predeterminado). | |||
Language | String | El idioma de la pista de subtítulos. El valor de la columna es una etiqueta de idioma BCP-47. | |||
Name | String | El nombre de la pista de subtítulos. El nombre está destinado a ser visible para el usuario como una opción durante la reproducción. | |||
AudioTrackType | String | El tipo de pista de audio asociada con la pista de subtítulos. Valores válidos para esta columna: comentario (la pista de subtítulos corresponde a una pista de audio alternativa que incluye comentarios, como los comentarios del director); descriptivo (la pista de subtítulos corresponde a una pista de audio alternativa que incluye audio descriptivo adicional); principal (la pista de subtítulos corresponde a la pista de audio principal del video, que es la pista de audio normalmente asociada con el video); desconocido (este es el valor predeterminado). | |||
IsCC | Boolean | Indica si la pista contiene subtítulos para personas sordas o con dificultades auditivas. El valor predeterminado es falso. | |||
IsLarge | Boolean | Indica si la pista de subtítulos utiliza texto grande para personas con problemas de visión. El valor predeterminado es falso. | |||
IsEasyReader | Boolean | Indica si la pista de subtítulos está formateada para facilitar la lectura, lo que significa que está en un nivel de tercer grado para estudiantes de idiomas. El valor predeterminado es falso. | |||
IsDraft | Boolean | Indica si la pista de subtítulos es un borrador. Si el valor es verdadero, la pista no es públicamente visible. El valor predeterminado es falso. | |||
IsAutoSynced | Boolean | Indica si YouTube sincronizó la pista de subtítulos con la pista de audio del video. El valor será verdadero si se solicitó explícitamente una sincronización cuando se cargó la pista de subtítulos. Si el valor es falso, YouTube usa los códigos de tiempo en la pista de subtítulos cargada para determinar cuándo mostrar los subtítulos. | |||
Status | String | El estado de la pista de subtítulos. Valores válidos para esta columna: fallado, sirviendo, sincronizando. | |||
FailureReason | String | La razón por la que YouTube no pudo procesar la pista de subtítulos. Valores válidos: processingFailed (YouTube no pudo procesar la pista de subtítulos cargada); unknownFormat (no se reconoció el formato de la pista de subtítulos); unsupportedFormat (el formato de la pista de subtítulos no es compatible). |
Canales
Consulta de canales de YouTube.
Información específica de la tabla
Seleccionar
Por defecto, SupportEnhancedSQL
se establece en verdadero y lo siguiente se pasará a YouTube Analytics, si está presente. Otros filtros se ejecutarán del lado del cliente. Si SupportEnhancedSQL
se establece en falso, solo se respetarán los siguientes filtros.
De manera predeterminada, si no se especifican filtros, el controlador devolverá todos los canales que pertenecen al usuario autenticado.
YouTube Analytics permite que solo se utilice un subconjunto de columnas como criterio de filtro. Los canales se pueden filtrar por el Id. Las columnas opcionales adicionales admitidas son Language y ChannelId.
Se puede activar una búsqueda en todos los canales en YouTube Analytics especificando uno o más términos de búsqueda, ID de canal, región, SafeSearch, calificación o relevancia para buscar en todos los canales.
Todas las columnas admiten el operador '='. 'PublishedAt' también admite '>', '>=', '<' y '<='.
Ordenar por es compatible con las columnas Calificación, Relevancia y Título.
SELECT * FROM Channels WHERE Id = 'abc123'
SELECT * FROM Channels WHERE ChannelId = 'abc123' AND SearchTerms = 'music|movies-horror' ORDER BY Rating LIMIT 10
Nota: No se admite la ordenación cuando se especifica una de las columnas utilizadas para buscar canales como SearchTerms.
Columnas
Nombre | Tipo | Dimensión | Métrica predeterminada | Dimensión por defecto | Descripción |
---|---|---|---|---|---|
Id [KEY] | String | El ID que utiliza YouTube para identificar de forma exclusiva el canal. | |||
Title | String | El título del canal. | |||
Description | String | La descripción del canal. El valor de la columna tiene una longitud máxima de 1000 caracteres. | |||
CustomUrl | String | La URL personalizada del canal. | |||
PublishedAt | Datetime | La fecha y hora en que se creó el canal. El valor se especifica en formato ISO 8601 (YYYY-MM-DDThhss.sZ). | |||
ThumbnailsDefaultUrl | String | La URL de la miniatura de la imagen predeterminada. | |||
DefaultLanguage | String | Esta columna es confidencial para evaluadores de confianza. | |||
LiveBroadcastContent | String | Una indicación de si un recurso de video o canal tiene contenido de transmisión en vivo. | |||
LocalizedTitle | String | Esta columna es confidencial para evaluadores de confianza. El título del video localizado. | |||
LocalizedDescription | String | Esta columna es confidencial para evaluadores de confianza. La descripción del video localizado. | |||
Country | String | El país con el que está asociado el canal. | |||
ViewCount | Long | El número de veces que se ha visto el canal. | |||
SubscriberCount | Long | El número de suscriptores que tiene el canal. Este valor se redondea a tres cifras significativas. | |||
HiddenSubscriberCount | Boolean | Indica si el recuento de suscriptores del canal es visible públicamente. | |||
VideoCount | Long | El número de videos subidos al canal. | |||
RelatedPlaylistsLikes | String | El ID de la lista de reproducción que contiene los videos que te gustan del canal. | |||
RelatedPlaylistsUploads | String | El ID de la lista de reproducción que contiene los videos subidos del canal. | |||
PrivacyStatus | String | Estado de privacidad del canal. Valores válidos para esta columna: privado, público, no listado. | |||
IsLinked | Boolean | Indica si los datos del canal identifican a un usuario que ya está vinculado a un nombre de usuario de YouTube o a una cuenta de Google+. Un usuario que tiene uno de estos enlaces ya tiene una identidad pública de YouTube, lo cual es un prerrequisito para varias acciones, como subir videos. | |||
LongUploadsStatus | String | Indica si el canal es elegible para subir videos de más de 15 minutos de duración. Esta columna solo se devuelve si el propietario del canal autorizó la solicitud de API. Consulte el Centro de ayuda de YouTube para obtener más información sobre esta función. | |||
MadeForKids | Boolean | Este valor indica si el canal está designado como dirigido a niños y contiene el estado actual del canal "creado para niños". | |||
Keywords | String | Palabras clave asociadas a tu canal. El valor es una lista de cadenas separadas por espacios. | |||
TrackingAnalyticsAccountId | String | El ID de una cuenta de Google Analytics que desea utilizar para realizar un seguimiento y medir el tráfico de su canal. | |||
ModerateComments | Boolean | Esta configuración determina si los comentarios enviados por el usuario que quedan en la página del canal deben ser aprobados por el propietario del canal para que sean visibles públicamente. El valor predeterminado es falso. | |||
SearchTerms | String | El parámetro SearchTerms especifica el término de consultar para buscar. |
Pseudo-Columnas
Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.
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-DDThhss.sZ). | |||
UpdatedAt | Datetime | La fecha y hora en que se actualizó por última vez el comentario. El valor se especifica en formato ISO 8601 (YYYY-MM-DDThhss.sZ). |
Pseudo-Columnas
Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.
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-DDThhss.sZ). | |||
ChannelId | String | El ID que utiliza YouTube para identificar de forma exclusiva al usuario que agregó el elemento a la lista de reproducción. | |||
Title | String | El título del elemento. | |||
Description | String | La descripción del artículo. | |||
ThumbnailsDefaultUrl | String | La URL del elemento. | |||
ChannelTitle | String | El título del canal al que pertenece el elemento de la lista de reproducción. | |||
VideoOwnerChannelTitle | String | El título del canal del canal que subió este video. | |||
VideoOwnerChannelId | String | El ID de canal del canal que subió este video. | |||
PlaylistId | String | El ID que utiliza YouTube para identificar de forma exclusiva la lista de reproducción en la que se encuentra el elemento de la lista de reproducción. | |||
Position | String | El orden en que aparece el elemento en la lista de reproducción. El valor utiliza un índice basado en cero, por lo que el primer elemento tiene una posición de 0, el segundo elemento tiene una posición de 1 y así sucesivamente. | |||
ResourceIdKind | String | El tipo, o tipo, del recurso referido. | |||
ResourceIdVideoId | String | Si el valor de ResourceIdKind de la columna es youtube#video, entonces esta columna estará presente y su valor contendrá el ID que utiliza YouTube para identificar de manera única el video en la lista de reproducción. | |||
VideoId | String | El ID que usa YouTube para identificar un video de manera única. Para recuperar el recurso de video, establezca la columna ID en este valor. | |||
Note | String | Una nota generada por el usuario para este elemento. | |||
VideoOwnerPublishedAt | Datetime | La fecha y la hora en que se publicó el video en YouTube. El valor se especifica en formato ISO 8601 (YYYY-MM-DDThhss.sZ). | |||
PrivacyStatus | String | El estado de privacidad del elemento de la lista de reproducción. |
Pseudo-Columnas
Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.
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-DDThhss.sZ). | |||
ChannelId | String | El ID que utiliza YouTube para identificar de forma exclusiva el canal que publicó la lista de reproducción. | |||
Title | String | El título de la lista de reproducción. | |||
Description | String | La descripción de la lista de reproducción. | |||
ThumbnailsDefaultUrl | String | La URL de la imagen. | |||
ChannelTitle | String | Título del canal del canal al que pertenece el video. | |||
DefaultLanguage | String | Esta columna es confidencial para evaluadores de confianza. El idioma del texto en las columnas Título y Descripción. | |||
LocalizedTitle | String | Esta columna es confidencial para evaluadores de confianza. El título de la lista de reproducción localizada. | |||
LocalizedDescription | String | Esta columna es confidencial para evaluadores de confianza. La descripción de la lista de reproducción localizada. | |||
PrivacyStatus | String | El estado de privacidad de la lista de reproducción. Valores válidos para esta columna: privado, público, no listado. | |||
VideoCount | Integer | El número de videos en la lista de reproducción. | |||
EmbedHtml | String | Una etiqueta iframe que incrusta un reproductor que reproducirá la lista de reproducción. | |||
SearchTerms | String | El parámetro SearchTerms especifica el término de consultar para buscar. |
Pseudo-Columnas
Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.
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-DDThhss.sZ). | |||
ChannelTitle | String | El título del canal al que pertenece la suscripción. | |||
Title | String | El título de la suscripción. | |||
Description | String | Los detalles de la suscripción. | |||
ResourceIdKind | String | El tipo del recurso API. | |||
ResourceIdChannelId | String | El valor que utiliza YouTube para identificar de forma exclusiva el canal al que se suscribió el usuario. | |||
ChannelId | String | El ID que utiliza YouTube para identificar de forma exclusiva el canal del suscriptor. | |||
ThumbnailsDefaultUrl | String | La URL de la imagen predeterminada. | |||
TotalItemCount | Integer | El número aproximado de elementos a los que apunta la suscripción. | |||
NewItemCount | Integer | El número de elementos nuevos en la suscripción desde que se leyó su contenido por última vez. | |||
ActivityType | String | El tipo de actividad para la que es esta suscripción. Valores válidos: todos, subidas. | |||
SubscriberTitle | String | El título del canal del suscriptor. | |||
SubscriberDescription | String | La descripción del canal del suscriptor. | |||
SubscriberChannelId | String | El ID que asigna YouTube para identificar de forma única el canal del suscriptor. | |||
SubscriberThumbnailsDefaultUrl | String | La URL de la imagen predeterminada. |
Pseudo-Columnas
Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.
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-DDThhss.sZ). | |||
Description | String | La descripción del vídeo. | |||
Duration | String | La duración del vídeo. El valor de la propiedad es una duración ISO 8601. | |||
ViewCount | Long | La cantidad de veces que se ha visto el video. | |||
LikeCount | Long | El número de usuarios que han indicado que les gustó el video. | |||
DislikeCount | Long | El número de usuarios que indicaron que no les gustó el video. Junto con los cambios para hacer privados los recuentos de No me gusta de los videos en toda la plataforma de YouTube, este campo se devuelve solo si el propietario del video autenticó la solicitud de API. | |||
CommentCount | Long | El número de comentarios para el video. | |||
EmbedHtml | String | Una etiqueta iframe que incrusta un reproductor que reproducirá el video. | |||
PublicStatsViewable | Boolean | Este valor indica si las estadísticas de video extendidas en la página de reproducción se pueden ver públicamente. De forma predeterminada, esas estadísticas se pueden ver, y las estadísticas como el número de vistas y las calificaciones seguirán siendo visibles públicamente incluso si este valor se establece en falso. | |||
TagsAggregate | String | Una lista de etiquetas de palabras clave asociadas con el video. | |||
LiveBroadcastContent | String | Indica si el video es una transmisión en vivo próxima/activa. Un valor de ninguno indica que el video no es una transmisión en vivo próxima/activa. Valores válidos para esta columna: en vivo, ninguno, próximo. | |||
Dimension | String | Indica si el video está disponible en 3D o en 2D. | |||
Definition | String | Indica si el video está disponible en alta definición HD o solo en definición estándar. Valores válidos para esta columna: hd, sd. | |||
Caption | String | Indica si los subtítulos están disponibles para el video. Valores válidos para esta columna: falso, verdadero. | |||
LicensedContent | Boolean | Indica si el video representa contenido con licencia, lo que significa que el contenido se subió a un canal vinculado a un socio de contenido de YouTube y luego fue reclamado por ese socio. | |||
AllowedAggregate | String | Una lista de códigos de región que identifican los países donde se puede ver el video. | |||
BlockedAggregate | String | Una lista de códigos de región que identifican los países donde el video está bloqueado. | |||
Projection | String | Especifica el formato de proyección del video. Valores válidos: 360, rectangular. | |||
PrivacyStatus | String | El estado de privacidad de la lista de reproducción. Valores válidos: privado, público, no listado. | |||
MadeForKids | Boolean | Este valor indica si el video está hecho para niños. | |||
License | String | La licencia. Valores válidos: creativeCommon, youtube. | |||
Embeddable | Boolean | Este valor indica si el video se puede incrustar en otro sitio web. | |||
ThumbnailsDefaultUrl | String | La URL de la imagen predeterminada. | |||
DefaultLanguage | String | Esta columna es confidencial para evaluadores de confianza. El idioma del texto en las columnas Título y Descripción. | |||
DefaultAudioLanguage | String | La columna default_audio_language especifica el idioma que se habla en la pista de audio predeterminada del video. | |||
UploadStatus | String | El estado del video subido. Valores válidos para esta columna: eliminado, fallido, procesado, rechazado, cargado. | |||
FailureReason | String | Este valor explica por qué no se pudo cargar un video. Esta columna solo tiene un valor si la columna UploadStatus indica que la carga falló. Valores válidos para esta columna: códec, conversión, archivo vacío, archivo no válido, demasiado pequeño, carga anulada. | |||
RejectionReason | String | Este valor explica por qué YouTube rechazó un video subido. Esta columna solo tiene un valor si la columna UploadStatus indica que se rechazó la carga. Valores válidos para esta columna: reclamo, derechos de autor, duplicado, inapropiado, longitud, términos de uso, marca comercial, cuenta de carga cerrada, cuenta de carga suspendida. | |||
RecordingDate | Datetime | La fecha y hora en que se grabó el video. El valor se especifica en formato ISO 8601 (YYYY-MM-DDThhss.sssZ). | |||
SearchTerms | String | El término de consultar a buscar. |
Pseudo-Columnas
Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.
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:
- sys_catalogs: enumera las bases de datos disponibles.
- sys_schemas: enumera los esquemas disponibles.
- sys_tablas: enumera las tablas y vistas disponibles.
- sys_tablecolumns: Describe las columnas de las tablas y vistas disponibles.
- procedimientos_sys: describe los procedimientos almacenados disponibles.
- parámetros_procedimiento_sys: Describe procedimiento almacenado* parámetros.
- sys_keycolumns: describe las claves principal y externa.
- índices_sys: Describe los índices disponibles.
Tablas de origen de datos
Las siguientes tablas devuelven información sobre cómo conectarse y consultar la fuente de datos:
- sys_connection_props: Devuelve información sobre las propiedades de conexión disponibles.
- sys_sqlinfo: describe las consultas SELECT que el conector puede descargar al origen de datos.
Consultar tablas de información
La siguiente tabla devuelve estadísticas de consultar para consultas de modificación de datos:
- identidad_sys: devuelve información sobre operaciones lote o actualizaciones individuales.
sys_catalogs
Enumera las bases de datos disponibles.
La siguiente consultar recupera todas las bases de datos determinadas por la cadena de conexión:
SELECT * FROM sys_catalogs
Columnas
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.
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. |
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. |
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. |
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. |
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:
OFF
: Indica que el flujo de OAuth será manejado en su totalidad por el usuario. Se requerirá un OAuthAccessToken para la autenticación.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.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"